ApsaraDB RDS ofrece una consola para operaciones visuales y varias formas de invocar operaciones de API, como OpenAPI Explorer, los SDK de Alibaba Cloud y Resource Orchestration Service (ROS). Elija el método de integración que mejor se adapte a su flujo de trabajo.
Descripción general de OpenAPI Explorer
OpenAPI Explorer es una herramienta de Alibaba Cloud que ayuda a los desarrolladores a descubrir y usar operaciones de API en los servicios de Alibaba Cloud. Combina búsqueda inteligente, documentación, depuración en línea, descarga de SDK, código de ejemplo, diagnóstico de errores y estadísticas de llamadas en un solo lugar. Use OpenAPI Explorer para invocar operaciones de API e inspeccionar solicitudes y respuestas. También genera automáticamente código de ejemplo de SDK para las operaciones que pruebe. Para obtener más información, consulte ¿Qué es una API?
Descripción de versiones
ApsaraDB RDS usa números de versión para gestionar las versiones de la API. La versión recomendada actual es 2014-08-15. Tenga en cuenta que 2014-08-15 es un identificador de versión, no una fecha.
| Versión | Descripción |
|---|---|
| 2014-08-15 | Recomendada |
Depuración en línea
OpenAPI Explorer admite la depuración de API para ApsaraDB RDS. Antes de invocar operaciones de API, revise las versiones disponibles, los endpoints y los métodos de integración.
Página de depuración en línea
Acceda a OpenAPI Explorer.
Punto de entrada de depuración: Depurar API
Endpoints
Use el endpoint correspondiente a la región donde reside su instancia para reducir la latencia. Por ejemplo, para una instancia en la región China (Zhangjiakou), el endpoint público es rds.cn-zhangjiakou.aliyuncs.com y el endpoint de virtual private cloud (VPC) es rds-vpc.cn-zhangjiakou.aliyuncs.com.
El endpoint público es accesible globalmente.
-
Los endpoints de VPC ofrecen las siguientes ventajas frente a los endpoints públicos:
Alta seguridad: Los endpoints de VPC solo son accesibles dentro de una VPC, lo que proporciona mayor seguridad y privacidad.
Respuesta rápida: Los datos viajan a través de la red de VPC, lo que reduce la latencia y evita limitaciones de ancho de banda.
Bajo costo: El tráfico a través de endpoints de VPC usa la red interna.
Para obtener más información, consulte Endpoints.
Identidades de usuario compatibles
De forma predeterminada, OpenAPI Explorer usa su cuenta de Alibaba Cloud para la depuración en línea. Una cuenta de Alibaba Cloud tiene permisos completos sobre todas las operaciones de API, lo que implica riesgos de seguridad. Invoque operaciones de API y realice tareas rutinarias de operación y mantenimiento mediante un usuario RAM o un rol RAM. Antes de usar un usuario RAM, otorgue los permisos necesarios para gestionar recursos de ApsaraDB RDS. Para obtener más información, consulte Autorizar a un usuario RAM para gestionar instancias de ApsaraDB RDS.
|
Identidad |
Compatible |
|
Sí |
|
|
RAM user (recomendado) |
Sí |
|
RAM role (recomendado) |
Sí |
Referencias
Métodos de integración
ApsaraDB RDS admite SDK de Alibaba Cloud, Alibaba Cloud CLI, ROS, Terraform y encapsulación personalizada. Seleccione un método según su flujo de trabajo.
|
Método de llamada |
Compatible |
|
Sí |
|
|
Sí |
|
|
Sí |
|
|
Sí |
|
|
Encapsulación personalizada |
Sí |
Se recomienda usar SDK para la mayoría de los casos de uso por su facilidad de integración.
SDK de Alibaba Cloud
Los SDK de Alibaba Cloud están disponibles para Java, C#, Go, Python, TypeScript, Node.js, PHP y C++. Los SDK gestionan la firma de solicitudes, los tiempos de espera y los reintentos, además de devolver objetos de respuesta estructurados que simplifican el desarrollo. Para obtener más información, consulte Alibaba Cloud SDKs.
Para consultar los lenguajes y dependencias compatibles con ApsaraDB RDS, visite OpenAPI Explorer.
Alibaba Cloud CLI
Alibaba Cloud CLI le permite ejecutar comandos aliyun para interactuar con los servicios de Alibaba Cloud y gestionar recursos en la nube. Para obtener más información, consulte What is Alibaba Cloud CLI?
Para invocar operaciones de API de ApsaraDB RDS mediante Alibaba Cloud CLI, consulte Generate a command.
ROS
Resource Orchestration Service (ROS) automatiza la creación y configuración de recursos en la nube. Defina su infraestructura en una plantilla, incluidas las instancias de Elastic Compute Service (ECS) y de ApsaraDB RDS, así como las relaciones entre los recursos, y ROS aprovisionará todo automáticamente para implementar el despliegue y la operación y mantenimiento automatizados. Para obtener más información, consulte What is ROS?
Para consultar los recursos y tipos de datos de ApsaraDB RDS compatibles, consulte ApsaraDB RDS resources supported by ROS.
Llamadas de API con encapsulación personalizada
Para hacer llamadas HTTP nativas, construya las solicitudes manualmente y fírmelas. Para obtener detalles sobre la firma, consulte Lista de operaciones por función y Request syntax and signature method V3.
Notas de uso
Si una operación de API devuelve un error, compruebe el código de error y verifique sus parámetros de entrada. Para consultar la lista de códigos de error, consulte Public error codes.
Para realizar diagnósticos de autoservicio mediante un ID de solicitud o detalles de errores del SDK, use Alibaba Cloud OpenAPI Diagnostics.