Antes de comenzar
Bienvenido a Referencia de la API de Elastic Volume Service. Elastic Volume Service (EVS) ofrece almacenamiento en bloque escalable para servidores en la nube. Con alta confiabilidad, alto rendimiento y una variedad de especificaciones, los discos de EVS se pueden utilizar para sistemas de archivos distribuidos, entornos de desarrollo y prueba, almacenes de datos y aplicaciones de cómputo de alto rendimiento (HPC).
Este documento describe cómo utilizar las interfaces de programación de aplicaciones (API) para realizar operaciones en recursos de EVS, como crear, consultar, eliminar y actualizar un recurso de EVS. Para obtener más información sobre todas las operaciones admitidas, consulte Descripción de las API.
Antes de invocar una API de EVS, asegúrese de estar familiarizado con los conceptos de EVS. Para obtener más información, consulte Descripción del servicio.
Invocación de las API
EVS admite las API de transferencia de estado representacional (REST), lo que le permite invocar las API mediante HTTPS. Para obtener más información sobre la invocación de las API, consulte Llamada a APIs.
Puntos de conexión
Un punto de conexión es la dirección de solicitud para invocar una API. Los puntos de conexión varían según los servicios y las regiones. Para ver el punto de conexión del servicio EVS, consulte Regiones y puntos de conexión.
Restricciones
- La cantidad de recursos de EVS que puede crear está determinada por su cuota. Para ver o aumentar las cuotas, consulte Consulta de cuotas de recursos de EVS.
- Para conocer las restricciones detalladas, consulte las restricciones descritas en las API específicas.
Conceptos
- Cuenta
Se crea una cuenta al registrarse correctamente. La cuenta tiene permisos de acceso completos para todos sus servicios y recursos en la nube. Se puede utilizar para restablecer contraseñas de usuario y conceder permisos de usuario. La cuenta es una entidad de pago, que no debe usarse directamente para realizar una gestión rutinaria. Por motivos de seguridad, cree usuarios de Identity and Access Management (IAM) y concédeles permisos para la gestión de rutina.
- Usuario
Un usuario de IAM es creado por una cuenta en IAM para usar servicios en la nube. Cada usuario de IAM tiene sus propias credenciales de identidad (contraseña y claves de acceso).
La autenticación de API requiere información como el nombre de cuenta, nombre de usuario y contraseña.
- Región
Las regiones se dividen en función de la ubicación geográfica y la latencia de la red. Los servicios públicos, como Elastic Cloud Server (ECS), Elastic Volume Service (EVS), Object Storage Service (OBS), Virtual Private Cloud (VPC), Elastic IP (EIP) e Image Management Service (IMS), se comparten dentro de la misma región. Las regiones se clasifican en regiones universales y regiones dedicadas. Una región universal proporciona servicios en la nube universales para los tenants estándares. Una región dedicada proporciona servicios específicos para tenants específicos.
Para obtener más detalles, consulte Región y AZ.
- AZ
Una AZ comprende uno o más centros de datos físicos equipados con instalaciones independientes de ventilación, fuego, agua y electricidad. El cómputo, la red, el almacenamiento y otros recursos en una AZ se dividen lógicamente en múltiples clústeres. Las AZ dentro de una región están interconectadas mediante fibras ópticas de alta velocidad para permitirle construir sistemas de alta disponibilidad entre las AZ.
- Proyecto
Un proyecto corresponde a una región. Los proyectos predeterminados se definen para agrupar y aislar físicamente recursos (incluidos recursos de cómputo, de almacenamiento y de red) entre regiones. Se pueden conceder permisos a los usuarios en un proyecto predeterminado para acceder a todos los recursos en sus cuentas en la región asociada al proyecto. Si necesita un control de acceso más preciso, cree subproyectos en un proyecto predeterminado y cree recursos en subproyectos. A continuación, puede asignar a los usuarios los permisos necesarios para acceder únicamente a los recursos de los subproyectos específicos.
Figura 1 Modelo de aislamiento del proyecto
- Proyecto empresarial
Los proyectos empresariales agrupan y gestionan recursos en distintas regiones. Los recursos en diferentes proyectos empresariales están lógicamente aislados. Un proyecto empresarial puede contener recursos de múltiples regiones y se pueden agregar o quitar recursos de proyectos empresariales.
Para obtener detalles sobre proyectos empresariales y cómo obtener ID de proyectos empresariales, consulte Guía de usuario de Enterprise Management.
Tipos/Versiones/Microversiones de API
Tipos de API
- Las API para EVS con especificaciones personalizadas, también conocidas como API personalizadas
- Las API de OpenStack que cumplen con las especificaciones de la comunidad OpenStack, también conocidas como API de Cinder
- Gestión de proyectos empresariales
Versiones de API
Las API personalizadas de EVS proporcionan múltiples versiones. Para las API que ofrecen las mismas funciones, se recomienda utilizar las API v2.