Sdílet prostřednictvím


Začínáme s vývojářskými nástroji pro úložiště Azure Stack Hub

Microsoft Azure Stack Hub poskytuje sadu služeb úložiště, které zahrnují úložiště objektů blob, tabulek a front.

Tento článek slouží jako průvodce, abyste mohli začít používat vývojové nástroje pro úložiště Služby Azure Stack Hub. Podrobnější informace a ukázkový kód najdete v příslušných kurzech pro Azure Storage.

Poznámka

Mezi úložištěm Azure Stack Hub a úložištěm Azure existují rozdíly, včetně specifických požadavků pro každou platformu. Existují například specifické požadavky na klientské knihovny a příponu koncového bodu pro službu Azure Stack Hub. Další informace najdete v tématu Úložiště služby Azure Stack Hub: Rozdíly a důležité informace.

Klientské knihovny Azure

U klientských knihoven úložiště mějte na paměti verzi, která je kompatibilní s rozhraním REST API. V kódu musíte také zadat koncový bod služby Azure Stack Hub.

Aktualizace 2301 a novější

Klientská knihovna Podporovaná verze služby Azure Stack Hub Odkaz Specifikace koncového bodu
.NET Běžné: 12.9.0
Objekt blob: 12.10.0
Fronta: 12.8.0
Balíček NuGet:
Společné: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
Fronty: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

Vydání GitHubu:
Společné: 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
Fronty: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
app.config soubor
Java Běžné: 12.12.0
Objekt blob: 12.14.3
Fronta: 12.11.3
Balíček Maven:
Společné: 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
Fronty: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3

Vydání GitHubu:
Společné: 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
Fronty: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.11.3/sdk/storage/azure-storage-queue
Nastavení připojovacího řetězce
Node.js 2.8.3 Odkaz NPM:
https://www.npmjs.com/package/azure-storage
(Spustit: npm install azure-storage@2.8.3)

Vydání GitHubu:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Deklarace instance služby
C++ Objekt blob: 12.2.0
Fronta: 12.0.0
Vydání GitHubu:
Blob: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0
Fronty: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-queues_12.0.0
Nastavení připojovacího řetězce
PHP 1.2.0 Vydání GitHubu:
Společné: 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
Fronty:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tabulka: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Instalace přes Composer (Další informace najdete v následujících podrobnostech.)
Nastavení připojovacího řetězce
Python Objekt blob: 12.9.0
Fronta: 12.1.6
Vydání GitHubu:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob
Fronty:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
Deklarace instance služby
Ruby 1.0.1 Balíček RubyGems:
Společné:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Fronty: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tabulka: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

Vydání GitHubu:
Společné: 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
Fronty: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tabulka: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Nastavení připojovacího řetězce

Poznámka

Ve staré verzi klientské knihovny .NET a Java existuje ohrožení zabezpečení s vysokou závažností kvůli závislostem na zranitelné verzi balíčku Jackson. Důrazně doporučujeme použít nejnovější podporovanou verzi klientské knihovny .NET a Java, abyste se vyhnuli problémům se zabezpečením.

Instalace klienta PHP přes Composer – aktuální

Instalace přes Composer: (jako příklad použijte objekt blob).

  1. V kořenovém adresáři projektu vytvořte soubor s názvem composer.json s následujícím kódem:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. Stáhněte soubor composer.phar do kořenového adresáře projektu.

  3. Spusťte php composer.phar install.

Určení verze rozhraní API

Pokud chcete používat novou klientskou knihovnu .NET (běžné: v12.9.0 / Objekt blob: v12.10.0 / Fronta: v12.8.0) a klientskou knihovnu Java (společné: v12.12.0 / Objekt blob: v12.13.0 / Fronta: v12.10.0), musíte explicitně zadat serviceVersion v každé třídě klienta (včetně třídy BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient a QueueClient), protože služba Azure Stack Hub v současné době nepodporuje výchozí verzi v klientské třídě.

Příklady

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

Aktualizace z roku 2008 a novější

Klientská knihovna Podporovaná verze služby Azure Stack Hub Odkaz Specifikace koncového bodu
.NET Běžné: 12.9.0
Objekt blob: 12.10.0
Fronta: 12.8.0
Balíček NuGet:
Společné: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
Fronty: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

Vydání GitHubu:
Společné: 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
Fronty: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
app.config soubor
Java Běžné: 12.12.0
Objekt blob: 12.13.0
Fronta: 12.10.0
Balíček Maven:
Společné: 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
Fronty: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.10.0

Vydání GitHubu:
Společné: 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
Fronty: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.10.0/sdk/storage/azure-storage-queue
Nastavení připojovacího řetězce
Node.js 2.8.3 Odkaz NPM:
https://www.npmjs.com/package/azure-storage
(Spustit: npm install azure-storage@2.8.3)

