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

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

Tento článek vám pomůže začít používat vývojové nástroje pro úložiště služby Azure Stack Hub. Podrobnější informace a vzorový kód najdete v odpovídajících kurzech služby Azure Storage.

Poznámka:

Mezi úložištěm služby Azure Stack Hub a úložištěm Azure existují rozdíly, včetně konkrétních požadavků pro každou platformu. Existují například konkrétní klientské knihovny a požadavky na příponu koncového bodu pro 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	Společ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 Kapka: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0 Fronta: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0 Verze GitHubu: Společný: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.9.0/sdk/storage/Azure.Storage.Common Kapka: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.10.0/sdk/storage/Azure.Storage.Blobs Fronta: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues	soubor app.config
Java	Společ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 Kapka: https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.14.3 Fronta: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3 Verze GitHubu: Společný: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-common_12.12.0/sdk/storage/azure-storage-common Kapka: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-blob_12.14.3/sdk/storage/azure-storage-blob Fronta: 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) Verze 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	Verze GitHubu: Kapka: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0 Fronta: 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	Verze GitHubu: Společný: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-common Kapka: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-blob Fronta: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue Stůl: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table Instalace prostřednictvím nástroje Composer (Další informace najdete níže v podrobnostech.)	Nastavení připojovacího řetězce
Python	Objekt blob: 12.9.0 Fronta: 12.1.6	Verze GitHubu: Objekt blob: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob Fronta: 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 Kapka: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1 Fronta: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1 Stůl: https://rubygems.org/gems/azure-storage-table/versions/1.0.1 Verze GitHubu: Společný: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-common Kapka: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-blob Fronta: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue Stůl: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table	Nastavení připojovacího řetězce

Poznámka:

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

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

Instalace prostřednictvím nástroje Composer: (jako příklad vezměte 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. Spustit: php composer.phar install.

Určení verze rozhraní API

Pokud chcete použít novou klientskou knihovnu .NET (Common: v12.9.0 / Blob: v12.10.0 / Queue: v12.8.0) a klientskou knihovnu Java (Common: v12.12.0 / Blob: v12.13.0 / Queue: v12.10.0), musíte explicitně zadat serviceVersion v každé klientské třídě (včetně BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient a QueueClient), protože azure Stack Hub v současné době nepodporuje výchozí verzi klientské třídy.

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

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 vývojové sadě Azure Stack je výchozím koncovým bodem local.azurestack.external. Pokud si nejste jisti koncovým bodem, obraťte se na správce cloudu.

Příklady

.NET

Pro Azure Stack Hub se přípona koncového bodu zadává v souboru app.config:

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

Java

V případě služby Azure Stack Hub se přípona koncového bodu zadává 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

V případě služby Azure Stack Hub se přípona koncového bodu zadává v instanci deklarace:

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

C++

V případě služby Azure Stack Hub se přípona koncového bodu zadává 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

V případě služby Azure Stack Hub se přípona koncového bodu zadává 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

V případě služby Azure Stack Hub se přípona koncového bodu zadává v instanci deklarace:

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

Ruby

V případě služby Azure Stack Hub se přípona koncového bodu zadává 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 vztahují ke službě Azure Stack Hub. Všimněte si konkrétního požadavku na příponu koncového bodu pro službu Azure Stack Hub popsanou v předchozí části Příklady .

• Začínáme s úložištěm Azure Blob pomocí rozhraní .NET
• Používání úložiště Blob z Javy
• Používání úložiště Blob z Node.js
• Jak používat úložiště objektů blob z C++
• Používání úložiště Blob z PHP
• Jak používat Azure Blob Storage z Pythonu
• Používání úložiště Blob z Ruby

Queue Storage

Následující kurzy ke službě Azure Queue Storage se vztahují ke službě Azure Stack Hub. Všimněte si konkrétního požadavku na příponu koncového bodu pro službu Azure Stack Hub popsanou v předchozí části Příklady .

• Začínáme s úložištěm Azure Queue pomocí rozhraní .NET
• Používání úložiště Queue z Javy
• Používání úložiště Queue z Node.js
• Jak používat Queue Storage z C++
• Používání úložiště Queue z PHP
• Používání úložiště Queue z Pythonu
• Používání úložiště Queue z Ruby

Table Storage

Následující kurzy ke službě Azure Table Storage se vztahují ke službě Azure Stack Hub. Všimněte si konkrétního požadavku na příponu koncového bodu pro službu Azure Stack Hub popsanou v předchozí části Příklady .

• Začínáme s úložištěm Azure Table pomocí rozhraní .NET
• Používání úložiště Table z Javy
• Používání tabulkového úložiště Azure z Node.js
• Použití služby Table Storage z C++
• Používání úložiště Table z PHP
• Jak používat table storage v Pythonu
• Používání úložiště Table z Ruby

Další kroky

• Úvod do úložiště Microsoft Azure