ListAcls - - Alibaba Cloud ドキュメントセンター

デバッグ

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

リクエストパラメーター


項目	データ型	必須／任意	例:	説明
操作	String	必須	ListAcls	実行する操作です。値をListAclsに設定します。
RegionId	String	必須	cn-hangzhou	Global Accelerator (GA) インスタンスがデプロイされているリージョンのID。値をcn-hangzhouに設定します。
ClientToken	String	任意	123e4567-e89b-12d3-a456-426655440000	リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。説明このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 RequestIdの値は、APIリクエストごとに異なる場合があります。
AclIds.N	String	任意	nacl-hp34s2h0xx1ht4nwo****	ネットワークACLのID。各リクエストで最大20のネットワークACL IDを指定できます。
AclName	String	任意	test-acl	ネットワークACLの名前。各リクエストで最大10個のネットワークACL名を指定できます。. 名前は2 ~ 128文字で、数字、ピリオド (.) 、アンダースコア (_) 、ハイフン (-) を使用できます。先頭は英字とする必要があります。
NextToken	String	任意	caeba0bbb2be03f84eb48b699f0a ****	クエリーの開始点を決定するトークンです。有効な値：これが最初のクエリである場合、または後続のクエリを送信しない場合は、このパラメーターを無視します。次のクエリを送信する場合は、前回の呼び出しから返されたNextTokenの値に値を設定します。
MaxResults	Integer	いいえ	10	各ページで返されるエントリ数。有効な値: 1〜50。デフォルト値: 10

レスポンスパラメーター


項目	データ型	例:	説明
RequestId	String	64ADAB1E-0B7F-4FD8-A404-3BECC0E9CCFF	リクエストの ID です。
TotalCount	Integer	1	返されたエントリの総数。
NextToken	String	FFmyTO70t ****	次のクエリの開始点を決定するトークン。有効な値： NextTokenが返されなかった場合は、追加の結果が存在しないことを示します。前のクエリでNextTokenが返された場合は、値を指定して次の結果セットを取得します。
MaxResults	Integer	10	1 ページあたりで返されるエントリ数。
Acls	GaAclsの配列		ネットワークACL。
AclId	String	nacl-hp34s2h0xx1ht4nwo ****	ネットワークACLのID。
AclName	String	test-acl	ネットワークACLの名前。
AddressIPVersion	String	IPv4	ネットワークACLのIPバージョン。有効な値： IPv4 IPv6
AclStatus	String	active	ネットワークACLの状態。有効な値： init: ネットワークACLの初期化中です。 active: ネットワークACLが利用可能です。 configuring: ネットワークACLが設定中です。 updating: ネットワークACLが更新中です。 deleting: GAインスタンスは削除中です。

例

リクエストの例

http(s)://[Endpoint]/?Action=ListAcls
&RegionId=cn-hangzhou
&ClientToken=02fb3da4 ****
&AclIds=["nacl-hp34s2h0xx1ht4nwo ****"]
&AclName=test-acl
&NextToken=caeba0bbb2be03f84eb48b699f0a ****
&MaxResults=10
&<共通リクエストパラメーター>

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

XML 形式

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

<ListAclsResponse>
    <RequestId>64ADAB1E-0B7F-4FD8-A404-3BECC0E9CCFF</RequestId>
    <TotalCount> 1 </ TotalCount>
    <NextToken>FFmyTO70t ****</NextToken>
    <MaxResults>10</MaxResults>
    <Acls>
        <AclId>nacl-hp34s2h0xx1ht4nwo ****</AclId>
        <AclName>test-acl</AclName>
        <AddressIPVersion>IPv4</AddressIPVersion>
        <AclStatus> アクティブ </AclStatus>
    </Acls>
</ListAclsResponse>

JSON 形式

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

{
  "RequestId" : "64ADAB1E-0B7F-4FD8-A404-3BECC0E9CCFF" 、
  "TotalCount" : 1、
  "NextToken" : "FFmyTO70t ****" 、
  "MaxResults" : 10、
  "Acls" : [ {
    "AclId" : "nacl-hp34s2h0xx1ht4nwo ****" 、
    "AclName" : "test-acl" 、
    "AddressIPVersion" : "IPv4" 、
    "AclStatus" : "active"
  } ]
}

エラーコード

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