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

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

Skorzystaj z tego artykułu jako przewodnika, aby rozpocząć korzystanie z narzędzi deweloperskich magazynu usługi 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, zobacz Magazyn usługi Azure Stack Hub: różnice i zagadnienia.

Biblioteki klienta platformy Azure

W przypadku bibliotek klienta magazynu 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

Biblioteka kliencka	Obsługiwana wersja usługi Azure Stack Hub	Link	Specyfikacja punktu końcowego
.NET	Typowe: 12.9.0 Obiekt 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 Obiekt 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++	Obiekt 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	Obiekt 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
Ruby	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: (przykładowy obiekt blob).

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 polecenie: 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 Języka Java (Common: v12.1 2.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 klasy 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 parametry 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 konfiguracji parametry 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 parametry 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 parametry połączenia:

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

Blob storage

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

Table Storage

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