Adición de etiquetas a un BMS (API nativa de OpenStack)
Función
Esta API se utiliza para agregar etiquetas a un BMS.
Se requiere que utilice el encabezado de HTTP X-OpenStack-Nova-API-Version: 2.26 para especificar la versión micro en el cliente.
Restricciones
- Se recomienda agregar la etiqueta __type_baremetal a los BMS para distinguir los BMS de los ECS. De lo contrario, los BMS solo estarán disponibles en la consola de ECS.
- Una nueva etiqueta sobrescribirá la existente. Si desea conservar la etiqueta original, agréguela a la lista de etiquetas nuevas. Se recomienda agregar __type_baremetal a la lista de etiquetas agregadas cada vez que agregue una etiqueta.
URI
PUT /v2.1/{project_id}/servers/{server_id}/tags
Tabla 1 enumera los parámetros.
Parámetro |
Obligatorio |
Descripción |
---|---|---|
project_id |
Sí |
Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto. |
server_id |
Sí |
Especifica el ID del BMS. Puede obtener el ID de BMS desde la consola de BMS o usando la API de Consulta del BMS (API nativa de OpenStack). |
Solicitud
- Parámetros de solicitud
Parámetro
Obligatorio
Tipo
Descripción
tags
Sí
Array of strings
- Especifica las etiquetas de un BMS. Cada etiqueta puede contener un máximo de 80 caracteres.
- La etiqueta no puede comenzar con un punto (.).
- Un BMS puede tener un máximo de 50 etiquetas.
- No se puede crear una etiqueta vacía.
- Ejemplo de la solicitud
1
PUT https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43/tags
1 2 3 4 5 6 7
{ "tags": [ "baz", "foo", "qux" ] }
Respuesta
- Parámetros de respuesta
Parámetro
Tipo
Descripción
tags
Array of strings
Especifica las etiquetas definidas por el usuario de un BMS.
- Ejemplo de la respuesta
1 2 3 4 5 6 7
{ "tags": [ "baz", "foo", "qux" ] }
Valores devueltos
Valores devueltos |
Descripción |
---|---|
200 |
La solicitud se ha procesado correctamente. |
Para obtener más información sobre otros valores devueltos, consulte Códigos de estado.
Códigos de error
Véase Códigos de error.