Aan de slag met ontwikkelhulpprogramma's voor Azure Stack Hub-opslag

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

Gebruik dit artikel als handleiding 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 Zelfstudies voor Azure Storage.

Notitie

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

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 in uw code opgeven.

Update van 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 Rij: 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 Rij: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues	bestand app.config
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 Rij: 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 Rij: 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 (Uitvoeren: 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 Rij: 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 Tafel: 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 Rij: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1 Tafel: 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 Rij: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue Tafel: 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 de .NET- en Java-clientbibliotheek, vanwege de afhankelijkheden van een kwetsbare versie van Jackson-pakket. Het wordt sterk aangeraden de meest recente ondersteunde versie van .NET en Java-clientbibliotheek te gebruiken om beveiligingsproblemen te voorkomen.

PHP-client installeren via Composer - actueel

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 gebruiken (Common: v12.9.0 / Blob: v12.10.0 / Queue: v12.8.0) en Java-clientbibliotheek (Common: v12.0)12.0 / Blob: v12.13.0 / Wachtrij: 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 bevat twee delen: 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 weet wat uw eindpunt is.

Voorbeelden

.NET

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

<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 declaratieexemplaren:

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 declaratieexemplaren:

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-opslag

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 die wordt 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 Storage 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 die wordt beschreven in de vorige sectie Voorbeelden .

• Aan de slag met Azure Queue Storage met .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 die wordt 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