Conheça os principais termos da Cloud Control API, incluindo metadados de recursos, recursos pai e filho, além de operações síncronas e assíncronas.
Metadados de recursos
Os metadados de recursos descrevem atributos, tipos, relacionamentos e comportamentos dos recursos. Todas as operações de gerenciamento de recursos baseiam-se nesses metadados. Chame a operação GetResourceType para obter os metadados de um recurso específico e interpretar as informações nos parâmetros de resposta.
Esses metadados dividem-se em três partes: informações básicas, atributos e informações estendidas.
Informações básicas: nome, serviço associado, descrição, nível de implantação e método de faturamento do recurso.
Atributos: descrição das propriedades específicas do recurso, parâmetros de operação privada e atributos sensíveis.
Informações estendidas: detalhes sobre autorização e capacidade do recurso, como política de autorização, política de limitação e cota.
Recursos pai e recursos filho
Recursos pai e filho são conceitos lógicos que descrevem dependências entre recursos do mesmo produto. Um recurso pai contém recursos filho, e estes pertencem àquele. Essa relação hierárquica facilita o gerenciamento dos recursos filho.
-
Como identificar se um recurso pertence a um recurso pai
Se o resourceType de um recurso estiver no formato **/**, ele pertence a um recurso pai. Por exemplo, o ApsaraDB for Redis possui uma instância chamada DBInstance e uma conta de banco de dados denominada DBInstance/Account. Como o resourceType da conta é DBInstance/Account, ela pertence ao recurso pai DBInstance, que corresponde à instância do ApsaraDB for Redis.
-
Como gerencie um recurso vinculado a um recurso pai
Ao chamar uma operação de API para gerencie um recurso filho, inclua as informações do recurso pai no caminho da requisição. Para mais detalhes, consulte o requestPath nos parâmetros de requisição da API em API Directory.
Operações síncronas e assíncronas
Operações síncronas e assíncronas representam dois modos de execução de tarefas. Uma operação síncrona retorna uma resposta somente após a conclusão da tarefa, enquanto uma operação assíncrona responde imediatamente, sem aguardar o término do processamento.
Geralmente, a Cloud Control API processa de forma síncrona operações como consulta, listagem e atualização de recursos, bem como consultas de metadados. Tarefas mais demoradas, como criação e exclusão de recursos, são executadas assincronicamente para garantir maior estabilidade do serviço.
Caso receba o código de status 202 ao chamar uma operação da Cloud Control API para criar uma tarefa assíncrona, utilize a operação GetTask para consultar o status da tarefa.