Concetti di base di Azure SDK per C++

Azure SDK per C++ offre un set di librerie progettate per consentire agli sviluppatori C++ di integrare i servizi di Azure nelle applicazioni. Questo articolo illustra i concetti fondamentali alla base dell'SDK, inclusa la distinzione tra i piani di dati e di gestione, il ruolo di Azure Core, le convenzioni di denominazione dei pacchetti, gli oggetti client e le opzioni di configurazione. La comprensione di questi concetti di base consentirà di usare efficacemente l'SDK nelle applicazioni C++.

Piano dati e piano di gestione

Azure SDK per C++ fornisce librerie per le operazioni del piano dati, ma non offre librerie per le operazioni del piano di gestione. Le librerie del piano dati vengono usate per interagire con i servizi di Azure di cui è già stato effettuato il provisioning. Se hai bisogno di librerie del piano di gestione per il provisioning e la gestione delle risorse di Azure in C++, segnala un problema nel repository GitHub.

Confronto tra Azure Core e altre librerie

La libreria Azure Core (azure-core) fornisce funzionalità fondamentali basate su altre librerie per fornire funzionalità specifiche per diversi servizi di Azure. Gli sviluppatori devono comprendere il ruolo di Azure Core per usare efficacemente l'SDK.

I principali concetti condivisi di Azure::Core includono:

• Gestione dei dati di streaming e input/output (I/O) tramite BodyStream insieme ai relativi tipi derivati.
• È possibile accedere ai dettagli della risposta HTTP per il modello restituito da qualsiasi operazione del client SDK tramite Response<T>.
• Sondaggio delle operazioni a lungo termine (LRO) tramite Operation<T>.
• Eccezioni per la segnalazione coerente di errori derivanti dalle richieste di servizio tramite il tipo di eccezione base RequestFailedException.
• Astrazioni per le credenziali TokenCredentialdi Azure SDK.
• Livello di trasporto HTTP sostituibile per inviare richieste e ricevere risposte in rete.
• Pipeline HTTP e criteri HTTP, ad esempio la ripetizione dei tentativi e la registrazione, configurabili tramite opzioni specifiche del client del servizio.

Schema di denominazione dei pacchetti

Azure SDK per C++ usa uno schema di denominazione coerente: azure-<group_name>-<service_name>-<sub_service_name>. Ogni nome inizia con azure-, seguito dal gruppo, dal servizio e, facoltativamente, da un sottoservizio. Ad esempio, azure-security-keyvault-secrets per i segreti di Azure Key Vault.

Oggetti client

Gli oggetti client in Azure SDK per C++ vengono usati per interagire con i servizi di Azure. Ogni oggetto client corrisponde a un servizio di Azure specifico e fornisce metodi per eseguire operazioni su tale servizio. Ad esempio, BlobClient viene usato per interagire con Azure Blob Storage.

Parametro delle opzioni per gli oggetti del client

Gli oggetti client in Azure SDK per C++ hanno metodi che accettano un parametro di opzioni per personalizzare le interazioni con il servizio. Questi parametri di opzioni possono essere usati per impostare elementi come timeout, criteri di ripetizione dei tentativi e altre configurazioni.