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/ Dedicated Host/ Referência de API/ API/ Gerenciamento de tags do DeH/ Adição de tags a um DeH em lotes
Atualizado em 2024-01-26 GMT+08:00
Ver PDF
Compartilhar

Adição de tags a um DeH em lotes

Função

  • Essa API é usada para adicionar tags a um DeH especificado em lotes.
  • Tag Management Service (TMS) usa essa API para adicionar tags em lote a um DeH.

Restrição

  • Um DeH permite um máximo de 10 tags.
  • Esta API é idempotente.

    Durante a criação da tag, se existir uma tag (tanto a chave quanto o valor são os mesmos de uma tag existente), a tag é processada com sucesso por padrão.

  • Uma nova tag substituirá a original se suas chaves forem as mesmas e os valores forem diferentes.

URI

POST /v1.0/{project_id}/dedicated-host-tags/{dedicated_host_id}/tags/action

Tabela 1 descreve os parâmetros.

Tabela 1 Descrição dos parâmetros

Parâmetro

Tipo

Obrigatório

Descrição

project_id

String

Sim

Especifica o ID do projeto.

Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.

dedicated_host_id

String

Sim

Especifica o ID do DeH.

Você pode obter o valor no console do DeH ou usando a API no Consulta de DeHs.

Solicitação

Tabela 2 Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Descrição

tags

Array of objects

Sim

Especifica a lista de tags. Para mais detalhes, consulte Tabela 3.

action

String

Sim

Especifica a operação. Somente letras minúsculas são suportadas. Por exemplo, create indica a operação de criar.
Tabela 3 tag field description

Parameter

Type

Mandatory

Description

key

String

Yes

Specifies the tag key.

  • It contains a maximum of 36 Unicode characters.
  • The value cannot be empty.
  • It cannot contain the following ASCII characters: =*<>\|/,

value

String

Yes

Specifies the tag value.

  • It contains a maximum of 43 Unicode characters.
  • It cannot contain the following ASCII characters: =*<>\|/,

Resposta

N/D

Exemplo de solicitação

Adicione duas etiquetas a um DeH em um lote. As chaves e os valores correspondentes para essas duas tags são os seguintes: key1 e value1; key2 e value2 
POST https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-tags/74259164-e63a-4ad9-9c77-a1bd2c9aa187/tags/action
{
    "action": "create",
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        },
        {
            "key": "key2",
            "value": "value2"
        }
    ]
}

Exemplo de resposta

N/D

Código de status

Consulte Códigos de status.

Tópico principal: Gerenciamento de tags do DeH