Enterprise Editionトランジットルーターに仮想プライベートクラウド (VPC) 接続を作成します。
前提条件
この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。
- VPCには、Enterprise Editionトランジットルーターでサポートされる異なるゾーンにデプロイされた少なくとも2つのvSwitchがあります。 詳細については、「Enterprise Editionトランジットルーターでサポートされているリージョンとゾーン」をご参照ください。
- 別のAlibaba Cloudアカウントに属するネットワークインスタンスに接続するには、まずアカウントから権限を取得する必要があります。 詳細については、「別のアカウントに属するネットワークインスタンスに接続するためのアクセス許可の取得」をご参照ください。
- VPC接続には料金がかかります。 VPC接続を作成する前に、VPC接続の課金ルールに注意してください。 詳細は、「課金方法」をご参照ください。
使用上の注意
次の方法を使用して、Enterprise EditionトランジットルーターでVPC接続を作成できます。
- VPC接続を作成するリージョンにEnterprise Editionトランジットルーターが既に作成されている場合は、VpcId、ZoneMappings.N.VSwitchId、ZoneMappings.N.ZoneId、TransitRouterIdを設定します。
- VPC接続を作成する地域にEnterprise Editionのトランジットルーターが作成されていない場合、以下のように設定します。 VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, CenId, とRegionId. VPC接続を作成すると、指定されたリージョンにEnterprise Editionトランジットルーターが自動的に作成されます。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | CreateTransitRouterVpcAttachment |
実行する操作です。 値をCreateTransitRouterVpcAttachmentに設定します。 |
ClientTokend | String | 任意 | 02fb3da4-130e-11e9-8e44-001**** |
リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアントを使用してトークンを生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 |
CenId | String | 任意 | cen-j3jzhw1zpau2km **** |
CEN インスタンスの ID。 |
TransitRouterId | String | 任意 | tr-bp1su1ytdxtataupl **** |
Enterprise EditionトランジットルーターのID。 |
RegionId | String | 任意 | cn-hangzhou |
VPC のリージョン ID です。 DescribeChildInstanceRegionsを呼び出して、最新のリージョンリストを照会できます。 |
TransitRouterAttachmentName | String | 任意 | テスト名 |
VPC接続の名前。 名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字である必要があります。 |
TransitRouterAttachmentDescription | String | 任意 | テスト名 |
VPC接続の説明。 長さは 2 文字から 256 文字である必要があります。 説明は文字で始める必要がありますが、 |
VpcId | String | 必須 | vpc-bp1kbjcre9vtsebo1 **** |
VPC の ID です。 |
VpcOwnerId | Long | 任意 | 253460731706911258 |
VPCが属するAlibaba CloudアカウントのID。 デフォルト値は、現在のAlibaba CloudアカウントのIDです。 説明 別のアカウントに属するネットワークインスタンスに接続する場合は、このパラメーターが必要です。
|
ChargeType | String | 任意 | ポストペイ |
課金方法です。 デフォルト値: POSTPAY。従量課金の課金方法を指定します。 |
DryRun | Boolean | 任意 | false |
権限やインスタンスのステータスなどの情報を事前チェックするかどうかを指定します。 設定可能な値は以下のとおりです。
|
ZoneMappings.N.VSwitchId | String | 必須 | vsw-bp1a214sbus8z3b54 **** |
Enterprise EditionトランジットルーターでサポートされているゾーンにデプロイされているvSwitch。 最大2つのゾーンを指定できます。 |
ZoneMappings.N.ZoneId | String | 必須 | cn-hangzhou-h |
Enterprise EditionトランジットルーターでサポートされているゾーンのID。 DescribeZones操作を呼び出して、ゾーンIDを照会できます。 最大2つのゾーンを指定できます。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
TransitRouterAttachmentId | String | tr-attach-ia340z7xis7t5s **** |
VPC接続のID。 |
RequestId | String | C087A369-82B9-43EF-91F4-4B63A9C6E6B6 |
リクエストの ID です。 |
例
リクエストの例
http(s)://[Endpoint]/? アクション=CreateTransitRouterVpcAttachment
&ClientToken=02fb3da4-130e-11e9-8e44-001 ****
&CenId=cen-j3jzhw1zpau2km ****
&TransitRouterId=tr-bp1su1ytdxtataupl ****
&RegionId=cn-hangzhou
&TransitRouterAttachmentName=testname
&TransitRouterAttachmentDescription=testname
&VpcId=vpc-bp1kbjcre9vtsebo1 ****
&VpcOwnerId=253460731706911258
&ChargeType=POSTPAY
&DryRun=false
&ZoneMappings=[{"VSwitchId":"vsw-bp1a214sbus8z3b54 ****","ZoneId":"cn-hangzhou-h"}]
&共通リクエストパラメータ
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateTransitRouterVpcAttachmentResponse>
<TransitRouterAttachmentId>tr-attach-ia340z7xis7t5s ****</TransitRouterAttachmentId>
<RequestId>C087A369-82B9-43EF-91F4-4B63A9C6E6B6</RequestId>
</CreateTransitRouterVpcAttachmentResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TransitRouterAttachmentId" : "tr-attach-ia340z7xis7t5s ****" 、
"RequestId" : "C087A369-82B9-43EF-91F4-4B63A9C6E6B6"
}
エラーコード
HttpCode | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | OperationUnsupported.TransitRouterRegionId | 指定されたTransitRouterRegionは操作をサポートしていません。 | 指定されたリージョンが操作をサポートしていない場合に返されるエラーメッセージ。 |
400 | NoPermission.AliyunServiceRoleForCEN | サービスにリンクされたロールを作成する権限がありません。 ロール名: AliyunServiceRoleForCEN。 サービス名: cen.aliyuncs.com。 ユーザーにram:CreateServiceLinkedRole権限が付与されていることを確認します。 | サービスe cen.aliyuncs.comにサービスにリンクされたロールAliyunServiceRoleForCENを作成する権限がない場合に返されるエラーメッセージ。 操作を実行する前に、ram:CreateServiceLinkedRole権限を取得する必要があります。 |
400 | MissingParam.CenIdOrRegionId | CenIdまたはRegionIdのいずれかを指定する必要があります。 | CenIdまたはRegionIdが設定されていない場合に返されるエラーメッセージ。 |
400 | IllegalParam.ZoneId | 指定されたZoneIdは不正です。 | 指定されたゾーンが無効な場合に返されるエラーメッセージ。 |
400 | IllegalParam.ChargeType | 指定されたChargeTypeは不正です。 | 指定された課金方法が無効な場合に返されるエラーメッセージ。 |
400 | InvalidTransitRouterId.NotFound | 指定されたTransitRouterIdが見つかりません。 | 指定されたトランジットルーターが存在しない場合に返されるエラーメッセージ。 |
400 | IncorrectStatus.Attachment | リソースは、アタッチ操作に対して有効な状態ではありません。 | ネットワークインスタンスの処理中に操作が許可されていない場合に返されるエラーメッセージ。 しばらくしてから再試行します。 |
400 | IncorrectStatus.Vpc | リソースは、アタッチ操作に対して有効な状態ではありません。 | ネットワークインスタンスの処理中に操作が許可されていない場合に返されるエラーメッセージ。 しばらくしてから再試行します。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。