Enterprise Editionトランジットルーターに仮想プライベートクラウド (VPC) 接続を作成します。

前提条件

この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。

使用上の注意

次の方法を使用して、Enterprise EditionトランジットルーターでVPC接続を作成できます。

  • VPC接続を作成するリージョンにEnterprise Editionトランジットルーターが既に作成されている場合は、VpcIdZoneMappings.N.VSwitchIdZoneMappings.N.ZoneIdTransitRouterIdを設定します。
  • VPC接続を作成する地域にEnterprise Editionのトランジットルーターが作成されていない場合、以下のように設定します。 VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, CenId, とRegionId. VPC接続を作成すると、指定されたリージョンにEnterprise Editionトランジットルーターが自動的に作成されます。

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 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 文字である必要があります。 説明は文字で始める必要がありますが、http:// またはhttps:// で始めることはできません。

VpcId String 必須 vpc-bp1kbjcre9vtsebo1 ****

VPC の ID です。

VpcOwnerId Long 任意 253460731706911258

VPCが属するAlibaba CloudアカウントのID。 デフォルト値は、現在のAlibaba CloudアカウントのIDです。

説明 別のアカウントに属するネットワークインスタンスに接続する場合は、このパラメーターが必要です。
ChargeType String 任意 ポストペイ

課金方法です。 デフォルト値: POSTPAY。従量課金の課金方法を指定します。

DryRun Boolean 任意 false

権限やインスタンスのステータスなどの情報を事前チェックするかどうかを指定します。 設定可能な値は以下のとおりです。

  • false (デフォルト): リクエストを送信します。 リクエストが事前チェックに合格すると、VPC接続が作成されます。
  • true: 事前チェックリクエストを送信します。 VPC接続は作成されません。 この値を使用すると、必要なパラメーターが設定されているかどうか、およびリクエスト構文が有効かどうかが確認されます。 リクエストが事前チェックに失敗した場合、エラーメッセージが返されます。 リクエストが事前チェックに合格した場合、DryRunOperationエラーコードが返されます。
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 エラーセンター」をご参照ください。