リスナーにアクセス制御リスト (ACL) を関連付けます。
操作説明
AssociateAclsWithListener は非同期操作です。リクエストの送信後、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。ListAclRelations 操作を呼び出して、タスクのステータスをクエリできます。
ACL が 関連付け中 の状態である場合、ACL はリスナーに関連付け処理中です。
ACL が 関連付け済み の状態である場合、ACL はリスナーに関連付けられています。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
alb:AssociateAclsWithListener |
create |
*Acl
*LoadBalancer
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| AclIds |
array |
必須 |
ACL の ID。各呼び出しで最大 3 つの ID を指定できます。 |
|
|
string |
任意 |
ACL の ID。 |
nacl-hp34s2h0xx1ht4nwo**** |
|
| ListenerId |
string |
必須 |
リスナーの ID。 |
lsr-bp1bpn0kn908w4nbw**** |
| AclType |
string |
必須 |
ACL のタイプ。有効な値:
|
White |
| DryRun |
boolean |
任意 |
リクエストを実行せずに、ドライランのみを実行するかどうかを指定します。有効な値:
|
true |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。 説明
このパラメーターを指定しない場合、システムは自動的に リクエスト ID をクライアントトークンとして使用します。リクエスト ID はリクエストごとに異なる場合があります。 |
5A2CFF0E-5718-45B5-9D4D-70B3FF3898 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
リスナーに ACL を関連付ける操作。 |
||
| JobId |
string |
同期タスクの ID です。 |
72dcd26b-f12d-4c27-b3af-18f6aed5**** |
| RequestId |
string |
リクエスト ID。 |
CEF72CEB-54B6-4AE8-B225-F876FF7BA984 |
例
成功レスポンス
JSONJSON
{
"JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | QuotaExceeded.AclsNum | The quota of %s is exceeded, usage %s/%s. | |
| 400 | IncorrectStatus.Acl | The status of %s [%s] is incorrect. | |
| 400 | ResourceQuotaExceeded.ListenerAclEntriesNum | The quota of %s is exceeded for resource %s, usage %s/%s. | |
| 400 | OperationDenied.AclNotSupport | The operation is not allowed because of %s. | |
| 400 | ResourceAlreadyExist.AclEntry | The specified resource %s already exists. | |
| 400 | ResourceInUse.Acl | The specified resource %s is in use. | |
| 400 | OperationDenied.LoadBalancerJoinedSecurityGroupNotSupportAcl | The operation is not allowed because of loadbalancer joined security group not support acl. | |
| 404 | ResourceNotFound.Acl | The specified resource %s is not found. | |
| 404 | ResourceNotFound.Listener | The specified resource %s is not found. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。