Azure Stack Hub depolama geliştirme araçlarını kullanmaya başlama

Microsoft Azure Stack Hub blob, tablo ve kuyruk depolamayı içeren bir depolama hizmetleri kümesi sağlar.

Azure Stack Hub depolama geliştirme araçlarını kullanmaya başlamak için bu makaleyi kılavuz olarak kullanın. Daha ayrıntılı bilgileri ve örnek kodu ilgili Azure depolama öğreticilerinde bulabilirsiniz.

Not

Her platform için belirli gereksinimler dahil olmak üzere Azure Stack Hub depolama alanı ile Azure depolama arasında farklar vardır. Örneğin, Azure Stack Hub için belirli istemci kitaplıkları ve uç nokta son eki gereksinimleri vardır. Daha fazla bilgi için bkz. Azure Stack Hub depolama: Farklılıklar ve dikkat edilmesi gerekenler.

Azure istemci kitaplıkları

Depolama istemci kitaplıkları için REST API ile uyumlu sürüme dikkat edin. Kodunuzda Azure Stack Hub uç noktasını da belirtmeniz gerekir.

2301 güncelleştirmesi ve daha yenisi

İstemci kitaplığı Azure Stack Hub desteklenen sürümü Bağlantı Uç nokta belirtimi
.NET Ortak: 12.9.0
Blob: 12.10.0
Sıra: 12.8.0
NuGet paketi:
Ortak: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
Sıra: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

GitHub sürümü:
Ortak: 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
Sıra: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
app.config dosyası
Java Ortak: 12.12.0
Blob: 12.14.3
Kuyruk: 12.11.3
Maven paketi:
Ortak: 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
Sıra: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3

GitHub sürümü:
Ortak: 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
Sıra: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.11.3/sdk/storage/azure-storage-queue
Bağlantı dizesi kurulumu
Node.js 2.8.3 NPM bağlantısı:
https://www.npmjs.com/package/azure-storage
(Çalıştır: npm install azure-storage@2.8.3)

GitHub sürümü:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Hizmet örneği bildirimi
C++ Blob: 12.2.0
Kuyruk: 12.0.0
GitHub sürümü:
Blob: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0
Sıra: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-queues_12.0.0
Bağlantı dizesi kurulumu
PHP 1.2.0 GitHub sürümü:
Ortak: 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
Sıra:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tablo: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Composer aracılığıyla yükleme (Daha fazla bilgi için aşağıdaki ayrıntılara bakın.)
Bağlantı dizesi kurulumu
Python Blob: 12.9.0
Sıra: 12.1.6
GitHub sürümü:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob
Sıra:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
Hizmet örneği bildirimi
Ruby 1.0.1 RubyGems paketi:
Ortak:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Sıra: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tablo: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub sürümü:
Ortak: 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
Sıra: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tablo: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Bağlantı dizesi kurulumu

Not

Jackson paketinin savunmasız bir sürümüne bağımlılıkları nedeniyle .NET ve Java istemci kitaplığının eski sürümünde yüksek önem derecesinde bir güvenlik açığı vardır. Güvenlik sorununu önlemek için .NET ve Java istemci kitaplığının desteklenen en son sürümünün kullanılması kesinlikle önerilir.

Php istemcisini Composer aracılığıyla yükleme - current

Composer aracılığıyla yüklemek için: (örnek olarak blobu alın).

  1. Aşağıdaki kodla projenin kökünde composer.json adlı bir dosya oluşturun:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. composer.phar dosyasını proje köküne indirin.

  3. Şunu çalıştırın: php composer.phar install.

API sürümünü belirtme

Yeni .NET istemci kitaplığını (Ortak: v12.9.0 / Blob: v12.10.0 / Kuyruk: v12.8.0) ve Java istemci kitaplığını (Ortak: v12.0) kullanmak için12.0 / Blob: v12.13.0 / Kuyruk: v12.10.0), her istemci sınıfında ( BlobServiceClient, BlobContainerClient, dahil) serviceVersion'ı açıkça belirtmeniz gerekir BlobClient, QueueServiceClient ve QueueClient), istemci sınıfındaki varsayılan sürüm şu anda Azure Stack Hub tarafından desteklenmediğinden.

Örnekler

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

2008 güncelleştirmesi ve daha yenisi

İstemci kitaplığı Azure Stack Hub desteklenen sürümü Bağlantı Uç nokta belirtimi
.NET Ortak: 12.9.0
Blob: 12.10.0
Kuyruk: 12.8.0
NuGet paketi:
Ortak: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
Sıra: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

GitHub sürümü:
Ortak: 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
Sıra: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
app.config dosyası
Java Ortak: 12.12.0
Blob: 12.13.0
Kuyruk: 12.10.0
Maven paketi:
Ortak: 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
Sıra: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.10.0

GitHub sürümü:
Ortak: 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
Sıra: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.10.0/sdk/storage/azure-storage-queue
Bağlantı dizesi kurulumu
Node.js 2.8.3 NPM bağlantısı:
https://www.npmjs.com/package/azure-storage
(Çalıştır: npm install azure-storage@2.8.3)

