Adición de una etiqueta a un recurso asociado
Función
Esta API se utiliza para agregar una etiqueta a un recurso asociado. Un recurso puede tener un máximo de 10 etiquetas. Esta API es idempotente. Si una etiqueta por agregar tiene la misma clave que una etiqueta existente, la etiqueta se agregará y sobrescribirá la etiqueta existente.
URI
POST /v3/{project_id}/vault/{vault_id}/tags
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
project_id |
Sí |
String |
ID de proyecto |
vault_id |
Sí |
String |
ID de recurso |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
tag |
No |
Tag object |
Etiqueta |
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
key |
Sí |
String |
Clave Puede contener un máximo de 36 caracteres. No puede ser una cadena vacía. Los espacios antes y después de una clave serán descartados. No puede contener los siguientes caracteres: ASCII (0-31), signos iguales (=), asteriscos (*), corchetes angulares izquierdos (<), corchetes angulares rectos (>), barras invertidas (), comas (,), barras verticales (|), y barras inclinadas (/) Puede contener solo letras, dígitos, guiones (-) y guiones bajos (_). |
value |
No |
String |
Valor Es obligatorio cuando se agrega una etiqueta y opcional cuando se elimina una etiqueta. Puede contener un máximo de 43 caracteres. Puede ser una cadena vacía. Los espacios antes y después de un valor serán descartados. No puede contener los siguientes caracteres: ASCII (0-31), signos iguales (=), asteriscos (*), corchetes angulares izquierdos (<), corchetes angulares rectos (>), barras invertidas (), comas (,), barras verticales (|), y barras inclinadas (/) Puede contener solo letras, dígitos, guiones (-) y guiones bajos (_). |
Parámetros de respuesta
Código de estado: 400
Parámetro |
Tipo |
Descripción |
|---|---|---|
error_code |
String |
Para obtener más información, consulte Códigos de error. |
error_msg |
String |
Mensaje de error |
Solicitudes de ejemplo
Solicitud de ejemplo
POST https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags
{
"tag" : {
"key" : "key1",
"value" : "key2"
}
}
Ejemplo de respuestas
Ninguna
Códigos de estado
Código de estado |
Descripción |
|---|---|
204 |
No Content |
400 |
Bad Request |
Códigos de error
Consulte Códigos de error.
