Todos os produtos
Search
Central de documentação

Cloud Control API:Termos

Última atualização: Jun 28, 2026

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.