Creación o eliminación de una etiqueta

Función

Esta API se utiliza para crear o eliminar una etiqueta.

URI

POST /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tags/action

Mensaje de solicitud

• Parámetros de solicitud

  Tabla 2 Parámetros de solicitud

  Parámetro	Obligatorio	Tipo	Descripción
  tags	Sí	Array of ResourceTag objects	Especifica la lista de etiquetas. Para más detalles, consulte Tabla 3. Si action está establecida para delete, la estructura de etiquetas no puede faltar y la clave no se puede dejar en blanco o una string vacía.
  action	Sí	String	Especifica el ID de operación. El valor distingue entre mayúsculas y minúsculas y puede ser cualquiera de las siguientes: delete: indica eliminar una etiqueta. create: indica la creación de una etiqueta. Si ya existe el mismo valor de clave, se sobrescribirá.

  Tabla 3 Descripción del campo ResourceTag

  Parámetro	Obligatorio	Tipo	Description
  key	Sí	String	Especifica la clave de etiqueta. Las claves de etiqueta de un recurso deben ser únicas. Una clave de etiqueta contiene un máximo de 36 caracteres. El conjunto de caracteres es el siguiente: A-Z, a-z, 0-9, guiones (-), guiones bajos (_) y caracteres Unicode (\u4E00-\u9FFF). Cuando action se establece para delete, el conjunto de caracteres de etiqueta no se verifica y una clave contiene un máximo de 127 caracteres Unicode.
  value	No	String	Especifica el valor de etiqueta. Un valor de etiqueta contiene un máximo de 43 caracteres y se puede dejar en blanco. El conjunto de caracteres es el siguiente: A-Z, a-z, 0-9, puntos (.), guiones (-), guiones bajos (_) y caracteres Unicode (\u4E00-\u9FFF). Cuando action se establece para delete, el conjunto de caracteres de etiqueta no se verifica y un valor contiene un máximo de 255 caracteres Unicode. Si se especifica value, las etiquetas se eliminan por clave y valor. Si no se especifica value, las etiquetas se eliminan por clave.

• Ejemplo de la solicitud

  Este ejemplo muestra cómo agregar dos etiquetas (clave = ENV15 y valor = ENV15) y (clave = ENV151 y valor = ENV151) al grupo AS con ID e5d27f5c-dd76-4a61-b4bc-a67c5686719a.

  POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_tag/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/tags/action
  
  { 
    "tags": [
      { 
          "key": "ENV15", 
          "value": "ENV15" 
      }, 
      { 
          "key": "ENV151", 
          "value": "ENV151" 
      }
      ], 
    "action": "create" 
  }

Mensaje de la respuesta

• Parámetros de respuesta

  No hay

• Ejemplo de la respuesta

  No hay

Valores devueltos

• Normal

  204

• Anormal

  Valor devuelto	Descripción
  400 Bad Request	Se produjo un error en el servidor al procesar la solicitud.
  401 Unauthorized	Debe introducir el nombre de usuario y la contraseña para acceder a la página solicitada.
  403 Forbidden	Está prohibido el acceso a la página solicitada.
  404 Not Found	No se pudo encontrar la página solicitada.
  405 Method Not Allowed	No se le permite utilizar el método especificado en la solicitud.
  406 Not Acceptable	El cliente no pudo aceptar la respuesta generada por el servidor.
  407 Proxy Authentication Required	Debe utilizar el servidor proxy para la autenticación para que la solicitud pueda procesarse.
  408 Request Timeout	Se agotó el tiempo de espera de la solicitud.
  409 Conflict	La solicitud no se pudo procesar debido a un conflicto.
  500 Internal Server Error	Error al completar la solicitud porque se produjo un error de servicio interno.
  501 Not Implemented	Error al completar la solicitud porque el servidor no admite la función solicitada.
  502 Bad Gateway	Error al completar la solicitud porque el servidor ha recibido una respuesta no válida.
  503 Service Unavailable	Error al completar la solicitud porque el sistema no está disponible actualmente.
  504 Gateway Timeout	Se ha producido un error de tiempo de espera de la puerta de enlace.

Códigos de error

Consulte Códigos de error