Vydání GitHubu:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Deklarace instance služby
C++ 7.2.0 Vydání GitHubu:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.2.0
Nastavení připojovacího řetězce
PHP 1.2.0 Vydání GitHubu:
Společné: 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
Fronty:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tabulka: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Instalace přes Composer (Další informace najdete v následujících podrobnostech.)
Nastavení připojovacího řetězce
Python Objekt blob: 12.3.1
Fronta: 12.1.6
Vydání GitHubu:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.3.1/sdk/storage/azure-storage-blob
Fronty:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
Deklarace instance služby
Ruby 1.0.1 Balíček RubyGems:
Společné:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Fronty: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tabulka: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

Vydání GitHubu:
Společné: 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
Fronty: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tabulka: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Nastavení připojovacího řetězce

Instalace klienta PHP přes Composer – aktuální

Instalace přes Composer: (jako příklad použijte objekt blob).

  1. V kořenovém adresáři projektu vytvořte soubor s názvem composer.json s následujícím kódem:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. Stáhněte soubor composer.phar do kořenového adresáře projektu.

  3. Spusťte php composer.phar install.

Určení verze rozhraní API

Pokud chcete používat novou klientskou knihovnu .NET (běžné: v12.9.0 / Objekt blob: v12.10.0 / Fronta: v12.8.0) a klientskou knihovnu Java (společné: v12.12.0 / Objekt blob: v12.13.0 / Fronta: v12.10.0), musíte explicitně zadat serviceVersion v každé třídě klienta (včetně třídy BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient a QueueClient), protože služba Azure Stack Hub v současné době nepodporuje výchozí verzi v klientské třídě.

Příklady

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

Aktualizace z roku 2005

Klientská knihovna Podporovaná verze služby Azure Stack Hub Odkaz Specifikace koncového bodu
.NET 11.0.0 Balíček NuGet:
Společné: 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
Fronty:
https://www.nuget.org/packages/Microsoft.Azure.Storage.Queue/11.0.0

Vydání GitHubu:
https://github.com/Azure/azure-storage-net/releases/tag/v11.0.0
app.config soubor
Java 12.0.0-preview.3 Balíček Maven:
https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.0.0-preview.3

Vydání GitHubu:
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage
Nastavení připojovacího řetězce
Node.js 2.8.3 Odkaz NPM:
https://www.npmjs.com/package/azure-storage
(Spustit: npm install azure-storage@2.8.3)

Vydání GitHubu:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Deklarace instance služby
C++ 7.1.0 Vydání GitHubu:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.1.0
Nastavení připojovacího řetězce
PHP 1.2.0 Vydání GitHubu:
Společné: 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
Fronty:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tabulka: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Instalace přes Composer (Další informace najdete v následujících podrobnostech.)
Nastavení připojovacího řetězce
Python 2.1.0 Vydání GitHubu:
Společné:
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
Fronty:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-queue
Deklarace instance služby
Ruby 1.0.1 Balíček RubyGems:
Společné:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Fronty: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tabulka: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

Vydání GitHubu:
Společné: 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
Fronty: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tabulka: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Nastavení připojovacího řetězce

Instalace klienta PHP přes Composer – aktuální

Instalace přes Composer: (jako příklad použijte objekt blob).

  1. V kořenovém adresáři projektu vytvořte soubor s názvem composer.json s následujícím kódem:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. Stáhněte soubor composer.phar do kořenového adresáře projektu.

  3. Spusťte php composer.phar install.

Deklarace koncového bodu

Koncový bod služby Azure Stack Hub zahrnuje dvě části: název oblasti a doménu služby Azure Stack Hub. Ve sadě Azure Stack Development Kit je výchozím koncovým bodem local.azurestack.external. Pokud si nejste jistí svým koncovým bodem, obraťte se na správce cloudu.

Příklady

.NET

V případě služby Azure Stack Hub je přípona koncového bodu zadaná v souboru app.config:

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

Java

Pro Azure Stack Hub je přípona koncového bodu určená v nastavení připojovací řetězec:

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

Node.js

Pro Azure Stack Hub je přípona koncového bodu určená v instanci deklarace:

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

C++

Pro Azure Stack Hub je přípona koncového bodu určená v nastavení připojovací řetězec:

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

PHP

Pro Azure Stack Hub je přípona koncového bodu určená v nastavení připojovací řetězec:

$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

Pro Azure Stack Hub je přípona koncového bodu určená v instanci deklarace:

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

Ruby

Pro Azure Stack Hub je přípona koncového bodu určená v nastavení připojovací řetězec:

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

Blob Storage

Následující kurzy služby Azure Blob Storage se týkají služby Azure Stack Hub. Všimněte si požadavku na konkrétní příponu koncového bodu pro službu Azure Stack Hub, který je popsaný v předchozí části Příklady .

Queue Storage

Následující kurzy služby Azure Queue Storage se týkají služby Azure Stack Hub. Všimněte si požadavku na konkrétní příponu koncového bodu pro službu Azure Stack Hub, který je popsaný v předchozí části Příklady .

Table Storage

Následující kurzy služby Azure Table Storage se týkají služby Azure Stack Hub. Všimněte si požadavku na konkrétní příponu koncového bodu pro službu Azure Stack Hub, který je popsaný v předchozí části Příklady .

Další kroky