Aan de slag met hulpprogramma's voor opslagontwikkeling in Azure Stack Hub

Microsoft Azure Stack Hub biedt een set opslagservices met blob-, tabel- en wachtrijopslag.

Gebruik dit artikel als richtlijn om aan de slag te gaan met de ontwikkelhulpprogramma's voor Azure Stack Hub-opslag. Meer gedetailleerde informatie en voorbeeldcode vindt u in de bijbehorende Azure Storage-zelfstudies.

Notitie

Er zijn verschillen tussen Azure Stack Hub-opslag en Azure-opslag, met inbegrip van specifieke vereisten voor elk platform. Er zijn bijvoorbeeld specifieke vereisten voor clientbibliotheken en eindpuntachtervoegsels voor Azure Stack Hub. Zie Azure Stack Hub-opslag: verschillen en overwegingen voor meer informatie.

Azure-clientbibliotheken

Houd voor de opslagclientbibliotheken rekening met de versie die compatibel is met de REST API. U moet ook het Azure Stack Hub-eindpunt opgeven in uw code.

Update 2301 en nieuwer

Clientbibliotheek	Ondersteunde versie van Azure Stack Hub	Koppeling	Eindpuntspecificatie
.NET	Algemeen: 12.9.0 Blob: 12.10.0 Wachtrij: 12.8.0	NuGet-pakket: Gemeenschappelijk: https://www.nuget.org/packages/Azure.Storage.common/12.9.0 Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0 Wachtrij: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0 GitHub-release: Gemeenschappelijk: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.9.0/sdk/storage/Azure.Storage.Common Blob: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.10.0/sdk/storage/Azure.Storage.Blobs Wachtrij: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues	app.config-bestand
Java	Algemeen: 12.12.0 Blob: 12.14.3 Wachtrij: 12.11.3	Maven-pakket: Gemeenschappelijk: https://mvnrepository.com/artifact/com.azure/azure-storage-common/12.12.0 Blob: https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.14.3 Wachtrij: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3 GitHub-release: Gemeenschappelijk: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-common_12.12.0/sdk/storage/azure-storage-common Blob: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-blob_12.14.3/sdk/storage/azure-storage-blob Wachtrij: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.11.3/sdk/storage/azure-storage-queue	Installatie van verbindingsreeks
Node.js	2.8.3	NPM-koppeling: https://www.npmjs.com/package/azure-storage (Voer uit: npm install azure-storage@2.8.3) GitHub-release: https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3	Declaratie van service-exemplaar
C++	Blob: 12.2.0 Wachtrij: 12.0.0	GitHub-release: Blob: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0 Wachtrij: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-queues_12.0.0	Installatie van verbindingsreeks
PHP	1.2.0	GitHub-release: Gemeenschappelijk: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-common Blob: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-blob Wachtrij: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue Tabel: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table Installeren via Composer ( Zie de onderstaande details voor meer informatie.)	Installatie van verbindingsreeks
Python	Blob: 12.9.0 Wachtrij: 12.1.6	GitHub-release: Blob: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob Wachtrij: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue	Declaratie van service-exemplaar
Ruby	1.0.1	RubyGems-pakket: Gemeenschappelijk: https://rubygems.org/gems/azure-storage-common/versions/1.0.1 Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1 Wachtrij: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1 Tabel: https://rubygems.org/gems/azure-storage-table/versions/1.0.1 GitHub-release: Gemeenschappelijk: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-common Blob: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-blob Wachtrij: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue Tabel: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table	Installatie van verbindingsreeks

Notitie

Er is een beveiligingsprobleem met hoge ernst in de oude versie van .NET en Java-clientbibliotheek, vanwege de afhankelijkheden van een kwetsbare versie van Jackson-pakket. Het wordt sterk aanbevolen om de meest recente ondersteunde versie van .NET en Java-clientbibliotheek te gebruiken om beveiligingsproblemen te voorkomen.

PHP-client installeren via Composer - current

Installeren via Composer: (neem de blob als voorbeeld).

1. Maak een bestand met de naam composer.json in de hoofdmap van het project met de volgende code:

   {
     "require": {
     "Microsoft/azure-storage-blob":"1.2.0"
     }
   }
   

2. Download composer.phar naar de hoofdmap van het project.

3. Uitvoeren: php composer.phar install.

API-versie opgeven

