Azure Blob Storage REST API
Azure Blob Storageは、テキストデータとバイナリデータをオブジェクトとしてクラウドに格納します。 Blob Storage には、ストレージ アカウント、コンテナー、BLOB というリソースが用意されています。 ストレージ アカウント内では、コンテナーは一連の BLOB を整理するための手段となります。
テキストおよびバイナリ データは、次の BLOB の種類のどちらかに格納できます。
ブロック BLOB。この BLOB はストリーミング用に最適化されています。
追加操作用に最適化された追加 BLOB。
ランダムな読み取り/書き込み操作用に最適化され、BLOB 内のバイト範囲に書き込む機能を提供するページ BLOB。
詳細については、「ブロック BLOB、追加 BLOB、ページ BLOB について」を参照してください。
BLOB ストレージ用の REST API では、ストレージ アカウント、コンテナー、BLOB に対する HTTP 操作が定義されています。 API には、次の表で示す操作が含まれます。
| 操作 | リソースの種類 | 説明 |
|---|---|---|
| コンテナーの一覧表示 | Account | ストレージ アカウント内のすべてのコンテナーを一覧表示します。 |
| Blob Storage のプロパティを設定する | Account | ログとメトリックの設定、既定のサービス バージョンなど、Blob Storage のプロパティを設定します。 |
| Blob Storage のプロパティを取得する | Account | ログ記録とメトリックの設定、既定のサービス バージョンなど、Blob Storage のプロパティを取得します。 |
| プレフライト BLOB 要求 | Account | 実際の要求を送信する前に、Blob Storage のクロスオリジン リソース共有 (CORS) 規則を照会します。 |
| Blob Storage の統計を取得する | Account | Blob Storage のレプリケーションに関連する統計を取得します。 読み取りアクセスの地理冗長レプリケーションがストレージ アカウントで有効なとき、この操作は 2 次拠点のエンドポイントでのみ使用できます。 |
| アカウント情報を取得する | Account | 指定したアカウントの SKU 名とアカウントの種類を返します。 |
| ユーザー委任キーを取得する | Account | ユーザー委任の共有アクセス署名に署名するために使用できるキーを取得します。 この署名は、Microsoft Entra資格情報を使用して Blob Storage 内のリソースへのアクセスを許可します。 |
| コンテナーの作成 | コンテナー | ストレージ アカウントに新しいコンテナーを作成します。 |
| コンテナーのプロパティの取得 | コンテナー | コンテナーのすべてのユーザー定義メタデータとシステム プロパティを返します。 |
| Get Container Metadata | コンテナー | コンテナーのユーザー定義メタデータのみを返します。 |
| コンテナー メタデータを設定する | コンテナー | コンテナーのユーザー定義メタデータを設定します。 |
| コンテナー ACL の取得 | コンテナー | コンテナーのパブリック アクセス ポリシーと保存されているアクセス ポリシーを取得します。 |
| コンテナー ACL の設定 | コンテナー | コンテナーのパブリック アクセス ポリシーと保存されているアクセス ポリシーを設定します。 |
| Lease Container | コンテナー | コンテナーでの削除操作のロックを設定および管理します。 |
| Delete Container | コンテナー | コンテナーと、それに含まれるすべての BLOB を削除します。 |
| BLOB を一覧表示する | コンテナー | コンテナー内のすべての BLOB を一覧表示します。 |
| Put Blob | ブロック BLOB、追加 BLOB、ページ BLOB | 新しい BLOB を作成するか、コンテナー内の既存の BLOB を置換します。 |
| Get Blob | ブロック BLOB、追加 BLOB、ページ BLOB | ユーザー定義のメタデータやシステム プロパティなど、Blob Storage から BLOB を読み取りまたはダウンロードします。 |
| Get Blob Properties | ブロック BLOB、追加 BLOB、ページ BLOB | BLOB のすべてのシステム プロパティとユーザー定義メタデータを返します。 |
| Set Blob Properties | ブロック BLOB、追加 BLOB、ページ BLOB | 既存の BLOB に対して定義されたシステム プロパティを設定します。 |
| BLOB の有効期限を設定する | ブロック blob | 既存の BLOB の有効期限を設定します。 |
| Get Blob Metadata | ブロック BLOB、追加 BLOB、ページ BLOB | 既存の BLOB またはスナップショットのすべてのユーザー定義メタデータを取得します。 |
| Set Blob Metadata | ブロック BLOB、追加 BLOB、ページ BLOB | 既存の BLOB のユーザー定義メタデータを設定します。 |
| BLOB タグの取得 | ブロック BLOB、追加 BLOB、ページ BLOB | 既存の BLOB のユーザー定義タグを取得します。 |
| BLOB タグの設定 | ブロック BLOB、追加 BLOB、ページ BLOB | セカンダリ インデックスを形成する既存の BLOB のユーザー定義タグを設定します。 |
| タグで BLOB を検索する | ブロック BLOB、追加 BLOB、ページ BLOB | ユーザー定義タグによって BLOB をListsします。 |
| Delete Blob | ブロック BLOB、追加 BLOB、ページ BLOB | BLOB を削除対象としてマークします。 |
| BLOB の削除の取り消し | ブロック BLOB、追加 BLOB、ページ BLOB | 論理的に削除された BLOB の内容とメタデータ、または関連付けられているすべての論理的に削除されたスナップショットを復元します。 |
| Lease Blob | ブロック BLOB、追加 BLOB、ページ BLOB | 書き込み操作と削除操作のロックを設定および管理します。 ロックされた BLOB の削除または書き込みを実行するには、クライアントがリース ID を提供する必要があります。 |
| Snapshot Blob | ブロック BLOB、追加 BLOB、ページ BLOB | BLOB の読み取り専用のスナップショットを作成します。 |
| Copy Blob | ブロック BLOB、追加 BLOB、ページ BLOB | このストレージ アカウントまたは別のストレージ アカウントのコピー先 BLOB に、コピー元 BLOB をコピーします。 |
| BLOB のコピーを中止する | ブロック BLOB、追加 BLOB、ページ BLOB | 保留中 Copy Blob の操作を停止し、長さが 0 の宛先 BLOB と完全なメタデータを残します。 |
| Put Block | ブロック BLOB のみ | ブロック BLOB の一部としてコミットされる新しいブロックを作成します。 |
| Put Block From URL | ブロック BLOB のみ | URL からコンテンツを読み取るブロック BLOB の一部としてコミットする新しいブロックを作成します。 |
| Put Block List | ブロック BLOB のみ | ブロック BLOB を構成するブロック ID のセットを指定することにより、BLOB をコミットします。 |
| Get Block List | ブロック BLOB のみ | ブロック BLOB の一部としてアップロードされたブロックのリストを取得します。 |
| BLOB コンテンツのクエリ | ブロック BLOB のみ | BLOB のコンテンツに単純な構造化照会言語 (SQL) ステートメントを適用し、クエリを実行したデータのサブセットのみを返します。 |
| BLOB 層の設定 | ブロック BLOB およびページ BLOB | BLOB の層を設定します。 |
| Put Page | ページ BLOB のみ | ページ BLOB にページ範囲を書き込みます。 |
| Get Page Ranges | ページ BLOB のみ | ページ BLOB またはページ BLOB のスナップショットの有効なページ範囲のリストを返します。 |
| Incremental Copy Blob | ページ BLOB のみ | ソース ページ BLOB のスナップショットをコピー先ページ BLOB にコピーします。 差分変更のみが転送されます。 |
| Append Block | 追加 BLOB のみ | データブロックを追加 BLOB の末尾に書き込みます。 |