Rozpoczynanie pracy z narzędziami programistycznymi usługi Azure Stack Hub

Microsoft Azure Stack Hub udostępnia zestaw usług magazynu, które obejmują blob, tabele i magazyn kolejek.

Skorzystaj z tego artykułu jako przewodnika, aby zacząć używać narzędzi rozwoju magazynowania dla Azure Stack Hub. Więcej szczegółowych informacji i przykładowego kodu można znaleźć w odpowiednich samouczkach usługi Azure Storage.

Uwaga

Istnieją różnice między magazynem usługi Azure Stack Hub i usługą Azure Storage, w tym określonymi wymaganiami dla każdej platformy. Istnieją na przykład określone biblioteki klienta i wymagania dotyczące sufiksu punktu końcowego dla usługi Azure Stack Hub. Aby uzyskać więcej informacji, zapoznaj się z Przechowywanie w Azure Stack Hub: różnice i zagadnienia.

Biblioteki klienta platformy Azure

W przypadku bibliotek klienta usługi magazynowej należy pamiętać o wersji zgodnej z interfejsem API REST. Należy również określić punkt końcowy usługi Azure Stack Hub w kodzie.

Aktualizacja 2301 i nowsze wersje

Biblioteka kliencka	Obsługiwana wersja usługi Azure Stack Hub	Link	Specyfikacja punktu końcowego
.NET	Typowe: 12.9.0 Blob 12.10.0 Kolejka: 12.8.0	Pakiet NuGet: Wspólny: https://www.nuget.org/packages/Azure.Storage.common/12.9.0 Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0 Kolejka: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0 Wydanie usługi GitHub: Wspólny: 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 Kolejka: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues	plik app.config
Java	Typowe: 12.12.0 Blob: 12.14.3 Kolejka: 12.11.3	Pakiet Maven: Wspólny: 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 Kolejka: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3 Wydanie usługi GitHub: Wspólny: 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 Kolejka: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.11.3/sdk/storage/azure-storage-queue	Konfiguracja parametrów połączenia
Node.js	2.8.3	Link NPM: https://www.npmjs.com/package/azure-storage (Uruchom: npm install azure-storage@2.8.3) Wydanie usługi GitHub: https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3	Deklaracja wystąpienia usługi
C++	Blob: 12.2.0 Kolejka: 12.0.0	Wydanie usługi GitHub: Blob: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0 Kolejka: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-queues_12.0.0	Konfiguracja parametrów połączenia
PHP	1.2.0	Wydanie usługi GitHub: Wspólny: 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 Kolejka: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue Stół: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table Zainstaluj za pomocą narzędzia Composer (aby dowiedzieć się więcej, zobacz poniższe szczegóły).	Konfiguracja parametrów połączenia
Python	Blob: 12.9.0 Kolejka: 12.1.6	Wydanie usługi GitHub: Obiekt blob: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob Kolejka: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue	Deklaracja wystąpienia usługi
Rubin	1.0.1	Pakiet RubyGems: Wspólny: https://rubygems.org/gems/azure-storage-common/versions/1.0.1 Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1 Kolejka: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1 Stół: https://rubygems.org/gems/azure-storage-table/versions/1.0.1 Wydanie usługi GitHub: Wspólny: 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 Kolejka: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue Stół: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table	Konfiguracja parametrów połączenia

Uwaga

Istnieje luka w zabezpieczeniach o wysokiej ważności w starej wersji biblioteki klienta .NET i Java ze względu na zależności od wrażliwej wersji pakietu Jackson. Zdecydowanie zaleca się użycie najnowszej obsługiwanej wersji biblioteki klienta .NET i Java, aby uniknąć problemu z zabezpieczeniami.

Instalowanie klienta PHP za pomocą narzędzia Composer — current

Aby zainstalować za pomocą narzędzia Composer: (weź obiekt blob jako przykład).

1. Utwórz plik o nazwie composer.json w katalogu głównym projektu z następującym kodem:

   {
     "require": {
     "Microsoft/azure-storage-blob":"1.2.0"
     }
   }
   

2. Pobierz plik composer.phar do katalogu głównego projektu.

3. Uruchom: php composer.phar install.

Określanie wersji interfejsu API