GitHub sürümü:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Hizmet örneği bildirimi
C++ 7.2.0 GitHub sürümü:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.2.0
Bağlantı dizesi kurulumu
PHP 1.2.0 GitHub sürümü:
Ortak: 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
Sıra:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tablo: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Composer aracılığıyla yükleme (Daha fazla bilgi edinmek için aşağıdaki ayrıntılara bakın.)
Bağlantı dizesi kurulumu
Python Blob: 12.3.1
Kuyruk: 12.1.6
GitHub sürümü:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.3.1/sdk/storage/azure-storage-blob
Sıra:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
Hizmet örneği bildirimi
Ruby 1.0.1 RubyGems paketi:
Ortak:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Sıra: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tablo: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub sürümü:
Ortak: 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
Sıra: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tablo: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Bağlantı dizesi kurulumu

Php istemcisini Composer aracılığıyla yükleme - geçerli

Composer aracılığıyla yüklemek için: (örnek olarak blobu alın).

  1. Aşağıdaki kodla projenin kökünde composer.json adlı bir dosya oluşturun:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. composer.phar dosyasını proje köküne indirin.

  3. Şunu çalıştırın: php composer.phar install.

API sürümünü belirtme

Yeni .NET istemci kitaplığını (Ortak: v12.9.0 / Blob: v12.10.0 / Kuyruk: v12.8.0) ve Java istemci kitaplığını (Ortak: v12.0) kullanmak için12.0 / Blob: v12.13.0 / Kuyruk: v12.10.0), her istemci sınıfında ( BlobServiceClient, BlobContainerClient dahil) serviceVersion'ı açıkça belirtmelisiniz. BlobClient, QueueServiceClient ve QueueClient), istemci sınıfındaki varsayılan sürüm şu anda Azure Stack Hub tarafından desteklenmediğinden.

Örnekler

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

2005 güncelleştirmesi

İstemci kitaplığı Azure Stack Hub desteklenen sürümü Bağlantı Uç nokta belirtimi
.NET 11.0.0 NuGet paketi:
Ortak: 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
Sıra:
https://www.nuget.org/packages/Microsoft.Azure.Storage.Queue/11.0.0

GitHub sürümü:
https://github.com/Azure/azure-storage-net/releases/tag/v11.0.0
app.config dosyası
Java 12.0.0-preview.3 Maven paketi:
https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.0.0-preview.3

GitHub sürümü:
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage
Bağlantı dizesi kurulumu
Node.js 2.8.3 NPM bağlantısı:
https://www.npmjs.com/package/azure-storage
(Çalıştır: npm install azure-storage@2.8.3)

GitHub sürümü:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Hizmet örneği bildirimi
C++ 7.1.0 GitHub sürümü:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.1.0
Bağlantı dizesi kurulumu
PHP 1.2.0 GitHub sürümü:
Ortak: 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
Sıra:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tablo: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Composer aracılığıyla yükleme (Daha fazla bilgi edinmek için aşağıdaki ayrıntılara bakın.)
Bağlantı dizesi kurulumu
Python 2.1.0 GitHub sürümü:
Ortak:
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
Sıra:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-queue
Hizmet örneği bildirimi
Ruby 1.0.1 RubyGems paketi:
Ortak:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Sıra: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tablo: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub sürümü:
Ortak: 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
Sıra: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tablo: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Bağlantı dizesi kurulumu

Php istemcisini Composer aracılığıyla yükleme - geçerli

Composer aracılığıyla yüklemek için: (örnek olarak blobu alın).

  1. Aşağıdaki kodla projenin kökünde composer.json adlı bir dosya oluşturun:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. composer.phar dosyasını proje köküne indirin.

  3. Şunu çalıştırın: php composer.phar install.

Uç nokta bildirimi

Azure Stack Hub uç noktası iki bölümden oluşur: bir bölgenin adı ve Azure Stack Hub etki alanı. Azure Stack Geliştirme Seti'nde varsayılan uç nokta local.azurestack.external'tır. Uç noktanızdan emin değilseniz bulut yöneticinize başvurun.

Örnekler

.NET

Azure Stack Hub için uç nokta son eki app.config dosyasında belirtilir:

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

Java

Azure Stack Hub için uç nokta son eki bağlantı dizesi kurulumunda belirtilir:

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

Node.js

Azure Stack Hub için, bildirim örneğinde uç nokta son eki belirtilir:

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

C++

Azure Stack Hub için uç nokta son eki bağlantı dizesi kurulumunda belirtilir:

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

PHP

Azure Stack Hub için uç nokta son eki bağlantı dizesi kurulumunda belirtilir:

$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

Azure Stack Hub için, bildirim örneğinde uç nokta son eki belirtilir:

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

Ruby

Azure Stack Hub için uç nokta son eki bağlantı dizesi kurulumunda belirtilir:

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

Blob depolama

Aşağıdaki Azure Blob depolama öğreticileri Azure Stack Hub için geçerlidir. Önceki Örnekler bölümünde açıklanan Azure Stack Hub için belirli uç nokta soneki gereksinimine dikkat edin.

Kuyruk depolama

Aşağıdaki Azure Kuyruk depolama öğreticileri Azure Stack Hub için geçerlidir. Önceki Örnekler bölümünde açıklanan Azure Stack Hub için belirli uç nokta soneki gereksinimine dikkat edin.

Tablo depolama

Aşağıdaki Azure Tablo depolama öğreticileri Azure Stack Hub için geçerlidir. Önceki Örnekler bölümünde açıklanan Azure Stack Hub için belirli uç nokta soneki gereksinimine dikkat edin.

Sonraki adımlar