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.
Atualizado em 2022-11-08 GMT+08:00

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

Tabela 1 descreve os parâmetros no URI.
Tabela 1 Descrição do parâmetro

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.

Tabela 2 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.

Tabela 3 Parâmetros de resposta

Parâmetro

Tipo

Descrição

metadata

Object

Especifica o par chave-valor de metadados definido pelo usuário.

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

Valores retornados

Consulte Valores retornados para solicitações gerais.