NAT CIDRブロックを作成します。

使用上の注意

CreateNatIpCidr操作を繰り返し呼び出して、指定された期間内にNAT CIDRブロックを作成することはできません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
RegionId String 必須 eu-central-1

CIDRブロックを関連付けるNATゲートウェイのリージョンID。

DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

NatGatewayId String 必須 ngw-gw8v16wgvtq26vh59 ****

CIDRブロックを関連付ける仮想プライベートクラウド (VPC) NATゲートウェイのID。

NatIpCidrName String 必須 newcidr

CIDRブロックの名前。

名前は2 ~ 128文字で、英数字、ピリオド (.) 、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は文字である必要があります。 先頭文字列を http://または https:// にすることはできません。

NatIpCidrDescription String 必須 mycidr

NAT CIDRブロックの説明。

説明の長さは 2～256 文字である必要があります。 名前は英字で始まる必要があります。先頭文字列は http:// または https:// にすることはできません。

DryRun Boolean いいえ false

操作を実行せずにリクエストをチェックするかどうかを指定します。 有効な値：

  • true: リクエストを事前にチェックしますが、NAT CIDRブロックは作成しません。 システムは、必要なパラメーター、要求構文、および制限をチェックします。 要求がチェックに失敗した場合、エラーメッセージが返されます。 リクエストがチェックに合格すると、DryRunOperationエラーコードが返されます。
  • false (デフォルト): リクエストを送信します。 リクエストがチェックに合格すると、HTTP 2xxステータスコードが返され、NAT CIDRブロックが作成されます。
ClientToken String 任意 5A2CFF0E-5718-45B5-9D4D-70B3FF3898

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

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

説明 このパラメーターを設定しない場合、システムは自動的にRequestIdをClientTokenとして使用します。 各APIリクエストのRequestIdは異なる場合があります。
NatIpCidr String 必須 172.16.0.0/24

NATゲートウェイに関連付けるNAT CIDRブロック。

NAT CIDRブロックは、次の条件を満たす必要があります。

  • NAT CIDRブロックは、10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、またはそのサブネット内にある必要があります。
  • サブネットマスクの長さは16〜32ビットでなければなりません。
  • NAT CIDRブロックは、NATゲートウェイが属するVPCのプライベートCIDRブロックと重複することはできません。 VPCのプライベートCIDRブロックの他のIPアドレスを使用してNATサービスを提供する場合は、vSwitchを作成し、vSwitchを別のVPC NATゲートウェイに接続します。
  • パブリックIPアドレスを使用してNATサービスを提供する場合は、パブリックIPアドレスがVPC NATゲートウェイが属するVPCの顧客CIDRブロック内にあることを確認してください。 詳細については、「顧客CIDRブロックとは? 」をご参照ください。.
操作 String 必須 CreateNatIpCidr

実行する操作です。 値をCreateNatIpCidrに設定します。

レスポンスパラメーター

項目 データ型 例: 説明　
NatIpCidrId String vpcnatcidr-gw8lhqtvdn4qnea ****

NAT CIDRブロックのID。

RequestId String 7021BEB1-210F-48A9-AB82-BE9A9110BB89

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/?RegionId=eu-central-1
&NatGatewayId=ngw-gw8v16wgvtq26vh59 ****
&NatIpCidrName=newcidr
&NatIpCidrDescription=mycidr
&DryRun=false
&ClientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF3898
&NatIpCidr=172.16.0.0/24
&アクション=CreateNatIpCidr
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateNatIpCidrResponse>
    <NatIpCidrId>vpcnatcidr-gw8lhqtvdn4qnea ****</NatIpCidrId>
    <RequestId>7021BEB1-210F-48A9-AB82-BE9A9110BB89</RequestId>
</CreateNatIpCidrResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NatIpCidrId" : "vpcnatcidr-gw8lhqtvdn4qnea ****" 、
  "RequestId" : "7021BEB1-210F-48A9-AB82-BE9A9110BB89"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明　
404 InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 指定されたリージョンのIDが存在しない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。