Aby użyć nowej biblioteki klienta platformy .NET (Common: v12.9.0 / Blob: v12.10.0 / Queue: v12.8.0) i biblioteki klienta Java (Common: v12.12.0 / Blob: v12.13.0 / Queue: v12.10.0), należy jawnie określić parametr serviceVersion w każdej klasie klienta (w tym BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient i QueueClient), ponieważ domyślna wersja w klasie klienta nie jest obecnie obsługiwana przez usługę Azure Stack Hub.

Przykłady

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

Deklaracja punktu końcowego

Punkt końcowy usługi Azure Stack Hub zawiera dwie części: nazwę regionu i domenę usługi Azure Stack Hub. W zestawie Azure Stack Development Kit domyślny punkt końcowy to local.azurestack.external. Skontaktuj się z administratorem chmury, jeśli nie masz pewności co do punktu końcowego.

Przykłady

.NET

W przypadku usługi Azure Stack Hub sufiks punktu końcowego jest określony w pliku app.config:

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

Java

W przypadku usługi Azure Stack Hub sufiks punktu końcowego jest określony w konfiguracji ciągu połączenia.

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

Node.js

W przypadku usługi Azure Stack Hub sufiks punktu końcowego jest określony w wystąpieniu deklaracji:

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

C++

W przypadku usługi Azure Stack Hub sufiks punktu końcowego jest określony w ustawieniach łańcucha połączenia.

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

PHP

W przypadku usługi Azure Stack Hub sufiks punktu końcowego jest określony w konfiguracji ciągu połączenia.

$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

W przypadku usługi Azure Stack Hub sufiks punktu końcowego jest określony w wystąpieniu deklaracji:

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

Ruby

W przypadku usługi Azure Stack Hub sufiks punktu końcowego jest określony w konfiguracji ciągu połączenia.

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

Przechowywanie obiektów blob

Następujące samouczki dotyczące usługi Azure Blob Storage mają zastosowanie do usługi Azure Stack Hub. Zwróć uwagę na konkretne wymaganie sufiksu punktu końcowego dla usługi Azure Stack Hub opisane w poprzedniej sekcji Przykłady .

• Rozpoczynanie pracy z usługą Azure Blob Storage przy użyciu platformy .NET
• Używanie usługi Blob Storage w języku Java
• Używanie usługi Blob Storage w oprogramowaniu Node.js
• Jak używać usługi Blob Storage z poziomu języka C++
• Używanie usługi Blob Storage w języku PHP
• Jak używać usługi Azure Blob Storage w języku Python
• Używanie usługi Blob Storage w języku Ruby

Queue Storage

Następujące samouczki dotyczące usługi Azure Queue Storage mają zastosowanie do usługi Azure Stack Hub. Zwróć uwagę na konkretne wymaganie sufiksu punktu końcowego dla usługi Azure Stack Hub opisane w poprzedniej sekcji Przykłady .

• Rozpoczynanie pracy z usługą Azure Queue Storage przy użyciu platformy .NET
• Używanie usługi Queue Storage w języku Java
• Używanie usługi Queue Storage w oprogramowaniu Node.js
• Jak używać usługi Queue Storage z poziomu języka C++
• Używanie usługi Queue Storage w języku PHP
• Używanie usługi Queue Storage w języku Python
• Używanie usługi Queue Storage w języku Ruby

Przechowywanie w tabelach

Poniższe samouczki dotyczące usługi Azure Table Storage mają zastosowanie do usługi Azure Stack Hub. Zwróć uwagę na konkretne wymaganie sufiksu punktu końcowego dla usługi Azure Stack Hub opisane w poprzedniej sekcji Przykłady .

• Rozpoczynanie pracy z usługą Azure Table Storage przy użyciu platformy .NET
• Używanie usługi Table Storage w języku Java
• How to use Azure Table storage from Node.js (Używanie usługi Azure Table Storage w oprogramowaniu Node.js)
• Jak używać usługi Table Storage z poziomu języka C++
• Używanie usługi Table Storage w języku PHP
• Jak używać usługi Table Storage w języku Python
• Używanie usługi Table Storage w języku Ruby

Następne kroki

• Wprowadzenie do usługi Microsoft Azure Storage