指定したリージョンのアクセス制御リスト (ACL) を照会します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 便宜上、この操作をOpenAPI Explorerで呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 文字列 必須 DescribeACL

実行する操作。The operation that you want to perform. 値をDescribeACLに設定します。

RegionId String 必須 cn-shanghai

ACLがデプロイされているリージョンのID。

AclIds String いいえ acl-xhwhyuo43l*******

ACLのID。

  • 複数のACLインスタンスを同時にクエリする場合は、ACL IDをコンマ (,) で区切ります。
  • このパラメーターを指定しないと、指定したリージョンのすべてのACLが照会されます。
パラメーター名 String 任意 test

ACLの名前。

名前は2 ~ 100文字で、英数字、ピリオド (.) 、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。

PageSize Integer 任意 10

各ページで返されるエントリ数。 最大値：50。 既定値：10。

PageNumber Integer 任意 1

返されるページ数。 既定値：1

レスポンスパラメーター

パラメーター データ型 例 説明
TotalCount Integer 455

ACLの総数。

PageSize Integer 3

1 ページあたりで返されるエントリ数。

RequestId 文字列 660F303F-C88E-4026-BC6A-FC24B78FD7EA

リクエストの ID です。

PageNumber Integer 1

返されたページの数です。

Acls Aclの配列

ACLのリスト。

Acl
SagCount 文字列 0

ACLに関連付けられているSAGインスタンスの数。

AclId String acl-ohlexqptfhy*******

ACLのID。

パラメーター名 String test

ACLの名前。

ResourceGroupId 文字列 rg-acfm2iu4fnc****

ACLが属するリソースグループのID。

例

リクエストの例

http(s):// [エンドポイント]/?Action=DescribeACL
&RegionId=cn-上海
&AclIds=acl-xhwhyuo43l *******
&名前=テスト
&PageSize=10
&PageNumber=1
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeACLsResponse>
    <TotalCount>455</TotalCount>
    <PageSize>3</PageSize>
    <RequestId>660F303F-C88E-4026-BC6A-FC24B78FD7EA</RequestId>
    <PageNumber>1</PageNumber>
    <Acls>
        <Acl>
            <SagCount>0</SagCount>
            <ResourceGroupId>rg-acfm2iu4fnc ****</ResourceGroupId>
            <AclId>acl-rsds2pk8gxcqce ****</AclId>
            <名前> http</名前>
        </Acl>
        <Acl>
            <SagCount>0</SagCount>
            <ResourceGroupId>rg-acfm2iu4fnc ****</ResourceGroupId>
            <AclId>acl-o6yol7zowii5n2 ****</AclId>
            <名前> zxtest</名前>
        </Acl>
        <Acl>
            <SagCount>0</SagCount>
            <ResourceGroupId>rg-acfm2iu4fnc ****</ResourceGroupId>
            <AclId>acl-cl8gkzvldyxayo ****</AclId>
            <Name>test-name-bvt-te</Name>
        </Acl>
    </Acls>
</DescribeACLsResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 455、
  "PageSize" : 3、
  "RequestId" : "660F303F-C88E-4026-BC6A-FC24B78FD7EA" 、
  "PageNumber" : 1,
  "Acls" : {
    "Acl" : [ {
      "SagCount" : 0、
      "ResourceGroupId" : "rg-acfm2iu4fnc ****" 、
      "AclId" : "acl-rsds2pk8gxcqce ****" 、
      "Name" : "http"
    }, {
      "SagCount" : 0、
      "ResourceGroupId" : "rg-acfm2iu4fnc ****" 、
      "AclId" : "acl-o6yol7zowii5n2 ****" 、
      "Name" : "zxtest"
    }, {
      "SagCount" : 0、
      "ResourceGroupId" : "rg-acfm2iu4fnc ****" 、
      "AclId" : "acl-cl8gkzvldyxayo ****" 、
      "Name" : "test-name-bvt-te"
    } ]
  }
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明
403 Forbidden User not authorized to operate on the specified resource. 指定されたリソースを管理する権限がない場合に返されるエラーメッセージ。
403 MissingParameter 入力パラメータがありません。入力を確認してください。 1つ以上の必須パラメーターが設定されていない場合に返されるエラーメッセージ。 必要なパラメーターをすべて設定しているかどうかを確認します。
403 InvalidParameter 指定したパラメーターは無効です。 パラメーターが無効な値に設定されている場合に返されるエラーメッセージ。
403 InternalError 内部サーバーエラーが発生しました。 内部サーバーエラーが発生した場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。