カスタマーゲートウェイを作成します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vpc:CreateCustomerGateway |
create |
*CustomerGateway。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
カスタマーゲートウェイのリージョン ID。 DescribeRegions 操作を呼び出して、リージョン ID をクエリできます。 |
cn-shanghai |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字以下にする必要があります。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API 呼び出しごとに異なる場合があります。 |
02fb3da4-130e-11e9-8e44**** |
| IpAddress |
string |
必須 |
オンプレミスデータセンターのゲートウェイデバイスの静的 IP アドレス。
以下の IP アドレスはサポートされていません。これらの IP アドレスを使用すると、IPsec-VPN 接続を確立できません。
|
101.12.XX.XX |
| Name |
string |
任意 |
カスタマーゲートウェイの名前。 名前の長さは 1～100 文字で、 |
nametest |
| Description |
string |
任意 |
カスタマーゲートウェイの説明。 説明の長さは 1～100 文字で、 |
desctest |
| Asn |
string |
任意 |
IPsec-VPN 接続で BGP 動的ルートプロトコルを有効にする予定がある場合は、オンプレミスデータセンターのゲートウェイデバイスの自律システム番号 (ASN) を割り当てる必要があります。有効な値: 1～4294967295。値 45104 はサポートされていません。 Asn は 4 バイトの数値です。2 セグメントフォーマット (最初の 16 ビット.最後の 16 ビット) で数値を入力できます。各セグメントは 10 進数フォーマットで入力します。 たとえば、123.456 と入力した場合、ASN は 123 × 65536 + 456 = 8061384 となります。 説明
|
65530 |
| AuthKey |
string |
任意 |
オンプレミスデータセンターのゲートウェイデバイスの BGP ルーティングプロトコルの認証キー。 キーの長さは 1～64 文字で、ASCII 文字のみを含めることができます。スペース、中国語の文字、半角疑問符 (?) はサポートされていません。 |
AuthKey**** |
| Tags |
array<object> |
任意 |
カスタマーゲートウェイに追加するタグのリスト。 一度に最大 20 個のタグをカスタマーゲートウェイに追加できます。 |
|
|
object |
任意 |
タグ情報。 |
||
| Key |
string |
任意 |
タグキー。このパラメーターを指定する場合、値は空文字列にできません。 タグキーの長さは最大 64 文字で、 一度に最大 20 個のタグキーを指定できます。 |
TagKey |
| Value |
string |
任意 |
タグ値。 タグ値の長さは最大 128 文字で、空文字列にすることができます。 各タグキーは 1 つのタグ値に対応します。一度に最大 20 個のタグ値を指定できます。 |
TagValue |
| ResourceGroupId |
string |
任意 |
カスタマーゲートウェイが属するリソースグループの ID。
|
rg-aek2qo2h4jy**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答パラメーター。 |
||
| RequestId |
string |
リクエスト ID。 |
D32B3C26-6C6C-4988-93E9-D2A6444CE6AE |
| IpAddress |
string |
オンプレミスデータセンターのゲートウェイデバイスの静的 IP アドレス。 |
101.12.XX.XX |
| Description |
string |
カスタマーゲートウェイの説明。 |
desctest |
| CustomerGatewayId |
string |
カスタマーゲートウェイのインスタンス ID。 |
cgw-bp1jrawp82av6bws9**** |
| CreateTime |
integer |
カスタマーゲートウェイが作成されたタイムスタンプ。単位: ミリ秒。 タイムスタンプは UNIX フォーマットで、1970 年 1 月 1 日 00:00:00 協定世界時 (UTC) からの経過時間をミリ秒単位で表します。 |
1493363486000 |
| Name |
string |
カスタマーゲートウェイの名前。 |
nametest |
例
成功レスポンス
JSONJSON
{
"RequestId": "D32B3C26-6C6C-4988-93E9-D2A6444CE6AE",
"IpAddress": "101.12.XX.XX",
"Description": "desctest",
"CustomerGatewayId": "cgw-bp1jrawp82av6bws9****",
"CreateTime": 1493363486000,
"Name": "nametest"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidAuthkey.Malformed | The specified BGP authentication key (%s) is malformed. | 指定された BGP 認証キーが無効です。 |
| 400 | InvalidIpAddress.AlreadyExist | Specified IpAddress is already exist. | IP アドレスはすでに存在します。同じユーザーは同じリージョンで重複する IP アドレスを使用できません。 |
| 400 | InvalidIpAddress.WrongFormat | Specified IpAddress is invalid. | |
| 400 | InvalidName | The name is not valid | |
| 400 | InvalidDescription | The description is not valid | |
| 400 | Resource.QuotaFull | The quota of resource is full | |
| 400 | IllegalParam.Asn | The specified Asn is invalid. | 指定された ASN は仕様に準拠していません。 |
| 400 | OperationDenied.MissingAsn | The autonomous system number of the customer gateway is mandatory when BGP authentication key is specified. | カスタマーゲートウェイの BGP 認証キーを指定する場合、自律システム番号も指定する必要があります。 |
| 400 | InvalidParameter.TagValue | The specified parameter TagValue is invalid. | 指定された TagValue パラメーターが無効です。 |
| 400 | SizeLimitExceeded.TagNum | The maximum number of tags is exceeded. | タグの数が上限を超えています。 |
| 400 | Forbidden.TagKey.Duplicated | The specified tag key already exists. | タグのリソースが重複しています。 |
| 400 | InvalidParameter.TagKey | The specified parameter TagKey is invalid. | 指定された TagKey パラメーターが無効です。 |
| 400 | Duplicated.TagKey | The specified parameter TagKey is duplicated. | 指定された TagKey パラメーターが重複しています。 |
| 400 | OperationFailed.NoRamPermission | Vpn Service has no permission to operate your IDaaS instances. | VPN サービスにお客様の IDaaS インスタンスを操作する権限がありません。 |
| 400 | CreateVpnUserGatewayQuotaFull.QuotaFull | The number of created VPN customer gateways exceeds the quota. | VPN カスタマーゲートウェイの数がクォータ制限を超えています。 |
| 403 | Forbidden.SubUser | User not authorized to operate on the specified resource as your account is created by another user. | このリソースを操作する権限がありません。必要な権限を申請してから、もう一度お試しください。 |
| 403 | Forbidden | User not authorized to operate on the specified resource. | EIP が現在の呼び出し元に属していません。この EIP を操作する権限があるかどうかを確認してください。 |
| 409 | OperationConflict | The operation against this instance is too frequent, please try again later. | リクエストの競合が発生しました。後でもう一度お試しください。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。