Dela via


Kom igång med utvecklingsverktyg för Azure Stack Hub-lagring

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 utvecklingsverktyg för Azure Stack Hub-lagring. Mer detaljerad information och exempelkod finns i motsvarande Självstudier om Azure Storage.

Anteckning

Det finns skillnader mellan Azure Stack Hub-lagring och Azure Storage, inklusive specifika krav för varje plattform. Det finns till exempel specifika klientbibliotek och slutpunktssuffixkrav för Azure Stack Hub. Mer information finns i Azure Stack Hub-lagring: 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 Vanligt: 12.9.0
Blob: 12.10.0
Kö: 12.8.0
NuGet-paket:
Gemensamma: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: 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:
Gemensamma: 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
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 Vanligt: 12.12.0
Blob: 12.14.3
Kö: 12.11.3
Maven-paket:
Gemensamma: 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
Kö: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3

GitHub-version:
Gemensamma: 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
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
Deklaration av tjänstinstans
C++ Blob: 12.2.0
Kö: 12.0.0
GitHub-version:
Blob: 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:
Gemensamma: 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
Kö:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tabell: 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
Deklaration av tjänstinstans
Ruby 1.0.1 RubyGems-paket:
Gemensamma:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Kö: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tabell: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub-version:
Gemensamma: 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
Kö: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tabell: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Konfiguration av anslutningssträng

Anteckning

Det finns en säkerhetsrisk med 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 exempel).

  1. Skapa en fil med namnet composer.json i roten av projektet 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 (Vanligt: v12.9.0/Blob: v12.10.0/Queue: v12.8.0) och Java-klientbiblioteket (Vanligt: 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();

Uppdatering 2008 och senare

Klientbibliotek Version som stöds av Azure Stack Hub Länk Slutpunktsspecifikation
.NET Vanligt: 12.9.0
Blob: 12.10.0
Kö: 12.8.0
NuGet-paket:
Gemensamma: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: 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:
Gemensamma: 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
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 Vanligt: 12.12.0
Blob: 12.13.0
Kö: 12.10.0
Maven-paket:
Gemensamma: 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
Kö: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.10.0

GitHub-version:
Gemensamma: 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
Kö: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.10.0/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
Deklaration av tjänstinstans
C++ 7.2.0 GitHub-version:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.2.0
Konfiguration av anslutningssträng
PHP 1.2.0 GitHub-version:
Gemensamma: 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
Kö:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tabell: 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.3.1
Kö: 12.1.6
GitHub-version:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.3.1/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
Deklaration av tjänstinstans
Ruby 1.0.1 RubyGems-paket:
Gemensamma:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Kö: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tabell: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub-version:
Gemensamma: 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
Kö: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tabell: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Konfiguration av anslutningssträng

Installera PHP-klienten via Composer – aktuell

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

  1. Skapa en fil med namnet composer.json i roten av projektet 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 (Vanligt: v12.9.0/Blob: v12.10.0/Queue: v12.8.0) och Java-klientbiblioteket (Vanligt: 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();

Uppdatering 2005

Klientbibliotek Version som stöds av Azure Stack Hub Länk Slutpunktsspecifikation
.NET 11.0.0 NuGet-paket:
Gemensamma: 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
Kö:
https://www.nuget.org/packages/Microsoft.Azure.Storage.Queue/11.0.0

GitHub-version:
https://github.com/Azure/azure-storage-net/releases/tag/v11.0.0
app.config fil
Java 12.0.0-preview.3 Maven-paket:
https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.0.0-preview.3

GitHub-version:
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage
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++ 7.1.0 GitHub-version:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.1.0
Konfiguration av anslutningssträng
PHP 1.2.0 GitHub-version:
Gemensamma: 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
Kö:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tabell: 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 2.1.0 GitHub-version:
Gemensamma:
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
Kö:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-queue
Tjänstinstansdeklaration
Ruby 1.0.1 RubyGems-paket:
Gemensamma:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Kö: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tabell: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub-version:
Gemensamma: 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
Kö: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tabell: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Konfiguration av anslutningssträng

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.

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

Blob Storage

Följande Azure Blob Storage-självstudier gäller för Azure Stack Hub. Observera kravet på specifikt slutpunktssuffix för Azure Stack Hub som beskrivs i föregående exempelavsnitt .

Queue Storage

Följande Azure Queue Storage-självstudier gäller för Azure Stack Hub. Observera kravet på specifikt slutpunktssuffix för Azure Stack Hub som beskrivs i föregående exempelavsnitt .

Table Storage

Följande Självstudier för Azure Table Storage gäller för Azure Stack Hub. Observera kravet på specifikt slutpunktssuffix för Azure Stack Hub som beskrivs i föregående exempelavsnitt .

Nästa steg