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.
