Modificação de metadados de ECS com uma chave especificada
Função
Essa API é usada para modificar os metadados de ECS com uma chave especificada.
- 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.
Restrições
Um ECS deve estar no estado ativo, parado, pausado ou suspenso, que é especificado por OS-EXT-STS:vm_state.
URI
PUT /v2.1/{project_id}/servers/{server_id}/metadata/{key}
|
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. |
|
key |
Sim |
Especifica a chave de metadados ECS. |
Solicitação
Tabela 2 descreve os parâmetros de solicitação.
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
meta |
Sim |
Object |
Especifica o par de chaves de metadados definido pelo usuário. Para uma chave de metadados: Ele contém no máximo 255 caracteres Unicode e não pode ser deixado em branco. Uma chave pode conter letras maiúsculas (A-Z), letras minúsculas (a-z), dígitos (0-9), hífens (-) sublinhados, dois-pontos (:), e pontos (.). Para um valor de metadados: Ele contém um máximo de 255 caracteres Unicode. |
Resposta
Exemplo de solicitação
PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/metadata/{key}
{
"meta":{
"key":"value"
}
}
Exemplo de resposta
{
"meta":{
"key":"value"
}
}
