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

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

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

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 Opslag Azure Stack Hub : verschillen en overwegingen voor meer informatie.

Azure-clientbibliotheken

Voor de opslagclientbibliotheken moet u rekening houden met de versie die compatibel is met de REST API. U moet ook het eindpunt Azure Stack Hub in uw code opgeven.

Update van 2008 en hoger

Clientbibliotheek Azure Stack Hub ondersteunde versie 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.13.0
Wachtrij: 12.10.0
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.13.0
Wachtrij: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.10.0

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.13.0/sdk/storage/azure-storage-blob
Wachtrij: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.10.0/sdk/storage/azure-storage-queue
Verbindingsreeks instellen
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 het service-exemplaar
C++ 7.2.0 GitHub release:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.2.0
Verbindingsreeks instellen
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.)
Verbindingsreeks instellen
Python 12.3.2 GitHub release:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.3.2/sdk/storage/azure-storage-blob
Wachtrij:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.3.2/sdk/storage/azure-storage-queue
Declaratie van het 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
Verbindingsreeks instellen

Notitie

Er is een zeer ernstig beveiligingsprobleem in de oude versie van .NET- en Java-clientbibliotheek, vanwege de afhankelijkheden van een kwetsbare versie van het Package Package. Het wordt sterk aanbevolen om de nieuwste ondersteunde versie van .NET- en Java-clientbibliotheek te gebruiken om beveiligingsprobleem 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 (algemeen: v12.9.0 / Blob: v12.10.0 / Wachtrij: v12.8.0) en Java-clientbibliotheek (algemeen: v12.012.0 / Blob: v12.13.0 / Queue: v12.10.0), moet u de serviceVersion expliciet 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();

Update van 2005

Clientbibliotheek Azure Stack Hub ondersteunde versie Koppeling Eindpuntspecificatie
.NET 11.0.0 NuGet-pakket:
Gemeenschappelijk: https://www.nuget.org/packages/Microsoft.Azure.Storage.Common/11.0.0
Blob: https://www.nuget.org/packages/Microsoft.Azure.Storage.Blob/11.0.0
Wachtrij:
https://www.nuget.org/packages/Microsoft.Azure.Storage.Queue/11.0.0

GitHub release:
https://github.com/Azure/azure-storage-net/releases/tag/v11.0.0
app.config bestand
Java 12.0.0-preview.3 Maven-pakket:
https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.0.0-preview.3

GitHub release:
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage
Verbindingsreeks instellen
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 het service-exemplaar
C++ 7.1.0 GitHub release:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.1.0
Verbindingsreeks instellen
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.)
Verbindingsreeks instellen
Python 2.1.0 GitHub release:
Gemeenschappelijk:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-common
Blob:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-blob
Wachtrij:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-queue
Declaratie van het 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
Verbindingsreeks instellen

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.

Eindpuntdeclaratie

Een Azure Stack Hub eindpunt bestaat uit twee delen: de naam van een regio en het Azure Stack Hub domein. In de Azure Stack Development Kit is het standaard eindpunt 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 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 connection string:

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 connection string:

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 connection string:

$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 connection string:

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

Blob Storage

De volgende zelfstudies over Azure Blob Storage zijn van toepassing op Azure Stack Hub. Let op de specifieke vereiste voor het eindpuntachtervoegsel voor Azure Stack Hub in de vorige sectie Voorbeelden.

Queue Storage

De volgende zelfstudies over Azure Queue Storage zijn van toepassing op Azure Stack Hub. Let op de specifieke vereiste voor het eindpuntachtervoegsel voor Azure Stack Hub in de vorige sectie Voorbeelden.

Table Storage

De volgende zelfstudies over Azure Table Storage zijn van toepassing op Azure Stack Hub. Let op de specifieke vereiste voor het eindpuntachtervoegsel voor Azure Stack Hub in de vorige sectie Voorbeelden.

Volgende stappen