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" } }