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/ Modificação de metadados do BMS especificados (API OpenStack nativo)
Atualizado em 2023-03-20 GMT+08:00
Ver PDF
Compartilhar

Modificação de metadados do BMS especificados (API OpenStack nativo)

Função

Essa API é usada para modificar os metadados do BMS especificados.

Restrições

O atributo do BMS OS-EXT-STS:vm_state (status do BMS) deve estar active, stopped, paused ou suspended.

URI

PUT /v2.1/{project_id}/servers/{server_id}/metadata/{key}

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).

key

Sim

Especifica o valor da chave de metadados do BMS a ser modificado

Solicitação

  • Parâmetros de solicitação

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    meta

    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 meta

    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
    		 
    PUT https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata/{key}

    1
2
3
4
5
    		 
    {
    "meta": {
        "key": "value"
    }
}

Resposta

  • Parâmetros de resposta

    Parâmetro

    Tipo

    Descrição

    meta

    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 meta

    Parâmetro

    Tipo

    Descrição

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

    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.
  • Exemplo de resposta 
    1
2
3
4
5
    		 
    {
    "meta": {
        "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.