Adição ou exclusão de tags de um cofre em lote
Função
Esta API é usada para adicionar ou excluir tags em lote de uma instância especificada. O TMS usa essa API para gerenciar tags de recursos de serviço. Um recurso pode ter no máximo 10 tags. Esta API é idempotente. Se houver chaves duplicadas no corpo da solicitação quando você adicionar tags, um erro será relatado. Se uma tag a ser adicionada tiver a mesma chave que uma tag existente, a tag será adicionada e substituirá a tag existente. Ao excluir tags, você pode fazer upload de chaves duplicadas. Ao excluir tags, se algumas tags não existirem, a exclusão é considerada bem-sucedida por padrão. O conjunto de caracteres das tags não será verificado. Uma chave e um valor podem consistir individualmente em até 127 e 255 caracteres. Quando você exclui tags, a estrutura de tags não pode estar ausente e a chave não pode ser deixada em branco ou ser uma cadeia vazia.
URI
POST /v3/{project_id}/vault/{vault_id}/tags/action
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
ID do projeto |
vault_id |
Sim |
String |
ID do recurso |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
Tags |
Não |
Array of Tag objects |
Lista de tags Esta lista não pode ser uma lista vazia. A lista pode conter até 10 chaves. As chaves nesta lista devem ser exclusivas. |
sys_tags |
Não |
Array of SysTag objects |
Lista de tags do sistema Este campo está disponível apenas para a permissão op_service. Escolha este campo ou tags. Atualmente, as chamadas TMS contêm apenas uma estrutura resource_tag. A chave é fixada como as _sys_enterprise_project_id. O valor é o UUID ou 0. Valor 0 indica o projeto empresarial padrão. Atualmente, apenas a operação de criação é suportada. |
action |
Sim |
String |
Operação a ser realizada. O valor pode ser definido apenas para create ou delete. Enumeration values:
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
key |
Sim |
String |
Chave Pode conter no máximo 36 caracteres. Não pode ser uma cadeia vazia. Espaços antes e depois de uma chave serão descartados. Não pode conter os seguintes caracteres: ASCII (0-31), sinais de igual (=), asteriscos (*), parênteses angulares esquerdos (<), parênteses angulares direitos (>), barras invertidas (), vírgulas (,), barras verticais (|) e barras (/). Pode conter apenas caracteres chineses, letras, dígitos, hifens (-) e sublinhados (_). |
value |
Não |
String |
Valor É obrigatório quando uma tag é adicionada e opcional quando uma tag é excluída. Pode conter no máximo 43 caracteres. Pode ser uma cadeia vazia. Espaços antes e depois de um valor serão descartados. Não pode conter os seguintes caracteres: ASCII (0-31), sinais de igual (=), asteriscos (*), parênteses angulares esquerdos (<), parênteses angulares direitos (>), barras invertidas (), vírgulas (,), barras verticais (|) e barras (/). Pode conter apenas caracteres chineses, letras, dígitos, hifens (-), sublinhados (_), e pontos (.). |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
key |
Sim |
String |
Chave. Chave da tag do sistema, que é obtida da lista branca e não pode ser definida aleatoriamente. Atualmente, apenas o campo _sys_enterprise_project_id é suportado e o value correspondente indica o ID do projeto empresarial. |
value |
Sim |
String |
Valor. Atualmente, somente o ID do projeto empresarial é usado. O ID de projeto empresarial padrão é 0. |
Parâmetros de resposta
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Para obter detalhes, consulte Códigos de erro. |
error_msg |
String |
Mensagem de erro |
Exemplo de solicitações
Exemplo de solicitação
POST https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags/action { "tags" : [ { "key" : "string", "value" : "string" }, { "key" : "string1", "value" : "string2" } ], "action" : "create" }
Exemplo de respostas
Nenhum
Códigos de estado
Código de status |
Descrição |
---|---|
204 |
No Content |
400 |
Bad Request |
Códigos de erro
Consulte Códigos de erro.