Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> Bare Metal Server> Referência de API> APIs OpenStack nativo Nova V2.1> Gerenciamento de metadados do BMS> Atualização de metadados do BMS (API OpenStack nativo)
Atualizado em 2023-03-20 GMT+08:00
Ver PDF

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.

Tabela 1 Descrição do parâmetro

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.
    Tabela 2 Descrição da estrutura de dados do campo metadata

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    Par de valor e chave de campo definidos pelo usuário

    Sim

    String

    Especifica a chave de metadados definida pelo usuário e o par de valores.

    • Cada chave ou valor contém no máximo 255 caracteres.
    • A chave não suporta os seguintes caracteres especiais:

      :`~!@#$%^&*()=+<,>?/'";{[]}|\

    • O valor não suporta os seguintes caracteres especiais:

      \"
  • 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.
    Tabela 3 Descrição da estrutura de dados do campo metadata

    Parâmetro

    Tipo

    Descrição

    Par de valor e chave de campo definidos pelo usuário

    String

    Especifica o par de chave e valor dos metadados.

    • Cada chave ou valor contém no máximo 255 caracteres.
    • O valor não suporta os seguintes caracteres especiais:

      \"
  • Exemplo de resposta 
    1
2
3
4
5
    		 
    {
    "metadata": {
        "key": "value"
    }
    }

Valores retornados

Valores normais

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.