De nieuwe .NET-clientbibliotheek (Common: v12.9.0 / Blob: v12.10.0 / Queue: v12.8.0) en Java-clientbibliotheek (Algemeen: v12.8.0) gebruiken12.0 / Blob: v12.13.0 / Queue: v12.10.0), moet u expliciet de serviceVersion opgeven in elke clientklasse (inclusief BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient en QueueClient), omdat de standaardversie in de clientklasse momenteel niet wordt ondersteund door Azure Stack Hub.

Voorbeelden

.NET

BlobClientOptions options = new BlobClientOptions(BlobClientOptions.ServiceVersion.V2019_07_07);
BlobServiceClient client = new BlobServiceClient("<connection_string>", options);

Java

BlobServiceVersion version = BlobServiceVersion.V2019_07_07; 
BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
    .endpoint("<your_endpoint>")
    .sasToken("<your_SAS_token>")
    .serviceVersion(version)
    .buildClient();

Eindpuntdeclaratie

Een Azure Stack Hub-eindpunt bestaat uit twee onderdelen: de naam van een regio en het Azure Stack Hub-domein. In de Azure Stack Development Kit is het standaardeindpunt local.azurestack.external. Neem contact op met uw cloudbeheerder als u niet zeker bent over uw eindpunt.

Voorbeelden

.NET

Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in het app.config-bestand:

<add key="StorageConnectionString"
value="DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=mykey;
EndpointSuffix=local.azurestack.external;" />

Java

Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in de installatie van verbindingsreeks:

public static final String storageConnectionString =
    "DefaultEndpointsProtocol=http;" +
    "AccountName=your_storage_account;" +
    "AccountKey=your_storage_account_key;" +
    "EndpointSuffix=local.azurestack.external";

Node.js

Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in het declaratie-exemplaar:

var blobSvc = azure.createBlobService('myaccount', 'mykey',
'myaccount.blob.local.azurestack.external');

C++

Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in de installatie van verbindingsreeks:

const utility::string_t storage_connection_string(U("DefaultEndpointsProtocol=https;
AccountName=your_storage_account;
AccountKey=your_storage_account_key;
EndpointSuffix=local.azurestack.external"));

PHP

Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in de installatie van verbindingsreeks:

$connectionString = 'BlobEndpoint=https://<storage account name>.blob.local.azurestack.external/;
QueueEndpoint=https:// <storage account name>.queue.local.azurestack.external/;
TableEndpoint=https:// <storage account name>.table.local.azurestack.external/;
AccountName=<storage account name>;AccountKey=<storage account key>'

Python

Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in het declaratie-exemplaar:

block_blob_service = BlockBlobService(account_name='myaccount',
account_key='mykey',
endpoint_suffix='local.azurestack.external')

Ruby

Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in de installatie van verbindingsreeks:

set
AZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;
AccountName=myaccount;
AccountKey=mykey;
EndpointSuffix=local.azurestack.external

Blob Storage

De volgende zelfstudies voor Azure Blob Storage zijn van toepassing op Azure Stack Hub. Let op de specifieke vereiste voor eindpuntachtervoegsels voor Azure Stack Hub, zoals beschreven in de vorige sectie Voorbeelden .

• Aan de slag met Azure Blob Storage met .NET
• Blob Storage gebruiken met Java
• Blob Storage gebruiken met Node.js
• Blob-opslag gebruiken vanuit C++
• Blob Storage gebruiken met PHP
• Azure Blob Storage gebruiken vanuit Python
• Blob Storage gebruiken met Ruby

Queue Storage

De volgende zelfstudies voor Azure Queue Storage zijn van toepassing op Azure Stack Hub. Let op de specifieke vereiste voor eindpuntachtervoegsels voor Azure Stack Hub, zoals beschreven in de vorige sectie Voorbeelden .

• Aan de slag met Azure Queue Storage met behulp van .NET
• Queue Storage gebruiken met Java
• Queue Storage gebruiken met Node.js
• Queue Storage gebruiken vanuit C++
• Queue Storage gebruiken met PHP
• Queue Storage gebruiken met Python
• Queue Storage gebruiken met Ruby

Table Storage

De volgende zelfstudies voor Azure Table Storage zijn van toepassing op Azure Stack Hub. Let op de specifieke vereiste voor eindpuntachtervoegsels voor Azure Stack Hub, zoals beschreven in de vorige sectie Voorbeelden .

• Aan de slag met Azure Table Storage met .NET
• Table Storage gebruiken met Java
• Azure Table Storage gebruiken met Node.js
• Table Storage gebruiken vanuit C++
• Table Storage gebruiken met PHP
• Table Storage gebruiken in Python
• Table Storage gebruiken met Ruby

Volgende stappen

• Inleiding tot Microsoft Azure Storage