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

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

説明

グリッド ACL を表示するか、特定のプリンシパルに関連するグリッド ACL の部分を表示します。

構文

/api/v2/vdc/get_acl?vdc=controller-name 

引数

vdc

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

トランザクション タイプ

同期

リクエスト タイプ

GET

例： vdc mygrid の ACL を表示します

GET http://192.168.123.200/api/v2/vdc/get_acl?vdc=mygrid

サンプル出力

JSON：

{
   "acl" : {
      "owner" : {
         "id" : "a5cb10bc-7291-4a86-84f8-74419fc9ae63"
      },
      "entries" : [
         {
            "grid_administrator" : 1,
            "id" : "a5cb10bc-7291-4a86-84f8-74419fc9ae63"
         },
         {
            "grid_administrator" : 1,
            "id" : "8bc880d9-c86c-4d70-95b7-77438bf7d4d1"
         },
         {
            "app_developer" : 1,
            "id" : "4326b4d1-8896-4c92-931a-18a9fd6e0509"
         },
         {
            "app_developer" : 1,
            "id" : "afeb0c36-539f-4299-946b-820a0411f3de"
         }
      ]
   }
}

XML：

<acl>
  <entries>
    <entry>
      <grid_administrator>1</grid_administrator>
      <id>a5cb10bc-7291-4a86-84f8-74419fc9ae63</id>
    </entry>
    <entry>
      <grid_administrator>1</grid_administrator>
      <id>8bc880d9-c86c-4d70-95b7-77438bf7d4d1</id>
    </entry>
    <entry>
      <app_developer>1</app_developer>
      <id>4326b4d1-8896-4c92-931a-18a9fd6e0509</id>
    </entry>
    <entry>
      <app_developer>1</app_developer>
      <id>afeb0c36-539f-4299-946b-820a0411f3de</id>
    </entry>
  </entries>
  <owner>
    <id>a5cb10bc-7291-4a86-84f8-74419fc9ae63</id>
  </owner>
</acl>

HTTP エラー コード

400

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

404.1

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

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

メモ

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