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 tags 1D do BMS/ Adição de tags a um BMS (API OpenStack nativo)
Atualizado em 2023-03-20 GMT+08:00
Ver PDF
Compartilhar

Adição de tags a um BMS (API OpenStack nativo)

Função

Essa API é usada para adicionar tags a um BMS.

É necessário usar o cabeçalho HTTP X-OpenStack-Nova-API-Version: 2.26 para especificar a microversão no cliente.

Restrições

Um BMS pode ter no máximo 50 tags.

  • É recomendável adicionar a tag __type_baremetal aos BMSs para distinguir BMSs de ECSs. Caso contrário, os BMSs estará disponível somente no console do ECS.
  • Uma nova tag substituirá a existente. Se você quiser manter a tag original, adicione-a à lista de novas tags. Você é aconselhado a adicionar __type_baremetal à lista de tags adicionadas cada vez que adicionar uma tag.

URI

PUT /v2.1/{project_id}/servers/{server_id}/tags

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

    tags

    Sim

    Array of strings
    • Especifica as tags de um BMS. Cada tag pode conter no máximo 80 caracteres.
    • A tag não pode começar com um ponto (.).
    • Um BMS pode ter no máximo 50 tags.
    • Uma tag vazia não pode ser criada.
  • Exemplo de solicitação 
    1
    		 
    PUT https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43/tags

    1
2
3
4
5
6
7
    		 
    {
    "tags": [
        "baz",
        "foo",
        "qux"
    ]
}

Resposta

  • Parâmetros de resposta

    Parâmetro

    Tipo

    Descrição

    tags

    Array of strings

    Especifica as tags definidas pelo usuário de um BMS.
  • Exemplo de resposta 
    1
2
3
4
5
6
7
    		 
    {
    "tags": [
        "baz",
        "foo",
        "qux"
    ]
}

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.

Tópico principal: Gerenciamento de tags 1D do BMS