密钥对绑定标签

接口说明

该接口用于密钥对绑定标签。 说明:
1. 若标签未创建则会创建并绑定标签。
2. 一台密钥对最多绑定十个标签。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-ecs/customer/v3/keypair/tags/bind

请求参数

Body

参数名称
类型
必填
描述
bindKeypairTagReq
绑定密钥标签请求体
是

绑定密钥对标签请求体。

keypairName
string
是

密钥对名称,5-128位的英文、数字的组合。

tags
<TagReq> array
是

标签。

key
string
是

标签键,标签键仅支持数字、中英文、中划线、下划线,长度在1-127位之间,且不可重复不能以'ecloud'开头。

value
string
是

标签值,标签值仅支持数字、中英文、中划线、下划线,长度在1-255位之间,不能以'ecloud'开头。

请求示例

POST https://ecloud.10086.cn/api/openapi-ecs/customer/v3/keypair/tags/bind
{
	"keypairName":"testKeypair",
	"tags":[
		{
			"key":"testKey",
			"value":"testValue"
		}
	]
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
string

请求成功时返回的数据

errorCode
string

统一错误码

errorMessage
string

页面国际化错误提示

errorParams
<string> array

统一错误码的自定义参数

requestId
string

每个请求的序列号

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN

返回示例

返回码:200
OK
{
	"body":"",
	"requestId":"reqId-bbc8cd9eccbac18a2f62e-41d94183-1",
	"state":"OK"
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。