すべてのプロダクト
Search

このプロダクト

    Virtual Private Cloud:UpdateNetworkAclEntries

    ドキュメントセンター

    Virtual Private Cloud:UpdateNetworkAclEntries

    最終更新日:Apr 27, 2026

    ネットワークアクセスコントロールリスト (ACL) のルールを更新します。

    操作説明

    • UpdateNetworkAclEntries インターフェースは非同期インターフェースです。つまり、システムはリクエスト ID を返しますが、ネットワーク ACL ルールの更新はまだ完了しておらず、バックグラウンドで更新タスクが実行中です。DescribeNetworkAclAttributes を呼び出して、ネットワーク ACL ルールの更新ステータスを確認できます。

      • ネットワーク ACL ルールのステータスが Modifying の場合、ネットワーク ACL ルールが更新中の状態です。

      • ネットワーク ACL ルールのステータスが Available の場合、ネットワーク ACL ルールの更新が成功したことを示します。

    • UpdateNetworkAclEntries インターフェースでは、同一のネットワーク ACL ルールを並行して更新することはサポートされていません。

    今すぐお試しください

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

    テスト

    RAM 認証

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

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    IngressAclEntries

    array<object>

    任意

    インバウンドルールに関する情報です。

    object

    任意

    インバウンドルールに関する情報です。

    NetworkAclEntryId

    string

    任意

    インバウンドルールの ID です。

    N の有効値：0 ～ 99。最大 100 個のインバウンドルール ID を指定できます。

    nae-2zepn32de59j8m4****
    EntryType

    string

    任意

    ルールタイプです。値を custom に設定してください。

    custom
    NetworkAclEntryName

    string

    任意

    インバウンドルールの名前です。

    名前は 1 ～ 128 文字である必要があり、http:// または https:// で始まってはいけません。

    acl-3
    Policy

    string

    任意

    アクセス制御ポリシーです。有効値：

    • accept：ネットワークトラフィックを許可します。

    • drop

    列挙値:

    • drop :

      drop

    • accept :

      accept

    accept
    SourceCidrIp

    string

    任意

    送信元 CIDR ブロックです。プレフィックスリスト ID を指定することもできます。

    10.0.0.0/24 pl-xxxxxx
    IpVersion

    string

    任意

    IP バージョンです。

    • IPv4

    • IPv6

    列挙値:

    • IPv6 :

      IPv6

    • IPv4 :

      IPv4

    IPv4
    Description

    string

    任意

    インバウンドルールの説明です。

    説明は 1 ～ 256 文字である必要があり、http:// または https:// で始まってはいけません。

    This is IngressAclEntries.
    Protocol

    string

    任意

    プロトコルタイプです。有効値：

    • icmp

    • gre

    • tcp

    • udp

    • all

    • icmpv6

    列挙値:

    • all :

      all

    • tcp :

      tcp

    • udp :

      udp

    • gre :

      gre

    • icmp :

      icmp

    • icmpv6 :

      icmpv6

    all
    Port

    string

    任意

    インバウンドルールの送信元ポート範囲です。

    • Protocol が all、icmp、または gre に設定されている場合、ポート範囲は -1/-1 となり、すべてのポートが利用可能であることを示します。

    • Protocol が tcp または udp に設定されている場合、有効なポート番号は 1 ～ 65535 です。フォーマット：1/200（ポート 1 ～ 200）または 80/80（ポート 80）。

    -1/-1
    EgressAclEntries

    array<object>

    任意

    アウトバウンドルールに関する情報です。

    object

    任意

    アウトバウンドルールに関する情報です。

    NetworkAclEntryId

    string

    任意

    アウトバウンドルールの ID です。

    N の有効値：0 ～ 99。最大 100 個のアウトバウンドルール ID を指定できます。

    nae-2zecs97e0brcge46****
    EntryType

    string

    任意

    ルールタイプです。値を custom に設定してください。

    custom
    NetworkAclEntryName

    string

    任意

    アウトバウンドルールの名前です。

    名前は 1 ～ 128 文字である必要があり、http:// または https:// で始まってはいけません。

    acl-2
    Policy

    string

    任意

    アクセス制御ポリシーです。有効値：

    • accept

    • drop

    列挙値:

    • drop :

      drop

    • accept :

      accept

    accept
    Description

    string

    任意

    アウトバウンドルールの説明です。

    説明は 1 ～ 256 文字である必要があり、http:// または https:// で始まってはいけません。

    This is EgressAclEntries.
    Protocol

    string

    任意

    プロトコルタイプです。有効値：

    • icmp

    • gre

    • tcp

    • udp

    • all

    • icmpv6

    列挙値:

    • all :

      all

    • tcp :

      tcp

    • udp :

      udp

    • gre :

      gre

    • icmp :

      icmp

    • icmpv6 :

      icmpv6

    all
    DestinationCidrIp

    string

    任意

    宛先 CIDR ブロックです。プレフィックスリスト ID を指定することもできます。

    10.0.0.0/24 pl-xxxxxx
    IpVersion

    string

    任意

    IP バージョンです。

    • IPv4

    • IPv6

    列挙値:

    • IPv6 :

      IPv6

    • IPv4 :

      IPv4

    IPv4
    Port

    string

    任意

    アウトバウンドトラフィックの宛先ポート範囲です。

    • Protocol が all、icmp、または gre に設定されている場合、ポート範囲は -1/-1 となり、すべてのポートが利用可能であることを示します。

    • Protocol が tcp または udp に設定されている場合、有効なポート番号は 1 ～ 65535 です。フォーマット：1/200（ポート 1 ～ 200）または 80/80（ポート 80）。

    -1/-1
    UpdateIngressAclEntries

    boolean

    任意

    インバウンドルールを更新するかどうかを指定します。有効値：

    • true

    • false（デフォルト）

    説明

    このパラメーターを使用して ACL にインバウンドルールを追加することはできません。ACL にさらにインバウンドルールを追加する場合は、この API オペレーションを呼び出す際に、既存のルールと追加したいルールの両方を指定する必要があります。追加したいルールのみを指定した場合、既存のルールが上書きされます。

    false
    UpdateEgressAclEntries

    boolean

    任意

    アウトバウンドルールを更新するかどうかを指定します。有効値：

    • true

    • false（デフォルト）

    説明

    このパラメーターを使用して ACL にアウトバウンドルールを追加することはできません。ACL にさらにアウトバウンドルールを追加する場合は、この API オペレーションを呼び出す際に、既存のルールと追加したいルールの両方を指定する必要があります。追加したいルールのみを指定した場合、既存のルールが上書きされます。

    false
    NetworkAclId

    string

    必須

    ネットワーク ACL の ID です。

    nacl-bp1lhl0taikrzxsc****
    RegionId

    string

    必須

    ネットワーク ACL のリージョン ID です。

    DescribeRegions オペレーションを呼び出して、最新のリージョンリストを照会できます。

    cn-hangzhou
    ClientToken

    string

    任意

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

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

    説明

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

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

    boolean

    任意

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

    • true：ドライランを実行します。システムは AccessKey ペア、RAM ユーザーの権限、必須パラメーターなど、リクエストに潜在的な問題がないかをチェックします。ドライランに失敗した場合は、エラーメッセージが返されます。ドライランに成功した場合は、DryRunOperation エラーコードが返されます。

    • false（デフォルト）：ドライランを実行し、実際のリクエストも実行します。ドライランに成功した場合は、2xx HTTP ステータスコードが返され、操作が実行されます。

    true
    RegionId

    string

    必須

    ネットワーク ACL のリージョン ID です。

    DescribeRegions オペレーションを呼び出して、最新のリージョンリストを照会できます。

    cn-hangzhou

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID です。

    1170A5A0-E760-4331-9133-A7D38D973215

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "1170A5A0-E760-4331-9133-A7D38D973215"
}

    エラーコード

    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.Port ParameterMissing.Port
    400 ParameterIllegal.Port ParameterIllegal.Port
    400 ParameterIllegal.Policy ParameterIllegal.Policy
    400 ParameterMissing.Policy ParameterMissing.Policy
    400 ParameterIllegal.Protocol ParameterIllegal.Protocol
    400 ParameterMissing.Protocol ParameterMissing.Protocol
    400 ParameterLengthIllegal.Name ParameterLengthIllegal.Name
    400 ParameterIllegal.Name ParameterIllegal.Name
    400 ParameterLengthIllegal.Description ParameterLengthIllegal.Description
    400 ParameterIllegal.Description ParameterIllegal.Description
    400 ParameterIllegal.SourceCidrIp ParameterIllegal.SourceCidrIp
    400 ParameterMissing.SourceCidrIp ParameterMissing.SourceCidrIp
    400 ParameterIllegal.DestinationCidrIp ParameterIllegal.DestinationCidrIp
    400 ParameterMissing.DestinationCidrIp ParameterMissing.DestinationCidrIp
    400 QuotaExceed.NetworkAclEntry Network acl entry is over limit.
    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 NotSupport.NetworkAcl Network acl is not support now.
    400 IllegalParam.IngressAclEntryId The specified IngressAclEntryId is invalid.
    400 IllegalParam.EgressAclEntryId The specified EgressAclEntryId is invalid.
    400 OperationDenied.VpcIpv6NotEnabled IPv6 has not been enabled for the VPC.
    400 IllegalParam.SourceCidrIp Param SourceCidrIp is illegal.
    400 IllegalParam.Policy Param Policy illegal.
    400 IllegalParam.Protocol Param Protocol illegal.
    400 IllegalParam.DestinationCidrIp Param DestinationCidrIp illegal.
    400 IllegalParam.IpVersion Param IpVersion illegal.
    400 IllegalParam.PortRange The specified port range is invalid.
    400 ResourceNotFound.PrefixList The specified resource of prefixList is not found.
    400 OperationDenied.IpVersionInconsistencyWithPrefixList The ip version of the prefix list %s you passed in is inconsistent with the actual ip version of the prefix list.
    400 OperationDenied.SystemPrefixList The operation is not allowed because of SystemPrefixList.
    400 IncorrectStatus.PrefixList The status of prefixList is incorrect.
    400 UnsupportedRegion.PrefixListEntry The feature of prefixList entry is not supported in this region.
    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.

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

    変更履歴

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