Azure Stack Hub ストレージの開発ツールの概要
Microsoft Azure Stack Hub には、Blob Storage、Table Storage、Queue Storage など一連のストレージ サービスがあります。
この記事は、Azure Stack Hub ストレージの開発ツールを初めて使うときのガイドとしてご利用ください。 より詳細な情報とサンプル コードについては、該当する Azure ストレージのチュートリアルでご覧いただけます。
Note
Azure Stack Hub ストレージと Azure ストレージには、プラットフォームごとの固有の要件などの違いがあります。 たとえば、Azure Stack Hub には、クライアント ライブラリとエンドポイント サフィックスの特定の要件があります。 詳しくは、「Azure Stack Hub ストレージ:違いと考慮事項」をご覧ください。
Azure のクライアント ライブラリ
したがって、ストレージのクライアント ライブラリについて、REST API と互換性のあるバージョンを把握しておいてください。 また、コード内で Azure Stack Hub エンドポイントも指定する必要があります。
2301 以降の更新プログラム
Note
以前のバージョンの .NET および Java クライアント ライブラリには、脆弱なバージョンの Jackson パッケージへの依存関係があるため、重大度の高い脆弱性があります。 セキュリティの問題を回避するために、サポートされている最新バージョンの .NET および Java クライアント ライブラリを使用することを強くお勧めします。
Composer 経由で PHP クライアントをインストールする (現在)
Composer 経由でインストールするには (BLOB の例):
プロジェクトのルートに composer.json という名前のファイルを次のコードを使用して作成します。
{ "require": { "Microsoft/azure-storage-blob":"1.2.0" } }
composer.phar をプロジェクトのルートにダウンロードします。
php composer.phar install
を実行します。
API のバージョンを指定する
新しい .NET クライアント ライブラリ (共通: v12.9.0、BLOB: v12.10.0、キュー: v12.8.0) と Java クライアント ライブラリ (共通: v12.12.0、BLOB: v12.13.0、キュー: v12.10.0) を使用するには、クライアント クラスの既定のバージョンは現在 Azure Stack Hub でサポートされていないため、各クライアント クラス (BlobServiceClient、BlobContainerClient、BlobClient、QueueServiceClient、QueueClient を含む) で serviceVersion を明示的に指定する必要があります。
例
.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 以降の更新プログラム
Composer 経由で PHP クライアントをインストールする (現在)
Composer 経由でインストールするには (BLOB の例):
プロジェクトのルートに composer.json という名前のファイルを次のコードを使用して作成します。
{ "require": { "Microsoft/azure-storage-blob":"1.2.0" } }
composer.phar をプロジェクトのルートにダウンロードします。
php composer.phar install
を実行します。
API のバージョンを指定する
新しい .NET クライアント ライブラリ (共通: v12.9.0、BLOB: v12.10.0、キュー: v12.8.0) と Java クライアント ライブラリ (共通: v12.12.0、BLOB: v12.13.0、キュー: v12.10.0) を使用するには、クライアント クラスの既定のバージョンは現在 Azure Stack Hub でサポートされていないため、各クライアント クラス (BlobServiceClient、BlobContainerClient、BlobClient、QueueServiceClient、QueueClient を含む) で serviceVersion を明示的に指定する必要があります。
例
.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
Composer 経由で PHP クライアントをインストールする (現在)
Composer 経由でインストールするには (BLOB の例):
プロジェクトのルートに composer.json という名前のファイルを次のコードを使用して作成します。
{ "require": { "Microsoft/azure-storage-blob":"1.2.0" } }
composer.phar をプロジェクトのルートにダウンロードします。
php composer.phar install
を実行します。
エンドポイントの宣言
Azure Stack Hub のエンドポイントには、リージョン名と Azure Stack Hub ドメインの 2 つの部分があります。 Azure Stack Development Kit の既定のエンドポイントは local.azurestack.external です。 エンドポイントが不明の場合は、クラウド管理者に問い合わせてください。
例
.NET
Azure Stack Hub のエンドポイントのサフィックスは、app.config ファイルに指定されています。
<add key="StorageConnectionString"
value="DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=mykey;
EndpointSuffix=local.azurestack.external;" />
Java
Azure Stack Hub のエンドポイントのサフィックスは、接続文字列の設定に指定されています。
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 のエンドポイントのサフィックスは、宣言のインスタンスに指定されています。
var blobSvc = azure.createBlobService('myaccount', 'mykey',
'myaccount.blob.local.azurestack.external');
C++
Azure Stack Hub のエンドポイントのサフィックスは、接続文字列の設定に指定されています。
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 のエンドポイントのサフィックスは、接続文字列の設定に指定されています。
$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 のエンドポイントのサフィックスは、宣言のインスタンスに指定されています。
block_blob_service = BlockBlobService(account_name='myaccount',
account_key='mykey',
endpoint_suffix='local.azurestack.external')
Ruby
Azure Stack Hub のエンドポイントのサフィックスは、接続文字列の設定に指定されています。
set
AZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;
AccountName=myaccount;
AccountKey=mykey;
EndpointSuffix=local.azurestack.external
BLOB ストレージ
Azure Stack Hub に、次の Azure Blob ストレージのチュートリアルを応用できます。 Azure Stack Hub のエンドポイントのサフィックスの具体的な要件については、前の例のセクションを参照してください。
- .NET を使用して Azure Blob Storage を使用する
- Java から BLOB ストレージを使用する方法
- Node.js から BLOB ストレージを使用する方法
- C++ から BLOB ストレージを使用する方法
- PHP から BLOB ストレージを使用する方法
- Python から Azure BLOB ストレージを使用する方法
- Ruby から BLOB ストレージを使用する方法
ストレージ
Azure Stack Hub に、次の Azure Queue storage のチュートリアルを応用できます。 Azure Stack Hub のエンドポイントのサフィックスの具体的な要件については、前の例のセクションを参照してください。
- .NET を使用して Azure Queue Storage を使用する
- Java から Queue ストレージを使用する方法
- Node.js から Queue ストレージを使用する方法
- C++ から Queue ストレージを使用する方法
- PHP から Queue ストレージを使用する方法
- Python から Queue ストレージを使用する方法
- Ruby から Queue ストレージを使用する方法
テーブル ストレージ
Azure Stack Hub に、次の Azure Table storage のチュートリアルを応用できます Azure Stack Hub のエンドポイントのサフィックスの具体的な要件については、前の例のセクションを参照してください。
- .NET を使用して Azure Table Storage を使用する
- Java からテーブル ストレージを使用する方法
- Node.js から Azure Table Storage を使用する方法
- C++ から Table ストレージを使用する方法
- PHP から Table ストレージを使用する方法
- Python で Table Storage を使用する方法
- Ruby から Table ストレージを使用する方法