Delen via


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();

Update van 2008 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.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 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 details hieronder voor meer informatie.)
Verbindingsreeks instellen
Python Blob: 12.3.1
Wachtrij: 12.1.6
GitHub-release:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.3.1/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
Verbindingsreeks instellen

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 (common: v12.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();

2005-update

Clientbibliotheek Ondersteunde versie van Azure Stack Hub 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 service-exemplaar
C++ 7.1.0 GitHub-release:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.1.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 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 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

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.

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 .

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 .

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 .

Volgende stappen