ネットワークアクセス制御リスト (ACL) を照会します。

デバッグ

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

リクエストパラメーター

項目 データ型 必須／任意 例: 説明
操作 String 必須 GetAcl

実行する操作です。 Set the value to GetAcl.

RegionId String 必須 cn-hangzhou

Global Accelerator (GA) インスタンスがデプロイされているリージョンのID。 値をcn-hangzhouに設定します。

AclId String 必須 nacl-hp34s2h0xx1ht4nwo ****

ネットワークACLのID。

レスポンスパラメーター

項目 データ型 例: 説明
RequestId String CEF72CEB-54B6-4AE8-B225-F876FF7BA984

リクエストの ID です。

AclId String nacl-hp34s2h0xx1ht4nwo ****

ネットワークACLのID。

AddressIPVersion String IPv4

ネットワークACLのIPバージョン。 有効な値：

  • IPv4
  • IPv6
AclStatus String active

ネットワークACLの状態。 有効な値：

  • init: ネットワークACLの初期化中です。
  • active: ネットワークACLが利用可能です。
  • configuring: ネットワークACLが設定中です。
  • updating: ネットワークACLが更新中です。
  • deleting: ネットワークACLが削除中です。
AclEntries AclEntriesの配列

返されるネットワークACLエントリのリスト。 最大20のネットワークACLエントリを返すことができます。

エントリ String 10.0.XX.XX/24

The network ACL entry.

EntryDescription String テストエントリ

ネットワークACLエントリの説明。

RelatedListeners RelatedListenersの配列

ネットワーク ACL に関連するリスナー。

ListenerId String lsr-bp1bpn0kn908w4nbw****

リスナーの ID を示します。

AclType String 白

ネットワークACLのタイプ。

  • White: ホワイトリスト。 ACLのIPアドレスまたはCIDRブロックからのリクエストのみが転送されます。 ホワイトリストは、指定したIPアドレスのみにアプリケーションへのアクセスを許可するシナリオに適用されます。 ホワイトリストが適切に構成されていないと、サービスに悪影響を及ぼす可能性があります。 リスナーにホワイトリストを設定すると、ホワイトリストに追加されたIPアドレスからのリクエストのみがリスナーによって転送されます。 ホワイトリストが有効であっても、ネットワークACLにIPアドレスが追加されていない場合、リスナーはリクエストを転送しません。
  • 黒: ブラックリスト。 ACLのIPアドレスまたはCIDRブロックからのすべてのリクエストがブロックされます。 ブラックリストは、特定のIPアドレスからアプリケーションへのアクセスを拒否するシナリオに適用されます。ブラックリストが有効であっても、ネットワークACLにIPアドレスが追加されていない場合、リスナーはすべてのリクエストを転送します。
AcceleratorId String ga-bp1odcab8tmno0hdq****

GA インスタンスの ID です。

AclName String test-acl

ネットワークACLの名前。

例

リクエストの例

http(s)://[Endpoint]/?Action=GetAcl
&RegionId=cn-hangzhou
&AclId=nacl-hp34s2h0xx1ht4nwo ****
&共通リクエストパラメータ

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

XML 形式 

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

<GetAclResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <AclId>nacl-hp34s2h0xx1ht4nwo ****</AclId>
    <AddressIPVersion>IPv4</AddressIPVersion>
    <AclStatus> アクティブ </AclStatus>
    <AclEntries>
        <エントリー> 10.0.XX.XX/24</エントリー>
        <EntryDescription> テストエントリ </EntryDescription>
    </AclEntries>
    <RelatedListeners>
        <ListenerId>lsr-bp1bpn0kn908w4nbw****</ListenerId>
        <AclType> ホワイト </AclType>
        <AcceleratorId>ga-bp1odcab8tmno0hdq ****</AcceleratorId>
    </RelatedListeners>
    <AclName>test-acl</AclName>
</GetAclResponse>

JSON 形式 

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

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984" 、
  "AclId" : "nacl-hp34s2h0xx1ht4nwo ****" 、
  "AddressIPVersion" : "IPv4" 、
  "AclStatus" : "active" 、
  "AclEntries" : [ {
    「エントリー」: 「10.0.XX.XX/24」、
    "EntryDescription" : "test-entry"
  } ],
  "RelatedListeners" : [ {
    "ListenerId" : "lsr-bp1bpn0kn908w4nbw ****" 、
    "AclType" : "ホワイト" 、
    "AcceleratorId" : "ga-bp1odcab8tmno0hdq ****"
  } ],
  "AclName" : "test-acl"
}

エラーコード

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