前のトピック: get_acl メソッド(app オブジェクト)

次のトピック: modify_acl メソッド(app オブジェクト)


put_acl メソッド(app オブジェクト)
説明

アプリケーション ACL 全体を置換します。

構文
/api/v1/app/put_acl?app=application&owner=<owner>&acl=<ACLs>&vdc=controller-name
引数
app

アプリケーションの名前

owner

指定されたプリンシパルに対するアプリケーション ACL の URL エンコードされた所有者属性。 たとえば、local:user:api@3tera.com は local%3Auser%3Aapi%403tera.com として渡す必要があります

owner

指定されたプリンシパルに対するグリッド ACL の URL エンコードされた所有者属性

acl

スラッシュ(/)で区切られたプリンシパルの URL エンコードされたリスト

vdc

ターゲットの仮想データ センターの名前

トランザクション タイプ

同期

リクエスト タイプ

GET

アプリケーション test の ACL 全体を所有者 api@3tera.com に置換します

GET
http://192.168.123.200/api/v1/app/put_acl?app=test&owner=local%3Auser%3Aapi%403tera.com&acl=&vdc=mygrid 

アプリケーション test の ACL 全体を所有者 api@3tera.com およびプリンシパル local:user:api@3tera.com=full に置換します

GET
http://192.168.123.200/api/v1/app/put_acl?app=test&owner=local%3Auser%3Aapi%403tera.com&acl= local%3Auser%3Aapi%403tera.com%3Dfull&vdc=mygrid

アプリケーション test の ACL 全体を所有者 api@3tera.com およびプリンシパル local:user:api@3tera.com=full/local:user:test@3tera.com=configure に置換します。

GET
http://192.168.123.200/api/v1/app/put_acl?app=test&owner=local%3Auser%3Aapi%403tera.com&acl=local%3Auser%3Aapi%403tera.com%3Dfull%2Flocal%3Auser%3Atest%403tera.com%3Dconfigure&vdc=mygrid
サンプル出力

JSON

{
   "message" : ""
} 

XML

<message></message>

HTTP エラー コード
404

エンティティ vdc mygrid が見つかりません。WS_API アプリケーションに設定されていない VDC 名が指定されました。

400.4

必要な引数(app)がありません。 
リクエストに引数 app=app がありません。

必要な引数(owner)がありません

- 引数 owner=owner

必要な引数(acl)がありません

- 引数 acl=acl がありません

404.1

エンティティが見つかりません - アプリケーション test は存在しません。

- mygrid に存在しないアプリケーションが指定されました。

エンティティが見つかりません - アプリケーション ACL の配置に失敗しました - プリンシパルのデータが無効です - プリンシパルのローカル ユーザ「test@3tera.com」が存在しません。

- 無効な所有者または ACL が指定されました

ノート

この API は WS_API_r6-1.0.6-1 以降で使用できます。