Freigeben über


Erste Schritte mit den Azure Stack Hub-Speicherentwicklungstools

Microsoft Azure Stack Hub bietet eine Reihe von Speicherdiensten einschließlich Blob-, Tabellen- und Warteschlangenspeicher.

Nutzen Sie diesen Artikel als Leitfaden für die ersten Schritte mit den Azure Stack Hub-Speicherentwicklungstools. Ausführlichere Informationen und Beispielcode finden Sie in den entsprechenden Azure-Speichertutorials.

Hinweis

Es gibt Unterschiede zwischen Azure Stack Hub-Speicher und Azure-Speicher sowie besondere Anforderungen für die jeweilige Plattform. Beispielsweise gelten bestimmte Anforderungen in Bezug auf die Clientbibliotheken und Endpunktsuffixe für Azure Stack Hub. Weitere Informationen finden Sie unter Azure Stack Hub-Speicher: Unterschiede und Überlegungen.

Azure-Clientbibliotheken

Bei den Speicherclientbibliotheken müssen Sie auf die Version achten, die mit der REST-API kompatibel ist. Sie müssen auch den Azure Stack Hub-Endpunkt in Ihrem Code angeben.

Update 2301 und höher

Clientbibliothek Von Azure Stack Hub unterstützte Version Link Endpunktspezifikation
.NET Allgemein: 12.9.0
Blob: 12.10.0
Warteschlange: 12.8.0
NuGet-Paket:
Allgemein: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
Queue: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

GitHub-Release:
Allgemein: 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
Queue: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
app.config-Datei
Java Allgemein: 12.12.0
Blob: 12.14.3
Warteschlange: 12.11.3
Maven-Paket:
Allgemein: 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
Queue: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3

GitHub-Release:
Allgemein: 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
Queue: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.11.3/sdk/storage/azure-storage-queue
Verbindungszeichenfolgen-Setup
Node.js 2.8.3 NPM-Link:
https://www.npmjs.com/package/azure-storage
(Ausführung: npm install azure-storage@2.8.3)

GitHub-Release:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Dienstinstanzdeklaration
C++ Blob: 12.2.0
Warteschlange: 12.0.0
GitHub-Release:
Blob: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0
Queue: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-queues_12.0.0
Verbindungszeichenfolgen-Setup
PHP 1.2.0 GitHub-Release:
Allgemein: 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
Queue:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Table: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Installation über Composer (Weitere Informationen finden Sie weiter unten.)
Verbindungszeichenfolgen-Setup
Python Blob: 12.9.0
Warteschlange: 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
Queue:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
Dienstinstanzdeklaration
Ruby 1.0.1 RubyGems-Paket:
Allgemein:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Queue: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Table: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub-Release:
Allgemein: 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
Queue: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Table: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Verbindungszeichenfolgen-Setup

Hinweis

Es besteht ein schwerwiegendes Sicherheitsrisiko in einer alten Version der .NET- und Java-Clientbibliothek, da diese von einer gefährdeten Version des Jackson-Pakets abhängig ist. Es wird dringend empfohlen, die neueste unterstützte Version der .NET- und Java-Clientbibliothek zu verwenden, um Sicherheitsprobleme zu vermeiden.

Installation des PHP-Clients per Composer – Aktuell

Installation über Composer: (Verwenden Sie das Blob als Beispiel).

  1. Erstellen Sie eine Datei mit dem Namen composer.json im Stammverzeichnis des Projekts mit folgendem Code:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. Laden Sie composer.phar in das Stammverzeichnis des Projekts herunter.

  3. Führen Sie php composer.phar install aus.

Angeben der API-Version

Um die neue .NET-Clientbibliothek (Allgemein: v12.9.0 / Blob: v12.10.0 / Warteschlange: v12.8.0) und die Java-Clientbibliothek (Allgemein: v12.12.0 / Blob: v12.13.0 / Warteschlange: v12.10. 0) zu verwenden, müssen Sie die Dienstversion in jeder Clientklasse (einschließlich BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient und QueueClient) explizit angeben, da die Standardversion in der Clientklasse derzeit nicht von Azure Stack Hub unterstützt wird.

Beispiele

.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 2008 und höher

Clientbibliothek Von Azure Stack Hub unterstützte Version Link Endpunktspezifikation
.NET Allgemein: 12.9.0
Blob: 12.10.0
Warteschlange: 12.8.0
NuGet-Paket:
Allgemein: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
Queue: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

GitHub-Release:
Allgemein: 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
Queue: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
app.config-Datei
Java Allgemein: 12.12.0
Blob: 12.13.0
Warteschlange: 12.10.0
Maven-Paket:
Allgemein: 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
Queue: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.10.0

GitHub-Release:
Allgemein: 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
Queue: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.10.0/sdk/storage/azure-storage-queue
Verbindungszeichenfolgen-Setup
Node.js 2.8.3 NPM-Link:
https://www.npmjs.com/package/azure-storage
(Ausführung: npm install azure-storage@2.8.3)

