deleteNatGatewayInstance

Prev Next

VPC環境で利用できます。

NAT Gatewayインスタンス番号を指定して NAT Gatewayインスタンスを削除します。

リクエスト

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

メソッド URI
GET, POST /deleteNatGatewayInstance

リクエストヘッダ

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

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

パラメータの説明は次の通りです。

パラメータ名 タイプ 必須の有無 説明
regionCode String Optional 削除対象 NAT Gatewayのリージョンコード
  • 照会結果の最初のリージョン(デフォルト)
  • getRegionListを通じて確認
  • natGatewayInstanceNo String Required 削除対象 NAT Gatewayのインスタンス番号
  • getNatGatewayInstanceListを通じて確認
  • output String Optional レスポンス結果の形式
    • xml | json(デフォルト)
    returnPublicIpInstance Boolean Optional
    • true (デフォルト) | false
      • true: Public NAT Gatewayに割り当てられたグローバル IPアドレス Instanceを一緒に削除
      • false: グローバル IPアドレス Instanceはそのまま維持

    リクエスト例

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

    curl --location 'https://ncloud.apigw.ntruss.com/vpc/v2/deleteNatGatewayInstance
    ?regionCode=KR
    &natGatewayInstanceNo=***9734'
    --header 'x-ncp-apigw-timestamp: {Timestamp}'     
    --header 'x-ncp-iam-access-key: {Access Key}' 
    --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
    

    レスポンス

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

    レスポンスボディ

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

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

    NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

    レスポンス例

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

    <deleteNatGatewayInstanceResponse>
      <requestId>baac40a2-9a13-4fd0-9e53-3af315f29445</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <natGatewayInstanceList>
        <natGatewayInstance>
          <vpcNo>***04</vpcNo>
          <vpcName>test-***</vpcName>
          <natGatewayInstanceNo>***9734</natGatewayInstanceNo>
          <natGatewayName>test-***</natGatewayName>
          <publicIp>***.***.109.101</publicIp>
          <natGatewayInstanceStatus>
            <code>RUN</code>
            <codeName>run</codeName>
          </natGatewayInstanceStatus>
          <natGatewayInstanceStatusName>Running</natGatewayInstanceStatusName>
          <natGatewayInstanceOperation>
            <code>NULL</code>
            <codeName>NULL OP</codeName>
          </natGatewayInstanceOperation>
          <createDate>2020-08-07T16:05:52+0900</createDate>
          <natGatewayDescription></natGatewayDescription>
          <zoneCode>KR-1</zoneCode>
        </natGatewayInstance>
      </natGatewayInstanceList>
    </deleteNatGatewayInstanceResponse>