Adição de uma tag a um recurso associado
Função
Esta API é usada para adicionar uma tag a um recurso associado. Um recurso pode ter no máximo 10 tags. Esta API é idempotente. Se uma tag a ser adicionada tiver a mesma chave que uma tag existente, a tag será adicionada e substituirá a tag existente.
URI
POST /v3/{project_id}/vault/{vault_id}/tags
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 |
|---|---|---|---|
Tag |
Não |
Tag object |
Tag |
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, hífenes (-), sublinhados (_), e pontos (.). |
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 { "tag" : { "key" : "key1", "value" : "key2" } }
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.