GitHub-Release:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Dienstinstanzdeklaration
C++ 7.2.0 GitHub-Release:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.2.0
Verbindungszeichenfolgen-Setup
PHP 1.2.0 GitHub-Release:
Allgemein: 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
Queue:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Table: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Installation über Composer (Weitere Informationen finden Sie weiter unten.)
Verbindungszeichenfolgen-Setup
Python Blob: 12.3.1
Warteschlange: 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
Queue:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
Dienstinstanzdeklaration
Ruby 1.0.1 RubyGems-Paket:
Allgemein:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Queue: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Table: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub-Release:
Allgemein: 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
Queue: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Table: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Verbindungszeichenfolgen-Setup

Installation des PHP-Clients per Composer – Aktuell

Installation über Composer: (Verwenden Sie das Blob als Beispiel).

  1. Erstellen Sie eine Datei mit dem Namen composer.json im Stammverzeichnis des Projekts mit folgendem Code:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. Laden Sie composer.phar in das Stammverzeichnis des Projekts herunter.

  3. Führen Sie php composer.phar install aus.

Angeben der API-Version

Um die neue .NET-Clientbibliothek (Allgemein: v12.9.0 / Blob: v12.10.0 / Warteschlange: v12.8.0) und die Java-Clientbibliothek (Allgemein: v12.12.0 / Blob: v12.13.0 / Warteschlange: v12.10. 0) zu verwenden, müssen Sie die Dienstversion in jeder Clientklasse (einschließlich BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient und QueueClient) explizit angeben, da die Standardversion in der Clientklasse derzeit nicht von Azure Stack Hub unterstützt wird.

Beispiele

.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 2005

Clientbibliothek Von Azure Stack Hub unterstützte Version Link Endpunktspezifikation
.NET 11.0.0 NuGet-Paket:
Allgemein: 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
Queue:
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-Datei
Java 12.0.0-preview.3 Maven-Paket:
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
Verbindungszeichenfolgen-Setup
Node.js 2.8.3 NPM-Link:
https://www.npmjs.com/package/azure-storage
(Ausführung: npm install azure-storage@2.8.3)

GitHub-Release:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Dienstinstanzdeklaration
C++ 7.1.0 GitHub-Release:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.1.0
Verbindungszeichenfolgen-Setup
PHP 1.2.0 GitHub-Release:
Allgemein: 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
Queue:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Table: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Installation über Composer (Weitere Informationen finden Sie weiter unten.)
Verbindungszeichenfolgen-Setup
Python 2.1.0 GitHub-Release:
Allgemein:
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
Queue:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-queue
Dienstinstanzdeklaration
Ruby 1.0.1 RubyGems-Paket:
Allgemein:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Queue: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Table: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub-Release:
Allgemein: 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
Queue: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Table: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Verbindungszeichenfolgen-Setup

Installation des PHP-Clients per Composer – Aktuell

Installation über Composer: (Verwenden Sie das Blob als Beispiel).

  1. Erstellen Sie eine Datei mit dem Namen composer.json im Stammverzeichnis des Projekts mit folgendem Code:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. Laden Sie composer.phar in das Stammverzeichnis des Projekts herunter.

  3. Führen Sie php composer.phar install aus.

Endpunktdeklaration

Ein Azure Stack Hub-Endpunkt besteht aus zwei Teilen: dem Namen einer Region und der Azure Stack Hub-Domäne. Im Azure Stack Development Kit ist der Standardendpunkt local.azurestack.external. Wenden Sie sich an den Cloudadministrator, falls Sie nicht sicher sind, wie Ihr Endpunkt lautet.

Beispiele

.NET

Für Azure Stack Hub ist das Endpunktsuffix in der Datei „app.config“ angegeben:

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

Java

Für Azure Stack Hub ist das Endpunktsuffix im Setup der Verbindungszeichenfolge angegeben:

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

Node.js

Für Azure Stack Hub ist das Endpunktsuffix in der Deklarationsinstanz angegeben:

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

C++

Für Azure Stack Hub ist das Endpunktsuffix im Setup der Verbindungszeichenfolge angegeben:

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

PHP

Für Azure Stack Hub ist das Endpunktsuffix im Setup der Verbindungszeichenfolge angegeben:

$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

Für Azure Stack Hub ist das Endpunktsuffix in der Deklarationsinstanz angegeben:

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

Ruby

Für Azure Stack Hub ist das Endpunktsuffix im Setup der Verbindungszeichenfolge angegeben:

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

Blobspeicher

Die folgenden Tutorials zu Azure Blob Storage gelten für Azure Stack Hub. Beachten Sie die im vorherigen Abschnitt Beispiele beschriebene bestimmte Endpunktsuffix-Voraussetzung für Azure Stack Hub.

Queue Storage

Die folgenden Tutorials zu Azure Queue Storage gelten für Azure Stack Hub. Beachten Sie die im vorherigen Abschnitt Beispiele beschriebene bestimmte Endpunktsuffix-Voraussetzung für Azure Stack Hub.

Tabellenspeicher

Die folgenden Tutorials zu Azure Table Storage gelten für Azure Stack Hub. Beachten Sie die im vorherigen Abschnitt Beispiele beschriebene bestimmte Endpunktsuffix-Voraussetzung für Azure Stack Hub.

Nächste Schritte