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.