Udostępnij za pośrednictwem


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

Aktualizacja i nowsze wersje 2008

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

Wersja 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
app.config plik
Java Wspólne: 12.12.0
Obiekt blob: 12.13.0
Kolejka: 12.10.0
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.13.0
Kolejki: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.10.0

Wersja 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.13.0/sdk/storage/azure-storage-blob
Kolejki: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.10.0/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)

Wersja usługi GitHub:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Deklaracja wystąpienia usługi
C++ 7.2.0 Wersja usługi GitHub:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.2.0
Konfiguracja parametrów połączenia
PHP 1.2.0 Wersja 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 pośrednictwem programu Composer (aby dowiedzieć się więcej, zobacz poniższe szczegóły).
Konfiguracja parametrów połączenia
Python Obiekt blob: 12.3.1
Kolejka: 12.1.6
Wersja usługi GitHub:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.3.1/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

Wersja 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

Instalowanie klienta PHP za pośrednictwem programu Composer — bieżący

Aby zainstalować za pomocą narzędzia Composer: (weź 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 (typowe: wersja 12.1 2.0 / Obiekt blob: v12.13.0 / Queue: v12.10.0), należy jawnie określić 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();

Aktualizacja z 2005 r.

Biblioteka kliencka Obsługiwana wersja usługi Azure Stack Hub Link Specyfikacja punktu końcowego
.NET 11.0.0 Pakiet NuGet:
Wspólne: 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
Kolejki:
https://www.nuget.org/packages/Microsoft.Azure.Storage.Queue/11.0.0

Wersja usługi GitHub:
https://github.com/Azure/azure-storage-net/releases/tag/v11.0.0
app.config plik
Java 12.0.0-preview.3 Pakiet Maven:
https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.0.0-preview.3

Wersja usługi GitHub:
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage
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++ 7.1.0 Wydanie usługi GitHub:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.1.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 2.1.0 Wydanie usługi GitHub:
Wspólne:
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
Kolejki:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-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

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.

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 .

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 .

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 .

Następne kroki