Grundläggande begrepp i Azure SDK för C++

Azure SDK för C++ innehåller en uppsättning bibliotek som är utformade för att hjälpa C++-utvecklare att integrera Azure-tjänster i sina program. Den här artikeln utforskar de grundläggande begrepp som ligger till grund för SDK:t, inklusive skillnaden mellan data och hanteringsplan, rollen för Azure Core, namngivningskonventioner för paket, klientobjekt och konfigurationsalternativ. Genom att förstå dessa grundläggande begrepp kan du effektivt använda SDK:t i dina C++-program.

Dataplan jämfört med hanteringsplan

Azure SDK för C++ tillhandahåller bibliotek för dataplansåtgärder men erbjuder inte bibliotek för hanteringsplanåtgärder. Dataplansbibliotek används för att interagera med redan etablerade Azure-tjänster. Om du behöver hanteringsplanbibliotek för etablering och hantering av Azure-resurser i C++, lämnar du ett problem på vår GitHub-lagringsplats.

Azure Core jämfört med andra bibliotek

Azure Core-biblioteket (azure-core) innehåller grundläggande funktioner som andra bibliotek bygger på för att tillhandahålla specifika funktioner för olika Azure-tjänster. Utvecklare måste förstå rollen för Azure Core för att effektivt använda SDK:n.

De viktigaste delade begreppen Azure::Core är:

• Hantera strömmande data och indata/utdata (I/O) via BodyStream tillsammans med dess härledda typer.
• Åtkomst till HTTP-svarsinformation för den returnerade modellen för alla SDK-klientåtgärder via Response<T>.
• Pollning av långvariga processer (LRO:er) via Operation<T>.
• Undantag för att rapportera fel från tjänstbegäranden på ett konsekvent sätt via den grundläggande undantagstypen RequestFailedException.
• Abstraktioner för Azure SDK-autentiseringsuppgifter TokenCredential.
• Ersättningsbart HTTP-transportlager för att skicka begäranden och ta emot svar via nätverket.
• HTTP-pipeline- och HTTP-principer, till exempel återförsök och loggning, som kan konfigureras via klientspecifika alternativ för tjänsten.

Namnschema för paket

Azure SDK för C++ använder ett konsekvent namngivningsschema: azure-<group_name>-<service_name>-<sub_service_name>. Varje namn börjar med azure-, följt av gruppen, tjänsten och eventuellt en undertjänst. Är till exempel azure-security-keyvault-secrets för Azure Key Vault-hemligheter.

Klientobjekt

Klientobjekt i Azure SDK för C++ används för att interagera med Azure-tjänster. Varje klientobjekt motsvarar en specifik Azure-tjänst och tillhandahåller metoder för att utföra åtgärder på den tjänsten. Används till exempel BlobClient för att interagera med Azure Blob Storage.

Alternativparameter för klientobjekt

Klientobjekt i Azure SDK för C++ har metoder som använder en alternativparameter för att anpassa interaktionerna med tjänsten. Dessa alternativparametrar kan användas för att ange saker som tidsgränser, återförsöksprinciper och andra konfigurationer.