调用CreateTransitRouterVpcAttachment接口,创建一个VPC类型的网络实例连接。
下表中,Tags.N.a类型参数中的“N”表示标签信息的序号,需按照数字顺序从1开始填写,取值范围为1~50。多个标签之间使用&分隔。每个标签键对应一个标签值。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateTransitRouterVpcAttachment | 要执行的操作,取值为CreateTransitRouterVpcAttachment。 |
Version | String | 是 | 2020-04-01 | API版本信息,当前版本为2020-04-01。 |
TransitRouterId | String | 是 | tr-7qthudw0ll6jmc**** | 中转路由器实例的ID。您可以调用DescribeTransitRouters接口获取中转路由器实例ID。 |
Ipv6Enabled | Boolean | 否 | false | 是否开启IPv6功能。
说明 中转路由器IPv6功能正在邀测中,如需使用,请联系客户经理。 |
VpcId | String | 是 | vpc-2fexiqjlgjif45oxruvso**** | 私有网络实例的ID。您可以调用DescribeVpcs接口获取私有网络实例的ID。 |
AttachPoints.N.SubnetId | String | 是 | AttachPoints.1.SubnetId=subnet-2fexiqjlgjif45oxruvso****&AttachPoints.2.SubnetId=subnet-7rtsu6whhle6j**** | 网络实例连接连接点的子网ID。您可以调用DescribeSubnets接口获取子网ID。
|
AttachPoints.N.ZoneId | String | 是 | AttachPoints.1.ZoneId=cn-guangzhou-a&AttachPoints.2.ZoneId=cn-guangzhou-b | 子网所属可用区的ID。
|
Description | String | 否 | This attachment is used for test. | 网络实例连接的描述信息。
|
TransitRouterAttachmentName | String | 否 | attachment-01 | 网络实例连接的名称。
|
AutoPublishRouteEnabled | Boolean | 否 | false | 是否自动同步TR路由到网络实例路由表中。
|
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 客户端Token,用于保证请求的幂等性。
|
Tags.N.Key | String | 否 | Tags.1.Key=k1&Tags.2.Key=k2 | 网络实例连接用户标签的标签键。
说明
|
Tags.N.Value | String | 否 | Tags.1.Value=v1&Tags.2.Value=v2 | 网络实例连接用户标签的标签值。
说明 如果传入该参数,则必须先传入 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
TransitRouterAttachmentId | String | tr-attach-7qthudw0ll6jmc**** | 网络实例连接的ID。 |
GET /?Action=CreateTransitRouterVpcAttachment&Version=2020-04-01&TransitRouterId=tr-7qthudw0ll6jmc****&VpcId=vpc-2fexiqjlgjif45oxruvso****&AttachPoints.1.SubnetId=subnet-2fexiqjlgjif45oxruvso****&AttachPoints.2.SubnetId=subnet-7rtsu6whhle6j****AttachPoints.1.ZoneId=cn-guangzhou-a&AttachPoints.2.ZoneId=cn-guangzhou-b HTTP/1.1 Host: open.volcengineapi.com Service: transitrouter Region: cn-guangzhou
{ "ResponseMetadata": { "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****", "Action": "CreateTransitRouterVpcAttachment", "Version": "2020-04-01", "Service": "transitrouter", "Region": "cn-guangzhou" }, "Result": { "TransitRouterAttachmentId": "tr-attach-7qthudw0ll6jmc****" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidDescription.Malformed | The specified description is malformed. | 指定的描述格式不合法。请修复描述格式后重试。 |
400 | InvalidDescription.Malformed | The specified description is malformed. Ensure the maximum length of description is 255. | 指定的描述格式不合法。描述长度不能超过255个字符。 |
400 | InvalidName.Malformed | The specified name is malformed. | 指定的名称格式不合法。请修复名称格式后重试。 |
400 | InvalidName.Malformed | The specified name is malformed. Ensure the maximum length of name is 128. | 指定的名称格式不合法。名称长度不能超过128个字符。 |
400 | InvalidTransitRouter.InvalidBusinessStatus | The request is denied because the specified Transit Router is shut down due to arrears. | 指定的中转路由器欠费关停,不支持当前操作。 |
400 | InvalidTransitRouter.InvalidStatus | The specified Transit Router is not in the correct status for the request. | 指定的中转路由器所处状态无法响应该请求。 |
400 | InvalidTransitRouterAttachment.ServiceRoleNotAuthorized | The service role for Transit Router has not been authorized. | 当前账号尚未授权中转路由器的服务角色。 |
400 | InvalidTransitRouterAttachment.SubnetIdDuplicate | There are subnets used multiple times in the request. | 存在子网在创建网络实例连接操作中被多次指定。 |
400 | InvalidTransitRouterAttachment.ZoneIdDuplicate | There are available zones used multiple times in the request. | 存在可用区在创建网络实例连接操作中被多次指定。 |
400 | InvalidTransitRouterAttachment.ZoneIdMismatch | The specified available zone does not match with the specified subnet. | 指定的可用区和指定的子网不匹配。 |
400 | InvalidTransitRouterAttachment.ZoneUnsupported | There are available zones not supported by Transit Router. | 指定的部分可用区暂不支持创建网络实例连接。 |
400 | QuotaExceeded.TransitRouterAttachment | You've reached the maximum number of attachments that one Transit Router can have. | 已达到单个中转路由器可创建的网络实例上限。 |
400 | QuotaExceeded.VpcAttachment | You've reached the maximum number of vpc attachments that one transit router can have. | 已达到单个中转路由器可创建的vpc网络实例连接的上限。 |
400 | QuotaExceeded.AttachPointPerTransitRouterAttachment | The specified request reaches the max number of attach points that you can specify. | 已达到单个网络实例连接可指定的挂载点数目上限。 |
400 | QuotaExceeded.TransitRouterAttachmentPerVpc | You've reached the limit on the number of Transit Routers that one VPC can attach. | 已达到单个私有网络可挂载的中转路由器数目上限。 |
400 | InvalidTransitRouterAttachment.InsufficientSubnetIpAddresses | There are subnets that do not have available IP addresses. | 存在子网无可用IP。 |
400 | QuotaExceeded.TransitRouterSecurityGroup | You've reached the maximum number of security groups that can be created in one region. | 已达到单个地域可创建的安全组数量上限。 |
400 | OrderError | Failed to create order and pay in one step. | 创建订单并支付失败。 |
400 | UnsupportedOperation | The request on the specified instance is denied due to the account balance and available vouchers are less than 100 yuan in total. | 因账户余额及可用代金券共不足100元,对于该实例的操作请求被拒绝。 |
400 | UnsupportedOperation | The request on the specified instance is denied due to the account in arrears status. | 因账户处于欠费状态,对于该实例的操作请求被拒绝。 |
400 | IdempotentParameterMismatch | Arguments on this idempotent request are inconsistent with arguments used in previous request(s). | 此幂等请求的参数与前一个请求中使用的参数不一致。 |
400 | InvalidParameter.ClientTokenMalformed | The specified parameter ClientToken is malformed. | 指定的参数ClientToken格式不合法,长度不能超过64个ASCII字符。 |
400 | InvalidTag.Disorder | The specified index order of tag is malformed. | 指定标签的索引顺序参数格式不合法。 |
400 | InvalidTagKey.Malformed | The specified parameter tag key is invalid. | 标签键不合法。 |
400 | InvalidTagValue.Malformed | The specified parameter tag value is invalid. | 标签值不合法。 |
400 | LimitExceeded.Tags | You've reached the limit on the number of tags that you can operate at a time. | 已达到单次可操作标签数量的上限。 |
400 | LimitExceeded.AutoRoutePublishOfTrEnabledPerVpc | You've reached the maximum number of TRs that one vpc can enable auto route publish with. | 已达到单个私有网络可开启的TR路由自动同步的TR数量上限。 |
400 | InvalidTransitRouterAttachment.SubnetWithoutIPv4Cidr | There are subnets without IPv4 cidr within the specific requirement. | 存在部分子网无可用IPv4地址。 |
400 | InvalidTransitRouterAttachment.SubnetWithoutIPv6Cidr | There are subnets without IPv6 cidr within the specific requirement. | 存在部分子网无可用IPv6地址。 |
403 | Forbidden.TransitRouterIPv6 | You are not authorized to use ipv6 on Transit Router. | 未开通中转路由器IPv6功能,不支持该操作。 |
403 | Forbidden.PurchaseLimited | The account is not authorized to purchase the resource. | 此账户无权限购买资源。 |
404 | InvalidTransitRouter.NotFound | The specified Transit Router does not exist. | 指定的中转路由器不存在。 |
404 | InvalidTransitRouterAttachment.SubnetNotFound | The specified subnet does not exist. | 指定的子网不存在。 |
404 | InvalidTransitRouterAttachment.VpcNotFound | The specified VPC does not exist. | 指定的私有网络不存在。 |
409 | InvalidTransitRouterAttachment.Conflict | The specified instance has already been attached to the Transit Router. | 指定的网络实例已加入指定的中转路由器,不支持重复操作。 |
412 | IdempotentProcessing | The request uses the same client token as a previous one that is still in process. | 幂等请求处理中。 |