Atualização de metadados do BMS (API OpenStack nativo)
Função
Essa API é usada para atualizar metadados do BMS.
- Se os metadados não contiverem o campo de destino, o campo será adicionado automaticamente ao campo.
- Se os metadados contiverem o campo de destino, o valor do campo será atualizado automaticamente.
Restrições
O atributo do BMS OS-EXT-STS:vm_state (status do BMS) deve estar active, stopped, paused ou suspended.
URI
POST /v2.1/{project_id}/servers/{server_id}/metadata
A Tabela 1 lista os parâmetros.
Parâmetro |
Obrigatório |
Descrição |
---|---|---|
project_id |
Sim |
Especifica o 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 o ID de BMS. Você pode obter o ID do BMS no console do BMS ou usando a API do Consulta de BMSs (API OpenStack nativo). |
Solicitação
- Parâmetros de solicitação
Parâmetro
Obrigatório
Tipo
Descrição
metadata
Sim
Object
Especifica a chave de metadados definida pelo usuário e o par de valores. Para mais detalhes, consulte Tabela 2.
- Exemplo de solicitação
1
POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata
1 2 3 4 5
{ "metadata": { "key": "value" } }
Resposta
- Parâmetros de resposta
Parâmetro
Tipo
Descrição
metadata
Object
Especifica a chave de metadados definida pelo usuário e o par de valores. Para mais detalhes, consulte Tabela 3.
- Exemplo de resposta
1 2 3 4 5
{ "metadata": { "key": "value" } }
Valores retornados
Valores retornados |
Descrição |
---|---|
200 |
A solicitação foi processada com sucesso. |
Para obter detalhes sobre outros valores retornados, consulte Códigos de status.
Códigos de erro
Consulte Códigos de erro.