Exclusão de tags de um ECS em um lote
Função
- Essa API é usada para excluir tags de um ECS especificado em um lote.
- O serviço de gerenciamento de tags (TMS) usa essa API para gerenciar em lote as tags de um ECS.
- Esta API é idempotente. Quando você exclui uma tag, mas a tag não existe, um resultado bem-sucedido é retornado.
Restrições
Um ECS permite um máximo de 10 tags.
URI
POST /v1/{project_id}/cloudservers/{server_id}/tags/action
Parâmetro |
Obrigatório |
Descrição |
---|---|---|
project_id |
Sim |
Especifica a 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 a ID de ECS. |
Solicitação
Tabela 2 descreve os parâmetros de solicitação.
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
tags |
Sim |
Array of objects |
Especifica as tags. Para mais detalhes, consulte Tabela 3. |
action |
Sim |
String |
Especifica a operação. (Somente letras minúsculas são suportadas.) Por exemplo, excluir indica a operação de delete. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
key |
Sim |
String |
Especifica a chave de marcação. Ela contém no máximo 127 caracteres Unicode e não pode ser deixado em branco. A chave de tag de um ECS deve ser exclusiva. |
value |
Não |
String |
Especifica o valor da tag. Ele contém no máximo 255 caracteres Unicode e não pode ser deixado em branco. |
Resposta
Nenhum
Exemplo de solicitação
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/tags/action
{ "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
Exemplo de resposta
Nenhum
Valores retornados
Códigos de erro
Consulte Códigos de erro.