Listado de cadenas de instantáneas
Función
Esta API se utiliza para listar cadenas de instantáneas. 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
GET /v5/{project_id}/snapshot-chains
| 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ámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| marker | No | String | Definición El ID del recurso desde el cual comienza la consulta de paginación. Es el ID del último recurso de la página anterior. Restricciones N/D Rango N/D Valor predeterminado N/D |
| limit | No | Integer | Definición Cantidad máxima de resultados de consultas que se pueden devolver. Restricciones N/D Rango El valor oscila entre 1 y 1000 y el valor predeterminado es 1000. El valor devuelto no puede exceder este límite. Valor predeterminado N/D |
| id | No | String | Definición El ID de la cadena de instantáneas. Restricciones N/D Rango N/D Valor predeterminado N/D |
| volume_id | No | String | Definición El ID del disco al que pertenece la cadena de instantáneas. 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 |
| category | No | String | Definición El tipo de cadena de instantáneas. Restricciones N/D Rango El valor puede ser standard, backup o server_backup. 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ámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| snapshot_chains | Array of snapshot_chains objects | Definición La lista de cadenas de instantáneas. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | String | Definición El ID de la cadena de instantáneas. Rango N/D |
| availability_zone | String | Definición La AZ del disco al que pertenece la cadena de instantáneas. Rango N/D |
| snapshot_count | Integer | Definición La cantidad de instantáneas de la cadena de instantáneas. Rango ≥ 0 |
| capacity | Integer | Definición El uso del almacenamiento de la cadena de instantáneas. Rango El valor es mayor o igual que 0. |
| project_id | String | Definición El ID del proyecto. Rango N/D |
| volume_id | String | Definición El ID del disco al que pertenece la cadena de instantáneas. Rango N/D |
| category | String | Definición El tipo de cadena de instantáneas. Rango El valor puede ser standard o standard_copy. |
| created_at | String | Definición La fecha y hora de creación. Rango N/D |
| updated_at | String | Definición La fecha y hora de actualización. 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
GET https://{endpoint}/v5/{project_id}/snapshot-chains Ejemplo de respuestas
Código de estado: 200
OK
{
"snapshot_chains" : [ {
"id" : "e97f57fe-767b-46c6-ac1b-10b77e491406",
"capacity" : 0,
"project_id" : "fb640396c4344e4f96057fab643fe5b5",
"volume_id" : "7c40f5ae-2b26-4922-b586-3d41af4822f1",
"category" : "standard",
"availability_zone" : "cn-southwest-242a",
"snapshot_count" : 1,
"created_at" : "2023-10-25T08:56:26.087002",
"updated_at" : "2023-10-25T08:56:26.758003"
}, {
"id" : "5b798ddd-872b-4823-ab45-a02733ed62cb",
"capacity" : 1,
"project_id" : "fb640396c4344e4f96057fab643fe5b5",
"volume_id" : "92fea069-6073-4784-a7e8-7a1a4caf9c70",
"category" : "standard",
"availability_zone" : null,
"snapshot_count" : 1,
"created_at" : "2023-08-15T13:17:59.061000",
"updated_at" : "2023-08-15T13:17:59.065000"
} ]
} Código de estado: 400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "EVS.XXX"
}
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | OK |
| 400 | Bad Request |
Códigos de error
Consulte Códigos de error.
