ENS admite varios métodos de integración, como SDK, CLI, Terraform y ROS. Utilice estos métodos para automatizar la gestión de recursos de ENS y mejorar la eficiencia del desarrollo.
Descripción general de OpenAPI Explorer
OpenAPI Explorer es un portal integral para las operaciones de API de Alibaba Cloud. Ofrece búsqueda inteligente, documentación, depuración en línea, descargas de SDK, código de ejemplo, diagnóstico de errores y estadísticas de llamadas. Puede ejecutar operaciones de API, consultar solicitudes y respuestas, y generar código de ejemplo de SDK directamente desde el portal.
Para obtener más información, consulte Overview.
Descripción de versiones
|
Versión de API |
Descripción |
|
Se recomienda utilizar esta versión. |
Depuración en línea
ENS permite la depuración de API en OpenAPI Explorer. Antes de ejecutar operaciones de API, revise la siguiente información específica de ENS: versiones, endpoints, estilos de API y métodos de llamada.
En la página de ENS dentro de OpenAPI Explorer, el panel de navegación izquierdo muestra categorías de servicio como instancias, discos, instantáneas, imágenes, security groups y redes. En el panel central, puede configurar los parámetros de la API, seleccionar una dirección de servicio, como China (Hangzhou), e introducir los parámetros de solicitud. El panel derecho presenta la documentación de la API —incluida información sobre límites de tasa, parámetros de solicitud y parámetros de respuesta— en las pestañas Documentation, Debugging Result, SDK Sample y CLI Sample.
Depuración
Acceda al portal de depuración de API de ENS.
Endpoints
Utilice el endpoint de la región de Singapur ens.ap-southeast-1.aliyuncs.com.
Para obtener más información, consulte Endpoints.
Identidades
De forma predeterminada, OpenAPI Explorer utiliza su cuenta de Alibaba Cloud para la depuración en línea. Dado que una cuenta de Alibaba Cloud tiene permisos completos de API, usarla directamente puede implicar riesgos de seguridad. Se recomienda utilizar un usuario de Resource Access Management (RAM) en su lugar. Antes de ejecutar operaciones de API como usuario RAM, otorgue los permisos necesarios según sus requisitos empresariales. El usuario RAM debe contar con permisos para gestionar recursos de ENS. Para obtener más información, consulte System policies for ENS.
|
Identidad |
Compatible |
|
Sí |
|
|
RAM user (recomendado) |
Sí |
|
RAM role (recomendado) |
Sí |
Se recomienda otorgar únicamente los permisos mínimos necesarios a un usuario RAM o rol RAM y utilizar dicha identidad para ejecutar las operaciones de API.
Referencias
Métodos de integración
Métodos de llamada
|
Método de llamada |
Compatible |
|
Alibaba Cloud SDKs (recomendado) |
Sí |
|
Sí |
|
|
Sí |
|
|
Sí |
|
|
Sí |
SDK de Alibaba Cloud
Los SDK de Alibaba Cloud están disponibles para Java, C#, Go, Python, TypeScript, Node.js, PHP y C++. Estos SDK encapsulan la lógica de firma, el manejo de tiempos de espera y los mecanismos de reintento, además de devolver objetos de respuesta estructurados. Para obtener más información, consulte Alibaba Cloud SDKs.
Puede utilizar los SDK de Alibaba Cloud para llamar a las API de ENS. Para conocer los lenguajes compatibles y las instrucciones de instalación, consulte Centro de SDK de ENS.
CLI de Alibaba Cloud
Puede utilizar la CLI de Alibaba Cloud para ejecutar operaciones de API de ENS. Para obtener más información, consulte Sample commands.
Puede ejecutar comandos
aliyunpara interactuar con los servicios de Alibaba Cloud y gestionar recursos de servicios en la nube. Para obtener más información, consulte What is Alibaba Cloud CLI?
Terraform
Terraform es una herramienta de código abierto para previsualizar, configurar y gestionar infraestructura y recursos en la nube. Al igual que Resource Orchestration Service (ROS), Terraform interpreta plantillas y ejecuta operaciones de API en consecuencia. Para obtener más información, consulte What is Terraform?
Para obtener información sobre cómo utilizar Terraform para orquestar recursos de ENS, consulte Resource integration by using Terraform.
-
Recursos compatibles
Puede utilizar Terraform para gestionar recursos de ENS, incluidos recursos regulares y de datos. Para obtener más información sobre Terraform, consulte What is Terraform?
Tipo de recurso
Nombre del recurso
Descripción
Recursos
Proporciona discos.ENS
Proporciona adjuntos de instancia de disco.ENS
Proporciona direcciones IP elásticas (EIP).ENS
Proporciona recursos de imagen.ENS
Proporciona instancias.ENS
Proporciona adjuntos de security group de instancia.ENS
Proporciona key pairs.ENS
Proporciona balanceadores de carga.ENS
Proporciona redes.ENS
Proporciona security groups.ENS
Proporciona instantáneas.ENS
Proporciona vSwitches.ENS
Fuentes de datos
Proporciona key pairs del usuario actual de Alibaba Cloud.ENS
ROS
Resource Orchestration Service (ROS) simplifica la gestión de recursos en la nube. Puede crear plantillas que describan los recursos necesarios, como instancias de Elastic Compute Service (ECS) y ApsaraDB RDS, junto con sus dependencias. ROS crea y configura automáticamente todos los recursos para permitir el despliegue y la operación y mantenimiento automatizados. Para obtener más información, consulte What is ROS?.
-
Puede utilizar ROS para ejecutar operaciones de API de ENS. Los recursos que se pueden orquestar mediante ROS incluyen recursos regulares y de datos.
-
Recursos regulares:
ALIYUN::ENS::Disk: crea un disco de datos pay-as-you-go o de suscripción.
ALIYUN::ENS::DiskInstanceAttachment: adjunta un disco de datos a una instancia ENS.
ALIYUN::ENS::Instance: crea una instancia ENS.
ALIYUN::ENS::InstanceSecurityGroupAttachment: agrega una instancia ENS a un security group.
ALIYUN::ENS::KeyPair: importa la clave pública de un par de claves cifrado con Rivest-Shamir-Adleman (RSA).
ALIYUN::ENS::Network: crea una nube privada virtual (VPC).
ALIYUN::ENS::NetworkAcl: crea una lista de control de acceso (ACL) de red.
ALIYUN::ENS::NetworkAclAssociation: asocia una ACL con redes.
ALIYUN::ENS::SecurityGroup: crea un security group.
ALIYUN::ENS::Snapshot: crea una instantánea.
ALIYUN::ENS::vSwitch: crea un vSwitch.
-
Recursos de datos:
DATASOURCE::ENS::Instances: consulta los detalles de las instancias ENS.
-
Para obtener información sobre cómo utilizar ROS para orquestar recursos de ENS, consulte Resource integration by using ROS.
Encapsulación personalizada de API
Para realizar llamadas HTTP nativas, debe construir y firmar las solicitudes usted mismo. Para obtener más información, consulte List of operations by function y Request syntax and signature method V3.
Notas de uso
Si una llamada de API falla, compruebe el código de error devuelto con respecto a sus parámetros de solicitud. Para obtener más información, consulte Centro de códigos de error.
También puede utilizar el RequestID devuelto o el mensaje de error del SDK con la plataforma de diagnóstico de OpenAPI de Alibaba Cloud para realizar diagnósticos de autoservicio.