Atualização de metadados do ECS
Função
Essa API é usada para atualizar metadados do ECS.
- Se os metadados não contiverem o campo de destino, o campo será adicionado automaticamente.
- Se os metadados contiverem o campo de destino, o valor do campo será atualizado automaticamente.
- Se o campo nos metadados não for solicitado, o valor do campo permanecerá inalterado.
Restrições
Um ECS deve estar no estado ativo, parado, pausado ou suspenso, que é especificado por OS-EXT-STS:vm_state.
URI
POST /v1/{project_id}/cloudservers/{server_id}/metadata
Parâmetro |
Obrigatório |
Descrição |
|---|---|---|
project_id |
Sim |
Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto. |
server_id |
Sim |
Especifica a ID de ECS. |
Solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
metadata |
Sim |
Object |
Especifica o par chave-valor de metadados definido pelo usuário. A estrutura de dados pode estar vazia. Se o valor estiver vazio, os dados não serão atualizados. Para uma tag de metadados: Ele contém no máximo 255 caracteres Unicode e não pode ser deixado em branco. Uma marca pode conter letras maiúsculas (A-Z), minúsculas (a-z), dígitos (0-9), (-) de hífens, sublinhados (_), dois-pontos e pontos (.). Para um valor de metadados: Ele contém um máximo de 255 caracteres Unicode. |
Resposta
Parâmetro |
Tipo |
Descrição |
|---|---|---|
metadata |
Object |
Especifica o par chave-valor de metadados definido pelo usuário. |
Exemplo de solicitação
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/metadata
{
"metadata": {
"key": "value"
}
}
Exemplo de resposta
{
"metadata":{
"key":"value"
}
}
