调用CreateTransitRouter接口,创建一个中转路由器实例。
下表中,Tags.N.a类型参数中的“N”表示标签信息的序号,需按照数字顺序从1开始填写,取值范围为1~50。多个标签之间使用&分隔。每个标签键对应一个标签值。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateTransitRouter | 要执行的操作,取值为CreateTransitRouter。 |
Version | String | 是 | 2020-04-01 | API版本信息,当前版本为2020-04-01。 |
TransitRouterName | String | 否 | transitrouter-01 | 中转路由器实例的名称。
|
Description | String | 否 | This transit router is used for test. | 中转路由器实例的描述信息。
|
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 客户端Token,用于保证请求的幂等性。
|
ProjectName | String | 否 | default | 中转路由器实例所属项目的名称。 |
Tags.N.Key | String | 否 | Tags.1.Key=k1&Tags.2.Key=k2 | 中转路由器实例用户标签的标签键。
说明
|
Tags.N.Value | String | 否 | Tags.1.Value=v1&Tags.2.Value=v2 | 中转路由器实例用户标签的标签值。
说明 如果传入该参数,则必须先传入 |
Asn | Integer | 否 | 64512 | 中转路由器的ASN号。取值范围为64512 ~ 65534 和 4200000000 ~ 4294967294,默认值为64512。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
TransitRouterId | String | tr-7qthudw0ll6jmc**** | 中转路由器实例的ID。 |
GET /?Action=CreateTransitRouter&Version=2020-04-01&TransitRouterName=transitrouter-01 HTTP/1.1 Host: open.volcengineapi.com Service: transitrouter Region: cn-guangzhou
{ "ResponseMetadata": { "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****", "Action": "CreateTransitRouter", "Version": "2020-04-01", "Service": "transitrouter", "Region": "cn-guangzhou" }, "Result": { "TransitRouterId": "tr-7qthudw0ll6jmc****" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidDescription.Malformed | The specified description is malformed. Ensure the maximum length of description is 255. | 指定的描述格式不合法。描述长度不能超过255个字符。 |
400 | InvalidDescription.Malformed | The specified description is malformed. | 指定的描述格式不合法。请修复描述格式后重试。 |
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 | OrderError | Failed to create order and pay in one step. | 创建订单并支付失败。 |
400 | PreOrderError | Failed to create pre order. | 创建配置单失败。 |
400 | UnsupportedOperation | The request on the specified instance is denied due to the account in arrears status. | 因账户处于欠费状态,对于该实例的操作请求被拒绝。 |
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 | QuotaExceeded.TransitRouter | You've reached the maximum number of transit routers that one account can have. | 已达到单个账号可创建的中转路由器上限。 |
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 | InvalidTransitRouter.ASNInvalid | The specified ASN is invalid and it should be in the range of 64512-65534 or 4200000000-4294967294. | 指定的ASN号不合法,应该属于64512-65534或4200000000-4294967294范围内。 |
403 | Forbidden.CreateTransitRouterWithASN | You are not authorized to create transit router with ASN. | 无权限指定ASN创建中转路由器,请开通白名单。 |
403 | Forbidden.PurchaseLimited | The account is not authorized to purchase the resource. | 此账户无权限购买资源。 |
404 | InvalidProject.NotFound | The specified Project does not exist. | 指定的项目不存在。 |
412 | IdempotentProcessing | The request uses the same client token as a previous one that is still in process. | 幂等请求处理中。 |