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
.SÍŤ	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 Vydání na 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 Vydání na 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) Vydání na 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í na 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	Vydání na 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
Krajta	Objekt blob: 12.9.0 Fronta: 12.1.6	Vydání na GitHubu 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
rubín	1.0.1	Balíček RubyGems: Běž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 Vydání na 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

.SÍŤ

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

.SÍŤ

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ího řetězce.

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ího řetězce.

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ího řetězce.

$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>'

Krajta

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')

rubín

V případě služby Azure Stack Hub se přípona koncového bodu zadává v nastavení připojovacího řetězce.

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

Úložiště blobů

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 Azure Stack Hub popsaný 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

Úložiště front

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 Azure Stack Hub popsaný 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

Tabulkové úložiště

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 Azure Stack Hub popsaný 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