Cloud Parallel File Storage (CPFS) admite cuatro métodos para gestionar recursos mediante programación: SDK, interfaz de línea de comandos (CLI), Terraform y Resource Orchestration Service (ROS).
Elija un método de integración
Alibaba Cloud proporciona OpenAPI Explorer para que los desarrolladores aprendan y utilicen las API de los servicios en la nube de forma rápida y eficiente. Esta herramienta combina funciones como búsqueda inteligente de API, documentación, depuración en línea, obtención de SDK, ejemplos de código, diagnóstico de errores y estadísticas de llamadas. Con OpenAPI Explorer puede llamar a las API de los servicios de Alibaba Cloud y consultar las solicitudes y respuestas. Además, genera automáticamente código de ejemplo del SDK para facilitar sus primeros pasos con los servicios de Alibaba Cloud. Para obtener más información, consulte What is OpenAPI?.
Versiones
La OpenAPI de Alibaba Cloud utiliza números de versión para administrar las publicaciones de API de sus servicios. Por ejemplo, Cloud Parallel File Storage (CPFS) es compatible actualmente con la versión de API 2017-06-26. Este identificador es un número de versión, no una fecha. Representa la estructura de datos de la API y no implica que esta se haya mantenido sin cambios desde 2017-06-26.
Cloud Parallel File Storage (CPFS) y Apsara File Storage NAS comparten el mismo SDK. Por lo tanto, utilice los endpoints y el SDK de Apsara File Storage NAS cuando trabaje con CPFS.
|
Versión |
Descripción |
|
Recomendada |
Depuración en línea
Cloud Parallel File Storage (CPFS) ofrece funciones como la depuración de API en OpenAPI Explorer. Antes de llamar a una API, conozca las versiones, los endpoints y los métodos de integración que proporciona CPFS.
En la página de depuración de OpenAPI Explorer, el panel de navegación izquierdo muestra las API del sistema de archivos, como CreateFileSystem, DeleteFileSystem y DescribeFileSystems. El panel central contiene el formulario de configuración de parámetros de la API CreateFileSystem. Este formulario incluye campos como FileSystemType (valores válidos: standard, extreme, cpfs), ChargeType (valores válidos: PayAsYouGo, Subscription), Duration, Capacity, Bandwidth, StorageType (obligatorio, marcado con un asterisco rojo) y ZoneId. Puede seleccionar un endpoint para una región específica, como China East 1 (Hangzhou). En la parte inferior de la página se encuentra el botón Send Request.
Punto de entrada para la depuración
Para depurar la API, vaya a Cloud Parallel File Storage (CPFS).
A continuación se presenta una tabla comparativa de los cuatro métodos de integración para ayudarle a elegir el que mejor se adapte a su caso de uso.
|
Método |
Funcionamiento |
Cuándo utilizarlo |
|
SDK (recomendado) |
Llama a OpenAPI mediante una biblioteca cliente nativa del lenguaje. Gestiona automáticamente la autenticación, los reintentos y el análisis sintáctico de las respuestas. |
Al desarrollar aplicaciones o scripts de automatización en Python, Java, Go u otros lenguajes compatibles. Es la opción ideal para la mayoría de los desarrolladores. |
|
CLI |
Llama a OpenAPI mediante una herramienta de línea de comandos. No requiere escribir código. |
Para ejecutar operaciones puntuales, escribir scripts de shell o probar llamadas a la API de manera interactiva. |
|
Terraform |
Declara los recursos de CPFS como infraestructura como código. Convierte las plantillas en llamadas a OpenAPI. |
Cuando se gestionan recursos de CPFS junto con otra infraestructura en la nube dentro de un flujo de trabajo GitOps o de infraestructura como código (IaC). |
|
Resource Orchestration Service (ROS) |
Utiliza ROS de Alibaba Cloud para definir y desplegar pilas de recursos a partir de plantillas. |
Diseñado para escenarios donde se orquestan recursos de CPFS con otros recursos de Alibaba Cloud como parte de una pila de despliegue mayor. |
Endpoints
Para minimizar la latencia, utilice el endpoint de la región donde se encuentran sus recursos de CPFS. Por ejemplo, el endpoint público de CPFS en la región China (Ulanqab) es nas.cn-wulanchabu.aliyuncs.com, y el endpoint de VPC es nas-vpc.cn-wulanchabu.aliyuncs.com.
Existen dos tipos de endpoints disponibles:
Endpoints públicos: accesibles desde cualquier lugar, incluso fuera de Alibaba Cloud.
-
Endpoints de VPC: accesibles únicamente desde una virtual private cloud (VPC) en la misma región de Alibaba Cloud. Ventajas de los endpoints de VPC:
Mayor seguridad: los endpoints de VPC solo son accesibles desde dentro de una VPC, lo que proporciona un aislamiento y una privacidad más sólidos.
Menor latencia: los endpoints de VPC utilizan rutas de red internas. Estas suelen ofrecer tiempos de respuesta más rápidos que los endpoints públicos y ayudan a evitar problemas como la latencia de Internet y las limitaciones de ancho de banda.
Menor costo: los endpoints de VPC utilizan comunicación por red interna.
La siguiente tabla muestra las regiones y los endpoints compatibles con CPFS General-purpose Edition.
|
Nombre de la región |
ID de región |
Endpoint público |
Endpoint de VPC |
|
China (Qingdao) |
cn-qingdao |
nas.cn-qingdao.aliyuncs.com |
nas-vpc.cn-qingdao.aliyuncs.com |
|
China (Beijing) |
cn-beijing |
nas.cn-beijing.aliyuncs.com |
nas-vpc.cn-beijing.aliyuncs.com |
|
China (Zhangjiakou) |
cn-zhangjiakou |
nas.cn-zhangjiakou.aliyuncs.com |
nas-vpc.cn-zhangjiakou.aliyuncs.com |
|
China (Hohhot) |
cn-huhehaote |
nas.cn-huhehaote.aliyuncs.com |
nas-vpc.cn-huhehaote.aliyuncs.com |
|
China (Ulanqab) |
cn-wulanchabu |
nas.cn-wulanchabu.aliyuncs.com |
nas-vpc.cn-wulanchabu.aliyuncs.com |
|
China (Hangzhou) |
cn-hangzhou |
nas.cn-hangzhou.aliyuncs.com |
nas-vpc.cn-hangzhou.aliyuncs.com |
|
China (Shanghai) |
cn-shanghai |
nas.cn-shanghai.aliyuncs.com |
nas-vpc.cn-shanghai.aliyuncs.com |
|
China (Shenzhen) |
cn-shenzhen |
nas.cn-shenzhen.aliyuncs.com |
nas-vpc.cn-shenzhen.aliyuncs.com |
|
China (Heyuan) |
cn-heyuan |
nas.cn-heyuan.aliyuncs.com |
nas-vpc.cn-heyuan.aliyuncs.com |
|
China (Chengdu) |
cn-chengdu |
nas.cn-chengdu.aliyuncs.com |
nas-vpc.cn-chengdu.aliyuncs.com |
|
Singapore |
ap-southeast-1 |
nas.ap-southeast-1.aliyuncs.com |
nas-vpc.ap-southeast-1.aliyuncs.com |
Identidades de usuario compatibles
|
Identidad de usuario |
Estado de compatibilidad |
|
Compatible |
|
|
RAM user (recomendado) |
Compatible |
|
RAM role (recomendado) |
Compatible |
Se recomienda utilizar un usuario de RAM o un rol de RAM para realizar las llamadas a la API y otorgar permisos según sus necesidades comerciales específicas.
Más información
Métodos de integración
El SDK ofrece la configuración más sencilla y el mejor soporte a largo plazo. Utilícelo a menos que tenga un motivo específico para elegir otro método, como crear scripts de operaciones de shell (CLI) o gestionar la infraestructura como código (Terraform o ROS).
SDK de Alibaba Cloud
Alibaba Cloud proporciona SDK para varios lenguajes de programación, incluidos Java, C#, Go, Python, Node.js/TypeScript, PHP y C++. Puede usar estos SDK para llamar a las API. Los SDK simplifican el desarrollo porque gestionan la lógica de firma, los tiempos de espera, los reintentos y devuelven objetos de respuesta estructurados. Para obtener más información sobre el SDK de Alibaba Cloud, consulte Alibaba Cloud SDK.
Puede utilizar el SDK de Alibaba Cloud para llamar a las API de Cloud Parallel File Storage (CPFS) en OpenAPI Explorer. Para obtener información sobre los lenguajes compatibles y cómo instalar las dependencias, consulte SDK de Apsara File Storage NAS.
CLI de Alibaba Cloud
La CLI de Alibaba Cloud le permite interactuar con los servicios de Alibaba Cloud y gestionar sus recursos en la nube desde la línea de comandos mediante el comando aliyun. Para obtener más información sobre la CLI de Alibaba Cloud, consulte What is Alibaba Cloud CLI.
Llamadas manuales a la API (no recomendado)
Para realizar llamadas HTTP nativas, debe implementar el algoritmo de firma y construir solicitudes personalizadas. Para obtener más información sobre el mecanismo de firma, consulte API reference y V3 request body and signature mechanism.
Notas de uso
Si una llamada a la API devuelve un error, utilice el código de error devuelto para comprobar que los parámetros y valores de su solicitud sean correctos. Para obtener más información, consulte Centro de códigos de error.
También puede registrar el RequestID o el mensaje de error del SDK que devuelve la llamada y utilizar la Plataforma de diagnóstico de OpenAPI de Alibaba Cloud para ejecutar diagnósticos de autoservicio.