Creación de una instantánea
Función
Esta API se utiliza para crear una instantánea estándar. Las instantáneas estándares solo se admiten en algunas regiones. Puede consultar las regiones admitidas en la consola.
Método de invocación
Para obtener más información, consulte Invocación de las API.
URI
POST /v5/{project_id}/snapshots
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| project_id | Sí | String | Definición El ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto. Restricciones N/D Rango N/D Valor predeterminado N/D |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| X-Auth-Token | Sí | String | Definición El token del usuario. Se puede obtener invocando la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario. Restricciones N/D Rango N/D Valor predeterminado N/D |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| snapshot | Sí | CreateStandardSnapshot object | Definición El cuerpo de la solicitud para crear una instantánea estándar. Restricciones N/D Rango N/D Valor predeterminado N/D |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| volume_id | No | String | Definición El ID del disco. Puede invocar la API Consulta de detalles sobre todos los discos de EVS para obtener el ID del disco. Restricciones N/D Rango N/D Valor predeterminado N/D |
| name | No | String | Definición El nombre de la instantánea. Puede invocar a la API Consulta de detalles sobre instantáneas de EVS para obtener el nombre de la instantánea. Restricciones N/D Rango Puede contener un máximo de 64 caracteres. Valor predeterminado N/D |
| description | No | String | Definición Descripción de la instantánea. Restricciones N/D Rango Puede contener un máximo de 85 caracteres. Valor predeterminado N/D |
| tags | No | Map<String,String> | Definición Las etiquetas de la instantánea. Restricciones N/D Rango N/D Valor predeterminado N/D |
| enterprise_project_id | No | String | Definición El ID del proyecto empresarial al que pertenece la instantánea. Para obtener más información sobre los proyectos empresariales y cómo obtener los ID de proyecto empresariales, consulte Guía del usuario de Enterprise Management. Restricciones N/D Rango N/D Valor predeterminado 0: el proyecto empresarial predeterminado |
| instant_access | No | Boolean | Si se debe habilitar la restauración instantánea de instantáneas. El valor predeterminado es false, lo que indica que no se habilita la función. |
| incremental | No | Boolean | Definición Si se debe crear una instantánea incremental. Restricciones N/D Rango Valor predeterminado true |
Parámetros de respuesta
Código de estado: 202
| Parámetro | Tipo | Descripción |
|---|---|---|
| job_id | String | Definición El ID de la tarea. Para obtener más información sobre cómo consultar el estado de la tarea, consulte Consulta del estado de la tarea. Rango N/D |
| snapshot_id | String | Definición El ID de la instantánea. Rango N/D |
Código de estado: 400
| Parámetro | Tipo | Descripción |
|---|---|---|
| error | Error object | Definición La información de error devuelta si se produce un error. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | String | Definición El código de error devuelto si se produce un error. Rango Para obtener más información sobre el código de error, consulte Códigos de error. |
| message | String | Definición El mensaje de error devuelto si se produce un error. Rango N/D |
Ejemplo de solicitudes
POST https://{endpoint}/v5/{project_id}/snapshots
{
"snapshot" : {
"volume_id" : "2c194dde-7de5-4529-a141-49f48181f411",
"name" : "test_name",
"description" : "test description",
"enterprise_project_id" : "94f1ea84-1428-49b6-9920-8a9b8a29e4ca"
}
} Ejemplo de respuestas
Código de estado: 202
Accepted
{
"job_id" : "ee62a0c1e79c4e11be5adc17a49f69ef",
"snapshot_id" : "bb02c803-55ac-4e84-9c80-60d352199d7d"
} Código de estado: 400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "EVS.XXX"
}
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 202 | Accepted |
| 400 | Bad Request |
Códigos de error
Consulte Códigos de error.
