Conozca los términos clave que se utilizan en Cloud Control API, como los metadatos de recursos, los recursos padre e hijo y las operaciones síncronas y asíncronas.
Metadatos de recursos
Los metadatos de recursos describen los atributos, tipos, relaciones y comportamientos de los recursos. Todas las operaciones de gestión de recursos se basan en estos metadatos. Llame a GetResourceType para obtener los metadatos de un recurso específico e interpretar la información en los parámetros de respuesta.
Los metadatos de recursos constan de tres partes: información básica, atributos e información extendida.
Información básica: el nombre, el servicio asociado, la descripción, el nivel de despliegue y el método de facturación de un recurso.
Atributos: la descripción de atributos específicos del recurso, los parámetros de operación privados y los atributos confidenciales.
Información extendida: detalles de autorización y capacidad del recurso, como la política de autorización, la política de limitación de velocidad y la cuota.
Recursos padre y recursos hijo
Los recursos padre e hijo son conceptos lógicos que describen las dependencias entre los recursos de un mismo producto. Un recurso padre contiene recursos hijo, y los recursos hijo pertenecen a un recurso padre. Esta relación jerárquica facilita la gestión de los recursos hijo.
-
Cómo determinar si un recurso pertenece a un recurso padre
Si el resourceType de un recurso tiene el formato **/**, significa que dicho recurso pertenece a un recurso padre. Por ejemplo, ApsaraDB for Redis contiene una instancia llamada DBInstance y una cuenta de base de datos llamada DBInstance/Account. Dado que el resourceType de la cuenta de base de datos es DBInstance/Account, esta pertenece al recurso padre DBInstance, que corresponde a una instancia de ApsaraDB for Redis.
-
Cómo gestionar un recurso que pertenece a un recurso padre
Cuando llame a una API para gestionar un recurso hijo, incluya la información del recurso padre en la ruta de la solicitud. Para más información, consulte el requestPath de los parámetros de solicitud de la API en API Directory.
Operaciones síncronas y asíncronas
Las operaciones síncronas y asíncronas son dos modos de ejecución de tareas. Una operación síncrona devuelve una respuesta cuando la tarea finaliza, mientras que una operación asíncrona responde de inmediato sin esperar a que la tarea termine.
En la mayoría de los casos, Cloud Control API procesa de forma síncrona operaciones como la consulta, el listado y la actualización de recursos, así como la consulta de metadatos. Las tareas que consumen mucho tiempo, como la creación y eliminación de recursos, se procesan de forma asíncrona para mejorar la estabilidad del servicio.
Si al llamar a una operación de Cloud Control API para crear una tarea asíncrona se devuelve el código de estado 202, llame a la operación GetTask para consultar el estado de la tarea.