CreateDirectConnectConnectionOrder--专线连接-火山引擎

文档中心

立即注册

导航

CreateDirectConnectConnectionOrder

最近更新时间：2024.04.18 19:01:52首次发布时间：2022.11.03 08:36:58

调用CreateDirectConnectConnectionOrder为物理专线资源创建支付订单。

调用说明

仅处于“待支付”状态的物理专线可调用该API创建支付订单。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数名称	类型	是否必选	示例值	说明
Action	String	是	CreateDirectConnectConnectionOrder	要执行的操作，取值：CreateDirectConnectConnectionOrder。
Version	String	是	2020-04-01	API版本信息。
DirectConnectConnectionId	String	是	dcc-8njk2nl32bd232b****	物理专线的ID。您可调用DescribeDirectConnectConnections查询物理专线的ID。
PeriodUnit	String	否	Month	物理专线端口资源购买时长的单位。 Month（默认）：表示按月购买。 Year：表示按年购买。
Period	Integer	否	1	物理专线端口资源购买时长。如果参数`PeriodUnit`传入值为`Year`，此参数支持传入：1、2、3。如果参数`PeriodUnit`传入值为`Month`，此参数支持传入：1、2、3、4、5、6、7、8、9、10、11。不传默认为1。
ClientToken	String	否	123e4567-e89b-12d3-a456-BHLJK9832544****	客户端Token，用于保证请求幂等性。由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。仅支持ASCII字符，且不能超过64个字符。若不传入ClientToken，则此次API调用不进行幂等校验。

返回参数

参数名称	类型	示例值	说明
RequestId	String	20220627103212010225145152058*****	请求ID。
OrderNumber	String	Order71606759118820*****	订单号。

请求示例

GET /?Action=CreateDirectConnectConnectionOrder&Version=2020-04-01&DirectConnectConnectionId=dcc-8njk2nl32bd232b****&Period=1&PeriodUnit=Month' HTTP/1.1
Host: open.volcengineapi.com
ServiceName: directconnect
Region: cn-beijing

返回示例

{
 "ResponseMetadata": {
     "RequestId": "20220627103212010225145152058*****",
     "Action": "CreateDirectConnectConnectionOrder",
     "Version": "2020-04-01",
     "Service": "directconnect",
     "Region": "cn-beijing"
 },
 "Result": {
     "RequestId": "20220627103212010225145152058*****",
     "OrderNumber": "Order71606759118820*****"
 }
}

错误码

此处仅展示当前API的错误码，更多错误码请参见公共错误码。

HttpCode	错误码	错误信息	描述
400	OrderError	Failed to create an order in one step.	创建订单并支付失败。
400	PreOrderError	Failed to create pre order.	创建配置单失败。
400	InvalidDirectConnectConnection.InvalidStatus	The specified direct connect connection is not in the correct status for the request.	指定的物理专线所处的状态无法响应该请求。
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字符。
404	InvalidDirectConnectConnection.NotFound	The specified direct connect connection does not exist.	指定的物理专线不存在。
404	InvalidEip.GetInstanceDetail	Get instance detail failed.	获取实例信息失败。
412	IdempotentProcessing	The request uses the same client token as a previous one that is still in process.	幂等请求处理中。