Consulta de la cantidad de instantáneas
Función
Esta API se utiliza para consultar la cantidad 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}/snapshots/count
| 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 |
|---|---|---|---|
| volume_id | No | String | Definición El ID del disco de origen de la instantánea. 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 |
| availability_zone | No | String | Definición La AZ del disco de origen de la instantánea. Restricciones N/D Rango N/D Valor predeterminado N/D |
| name | No | String | Definición El nombre de la instantánea. Restricciones N/D Rango Puede contener un máximo de 64 caracteres. Valor predeterminado N/D |
| status | No | String | Definición El estado de la instantánea. Restricciones Puede contener un máximo de 255 caracteres. Rango Para obtener más información, consulte Estado de la instantánea de EVS. Valor predeterminado N/D |
| id | No | String | Definición El ID de la instantánea. Puede invocar la API Consulta de detalles sobre instantáneas de EVS para obtener el ID de la instantánea. Restricciones N/D Rango N/D Valor predeterminado N/D |
| snapshot_type | No | String | Definición El origen de creación 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 N/D |
| tag_key | No | String | Definición La clave de etiqueta de instantánea. Restricciones N/D Rango N/D Valor predeterminado N/D |
| tags | No | String | Definición Los pares clave-valor de las etiquetas de instantáneas, por ejemplo, [{"key":"bbb","value":"bbb"}]. Restricciones N/D Rango N/D Valor predeterminado N/D |
| snapshot_chain_id | No | String | Definición El ID de la cadena de instantáneas. 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ámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| count | Integer | Definición La cantidad de recursos. 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}/snapshots/count Ejemplo de respuestas
Código de estado: 200
OK
{
"count" : 100
} 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.
