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	Verknüpfung	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 Warteschlange: 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 Warteschlange: 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();

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

Blob Storage

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.

• Erste Schritte mit Azure Blob Storage mit .NET
• Gewusst wie: Verwenden von Blob Storage mit Java
• Gewusst wie: Verwenden von Blob Storage mit Node.js
• Verwenden des BLOB-Speichers mit C++
• Gewusst wie: Verwenden von Blob Storage mit PHP
• Verwenden von Azure Blob Storage mit Python
• Gewusst wie: Verwenden von Blob Storage mit Ruby

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.

• Erste Schritte mit Azure Queue Storage mit .NET
• Gewusst wie: Verwenden von Queue Storage mit Java
• How to use Queue storage from Node.js (Verwenden von Queue Storage mit Node.js)
• Verwenden des Warteschlangenspeichers mit C++
• Gewusst wie: Verwenden von Queue Storage mit PHP
• Gewusst wie: Verwenden von Queue Storage mit Python
• Gewusst wie: Verwenden von Queue Storage mit Ruby

Table Storage

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.

• Erste Schritte mit Azure Table Storage mit .NET
• Gewusst wie: Verwenden von Table Storage mit Java
• Verwenden des Azure-Tabellenspeichers mit Node.js
• Verwenden des Tabellenspeichers mit C++
• Gewusst wie: Verwenden von Table Storage mit PHP
• Verwenden von Table Storage in Python
• Gewusst wie: Verwenden von Table Storage mit Ruby

Nächste Schritte

• Einführung in Azure Storage