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

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

Função

Essa API é usada para verificar se um BMS possui uma tag especificada.

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

URI

GET /v2.1/{project_id}/servers/{server_id}/tags/{tag}

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

tag

Sim

Especifica a chave da tag a ser consultada.

Restrições:

  • A codificação de URL é necessária para caracteres especiais.
  • Se nenhuma chave de tag for especificada, todas as tags do BMS serão exibidas.

Solicitação

  • Parâmetros de solicitação

    Nenhum

  • Exemplo de solicitação 
    1
    		 
    GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/2d85af7c-cbfe-40c5-a378-4d03b42fb0e2/tags/{tag}

Resposta

Se a tag especificada existir, nenhuma resposta será retornada.

Se a tag especificada não existir, a resposta será a seguinte:

1
2
3
4
5
6
 
{
    "itemNotFound": {
        "message": "Server 2d85af7c-cbfe-40c5-a378-4d03b42fb0e2 has no tag 'abc'",
        "code": 404
    }
}

Valores retornados

Valores normais

Valores retornados

Descrição

204

O servidor processou a solicitação, mas não retornou nenhum conteúdo.

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