Основные понятия пакета SDK Azure для C++

Пакет SDK Azure для C++ предоставляет набор библиотек, предназначенных для помощи разработчикам C++ в интеграции служб Azure в свои приложения. В этой статье рассматриваются основные понятия, которые лежат в основе пакета SDK, включая различие между плоскостями данных и управления, ролью Azure Core, соглашениями об именовании пакетов, клиентскими объектами и параметрами конфигурации. Основные понятия позволяют эффективно использовать пакет SDK в приложениях C++.

Плоскость данных против плоскости управления

Пакет SDK Azure для C++ предоставляет библиотеки для операций плоскости данных, но не предлагает библиотеки для операций плоскости управления. Библиотеки плоскости данных используются для взаимодействия с уже подготовленными службами Azure. Если вам требуются библиотеки плоскости управления для подготовки ресурсов Azure и управления ими в C++, оставьте проблему в нашем репозитории GitHub.

Azure Core и другие библиотеки

Библиотека Azure Core (azure-core) предоставляет фундаментальные функциональные возможности, на которых другие библиотеки строятся, чтобы обеспечить конкретные функции для различных служб Azure. Разработчикам необходимо понять роль Azure Core для эффективного использования пакета SDK.

Основные общие понятия Azure::Core включают:

• Обработка потоковых данных и входных и выходных данных (ввода-вывода) BodyStream наряду с производными типами.
• Доступ к сведениям о ответе HTTP для возвращаемой модели любой клиентской операции пакета SDK через Response<T>.
• Опрос длительных операций (LROS) через Operation<T>.
• Исключения для создания отчетов об ошибках из запросов служб в согласованном режиме с помощью базового типа RequestFailedExceptionисключения.
• Абстракции для учетных данных пакета SDK для Azure.
• Замещаемый уровень транспорта HTTP для отправки запросов и получения ответов по сети.
• Конвейер HTTP и политики HTTP, такие как повторные попытки и ведение журнала, которые можно настроить с помощью определенных параметров клиента службы.

Схема именования пакетов

Пакет SDK Azure для C++ использует согласованную схему именования: azure-<group_name>-<service_name>-<sub_service_name> Каждое имя начинается с azure-, за которым следует группа, служба и при необходимости подслужба. Например, azure-security-keyvault-secrets используется для хранения секретов в Azure Key Vault.

Клиентские объекты

Клиентские объекты в пакете SDK Azure для C++ используются для взаимодействия со службами Azure. Каждый клиентский объект соответствует определенной службе Azure и предоставляет методы для выполнения операций с этой службой. Например, BlobClient используется для взаимодействия с хранилищем BLOB-объектов Azure.

Параметр опции для клиентских объектов

Клиентские объекты в пакете SDK Azure для C++ имеют методы, которые принимают параметр параметров для настройки взаимодействия со службой. Эти параметры можно использовать для задания таких элементов, как время ожидания, политики повторных попыток и другие конфигурации.