すべてのプロダクト
Search

このプロダクト

    Virtual Private Cloud:AssociateNetworkAcl

    ドキュメントセンター

    Virtual Private Cloud:AssociateNetworkAcl

    最終更新日:Apr 27, 2026

    ネットワークアクセスコントロールリスト (ACL) を vSwitch に関連付けます。

    操作説明

    説明

    • AssociateNetworkAcl は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。タスクのステータスを確認するには、DescribeNetworkAclAttributes 操作を呼び出してください。

      • ネットワーク ACL のステータスが BINDING の場合、ネットワーク ACL は関連付け中です。

      • ネットワーク ACL のステータスが BINDED の場合、ネットワーク ACL は関連付け済みです。

    • 指定された時間内に、AssociateNetworkAcl 操作を繰り返し呼び出してネットワーク ACL を関連付けることはできません。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Resource

    array<object>

    任意

    関連付けるリソースに関する情報。

    object

    任意

    ResourceType

    string

    必須

    ネットワーク ACL を関連付けるリソースのタイプ。値は VSwitch に設定します。

    N の有効値：0 ～ 29。ネットワーク ACL は最大 30 個の vSwitch に関連付けられます。

    VSwitch
    ResourceId

    string

    必須

    関連付けるリソースの ID。

    vsw-bp1de348lntdw****
    NetworkAclId

    string

    必須

    ネットワーク ACL の ID。

    nacl-a2do9e413e0sp****
    RegionId

    string

    必須

    ネットワーク ACL のリージョン ID。DescribeRegions 操作を呼び出して、最新のリージョン一覧をクエリできます。

    cn-hangzhou
    ClientToken

    string

    任意

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

    トークンはクライアント側で生成できますが、異なるリクエスト間で一意であることを保証する必要があります。トークンには ASCII 文字のみを使用できます。

    説明

    このパラメーターを指定しない場合、システムは自動的に リクエスト ID を クライアントトークン として使用します。リクエスト ID は各リクエストごとに異なる可能性があります。

    123e4567-e89b-12d3-a456-426655440000
    DryRun

    boolean

    任意

    実際のリクエストを実行せずにドライランのみを実行するかどうかを指定します。

    false
    RegionId

    string

    必須

    ネットワーク ACL のリージョン ID。DescribeRegions 操作を呼び出して、最新のリージョン一覧をクエリできます。

    cn-hangzhou

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ParameterMissing.AliUid ParameterMissing.AliUid
    400 ParameterMissing.Bid ParameterMissing.Bid
    400 ParameterMissing.RegionId ParameterMissing.RegionId
    400 ParameterEmpty.RegionId ParameterEmpty.RegionId
    400 ParameterMissing.NetworkAclId ParameterMissing.NetworkAclId
    400 ParameterEmpty.NetworkAclId ParameterEmpty.NetworkAclId
    400 ParameterMissing.Resources ParameterMissing.Resources
    400 ParameterEmpty.Resources ParameterEmpty.Resources
    400 InvalidNetworkAcl.NotFound The special Network Acl is not found.
    400 NetworkStatus.Modifying The special Network Acl is in modifying.
    400 ResourceStatus.Error The binding instance is in middle status.
    400 InvalidResource.NotFound The binding instance is not found.
    400 InvalidResource.VpcError The network acl and resource not in same vpc.
    400 InvalidResource.BindingExist The binding instance has been binded.
    400 NotSupport.NetworkAcl Network acl is not support now.
    400 ParameterIllegal.ResourceType The specified resource type is illegal.
    400 MissingParam.Resource Missing parameter Resource.
    400 OperationDenied.NetworkAclAttachmentInMiddleStatus The network ACL is being bound to or unbound from the switch.
    500 InternalError The request processing has failed due to some unknown error.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。