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

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 .

• 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 jazyka 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 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 .

• Začínáme se službou Azure Queue Storage s využitím .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 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 .

• 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
• Jak používat 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