File Storage NAS es compatible con varios métodos de integración, como SDK, CLI, Terraform y llamadas directas a la API.
OpenAPI
Alibaba Cloud ofrece el OpenAPI Portal, una plataforma integral que incluye búsqueda inteligente de API, documentación, depuración en línea, descargas de SDK, ejemplos de código, diagnóstico de errores y estadísticas de llamadas. Desde ahí puede invocar operaciones de openapi para los servicios de Alibaba Cloud, consultar solicitudes y respuestas, y generar ejemplos de llamadas con SDK. Para obtener más información, consulte What is OpenAPI?.
Versión
La openapi de Alibaba Cloud utiliza números de versión para gestionar las listas de API de los productos en la nube. File Storage NAS es compatible actualmente con la versión de API 2017-06-26. La cadena 2017-06-26 es un identificador de versión, no una fecha. Los datos de la API que se muestran siempre corresponden a la versión más reciente y pueden haber cambiado desde que se publicó la versión 2017-06-26.
|
Versión |
Descripción |
|
Recomendada |
Depuración en línea
El OpenAPI Portal proporciona herramientas de depuración de API para File Storage NAS. Antes de invocar una operación de API, familiarícese con las versiones de API, los endpoint y los métodos de integración disponibles.
El panel de navegación izquierdo enumera todas las operaciones de API de File Storage NAS, como CreateFileSystem, DeleteFileSystem y DescribeFileSystems. Seleccione una operación de API para configurar sus parámetros en el área principal, entre ellos FileSystemType, ChargeType, StorageType y ZoneId. El panel derecho muestra la documentación de la API, así como ejemplos de SDK y de CLI. Una vez configurados los parámetros, haga clic en Initiate Call para probar la llamada a la API.
URL de depuración
Acceda a la página de depuración de la API mediante la siguiente URL: Página de depuración de CreateFileSystem
Endpoint
Para obtener una latencia óptima, seleccione el endpoint del servicio en la misma región donde se encuentran sus recursos. Por ejemplo, si los recursos están en la región China (Qingdao), el endpoint público de File Storage NAS es nas.cn-qingdao.aliyuncs.com y el endpoint de VPC es nas-vpc.cn-qingdao.aliyuncs.com.
Los endpoint públicos son accesibles desde cualquier parte del mundo.
-
Los endpoint de VPC solo son accesibles desde una red VPC dentro de la misma región de Alibaba Cloud. Ofrecen diversas ventajas:
Mayor seguridad: al restringir el acceso a su VPC, estos endpoint aíslan el tráfico del internet público.
Tiempos de respuesta más rápidos: dado que operan dentro de una red VPC interna, suelen responder más rápido que los endpoint públicos y evitan la latencia y las limitaciones de ancho de banda de las redes públicas.
Menores costos: la comunicación se produce por la red interna, lo que reduce o elimina los cargos por transferencia de datos.
Para obtener más información, consulte Endpoints.
Identidades de usuario compatibles
|
Identidad |
Compatible |
|
Sí |
|
|
RAM User (recomendado) |
Sí |
|
RAM Role (recomendado) |
Sí |
Se recomienda utilizar un RAM User o un RAM Role con los permisos mínimos obligatorios para invocar las API.
Más información
Métodos de integración
Los SDK son la forma más sencilla y con mejor soporte para invocar la openapi.
File Storage NAS es compatible con varios métodos de integración, como los SDK, Alibaba Cloud CLI, el conjunto de herramientas de código abierto de NAS, Terraform y Resource Orchestration Service (ROS). Elija el método que mejor se adapte a sus necesidades.
SDK de Alibaba Cloud
Alibaba Cloud proporciona SDK para Java, C#, Go, Python, Node.js/TypeScript, PHP y C++. Estos SDK le permiten invocar operaciones de openapi mediante métodos tipados, ya que gestionan automáticamente la lógica de firmas, los tiempos de espera y los reintentos. Devuelven objetos de respuesta estructurados, lo que simplifica el desarrollo. Para obtener más información sobre los SDK de Alibaba Cloud, consulte Alibaba Cloud SDKs.
Puede usar los SDK de Alibaba Cloud para invocar las API de File Storage NAS. Para conocer los lenguajes compatibles y los métodos de instalación de dependencias, consulte SDK de File Storage NAS.
Alibaba Cloud CLI
Alibaba Cloud CLI le permite ejecutar el comando aliyun en una terminal para interactuar con los servicios de Alibaba Cloud y gestionar los recursos en la nube. Para obtener más información sobre Alibaba Cloud CLI, consulte What is Alibaba Cloud CLI.
Conjunto de herramientas de código abierto de NAS
Alibaba Cloud NAS ofrece un conjunto de herramientas de código abierto con soporte oficial en GitHub, que incluye scripts y utilidades para pruebas de rendimiento, asistencia de montaje y análisis de capacidad.
-
Herramienta de estadísticas de capacidad de NAS (nas_stat_util)
Analiza y recopila estadísticas sobre el uso de capacidad a nivel de directorio en un sistema de archivos NAS. Es compatible con diversos filtros y formatos de salida.
-
Kit de herramientas de montaje de NAS/CPFS (alinas-utils)
Un kit de herramientas para montar sistemas de archivos NAS y CPFS de Alibaba Cloud.
Visite la página del proyecto en GitHub para consultar la lista completa de herramientas y las instrucciones de uso.
Resource Orchestration Service (ROS)
Resource Orchestration Service (ROS) simplifica la gestión de recursos en la nube. Usted define sus recursos de Alibaba Cloud y sus dependencias en plantillas, y el motor de ROS los crea y configura automáticamente. Para obtener más información, consulte What is Resource Orchestration Service.
Para conocer los tipos de recursos de File Storage NAS compatibles con ROS, consulte ROS integration examples.
Encapsulación personalizada de API
Invocar llamadas HTTP sin procesar requiere implementar el algoritmo de firma y construir solicitudes personalizadas. Para obtener más información sobre el mecanismo de firma, consulte API reference guide y V3 request body and signing mechanism.
Solución de problemas
Solución de problemas mediante códigos de error
Si una llamada a la API devuelve un error, utilice el código de error resultante para diagnosticar el problema. Para obtener más información, consulte Centro de códigos de error.
Diagnóstico de autoservicio
También puede registrar el RequestID de la respuesta de la API o la información de error del SDK, y utilizar la Plataforma de diagnóstico de openapi de Alibaba Cloud para realizar un diagnóstico de autoservicio.