Wprowadzenie do narzędzi deweloperskich magazynu usługi Azure Stack Hub

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

Skorzystaj z tego artykułu jako przewodnika, aby rozpocząć korzystanie z narzędzi deweloperskich magazynu usługi Azure Stack Hub. Bardziej szczegółowe informacje i przykładowy kod 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 specyficzne wymagania 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	Wspólne: 12.9.0 Obiekt blob: 12.10.0 Kolejka: 12.8.0	Pakiet NuGet: Wspólne: https://www.nuget.org/packages/Azure.Storage.common/12.9.0 Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0 Kolejki: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0 Wydanie usługi GitHub: Wspólne: 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 Kolejki: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues	plik app.config
Java	Wspólne: 12.12.0 Obiekt blob: 12.14.3 Kolejka: 12.11.3	Pakiet Maven: Wspólne: 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 Kolejki: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3 Wydanie usługi GitHub: Wspólne: 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 Kolejki: 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 Kolejki: 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ólne: 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 Kolejki: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue Tabeli: 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: Blob: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob Kolejki: 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ólne: https://rubygems.org/gems/azure-storage-common/versions/1.0.1 Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1 Kolejki: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1 Tabeli: https://rubygems.org/gems/azure-storage-table/versions/1.0.1 Wydanie usługi GitHub: Wspólne: 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 Kolejki: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue Tabeli: 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 platformy .NET i języka 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 pośrednictwem narzędzia Composer — bieżąca

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 (Typowe: wersja 12.9.0 / Obiekt blob: v12.10.0 / Queue: v12.8.0) i biblioteki klienta Java (wspólne: wersja 12.1 2.0 / Obiekt blob: v12.13.0 / Queue: v12.10.0), musisz 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. Jeśli nie masz pewności co do punktu końcowego, skontaktuj się z administratorem chmury.

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 specyficzne 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
• Jak używać Magazynu obiektów Blob w języku Java
• Jak używać Magazynu obiektów Blob w oprogramowaniu Node.js
• Jak używać magazynu obiektów blob w języku C++
• Jak używać Magazynu obiektów Blob w języku PHP
• Jak używać usługi Azure Blob Storage w języku Python
• Jak używać Magazynu obiektów Blob 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 specyficzne 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
• Jak używać Magazynu kolejek 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++
• Jak używać Magazynu kolejek w języku PHP
• Jak używać Magazynu kolejek w języku Python
• Jak używać Magazynu kolejek w języku Ruby

Table Storage

Następujące samouczki dotyczące usługi Azure Table Storage mają zastosowanie do usługi Azure Stack Hub. Zwróć uwagę na specyficzne 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
• Jak używać Magazynu tabel 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 w języku C++
• Jak używać Magazynu tabel w języku PHP
• Jak używać usługi Table Storage w języku Python
• Jak używać Magazynu tabel w języku Ruby

Następne kroki

• Wprowadzenie do usługi Microsoft Azure Storage