Microsoft Azure Stack Hub には、Blob Storage、Table Storage、Queue Storage など一連のストレージ サービスがあります。
この記事は、Azure Stack Hub ストレージの開発ツールを初めて使うときのガイドとしてご利用ください。 より詳細な情報とサンプル コードについては、該当する Azure ストレージのチュートリアルでご覧いただけます。
注
Azure Stack Hub ストレージと Azure ストレージには、プラットフォームごとの固有の要件などの違いがあります。 たとえば、Azure Stack Hub には、クライアント ライブラリとエンドポイント サフィックスの特定の要件があります。 詳しくは、「Azure Stack Hub ストレージ:違いと考慮事項」をご覧ください。
Azure のクライアント ライブラリ
したがって、ストレージのクライアント ライブラリについて、REST API と互換性のあるバージョンを把握しておいてください。 また、コード内で Azure Stack Hub エンドポイントも指定する必要があります。
2301 以降の更新プログラム
注
以前のバージョンの .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 を明示的に指定する必要があります。
例
。網
BlobClientOptions options = new BlobClientOptions(BlobClientOptions.ServiceVersion.V2019_07_07);
BlobServiceClient client = new BlobServiceClient("<connection_string>", options);
ジャワ
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 を明示的に指定する必要があります。
例
。網
BlobClientOptions options = new BlobClientOptions(BlobClientOptions.ServiceVersion.V2019_07_07);
BlobServiceClient client = new BlobServiceClient("<connection_string>", options);
ジャワ
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 です。 エンドポイントが不明の場合は、クラウド管理者に問い合わせてください。
例
。網
Azure Stack Hub のエンドポイントのサフィックスは、app.config ファイルに指定されています。
<add key="StorageConnectionString"
value="DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=mykey;
EndpointSuffix=local.azurestack.external;" />
ジャワ
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')
ルビー
Azure Stack Hub のエンドポイントのサフィックスは、接続文字列の設定に指定されています。
set
AZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;
AccountName=myaccount;
AccountKey=mykey;
EndpointSuffix=local.azurestack.external
Blob Storage
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 ストレージを使用する方法
Queue Storage
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 ストレージを使用する方法