更新时间:2024-09-11 GMT+08:00

更新终端节点连接描述

功能介绍

更新终端节点服务连接的终端节点的描述。

调用方法

请参见如何调用API

URI

PUT /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/connections/description

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户ID

最小长度:1

最大长度:64

vpc_endpoint_service_id

String

终端节点服务ID

最小长度:1

最大长度:64

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

connections

Array of ConnectionsDesc objects

连接管理描述字段列表

表3 ConnectionsDesc

参数

是否必选

参数类型

描述

id

String

终端节点ID,UUID格式字符

最小长度:1

最大长度:64

description

String

描述字段,支持中英文字母、数字等字符,不支持“<”或“>”字符。

最小长度:0

最大长度:512

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

connections

Array of ConnectionEndpoints objects

连接列表

表5 ConnectionEndpoints

参数

参数类型

描述

id

String

终端节点的ID,唯一标识。

最小长度:1

最大长度:64

marker_id

Integer

终端节点的报文标识。

created_at

String

终端节点的创建时间。 采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ

updated_at

String

终端节点的更新时间。 采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ

domain_id

String

用户的Domain ID。

最小长度:1

最大长度:64

error

Array of QueryError objects

错误信息。

当终端节点服务状态异常,即“status”的值为“failed”时,会返回该字段。

status

String

终端节点的连接状态。

  • pendingAcceptance:待接受

  • creating:创建中

  • accepted:已接受

  • rejected:已拒绝

  • failed:失败

  • deleting:删除中

description

String

终端节点连接描述。

最小长度:0

最大长度:512

表6 QueryError

参数

参数类型

描述

error_code

String

错误编码。

最小长度:0

最大长度:10

error_message

String

错误信息。

最小长度:0

最大长度:1024

请求示例

更新终端节点连接描述

https://{endpoint}/v1/{project_id}/vpc-endpoint-services/813d9300-8473-405b-bfcd-f711117bad65/connections/description

{
  "connections" : [ {
    "id" : "0df78897-35b0-4a93-ad17-0bc0585f546b",
    "description" : "终端节点节点1, 属于账户[0605767a3300d5762fb7c0186d9e1779]abc_26"
  }, {
    "id" : "0d837f75-90d5-4528-bd11-5d974238ebca",
    "description" : "终端节点节点2, 属于账户[7876999999999]abc_26"
  } ]
}

响应示例

状态码: 200

服务器已成功处理了请求

{
  "connections" : [ {
    "id" : "0d837f75-90d5-4528-bd11-5d974238ebca",
    "status" : "accepted",
    "description" : "终端节点节点2, 属于账户[7876999999999]abc_26",
    "marker_id" : 302008767,
    "domain_id" : "05b5408a0a80d2b10f06c0184a774460",
    "created_at" : "2022-04-14T02:09:08Z",
    "updated_at" : "2022-04-14T07:55:40Z"
  }, {
    "id" : "0df78897-35b0-4a93-ad17-0bc0585f546b",
    "status" : "accepted",
    "description" : "终端节点节点1, 属于账户[0605767a3300d5762fb7c0186d9e1779]abc_26",
    "marker_id" : 302001833,
    "domain_id" : "05b5408a0a80d2b10f06c0184a774460",
    "created_at" : "2022-04-14T01:59:31Z",
    "updated_at" : "2022-04-14T07:57:39Z"
  } ]
}

状态码

状态码

描述

200

服务器已成功处理了请求

错误码

请参见错误码