Bagikan melalui


Memulai dengan alat pengembangan penyimpanan Azure Stack Hub

Microsoft Azure Stack Hub menyediakan satu set layanan penyimpanan yang mencakup blob, tabel, dan penyimpanan antrean.

Gunakan artikel ini sebagai panduan untuk memulai menggunakan alat pengembangan penyimpanan Azure Stack Hub. Anda dapat menemukan informasi dan kode sampel selengkapnya dalam tutorial penyimpanan Azure yang sesuai.

Catatan

Terdapat perbedaan antara penyimpanan Azure Stack Hub dan penyimpanan Azure, termasuk persyaratan khusus untuk tiap-tiap platform. Misalnya, terdapat pustaka klien tertentu dan persyaratan akhiran titik akhir untuk Azure Stack Hub. Untuk informasi selengkapnya, lihat Penyimpanan Azure Stack Hub: Perbedaan dan pertimbangan.

Pustaka klien Azure

Untuk pustaka klien penyimpanan, ketahui versi yang kompatibel dengan REST API. Anda juga harus menentukan titik akhir Azure Stack Hub dalam kode Anda.

Pembaruan 2301 dan yang lebih baru

Pustaka klien Versi yang didukung Azure Stack Hub Tautan Spesifikasi titik akhir
.NET Umum: 12.9.0
Blob: 12.10.0
Antrean: 12.8.0
Paket NuGet:
Umum: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
Antrean: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

Rilis GitHub:
Umum: 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
Antrean: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
file config aplikasi
Java Umum: 12.12.0
Blob: 12.14.3
Antrean: 12.11.3
Paket Maven:
Umum: 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
Antrean: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3

Rilis GitHub:
Umum: 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
Antrean: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.11.3/sdk/storage/azure-storage-queue
Penyiapan string koneksi
Node.js 2.8.3 Tautan NPM:
https://www.npmjs.com/package/azure-storage
(Jalankan: npm install azure-storage@2.8.3)

Rilis GitHub:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Deklarasi instans layanan
C++ Blob: 12.2.0
Antrean: 12.0.0
Rilis GitHub:
Blob: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0
Antrean: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-queues_12.0.0
Penyiapan string koneksi
PHP 1.2.0 Rilis GitHub:
Umum: 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
Antrean:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tabel: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Instal melalui Composer (Untuk mempelajari selengkapnya, lihat detail di bawah ini.)
Penyiapan string koneksi
Python Blob: 12.9.0
Antrean: 12.1.6
Rilis GitHub:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob
Antrean:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
Deklarasi instans layanan
Ruby 1.0.1 Paket RubyGems:
Umum:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Antrean: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tabel: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

Rilis GitHub:
Umum: 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
Antrean: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tabel: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Penyiapan string koneksi

Catatan

Terdapat kerentanan dengan keparahan tinggi di versi lama .NET dan pustaka klien Java, karena dependensi pada versi rentan paket Jackson. Sangat disarankan Anda menggunakan versi terbaru yang didukung untuk pustaka klien .NET dan Java guna menghindari masalah keamanan.

Pasang klien PHP melalui Composer - saat ini

Untuk menginstal melalui Composer: (ambil blob sebagai contoh).

  1. Buat file bernama composer.json di akar proyek dengan kode berikut:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. Unduh composer.phar ke akar proyek tersebut.

  3. Jalankan: php composer.phar install.

Menentukan versi API

Untuk menggunakan pustaka klien .NET baru (Umum: v12.9.0 / Blob: v12.10.0 / Antrean: v12.8.0) dan pustaka klien Java (Umum: v12.12.0 / Blob: v12.13.0 / Antrean: v12.10.0), Anda harus secara eksplisit menentukan serviceVersion di setiap kelas klien (termasuk BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient, dan QueueClient), karena versi default di kelas klien saat ini tidak didukung oleh Azure Stack Hub.

Contoh

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

Pembaruan 2008 dan versi yang lebih baru

Pustaka klien Versi yang didukung Azure Stack Hub Tautan Spesifikasi titik akhir
.NET Umum: 12.9.0
Blob: 12.10.0
Antrean: 12.8.0
Paket NuGet:
Umum: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
Antrean: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

Rilis GitHub:
Umum: 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
Antrean: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
file config aplikasi
Java Umum: 12.12.0
Blob: 12.13.0
Antrean: 12.10.0
Paket Maven:
Umum: 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
Antrean: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.10.0

Rilis GitHub:
Umum: 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
Antrean: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.10.0/sdk/storage/azure-storage-queue
Penyiapan string koneksi
Node.js 2.8.3 Tautan NPM:
https://www.npmjs.com/package/azure-storage
(Jalankan: npm install azure-storage@2.8.3)

