Compartir a través de


Conceptos básicos del SDK de Azure para C++

El SDK de Azure para C++ proporciona un conjunto de bibliotecas diseñadas para ayudar a los desarrolladores de C++ a integrar los servicios de Azure en sus aplicaciones. En este artículo se exploran los conceptos fundamentales que respaldan el SDK, incluida la distinción entre los planos de administración y los datos, el rol de Azure Core, las convenciones de nomenclatura de paquetes, los objetos de cliente y las opciones de configuración. Comprender estos conceptos básicos le permitirá usar eficazmente el SDK en las aplicaciones de C++.

Plano de datos frente al plano de administración

El SDK de Azure para C++ proporciona bibliotecas para las operaciones del plano de datos, pero no ofrece bibliotecas para las operaciones del plano de administración. Las bibliotecas del plano de datos se usan para interactuar con los servicios de Azure ya aprovisionados. Si necesita bibliotecas del plano de administración para el aprovisionamiento y la administración de recursos de Azure en C++, deje un problema en nuestro repositorio de GitHub.

Azure Core frente a otras bibliotecas

La biblioteca de Azure Core (azure-core) proporciona funcionalidades fundamentales que otras bibliotecas se basan en para proporcionar funcionalidades específicas para diferentes servicios de Azure. Los desarrolladores deben comprender el rol de Azure Core para usar eficazmente el SDK.

Los principales conceptos compartidos de Azure::Core incluyen:

  • Manejo de datos de transmisión y entrada/salida (E/S) a través de BodyStream, junto con sus tipos derivados.
  • Acceder a los detalles de la respuesta HTTP del modelo devuelto por cualquier operación de cliente del SDK, a través de Response<T>.
  • Sondear las operaciones de ejecución prolongada (LROs), a través de Operation<T>.
  • Excepciones para notificar errores de solicitudes de servicio de forma coherente a través del tipo RequestFailedExceptionde excepción base .
  • Abstracciones para las credenciales del SDK de AzureTokenCredential.
  • Una capa de transporte HTTP que se puede reemplazar para enviar solicitudes y recibir respuestas a través de la red.
  • Canalización HTTP y directivas HTTP, como reintento y registro, que se pueden configurar a través de opciones específicas del cliente de servicio.

Esquema de nomenclatura de paquetes

El SDK de Azure para C++ usa un esquema de nomenclatura coherente: azure-<group_name>-<service_name>-<sub_service_name>. Cada nombre comienza por azure-, seguido del grupo, el servicio y, opcionalmente, un subservicio. Por ejemplo, azure-security-keyvault-secrets es para secretos de Azure Key Vault.

Objetos de cliente

Los objetos de cliente del SDK de Azure para C++ se usan para interactuar con los servicios de Azure. Cada objeto de cliente corresponde a un servicio de Azure específico y proporciona métodos para realizar operaciones en ese servicio. Por ejemplo, BlobClient se usa para interactuar con Azure Blob Storage.

Parámetro de opciones para objetos de clientes

Los objetos de cliente del SDK de Azure para C++ tienen métodos que toman un parámetro de opciones para personalizar las interacciones con el servicio. Estos parámetros de opciones se pueden usar para establecer elementos como tiempos de espera, directivas de reintento y otras configuraciones.