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.
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
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. |
Parameter |
Type |
Mandatory |
Description |
---|---|---|---|
key |
String |
Yes |
Specifies the tag key.
|
value |
String |
Yes |
Specifies the tag value.
|
Resposta
N/D
Exemplo de solicitação
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.