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

get_newobj_acl メソッド（group オブジェクト）

説明

グループに関連付けられた新規オブジェクト ACL 定義を表示するか、特定のプリンシパルに関連のある新規オブジェクト ACL 定義の部分を表示します。

構文

/api/v2/group/get_newobj_acl?group=group&principal=principal&vdc=vdc 

引数

group

グループの名前。 グローバル グループの場合は先頭に / を付けます。

プリンシパル

プリンシパルの名前。 <principal> は以下の形式になります。

URL

以下の形式のエンコードされたプリンシパル：

<name> - ローカル ユーザまたはグループ。

/<name> - グローバル ユーザまたはグループ。

<scope>:<type>:<name> - 完全修飾プリンシパル名。<scope> は 'global' または 'local'、<type> は 'group' または 'user'、<name> はグループ名またはユーザ名になります。

たとえば、local:user:api@3tera.com=full は local%3Auser%3Aapi%403tera.com%3Dfull として渡す必要があります

プリンシパルが空の文字列である場合、グループに関連する新規オブジェクト ACL 定義全体が表示されます。それ以外の場合は、特定のプリンシパルに関連する部分のみが表示されます。

vdc

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

トランザクション タイプ

同期

リクエスト タイプ

GET

例

GET http://192.168.123.200/api/v2/group/get_newobj_acl?group=apigroup&principal=&vdc=mygrid

サンプル出力

XML：

<acl>
  <entries>
    <entry>
      <full>1</full>
      <id>a5cb10bc-7291-4a86-84f8-74419fc9ae63</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

JSON：

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "id" : "a5cb10bc-7291-4a86-84f8-74419fc9ae63",
            "full" : 1
         }
      ]
   }
}

HTTP エラー コード

404

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

404.1

エンティティが見つかりません。'principal' に一致するプリンシパル名はありません。

400.4

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

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