更新裸金属服务器元数据 - UpdateBaremetalServerMetadata

功能介绍

更新裸金属服务器元数据。

• 如果元数据中没有待更新字段，则自动添加该字段。
• 如果元数据中已存在待更新字段，则直接更新字段值。
• 如果元数据中的字段不再请求参数中，则保持不变。

约束

裸金属服务器状态（裸金属服务器的OS-EXT-STS:vm_state属性）必须是active、stopped、paused。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  bms:servers:updateMetadata	write	instance*	g:EnterpriseProjectId g:ResourceTag/<tag-key> bms:MetadataAgencyName	-	iam:agencies:pass

URI

POST /v1/{project_id}/baremetalservers/{server_id}/metadata

请求参数

请求示例

1

POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/metadata

1
2
3
4
5

{
    "metadata": {
        "key": "value"
    }
}

响应参数

响应示例

1
2
3
4
5

{
    "metadata":{
        "key": "value"
    }
} 

返回值

其他返回值请参考状态码。

错误码

请参考错误码。