Rilis GitHub:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Deklarasi instans layanan
C++ 7.2.0 Rilis GitHub:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.2.0
Penyiapan string koneksi
PHP 1.2.0 Rilis GitHub:
Umum: 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
Antrean:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tabel: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Instal melalui Composer (Untuk mempelajari selengkapnya, lihat detail di bawah ini.)
Penyiapan string koneksi
Python Blob: 12.3.1
Antrean: 12.1.6
Rilis GitHub:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.3.1/sdk/storage/azure-storage-blob
Antrean:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
Deklarasi instans layanan
Ruby 1.0.1 Paket RubyGems:
Umum:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Antrean: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tabel: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

Rilis GitHub:
Umum: 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
Antrean: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tabel: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Penyiapan string koneksi

Pasang klien PHP melalui Composer - saat ini

Untuk menginstal melalui Composer: (ambil blob sebagai contoh).

  1. Buat file bernama composer.json di akar proyek dengan kode berikut:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. Unduh composer.phar ke akar proyek tersebut.

  3. Jalankan: php composer.phar install.

Menentukan versi API

Untuk menggunakan pustaka klien .NET baru (Umum: v12.9.0 / Blob: v12.10.0 / Antrean: v12.8.0) dan pustaka klien Java (Umum: v12.12.0 / Blob: v12.13.0 / Antrean: v12.10.0), Anda harus secara eksplisit menentukan serviceVersion di setiap kelas klien (termasuk BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient, dan QueueClient), karena versi default di kelas klien saat ini tidak didukung oleh Azure Stack Hub.

Contoh

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

Pembaruan 2005

Pustaka klien Versi yang didukung Azure Stack Hub Tautan Spesifikasi titik akhir
.NET 11.0.0 Paket NuGet:
Umum: 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
Antrean:
https://www.nuget.org/packages/Microsoft.Azure.Storage.Queue/11.0.0

Rilis GitHub:
https://github.com/Azure/azure-storage-net/releases/tag/v11.0.0
file config aplikasi
Java 12.0.0-pratinjau.3 Paket Maven:
https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.0.0-preview.3

Rilis GitHub:
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage
Penyiapan string koneksi
Node.js 2.8.3 Tautan NPM:
https://www.npmjs.com/package/azure-storage
(Jalankan: npm install azure-storage@2.8.3)

Rilis GitHub:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
Deklarasi instans layanan
C++ 7.1.0 Rilis GitHub:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.1.0
Penyiapan string koneksi
PHP 1.2.0 Rilis GitHub:
Umum: 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
Antrean:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
Tabel: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Instal melalui Composer (Untuk mempelajari selengkapnya, lihat detail di bawah ini.)
Penyiapan string koneksi
Python 2.1.0 Rilis GitHub:
Umum:
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
Antrean:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-queue
Deklarasi instans layanan
Ruby 1.0.1 Paket RubyGems:
Umum:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
Antrean: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
Tabel: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

Rilis GitHub:
Umum: 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
Antrean: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
Tabel: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
Penyiapan string koneksi

Pasang klien PHP melalui Composer - saat ini

Untuk menginstal melalui Composer: (ambil blob sebagai contoh).

  1. Buat file bernama composer.json di akar proyek dengan kode berikut:

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. Unduh composer.phar ke akar proyek tersebut.

  3. Jalankan: php composer.phar install.

Deklarasi titik akhir

Titik akhir Azure Stack Hub mencakup dua bagian: nama wilayah dan domain Azure Stack Hub. Di Azure Stack Development Kit, titik akhir default adalah local.azurestack.external. Hubungi admin cloud jika Anda tidak yakin tentang titik akhir Anda.

Contoh

.NET

Untuk Azure Stack Hub, akhiran titik akhir ditentukan di file app.config:

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

Java

Untuk Azure Stack Hub, akhiran titik akhir ditentukan di penyiapan string koneksi:

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

Node.js

Untuk Azure Stack Hub, akhiran titik akhir ditentukan di instans deklarasi:

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

C++

Untuk Azure Stack Hub, akhiran titik akhir ditentukan di penyiapan string koneksi:

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

PHP

Untuk Azure Stack Hub, akhiran titik akhir ditentukan di penyiapan string koneksi:

$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

Untuk Azure Stack Hub, akhiran titik akhir ditentukan di instans deklarasi:

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

Ruby

Untuk Azure Stack Hub, akhiran titik akhir ditentukan di penyiapan string koneksi:

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

Penyimpanan Blob

Tutorial Azure Blob Storage berikut ini berlaku untuk Azure Stack Hub. Perhatikan persyaratan akhiran titik akhir tertentu untuk Azure Stack Hub yang dijelaskan di bagian Contoh sebelumnya.

Antrean Penyimpanan

Tutorial Azure Queue Storage berikut ini berlaku untuk Azure Stack Hub. Perhatikan persyaratan akhiran titik akhir tertentu untuk Azure Stack Hub yang dijelaskan di bagian Contoh sebelumnya.

Penyimpanan tabel

Tutorial Azure Table Storage berikut ini berlaku untuk Azure Stack Hub. Perhatikan persyaratan akhiran titik akhir tertentu untuk Azure Stack Hub yang dijelaskan di bagian Contoh sebelumnya.

Langkah berikutnya