Kom igång med Azure Stack Hub-lagringsutvecklingsverktyg

Microsoft Azure Stack Hub tillhandahåller en uppsättning lagringstjänster som innehåller blob, tabell och kölagring.

Använd den här artikeln som en guide för att komma igång med azure Stack Hub-lagringsutvecklingsverktyg. Du hittar mer detaljerad information och exempelkod i motsvarande Azure Storage-självstudier.

Kommentar

Det finns skillnader mellan Azure Stack Hub Storage och Azure Storage, inklusive specifika krav för varje plattform. Det finns till exempel specifika krav för klientbibliotek och slutpunktssuffix för Azure Stack Hub. Mer information finns i Azure Stack Hub Storage: Skillnader och överväganden.

Azure-klientbibliotek

För lagringsklientbiblioteken bör du vara medveten om den version som är kompatibel med REST-API:et. Du måste också ange Azure Stack Hub-slutpunkten i koden.

Uppdatering 2301 och senare

Klientbibliotek	Version som stöds av Azure Stack Hub	Länk	Slutpunktsspecifikation
.NET	Vanliga: 12.9.0 Blob: 12.10.0 Kö: 12.8.0	NuGet-paket: Gemensam: https://www.nuget.org/packages/Azure.Storage.common/12.9.0 Klick: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0 Kö: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0 GitHub-version: Gemensam: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.9.0/sdk/storage/Azure.Storage.Common Klick: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.10.0/sdk/storage/Azure.Storage.Blobs Kö: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues	app.config-fil
Java	Vanliga: 12.12.0 Blob: 12.14.3 Kö: 12.11.3	Maven-paket: Gemensam: https://mvnrepository.com/artifact/com.azure/azure-storage-common/12.12.0 Klick: https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.14.3 Kö: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3 GitHub-version: Gemensam: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-common_12.12.0/sdk/storage/azure-storage-common Klick: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-blob_12.14.3/sdk/storage/azure-storage-blob Kö: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.11.3/sdk/storage/azure-storage-queue	Konfiguration av anslutningssträng
Node.js	2.8.3	NPM-länk: https://www.npmjs.com/package/azure-storage (Kör: npm install azure-storage@2.8.3) GitHub-version: https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3	Tjänstinstansdeklaration
C++	Blob: 12.2.0 Kö: 12.0.0	GitHub-version: Klick: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0 Kö: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-queues_12.0.0	Konfiguration av anslutningssträng
PHP	1.2.0	GitHub-version: Gemensam: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-common Klick: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-blob Kö: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue Bord: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table Installera via Composer (Mer information finns i informationen nedan.)	Konfiguration av anslutningssträng
Python	Blob: 12.9.0 Kö: 12.1.6	GitHub-version: Blob: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob Kö: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue	Tjänstinstansdeklaration
Ruby	1.0.1	RubyGems-paket: Gemensam: https://rubygems.org/gems/azure-storage-common/versions/1.0.1 Klick: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1 Kö: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1 Bord: https://rubygems.org/gems/azure-storage-table/versions/1.0.1 GitHub-version: Gemensam: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-common Klick: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-blob Kö: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue Bord: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table	Konfiguration av anslutningssträng

Kommentar

Det finns en hög allvarlighetsgrad i den gamla versionen av .NET- och Java-klientbiblioteket på grund av beroendena för en sårbar version av Jackson-paketet. Vi rekommenderar starkt att du använder den senaste versionen av .NET- och Java-klientbiblioteket som stöds för att undvika säkerhetsproblem.

Installera PHP-klienten via Composer – aktuell

Så här installerar du via Composer: (ta bloben som ett exempel).

1. Skapa en fil med namnet composer.json i projektets rot med följande kod:

   {
     "require": {
     "Microsoft/azure-storage-blob":"1.2.0"
     }
   }
   

2. Ladda ned composer.phar till projektroten.

3. Kör: php composer.phar install.

Ange API-version

Så här använder du det nya .NET-klientbiblioteket (Common: v12.9.0 /Blob: v12.10.0/Queue: v12.8.0) och Java-klientbiblioteket (Common: v12.0) 12.0 /Blob: v12.13.0 /Queue: v12.10.0) måste du uttryckligen ange serviceVersion i varje klientklass (inklusive BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient och QueueClient), eftersom standardversionen i klientklassen för närvarande inte stöds av Azure Stack Hub.

Exempel

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

Slutpunktsdeklaration

En Azure Stack Hub-slutpunkt innehåller två delar: namnet på en region och Azure Stack Hub-domänen. I Azure Stack Development Kit är standardslutpunkten local.azurestack.external. Kontakta molnadministratören om du inte är säker på slutpunkten.

Exempel

.NET

För Azure Stack Hub anges slutpunktssuffixet i filen app.config:

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

Java

För Azure Stack Hub anges slutpunktssuffixet i konfigurationen av anslutningssträng:

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

Node.js

För Azure Stack Hub anges slutpunktssuffixet i deklarationsinstansen:

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

C++

För Azure Stack Hub anges slutpunktssuffixet i konfigurationen av anslutningssträng:

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

PHP

För Azure Stack Hub anges slutpunktssuffixet i konfigurationen av anslutningssträng:

$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

För Azure Stack Hub anges slutpunktssuffixet i deklarationsinstansen:

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

Ruby

För Azure Stack Hub anges slutpunktssuffixet i konfigurationen av anslutningssträng:

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

Blobb-lagring

Följande Azure Blob Storage-självstudier gäller för Azure Stack Hub. Observera det specifika suffixkravet för slutpunkt för Azure Stack Hub som beskrivs i föregående exempelavsnitt .

• Komma igång med Azure Blob Storage med hjälp av .NET
• Använda Blob Storage från Java
• Använda Blob Storage från Node.js
• Så här använder du Blob Storage från C++
• Använda Blob Storage från PHP
• Använda Azure Blob Storage från Python
• Använda Blob Storage från Ruby

Queue Storage

Följande Azure Queue Storage-självstudier gäller för Azure Stack Hub. Observera det specifika suffixkravet för slutpunkt för Azure Stack Hub som beskrivs i föregående exempelavsnitt .

• Komma igång med Azure Queue Storage med hjälp av .NET
• Använda Queue Storage från Java
• Använda Queue Storage från Node.js
• Så här använder du Queue Storage från C++
• Använda Queue Storage från PHP
• Använda Queue Storage från Python
• Använda Queue Storage från Ruby

Table Storage

Följande självstudier för Azure Table Storage gäller för Azure Stack Hub. Observera det specifika suffixkravet för slutpunkt för Azure Stack Hub som beskrivs i föregående exempelavsnitt .

• Komma igång med Azure Table Storage med hjälp av .NET
• Använda Table Storage från Java
• Använda Azure Table Storage från Node.js
• Så här använder du Table Storage från C++
• Använda Table Storage från PHP
• Så här använder du Table Storage i Python
• Använda Table Storage från Ruby

Nästa steg

• Introduktion till Microsoft Azure Storage