addNetworkAclOutboundRule

Prev Next

VPC環境で利用できます。

Network ACLの Outboundルールリストを追加します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET | POST /vpc/v2/addNetworkAclOutboundRule
参考

ガイドは GETメソッドを基準に説明します。POSTメソッドの呼び出しテストは、NAVERクラウドプラットフォームコンソールの API Gatewayサービスの Swaggerで行えます。

リクエストヘッダ

VPC APIで共通して使用されるヘッダの詳細は、VPCのリクエストヘッダをご参照ください。

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
regionCode String Optional Outboundルール追加対象 Network ACLのリージョンコード
  • 照会結果の最初のリージョン(デフォルト)
  • getRegionListを参照
networkAclNo String Required Network ACL番号
networkAclRuleList.N.priority Integer Required Network ACLルールの優先順位
  • 0~199
  • 他の Outboundルールの優先順位と重複不可
networkAclRuleList.N.protocolTypeCode String Required Network ACLルールのプロトコルタイプコード
  • TCP | UDP | ICMP
networkAclRuleList.N.ipBlock String Conditional Network ACLルールで 許可する IPアドレスの範囲
  • <例>0.0.0.0/0、100.10.20.0/24、192.168.0.10/32
networkAclRuleList.N.denyAllowGroupNo String Conditional Network ACLルールの Deny-Allowグループ番号
networkAclRuleList.N.portRange String Conditional Network ACLルールのポート範囲
  • <例> 単一ポート: 22、範囲指定: 1~65535
  • protocolTypeCodeが ICMPの場合、入力しない
networkAclRuleList.N.ruleActionCode String Required トラフィックを許可するかどうか
  • ALLOW | DROP
networkAclRuleList.N.networkAclRuleDescription String Optional Network ACLルールの説明(Byte)
  • 0~1000
responseFormatType String Optional レスポンス結果の形式
  • xml(デフォルト) | json

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location 'https://ncloud.apigw.ntruss.com/vpc/v2/addNetworkAclOutboundRule
?regionCode=KR
&networkAclNo=***31
&networkAclRuleList.1.priority=0 &networkAclRuleList.1.protocolTypeCode=TCP
&networkAclRuleList.1.ipBlock=***.***.0.0/0
&networkAclRuleList.1.portRange=22-23
&networkAclRuleList.1.ruleActionCode=ALLOW' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの詳細は、NetworkAclRuleListをご参照ください。

レスポンスステータスコード

VPC APIで共通して使用されるレスポンスステータスコードの詳細は、VPCのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

<addNetworkAclOutboundRuleResponse>
  <requestId>7bfc87eb-8830-426a-8c3a-66e68ef8cfbd</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <networkAclRuleList>
    <networkAclRule>
      <networkAclNo>***31</networkAclNo>
      <priority>0</priority>
      <protocolType>
        <code>TCP</code>
        <codeName>tcp</codeName>
      </protocolType>
      <portRange>22-23</portRange>
      <ruleAction>
        <code>ALLOW</code>
        <codeName>Allow</codeName>
      </ruleAction>
      <createDate>2020-08-05T20:00:42+0900</createDate>
      <ipBlock>***.***.0.0/0</ipBlock>
      <denyAllowGroupNo/>
      <networkAclRuleType>
        <code>OTBND</code>
        <codeName>Outbound</codeName>
      </networkAclRuleType>
      <networkAclRuleDescription></networkAclRuleDescription>
    </networkAclRule>
  </networkAclRuleList>
</addNetworkAclOutboundRuleResponse>