Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Elastic Cloud Server/ Referencia de la API/ API fuera de fecha/ Gestión de Instantáneas (API de OpenStack Nova)/ Creación de una instantánea (descartada)

Actualización más reciente 2022-11-08 GMT+08:00

Creación de una instantánea (descartada)

Función

Esta API se utiliza para crear una instantánea para un volumen.

Esta API ha sido descartada.Use the API described in Creating an EVS Snapshot (OpenStack Cinder API v2).

Restricciones

Un nombre de instantánea no puede tener el prefijo autobk_snapshot.

URI

POST /v2.1/{project_id}/os-snapshots

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
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, consulte Obtención de un ID de proyecto.

Solicitud

Tabla 2 describe los parámetros de solicitud.

**Tabla 2** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
display_description	No	String	Especifica la descripción de la instantánea.
volume_id	Sí	String	Especifica el ID del volumen.
display_name	No	String	Especifica el nombre de la instantánea de EVS. El valor contiene un máximo de 255 bytes. NOTA: Al crear una copia de seguridad para un disco EVS a través de VBS, se creará una instantánea y se nombrará con el prefijo autobk_snapshot_. La consola EVS ha impuesto restricciones de operación en las instantáneas con el prefijo autobk_snapshot_. Por lo tanto, se recomienda no utilizar autobk_snapshot_ como prefijo de nombre para las instantáneas creadas. De lo contrario, las instantáneas no se pueden utilizar normalmente.
force	No	Boolean	Especifica si se va a crear por la fuerza una instantánea. Si el valor es true, se puede crear una instantánea para el volumen en uso.

Respuesta

Tabla 3 describe los parámetros de respuesta.

**Tabla 3** Parámetros de respuesta
Parámetro	Obligatorio	Tipo	Descripción
id	Sí	String	Especifica el ID de la instantánea de disco en formato UUID.
status	Sí	String	Especifica el estado de la instantánea del volumen.
displayName	No	String	Especifica el nombre de la instantánea del volumen.
displayDescription	No	String	Especifica la descripción de la instantánea del volumen.
createdAt	Sí	String	Especifica la hora a la que se creó la instantánea del volumen.
volumeId	Sí	String	Especifica el ID de disco en formato UUID para la instantánea.
size	Sí	Integer	Especifica el tamaño de la instantánea del volumen.

Ejemplo de la solicitud

POST https://{endpoint}/v2.1/d6c277ba8820452e83df36f33c9fa561/os-snapshots

{
	"snapshot": {
		"display_name": "test",
		"display_description": null,
		"volume_id": "ba5730ea-8621-4ae8-b702-ff0ffc12c209"
	}
}

Ejemplo de la respuesta

{
    "snapshot": 
        {
            "createdAt": "2016-05-20T16:54:14.981520", 
            "displayDescription": null, 
            "id": "b836dc3d-4e10-4ea4-a34c-8f6b0460a583",  
            "displayName": "test", 
            "size": 1, 
            "status": "creating", 
            "volumeId": "ba5730ea-8621-4ae8-b702-ff0ffc12c209"
        }
}