更新元数据

POST

/v4/ecs/metadata-update

OperationId：ecsMetadataUpdate

为云主机更新元数据

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

string

实例ID

必需

metadata

object

元数据

必需

isForce

boolean

可选

是否覆盖原有的元数据信息，缺省为不覆盖

示例

{
    "regionID": "TestRegionID",
    "ID": "e993eff4-12c3-23cf-6a5a-196bb235496a",
    "metaData": {
        "test1": "123",
        "test2": "31242134"
    },
    "isForce": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/ecs/metadata-update' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "ID": "e993eff4-12c3-23cf-6a5a-196bb235496a",
    "metaData": {
        "test1": "123",
        "test2": "31242134"
    },
    "isForce": true
}'

返回响应

🟢200successful operation

application/json

Body

description

string

失败时的错误描述

可选

errorCode

string

具体错误码标志

可选

message

string

失败时的错误信息

可选

statusCode

integer <int32>

必需

返回状态码(800为成功，900为失败)

returnObj

object

返回参数

必需

spec_metadata

object

必需

mapStirng

示例

{
    "description": "成功",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": {
        "spec_metadata": {
            "test2": "31242134",
            "test1": "123"
        }
    },
    "statusCode": 800
}

修改于大约 2 个月前

查询元数据

删除云主机元数据