Principais conceitos do SDK do Azure para C++

O SDK do Azure para C++ fornece um conjunto de bibliotecas projetadas para ajudar os desenvolvedores do C++ a integrar os serviços do Azure em seus aplicativos. Este artigo explora os conceitos fundamentais que sustentam o SDK, incluindo a distinção entre planos de dados e gerenciamento, a função do Azure Core, convenções de nomenclatura de pacotes, objetos cliente e opções de configuração. Entender esses conceitos principais permitirá que você use efetivamente o SDK em seus aplicativos C++.

Plano de dados versus plano de gerenciamento

O SDK do Azure para C++ fornece bibliotecas para operações de plano de dados, mas não oferece bibliotecas para operações de plano de gerenciamento. As bibliotecas de plano de dados são usadas para interagir com os serviços do Azure já provisionados. Se você precisar de bibliotecas de plano de gerenciamento para provisionar e gerenciar recursos do Azure no C++, deixe um problema em nosso repositório GitHub.

Azure Core versus outras bibliotecas

A biblioteca do Azure Core (azure-core) fornece funcionalidades fundamentais sobre as quais outras bibliotecas são construídas para oferecer funcionalidades específicas para diferentes serviços do Azure. Os desenvolvedores precisam entender a função do Azure Core para usar efetivamente o SDK.

Os principais conceitos compartilhados de Azure::Core incluem:

• Manipulação de dados de streaming e de entrada/saída (E/S) através de BodyStream e de seus tipos derivados.
• Acessando detalhes da resposta HTTP do modelo retornado de qualquer operação de cliente do SDK, via Response<T>.
• Operações de longa execução de sondagem (LROs), via Operation<T>.
• Exceções para relatar erros de solicitações de serviço de forma consistente por meio do tipo RequestFailedExceptionde exceção base.
• Abstrações para credenciais do SDK do Azure TokenCredential.
• Camada de transporte HTTP substituível para enviar solicitações e receber respostas pela rede.
• Pipeline HTTP e políticas HTTP, como tentativa de nova execução e registro em log, configuráveis através de opções específicas do cliente de serviço.

Esquema de nomenclatura de pacote

O SDK do Azure para C++ usa um esquema de nomenclatura consistente: azure-<group_name>-<service_name>-<sub_service_name>. Cada nome começa com azure-, seguido pelo grupo, serviço e, opcionalmente, um subsserviço. Por exemplo, azure-security-keyvault-secrets é para segredos do Azure Key Vault.

Objetos do cliente

Os objetos cliente no SDK do Azure para C++ são usados para interagir com os serviços do Azure. Cada objeto cliente corresponde a um serviço específico do Azure e fornece métodos para executar operações nesse serviço. Por exemplo, BlobClient é usado para interagir com o Armazenamento de Blobs do Azure.

Parâmetro de opções para objetos cliente

Os objetos cliente no SDK do Azure para C++ têm métodos que utilizam um parâmetro de opções para personalizar as interações com o serviço. Esses parâmetros de opções podem ser usados para definir coisas como tempos limite, políticas de repetição e outras configurações.