C++용 Azure SDK는 C++ 개발자가 Azure 서비스를 애플리케이션에 통합할 수 있도록 설계된 라이브러리 집합을 제공합니다. 이 문서에서는 데이터와 관리 평면 간의 구분, Azure Core의 역할, 패키지 명명 규칙, 클라이언트 개체 및 구성 옵션을 포함하여 SDK를 뒷받침하는 기본 개념을 살펴봅니다. 이러한 핵심 개념을 이해하면 C++ 애플리케이션에서 SDK를 효과적으로 사용할 수 있습니다.
데이터 평면과 관리 평면 비교
C++용 Azure SDK는 데이터 평면 작업에 대한 라이브러리를 제공하지만 관리 평면 작업에 대한 라이브러리는 제공하지 않습니다. 데이터 평면 라이브러리는 이미 프로비전된 Azure 서비스와 상호 작용하는 데 사용됩니다. C++에서 Azure 리소스를 프로비전하고 관리하기 위해 관리 평면 라이브러리가 필요한 경우 GitHub 리포지토리에 문제를 남겨 둡니다.
Azure Core 및 기타 라이브러리
Azure Core(azure-core) 라이브러리는 다른 Azure 서비스에 대한 특정 기능을 제공하기 위해 다른 라이브러리가 빌드하는 기본 기능을 제공합니다. 개발자는 SDK를 효과적으로 사용하려면 Azure Core의 역할을 이해해야 합니다.
주요 공유 개념은 다음과 같습니다.Azure::Core
- 스트리밍 데이터와 입력/출력(I/O) 처리:
BodyStream및 파생 형식. - 를 통해
Response<T>모든 SDK 클라이언트 작업의 반환된 모델에 대한 HTTP 응답 세부 정보에 액세스합니다. -
Operation<T>을 통해 LRO(장기 실행 작업) 폴링 - 서비스 요청에서 오류를 일관된 방식으로 보고하기 위해 기본 예외 유형
RequestFailedException을 사용하는 예외입니다. - Azure SDK 자격 증명
TokenCredential에 대한 추상화. - 네트워크를 통해 요청을 보내고 응답을 수신하는 대체 가능한 HTTP 전송 계층입니다.
- 서비스 클라이언트 특정 옵션을 통해 구성할 수 있는 재시도 및 로깅과 같은 HTTP 파이프라인 및 HTTP 정책
패키지 명명 체계
C++용 Azure SDK는 일관된 명명 체계 azure-<group_name>-<service_name>-<sub_service_name>를 사용합니다. 각 이름은 그룹, 서비스 및 선택적으로 하위 서비스로 시작 azure-합니다. 예를 들어 azure-security-keyvault-secrets Azure Key Vault 비밀용입니다.
클라이언트 개체
C++용 Azure SDK의 클라이언트 개체는 Azure 서비스와 상호 작용하는 데 사용됩니다. 각 클라이언트 개체는 특정 Azure 서비스에 해당하며 해당 서비스에 대한 작업을 수행하는 메서드를 제공합니다. 예를 들어 BlobClient Azure Blob Storage와 상호 작용하는 데 사용됩니다.
클라이언트 개체에 대한 Options 매개 변수
C++용 Azure SDK의 클라이언트 개체에는 서비스와의 상호 작용을 사용자 지정하기 위한 옵션 매개 변수를 사용하는 메서드가 있습니다. 이러한 옵션 매개 변수를 사용하여 제한 시간, 재시도 정책 및 기타 구성과 같은 항목을 설정할 수 있습니다.