Configuração de metadados de ECS
Função
Essa API é usada para configurar metadados de ECS.
Quando você chamar essa API, todos os metadados desse ECS serão excluídos e o ECS usará o valor configurado na solicitação.
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
| 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
Tabela 2 descreve os parâmetros de solicitação.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| metadata | Object | Sim | Especifica o par chave-valor de metadados definido pelo usuário. Para uma chave de metadados: Uma chave contém no máximo 255 caracteres Unicode e não pode estar vazia. 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: Um valor contém no máximo 255 caracteres Unicode. |
Resposta
Tabela 3 descreve os parâmetros de resposta.
Exemplo de solicitação
PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/metadata {
"metadata": {
"key1": "value1",
"key2": "value2"
}
} Exemplo de resposta
{
"metadata": {
"key1": "value1",
"key2": "value2"
}
}