アクセス制御リスト (ACL) にIPエントリを追加します。

説明　

  • AddEntriesToAcl操作は非同期です。 リクエストを送信した後、システムはリクエストIDを返しますが、操作はバックグラウンドで実行中です。 GetAclまたはListAcls操作を呼び出して、ACLのステータスを照会できます。
    • ACLが設定中の状態の場合、IPエントリが追加されています。 この場合、クエリ操作のみを実行できます。
    • ACLがアクティブ状態の場合、IPエントリが追加されます。
  • 同じGlobal Accelerator (GA) インスタンスに対して、指定された期間内にAddEntriesToAcl操作を繰り返し呼び出すことはできません。

デバッグ

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

リクエストパラメーター

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

実行する操作です。 値をAddEntriesToAclに設定します。

RegionId String 必須 cn-hangzhou

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

AclId String 必須 nacl-hp34s2h0xx1ht4nwo ****

ACLのID。

AclEntries.N. エントリ String 任意 10.0.XX.XX/24

ネットワークACLに追加するIPアドレスまたはCIDRブロック。

各リクエストに最大20のエントリを追加できます。

説明 このパラメーターは必須です。
AclEntries.N.EntryDescription String 任意 テストエントリ

エントリの説明。

各リクエストに最大20のエントリの説明を追加できます。

説明は1 ~ 256文字で、英数字、ハイフン (-) 、スラッシュ (/) 、ピリオド (.) 、アンダースコア (_) を使用できます。

ClientToken String 任意 5A2CFF0E-5718-45B5-9D4D-70B3FF3898

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、すべてのリクエスト間で一意であることを確認する必要があります。 クライアントトークンにはASCII文字のみを含めることができます。

説明 このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 RequestIdの値は、APIリクエストごとに異なる場合があります。
DryRun Boolean いいえ false

操作を実行せずにリクエストをチェックするかどうかを指定します。 有効な値：

  • true: 操作を実行せずにリクエストをチェックします。 システムは、必要なパラメーター、要求構文、および制限をチェックします。 要求がチェックに失敗した場合、エラーメッセージが返されます。 リクエストがチェックに合格すると、DryRunOperationエラーコードが返されます。
  • false (デフォルト): リクエストを送信します。 リクエストがチェックに合格すると、HTTP 2xxステータスコードが返され、操作が実行されます。

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710

リクエストの ID です。

AclId String nacl-hp34s2h0xx1ht4nwo ****

ACLのID。

例

リクエストの例

http(s):// [エンドポイント]/?Action=AddEntriesToAcl
&RegionId=cn-hangzhou
&AclId=nacl-hp34s2h0xx1ht4nwo ****
&AclEntries=[{"Entry":"10.0.XX.XX/24","EntryDescription":"test-entry"}]
&ClientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF3898
&DryRun=false
&<共通リクエストパラメーター>

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

XML 形式 

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

<AddEntriesToAclResponse>
    <RequestId> 365F4154-92F6-4AE4-92F8-7FF34B540710 </ RequestId>
    <AclId>nacl-hp34s2h0xx1ht4nwo ****</AclId>
</AddEntriesToAclResponse>

JSON 形式 

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

{
  "RequestId" : "365F4154-92F6-4AE4-92F8-7FF34B540710" 、
  "AclId" : "nacl-hp34s2h0xx1ht4nwo ****"
}

エラーコード

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