統合ガイド › Web サービス API リファレンス ガイド › 有効なオブジェクト › app オブジェクト › get_acl メソッド（app オブジェクト）

get_acl メソッド（app オブジェクト）

説明

アプリケーション ACL、またはアプリケーション ACL の特定のプリンシパルに関連する部分を取得します。

構文

/api/v2/app/get_acl?app=application&principal=<principal>&vdc=controller-name

引数

app

アプリケーションの名前

プリンシパル

URL エンコードされたプリンシパル。 たとえば、local:user:api@3tera.com は local%3Auser%3Aapi%403tera.com として渡す必要があります

vdc

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

トランザクション タイプ

同期

リクエスト タイプ

GET

例： アプリケーション ACL の取得

アプリケーション test のアプリケーション ACL を取得します

GET http://192.168.123.200/api/v2/app/get_acl?app=test&principal=&vdc=mygrid 

サンプル出力

JSON：

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "configure" : 1,
            "id" : "778fee4e-9b83-4160-8b79-8bb0e1a87af8"
         }
      ]
   }
}

XML：

<acl>
  <entries>
    <entry>
      <configure>1</configure>
      <id>778fee4e-9b83-4160-8b79-8bb0e1a87af8</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

例： プリンシパルの ACL データの取得

アプリケーション test のプリンシパル local:user:api@3tera.com の ACL データを取得します。

GET
http://192.168.123.200/api/v2/app/get_acl?app=test&principal=local%3Auser%3Aapi%403tera.com&vdc=mygrid

サンプル出力

JSON：

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "id" : "f9939715-e340-4e09-b179-f61e3b031338",
            "full" : 1
         },
         {
            "id" : "932b639b-2f78-4415-9c3b-22a2a98ce9fe",
            "full" : 1
         },
         {
            "configure" : 1,
            "id" : "778fee4e-9b83-4160-8b79-8bb0e1a87af8"
         }
      ]
   }
}

XML：

<acl>
  <entries>
    <entry>
      <full>1</full>
      <id>f9939715-e340-4e09-b179-f61e3b031338</id>
    </entry>
    <entry>
      <full>1</full>
      <id>932b639b-2f78-4415-9c3b-22a2a98ce9fe</id>
    </entry>
    <entry>
      <configure>1</configure>
      <id>778fee4e-9b83-4160-8b79-8bb0e1a87af8</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

HTTP エラー コード

404

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

400.4

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

必要な引数（principal）がありません
- 引数 principal=principal がありません

404.1

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

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

エンティティが見つかりません - アプリケーション ACL の取得に失敗しました - ACL にプリンシパルのローカル ユーザ「test@3tera.com」が含まれていません。

- 無効なプリンシパルが指定されました

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