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

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.

• Memulai penyimpanan Blob Azure menggunakan .NET
• Cara menggunakan Blob Storage dari Java
• Cara menggunakan Blob Storage dari Node.js
• Cara menggunakan penyimpanan Blob dari C ++
• Cara menggunakan Blob Storage dari PHP
• Cara menggunakan Blob Storage dari Python
• Cara menggunakan Blob Storage dari Ruby

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.

• Memulai Azure Queue Storage menggunakan .NET
• Cara menggunakan Azure Queue Storage dari Java
• Cara menggunakan penyimpanan Antrean dari Node.js
• Cara menggunakan Queue Storage dari C ++
• Cara menggunakan Queue Storage dari PHP
• Cara menggunakan Queue Storage dari Python
• Cara menggunakan Queue Storage dari Ruby

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.

• Memulai Azure Table Storage menggunakan .NET
• Cara menggunakan Table Storage dari Java
• Cara menggunakan penyimpanan Azure Table dari Node.js
• Cara menggunakan Table Storage dari C++
• Cara menggunakan Table Storage dari PHP
• Cara menggunakan Table Storage dari Python
• Cara menggunakan Table Storage dari Ruby

Langkah berikutnya

• Pengantar Microsoft Azure Storage