次の方法で共有


BlockBlobClient クラス

定義

BlockBlobClientでは、Azure Storage ブロック BLOB を操作できます。

大きな BLOB は、ブロック BLOB を使用すると効率的にアップロードできます。 ブロック BLOB を構成する各ブロックは、ブロック ID で識別されます。 ブロック BLOB の作成や変更を行うには、一連のブロックを書き込んで、対応するブロック ID によってそれらのブロックをコミットします。 各ブロックは、最大 4,000 MB (2019-12-12 より前の REST バージョンを使用する要求の場合は 100 MB、2016-05-31 より前の REST バージョンを使用する要求の場合は 4 MB) で、ブロック BLOB には最大 50,000 個のブロックを含めることができます。 そのため、ブロック BLOB の最大サイズは約 190.73 TiB (4,000 MB X 50,000 ブロック) です。 サイズが 5,000 MB 以下のブロック BLOB を書き込む場合は、1 回の書き込み操作で全体をアップロードできます。を参照してください UploadAsync(Stream, BlobUploadOptions, CancellationToken)

ストレージ アカウント内の BLOB にブロックをアップロードすると、そのブロックは、指定されたブロック BLOB に関連付けられます。ただし、その新しいブロックの ID を含んだ一連のブロックがコミットされるまでは、そのブロックは BLOB に追加されません。 実際にコミットされるか破棄されるまで、新しいブロックはコミットされていない状態のままになります。 ブロックを書き込むだけでは、既存の BLOB の最終更新時刻は更新されません。

ブロック BLOB には、大きなファイルをネットワーク経由で効率よく管理できるという特徴があります。 ブロック BLOB を使用すると、複数のブロックを並列的にアップロードでき、アップロード時間を短縮することができます。 各ブロックには MD5 ハッシュを含めて転送を確認できるため、アップロードの進行状況を追跡し、必要に応じてブロックを再送信できます。ブロックは任意の順序でアップロードし、最終的なブロック リスト コミットメント ステップで順序を決定できます。 新しいブロックをアップロードして、同じブロック ID を持つ、まだコミットされていない既存のブロックを置き換えることもできます。 BLOB にコミットされないまま 1 週間が経過すると、そのブロックは破棄されます。 また、一連のブロックのコミット操作が実行されたときも、その対象に含まれていない未コミットのブロックはすべて破棄されます。

既存のブロック BLOB に変更を加える手段としては、挿入、置換、削除があります。 変更済みのブロック (複数可) をアップロードした後、保存しておく必要のある既存のブロックと併せて新規のブロックをコミットすることによって、BLOB の新しいバージョンをコミットできます。 コミットされた BLOB の 2 つの異なる場所に同じバイト範囲を挿入するには、同じコミット操作内の 2 つの場所で同じブロックをコミットできます。コミット操作の場合、ブロックが見つからない場合、コミットメント操作全体がエラーで失敗し、BLOB は変更されません。 いずれかのブロックがコミットされると、対象の BLOB の既存のプロパティとメタデータが上書きされ、コミットされていないブロックはすべて破棄されます。

ブロック ID は、同じ長さを持つ文字列です。BLOB 内に存在します。 通常、ブロックのクライアント側のコードが、Base 64 エンコード形式を使用して、文字列を同じ長さに正規化します。 Base 64 エンコード形式を使用する場合、エンコード前の文字列長が 64 バイト以下であることが必要です。 ブロック ID の値は、BLOB が異なれば重複してもかまいません。 BLOB には最大 100,000 個のコミットされていないブロックを含めることができます。最大合計サイズは 381.46 TiB (4,000 MB x 100,000 ブロック) です。

存在しない BLOB のブロックを記述すると、長さが 0 バイトの新しいブロック BLOB が作成されます。 この BLOB は、コミット前の BLOB を含んだ BLOB 一覧に反映されます。 この BLOB を 1 つのブロックもコミットせずに放置した場合、BLOB と、その未コミットのブロックは、最後に正常完了したブロック アップロードの 1 週間後に破棄されます。 コミットされていないブロックはすべて、同じ名前の新しい BLOB が 1 つのステップを使用して作成されるときにも破棄されます (2 ステップのブロック upload-then-commit プロセスではなく)。

public class BlockBlobClient : Azure.Storage.Blobs.Specialized.BlobBaseClient
type BlockBlobClient = class
    inherit BlobBaseClient
Public Class BlockBlobClient
Inherits BlobBaseClient
継承
BlockBlobClient

コンストラクター

BlockBlobClient()

モック作成のために クラスの BlockBlobClient 新しいインスタンスを初期化します。

BlockBlobClient(String, String, String)

BlockBlobClient クラスの新しいインスタンスを初期化します。

BlockBlobClient(String, String, String, BlobClientOptions)

BlockBlobClient クラスの新しいインスタンスを初期化します。

BlockBlobClient(Uri, AzureSasCredential, BlobClientOptions)

BlockBlobClient クラスの新しいインスタンスを初期化します。

BlockBlobClient(Uri, BlobClientOptions)

BlockBlobClient クラスの新しいインスタンスを初期化します。

BlockBlobClient(Uri, StorageSharedKeyCredential, BlobClientOptions)

BlockBlobClient クラスの新しいインスタンスを初期化します。

BlockBlobClient(Uri, TokenCredential, BlobClientOptions)

BlockBlobClient クラスの新しいインスタンスを初期化します。

プロパティ

AccountName

BLOB クライアントに対応するストレージ アカウント名を取得します。

(継承元 BlobBaseClient)
BlobContainerName

BLOB クライアントに対応するコンテナー名を取得します。

(継承元 BlobBaseClient)
BlockBlobMaxBlocks

ブロック BLOB で許可されるブロックの最大数を取得します。

BlockBlobMaxStageBlockLongBytes

への呼び出しで送信できる最大バイト数を Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlockAsync(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)取得します。

BlockBlobMaxUploadBlobLongBytes

への呼び出しで送信できる最大バイト数を UploadAsync(Stream, BlobUploadOptions, CancellationToken)取得します。

CanGenerateSasUri

クライアントが SAS を生成できるかどうかを判断します。 クライアントが で認証されている場合。StorageSharedKeyCredential

(継承元 BlobBaseClient)
Name

BLOB の名前を取得します。

(継承元 BlobBaseClient)
Uri

BLOB のプライマリ Uri エンドポイントを取得します。

(継承元 BlobBaseClient)

メソッド

AbortCopyFromUri(String, BlobRequestConditions, CancellationToken)

操作は AbortCopyFromUri(String, BlobRequestConditions, CancellationToken) 保留中 CopyFromUriOperationの を中止し、この BLOB の長さと完全なメタデータを残します。

詳細については、「 BLOB のコピーを中止します

(継承元 BlobBaseClient)
AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken)

操作は AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken) 保留中 CopyFromUriOperationの を中止し、この BLOB の長さと完全なメタデータを残します。

詳細については、「 BLOB のコピーを中止します

(継承元 BlobBaseClient)
CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken)

CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) 操作は、BLOB を構成するブロック ID の一覧を指定することによって BLOB を書き込みます。 ブロックを BLOB の一部として書き込むには、その前の Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) 操作でブロックがサーバーに正常に書き込まれている必要があります。 CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) を呼び出して、変更されたブロックのみをアップロードし、新規と既存のブロックを共にコミットすることによって BLOB を更新できます。 この操作を行うには、コミット後のブロック一覧またはコミット前のブロック一覧からブロックをコミットするか、あるいはどちらの一覧に属しているかに関係なく、アップロードされた最新バージョンのブロックをコミットするかを指定します。 ブロック リストで指定されておらず、完全に削除されたブロック。

詳細については、「 ブロック リストを配置します

CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken)

CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) 操作は、BLOB を構成するブロック ID の一覧を指定することによって BLOB を書き込みます。 ブロックを BLOB の一部として書き込むには、その前の Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) 操作でブロックがサーバーに正常に書き込まれている必要があります。 CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) を呼び出して、変更されたブロックのみをアップロードし、新規と既存のブロックを共にコミットすることによって BLOB を更新できます。 この操作を行うには、コミット後のブロック一覧またはコミット前のブロック一覧からブロックをコミットするか、あるいはどちらの一覧に属しているかに関係なく、アップロードされた最新バージョンのブロックをコミットするかを指定します。 ブロック リストで指定されておらず、完全に削除されたブロック。

詳細については、「 ブロック リストを配置します

CreateClient(Uri, BlobClientOptions, HttpPipeline)

BlockBlobClient クラスの新しいインスタンスを初期化します。

CreateSnapshot(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

CreateSnapshot(IDictionary<String,String>, BlobRequestConditions, CancellationToken) 操作は、BLOB の読み取り専用スナップショットを作成します。

詳細については、「 スナップショット BLOB

(継承元 BlobBaseClient)
CreateSnapshotAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

CreateSnapshotAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken) 操作は、BLOB の読み取り専用スナップショットを作成します。

詳細については、「 スナップショット BLOB

(継承元 BlobBaseClient)
Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) 操作は、指定した BLOB またはスナップショットを削除対象としてマークします。 後でガベージ コレクション中に BLOB が削除され、数分かかる場合があります。

BLOB を削除するには、そのスナップショットをすべて削除する必要があります。 を使用して IncludeSnapshots、両方を同時に削除できます。

詳細については、「 BLOB を削除します

(継承元 BlobBaseClient)
DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) 操作は、指定した BLOB またはスナップショットを削除対象としてマークします。 後でガベージ コレクション中に BLOB が削除され、数分かかる場合があります。

BLOB を削除するには、そのスナップショットをすべて削除する必要があります。 を使用して IncludeSnapshots、両方を同時に削除できます。

詳細については、「 BLOB を削除します

(継承元 BlobBaseClient)
DeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

この操作によりDeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)、指定した BLOB またはスナップショットが削除対象としてマークされます (BLOB が存在する場合)。 後でガベージ コレクション中に BLOB が削除され、数分かかる場合があります。

BLOB を削除するには、そのスナップショットをすべて削除する必要があります。 を使用して IncludeSnapshots、両方を同時に削除できます。

詳細については、「 BLOB を削除します

(継承元 BlobBaseClient)
DeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

この操作によりDeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)、指定した BLOB またはスナップショットが削除対象としてマークされます (BLOB が存在する場合)。 後でガベージ コレクション中に BLOB が削除され、数分かかる場合があります。

BLOB を削除するには、そのスナップショットをすべて削除する必要があります。 を使用して IncludeSnapshots、両方を同時に削除できます。

詳細については、「 BLOB を削除します

(継承元 BlobBaseClient)
DeleteImmutabilityPolicy(CancellationToken)

BLOB に関連付けられている不変ポリシーを削除します。 ストレージ アカウントで BLOB のバージョン管理を有効にする必要があり、BLOB は、この API を呼び出すためにバージョン管理が有効になっている不変ストレージを持つコンテナー内に存在する必要があることに注意してください。

(継承元 BlobBaseClient)
DeleteImmutabilityPolicyAsync(CancellationToken)

BLOB に関連付けられている不変ポリシーを削除します。 ストレージ アカウントで BLOB のバージョン管理を有効にする必要があり、BLOB は、この API を呼び出すためにバージョン管理が有効になっている不変ストレージを持つコンテナー内に存在する必要があることに注意してください。

(継承元 BlobBaseClient)
DownloadContent()

この操作では DownloadContent() 、メタデータとプロパティを含む BLOB がサービスからダウンロードされます。

詳細については、「 BLOB を取得します

(継承元 BlobBaseClient)
DownloadContent(BlobDownloadOptions, CancellationToken)

この操作では DownloadContent(BlobDownloadOptions, CancellationToken) 、メタデータとプロパティを含む BLOB がサービスからダウンロードされます。

詳細については、「 BLOB を取得します

(継承元 BlobBaseClient)
DownloadContent(CancellationToken)

この操作では DownloadContent(CancellationToken) 、メタデータとプロパティを含む BLOB がサービスからダウンロードされます。

詳細については、「 BLOB を取得します

(継承元 BlobBaseClient)
DownloadContentAsync()

この操作では DownloadContentAsync() 、メタデータとプロパティを含む BLOB がサービスからダウンロードされます。

詳細については、「 BLOB を取得します

(継承元 BlobBaseClient)
DownloadContentAsync(BlobDownloadOptions, CancellationToken)

この操作では DownloadContentAsync(BlobDownloadOptions, CancellationToken) 、メタデータとプロパティを含む BLOB がサービスからダウンロードされます。

詳細については、「 BLOB を取得します

(継承元 BlobBaseClient)
DownloadContentAsync(CancellationToken)

この操作では DownloadContentAsync(CancellationToken) 、メタデータとプロパティを含む BLOB がサービスからダウンロードされます。

詳細については、「 BLOB を取得します

(継承元 BlobBaseClient)
DownloadStreaming(BlobDownloadOptions, CancellationToken)

この操作では DownloadStreaming(BlobDownloadOptions, CancellationToken) 、メタデータとプロパティを含む BLOB がサービスからダウンロードされます。

詳細については、「 BLOB を取得します

(継承元 BlobBaseClient)
DownloadStreamingAsync(BlobDownloadOptions, CancellationToken)

この操作では DownloadStreamingAsync(BlobDownloadOptions, CancellationToken) 、メタデータとプロパティを含む BLOB がサービスからダウンロードされます。

詳細については、「 BLOB を取得します

(継承元 BlobBaseClient)
DownloadTo(Stream)

この操作では DownloadTo(Stream) 、並列要求を使用して BLOB をダウンロードし、コンテンツを に destination書き込みます。

(継承元 BlobBaseClient)
DownloadTo(Stream, BlobDownloadToOptions, CancellationToken)

この操作ではAzure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken)、並列要求を使用して BLOB をダウンロードし、 または options.Stream.Streamにコンテンツをoptions.Path.Path書き込みます。

(継承元 BlobBaseClient)
DownloadTo(Stream, CancellationToken)

この操作では DownloadTo(Stream, CancellationToken) 、並列要求を使用して BLOB をダウンロードし、コンテンツを に destination書き込みます。

(継承元 BlobBaseClient)
DownloadTo(String)

この操作では DownloadTo(String) 、並列要求を使用して BLOB をダウンロードし、コンテンツを に path書き込みます。

(継承元 BlobBaseClient)
DownloadTo(String, BlobDownloadToOptions, CancellationToken)

この操作ではAzure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken)、並列要求を使用して BLOB をダウンロードし、 または options.Stream.Streamにコンテンツをoptions.Path.Path書き込みます。

(継承元 BlobBaseClient)
DownloadTo(String, CancellationToken)

この操作では DownloadTo(String, CancellationToken) 、並列要求を使用して BLOB をダウンロードし、コンテンツを に path書き込みます。

(継承元 BlobBaseClient)
DownloadToAsync(Stream)

DownloadToAsync(Stream) 、並列要求を使用して BLOB をダウンロードし、コンテンツを に destination書き込みます。

(継承元 BlobBaseClient)
DownloadToAsync(Stream, BlobDownloadToOptions, CancellationToken)

この操作ではAzure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken)、並列要求を使用して BLOB をダウンロードし、 または options.Stream.Streamにコンテンツをoptions.Path.Path書き込みます。

(継承元 BlobBaseClient)
DownloadToAsync(Stream, CancellationToken)

この操作では DownloadToAsync(Stream, CancellationToken) 、並列要求を使用して BLOB をダウンロードし、コンテンツを に destination書き込みます。

(継承元 BlobBaseClient)
DownloadToAsync(String)

DownloadToAsync(String) 、並列要求を使用して BLOB をダウンロードし、コンテンツを に path書き込みます。

(継承元 BlobBaseClient)
DownloadToAsync(String, BlobDownloadToOptions, CancellationToken)

この操作ではAzure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken)、並列要求を使用して BLOB をダウンロードし、 または options.Stream.Streamにコンテンツをoptions.Path.Path書き込みます。

(継承元 BlobBaseClient)
DownloadToAsync(String, CancellationToken)

この操作では DownloadToAsync(String, CancellationToken) 、並列要求を使用して BLOB をダウンロードし、コンテンツを に path書き込みます。

(継承元 BlobBaseClient)
Exists(CancellationToken)

操作は Exists(CancellationToken) 、 で BlobBaseClient 呼び出して、ストレージ サービスのストレージ アカウントのコンテナーに関連付けられている BLOB が存在するかどうかを確認できます。

(継承元 BlobBaseClient)
ExistsAsync(CancellationToken)

操作は ExistsAsync(CancellationToken) 、 で BlobBaseClient 呼び出して、ストレージ サービスのストレージ アカウントのコンテナーに関連付けられている BLOB が存在するかどうかを確認できます。

(継承元 BlobBaseClient)
GenerateSasUri(BlobSasBuilder)

GenerateSasUri(BlobSasBuilder) 、クライアントの Uri プロパティとビルダーに基づいて Blob Service Shared Access Signature (SAS) URI を生成する を返します。 SAS は、クライアントの共有キー資格情報によって署名されます。

クライアントがサービス Sas に署名できるかどうかをチェックするには、「」を参照してくださいCanGenerateSasUri

詳細については、「 サービス SAS の構築

(継承元 BlobBaseClient)
GenerateSasUri(BlobSasPermissions, DateTimeOffset)

GenerateSasUri(BlobSasPermissions, DateTimeOffset)Uri 渡されたクライアントのプロパティとパラメーターに基づいて Blob Service Shared Access Signature (SAS) URI を生成する を返します。 SAS は、クライアントの共有キー資格情報によって署名されます。

クライアントがサービス Sas に署名できるかどうかをチェックするには、「」を参照してくださいCanGenerateSasUri

詳細については、「 サービス SAS の構築

(継承元 BlobBaseClient)
GetBlobLeaseClientCore(String)

BlobLeaseClient クラスの新しいインスタンスを初期化します。

(継承元 BlobBaseClient)
GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken)

操作操作は GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken) 、ブロック BLOB の一部としてアップロードされたブロックの一覧を取得します。 BLOB に対して保持されるブロック リストは 2 つあります。 Committed Block リストには、 を使用して特定の BLOB CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken)に正常にコミットされたブロックがあります。 コミットされていないブロックリストには、 を使用して Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)BLOB にアップロードされたが、まだコミットされていないブロックがあります。 これらのブロックは、BLOB との関連で Azure に格納されますが、まだ BLOB の一部にはなっていません。

GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken)

操作操作は GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken) 、ブロック BLOB の一部としてアップロードされたブロックの一覧を取得します。 BLOB に対して保持されるブロック リストは 2 つあります。 Committed Block リストには、 を使用して特定の BLOB CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken)に正常にコミットされたブロックがあります。 コミットされていないブロックリストには、 を使用して Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlockAsync(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)BLOB にアップロードされたが、まだコミットされていないブロックがあります。 これらのブロックは、BLOB との関連で Azure に格納されますが、まだ BLOB の一部にはなっていません。

GetParentBlobContainerClientCore()

この BlobBaseClientの親コンテナーを指す新しい BlobContainerClient を作成します。 新しい BlockBlobClient では、 と同じ要求ポリシー パイプラインが使用されます BlobBaseClient

(継承元 BlobBaseClient)
GetProperties(BlobRequestConditions, CancellationToken)

GetProperties(BlobRequestConditions, CancellationToken) 操作は、すべてのユーザー定義メタデータ、標準 HTTP プロパティ、および BLOB のシステム プロパティを返します。 BLOB のコンテンツは返しません。

詳細については、「 BLOB のプロパティを取得します

(継承元 BlobBaseClient)
GetPropertiesAsync(BlobRequestConditions, CancellationToken)

GetPropertiesAsync(BlobRequestConditions, CancellationToken) 操作は、すべてのユーザー定義メタデータ、標準 HTTP プロパティ、および BLOB のシステム プロパティを返します。 BLOB のコンテンツは返しません。

詳細については、「 BLOB のプロパティを取得します

(継承元 BlobBaseClient)
GetTags(BlobRequestConditions, CancellationToken)

基になる BLOB に関連付けられているタグを取得します。

詳細については、「 BLOB タグを取得する

(継承元 BlobBaseClient)
GetTagsAsync(BlobRequestConditions, CancellationToken)

基になる BLOB に関連付けられているタグを取得します。

詳細については、「 BLOB タグを取得する

(継承元 BlobBaseClient)
OpenRead(BlobOpenReadOptions, CancellationToken)

BLOB から読み取るためのストリームを開きます。 ストリームは、読み取り元としてのみ BLOB をダウンロードします。

(継承元 BlobBaseClient)
OpenReadAsync(BlobOpenReadOptions, CancellationToken)

BLOB から読み取るためのストリームを開きます。 ストリームは、読み取り元としてのみ BLOB をダウンロードします。

(継承元 BlobBaseClient)
OpenWrite(Boolean, BlockBlobOpenWriteOptions, CancellationToken)

BLOB に書き込むためのストリームを開きます。

OpenWriteAsync(Boolean, BlockBlobOpenWriteOptions, CancellationToken)

BLOB に書き込むためのストリームを開きます。 BLOB が存在する場合は、上書きされます。

Query(String, BlobQueryOptions, CancellationToken)

API は Query(String, BlobQueryOptions, CancellationToken) 、BLOB に対するクエリの結果を返します。

詳細については、「 BLOB コンテンツのクエリを実行します

QueryAsync(String, BlobQueryOptions, CancellationToken)

API は QueryAsync(String, BlobQueryOptions, CancellationToken) 、BLOB に対するクエリの結果を返します。

詳細については、「 BLOB コンテンツのクエリを実行します

SetAccessTier(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken)

この操作により SetAccessTier(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) 、BLOB の層が設定されます。 操作は、Premium Storage アカウントのページ BLOB と、BLOB ストレージまたは汎用 v2 アカウント内のブロック BLOB で許可されます。

Premium ページ BLOB の層によって、BLOB の許容サイズ、IOPS、帯域幅が決まります。 ブロック BLOB の層によって、ホット/クール/アーカイブ ストレージの種類が決まります。 この操作では、BLOB の ETag は更新されません。 ブロック BLOB レベルの階層化 Blob Storage 層の詳細については、以下を参照してください。

レベルの設定の詳細については、次を参照してください。 BLOB ストレージ層

(継承元 BlobBaseClient)
SetAccessTierAsync(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken)

この操作により SetAccessTierAsync(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) 、BLOB の層が設定されます。 操作は、Premium Storage アカウントのページ BLOB と、BLOB ストレージまたは汎用 v2 アカウント内のブロック BLOB で許可されます。

Premium ページ BLOB の層によって、BLOB の許容サイズ、IOPS、帯域幅が決まります。 ブロック BLOB の層によって、ホット/クール/アーカイブ ストレージの種類が決まります。 この操作では、BLOB の ETag は更新されません。 ブロック BLOB レベルの階層化 Blob Storage 層の詳細については、以下を参照してください。

レベルの設定の詳細については、次を参照してください。 BLOB ストレージ層

(継承元 BlobBaseClient)
SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken) 操作は BLOB のシステム プロパティを設定します。

詳細については、「 BLOB のプロパティを設定します

(継承元 BlobBaseClient)
SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken) 操作は BLOB のシステム プロパティを設定します。

詳細については、「 BLOB のプロパティを設定します

(継承元 BlobBaseClient)
SetImmutabilityPolicy(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

BLOB、BLOB スナップショット、または BLOB バージョンに不変ポリシーを設定します。 ストレージ アカウントで BLOB のバージョン管理を有効にする必要があり、BLOB は、この API を呼び出すためにバージョン管理が有効になっている不変ストレージを持つコンテナー内に存在する必要があることに注意してください。

(継承元 BlobBaseClient)
SetImmutabilityPolicyAsync(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

BLOB、BLOB スナップショット、または BLOB バージョンに不変ポリシーを設定します。 ストレージ アカウントで BLOB のバージョン管理を有効にする必要があり、BLOB は、この API を呼び出すためにバージョン管理が有効になっている不変ストレージを持つコンテナー内に存在する必要があることに注意してください。

(継承元 BlobBaseClient)
SetLegalHold(Boolean, CancellationToken)

BLOB の訴訟ホールドを設定します。 ストレージ アカウントで BLOB のバージョン管理を有効にする必要があり、BLOB は、この API を呼び出すためにバージョン管理が有効になっている不変ストレージを持つコンテナー内に存在する必要があることに注意してください。

(継承元 BlobBaseClient)
SetLegalHoldAsync(Boolean, CancellationToken)

BLOB の訴訟ホールドを設定します。 ストレージ アカウントで BLOB のバージョン管理を有効にする必要があり、BLOB は、この API を呼び出すためにバージョン管理が有効になっている不変ストレージを持つコンテナー内に存在する必要があることに注意してください。

(継承元 BlobBaseClient)
SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken) 操作は、指定された BLOB のユーザー定義メタデータを、1 組以上の名前と値のペアとして設定します。

詳細については、「 BLOB メタデータを設定します

(継承元 BlobBaseClient)
SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken) 操作は、指定された BLOB のユーザー定義メタデータを、1 組以上の名前と値のペアとして設定します。

詳細については、「 BLOB メタデータを設定します

(継承元 BlobBaseClient)
SetTags(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

基になる BLOB にタグを設定します。 BLOB には、最大 10 個のタグを含めることができます。 タグ キーは 1 ~ 128 文字にする必要があります。 タグ値は 0 ~ 256 文字にする必要があります。 有効なタグ キーと値の文字には、小文字と大文字、数字 (0 から 9)、スペース (' ')、プラス ('+')、マイナス ('-')、ピリオド ('.')、スラッシュ ('/')、コロン (':')、等しい ('=')、アンダースコア ('_') が含まれます。

詳細については、「 BLOB タグを設定します

(継承元 BlobBaseClient)
SetTagsAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

基になる BLOB にタグを設定します。 BLOB には、最大 10 個のタグを含めることができます。 タグ キーは 1 ~ 128 文字にする必要があります。 タグ値は 0 ~ 256 文字にする必要があります。 有効なタグ キーと値の文字には、小文字と大文字、数字 (0 から 9)、スペース (' ')、プラス ('+')、マイナス ('-')、ピリオド ('.')、スラッシュ ('/')、コロン (':')、等しい ('=')、アンダースコア ('_') が含まれます。

詳細については、「 BLOB タグを設定します

(継承元 BlobBaseClient)
StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken)

この操作では StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken) 、ブロック BLOB の "ステージング領域" の一部として新しいブロックが作成され、最終的に操作を CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) 介してコミットされます。

詳細については、「 ブロックを配置します

StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken)

この操作では StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken) 、ブロック BLOB の "ステージング領域" の一部として新しいブロックが作成され、最終的に操作を CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) 介してコミットされます。

詳細については、「 ブロックを配置します

StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken)

この操作により StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken) 、BLOB の一部としてコミットされる新しいブロックが作成され、そこから内容が読み取 sourceUriられます。

詳細については、「 URL からブロックを配置します

StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken)

この操作により StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken) 、BLOB の一部としてコミットされる新しいブロックが作成され、そこから内容が読み取 sourceUriられます。

詳細については、「 URL からブロックを配置します

StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

操作は StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken) 、 から source この BLOB へのデータの非同期コピーを開始します。 からGetProperties(BlobRequestConditions, CancellationToken)返された をAzure.Storage.Blobs.Models.BlobProperties.CopyStatusチェックして、コピーが完了したかどうかを判断できます。

詳細については、「 BLOB をコピーします

(継承元 BlobBaseClient)
StartCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

操作は Azure.Storage.Blobs.Specialized.BlobBaseClient.StartCopyFromUri(System.Uri,System.Collections.Generic.IDictionary{System.String,System.String},System.Nullable{Azure.Storage.Blobs.Models.AccessTier},Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.Blobs.Models.BlobRequestConditions,System.Nullable{Azure.Storage.Blobs.Models.RehydratePriority},System.Threading.CancellationToken) 、 から source この BLOB へのデータの非同期コピーを開始します。 からGetPropertiesAsync(BlobRequestConditions, CancellationToken)返された をAzure.Storage.Blobs.Models.BlobProperties.CopyStatusチェックして、コピーが完了したかどうかを判断できます。

詳細については、「 BLOB をコピーします

(継承元 BlobBaseClient)
SyncCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

[URL からの BLOB のコピー] 操作では、最大 256 MiB のソース BLOB サイズに対して、BLOB をストレージ アカウント内の宛先に同期的にコピーします。 この API は、バージョン 2018-03-28 以降で使用できます。 URL からの BLOB のコピー操作のソースには、パブリックまたは共有アクセス署名で承認されている任意の Azure ストレージ アカウント内のコミットされたブロック BLOB を指定できます。

ソース BLOB のサイズは、最大 256 MiB の長さにできます。

詳細については、「 URL から BLOB をコピーします

(継承元 BlobBaseClient)
SyncCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

[URL からの BLOB のコピー] 操作では、最大 256 MiB のソース BLOB サイズに対して、BLOB をストレージ アカウント内の宛先に同期的にコピーします。 この API は、バージョン 2018-03-28 以降で使用できます。 URL からの BLOB のコピー操作のソースには、パブリックまたは共有アクセス署名で承認されている任意の Azure ストレージ アカウント内のコミットされたブロック BLOB を指定できます。

ソース BLOB のサイズは、最大 256 MiB の長さにできます。

詳細については、「 URL から BLOB をコピーします

(継承元 BlobBaseClient)
SyncUploadFromUri(Uri, BlobSyncUploadFromUriOptions, CancellationToken)

[Uri からのアップロード] 操作では、BLOB の内容が特定の URL から読み取られた新しいブロック BLOB が作成されます。 この API は、2020-04-08 バージョン以降でサポートされています。

URL からの PUT BLOB では、部分的な更新はサポートされていません。既存の BLOB の内容は、新しい BLOB の内容で上書きされます。 ソース URL を使用してブロック BLOB のコンテンツの部分的な更新を実行するには、Put Block List と組み合わせて Put Block from URL API を使用します。

SyncUploadFromUri(Uri, Boolean, CancellationToken)

[Uri からのアップロード] 操作では、BLOB の内容が特定の URL から読み取られた新しいブロック BLOB が作成されます。 この API は、2020-04-08 バージョン以降でサポートされています。

URL からの PUT BLOB では、部分的な更新はサポートされていません。既存の BLOB の内容は、新しい BLOB の内容で上書きされます。 ソース URL を使用してブロック BLOB のコンテンツの部分的な更新を実行するには、Put Block List と組み合わせて Put Block from URL API を使用します。

SyncUploadFromUriAsync(Uri, BlobSyncUploadFromUriOptions, CancellationToken)

[Uri からのアップロード] 操作では、BLOB の内容が特定の URL から読み取られた新しいブロック BLOB が作成されます。 この API は、2020-04-08 バージョン以降でサポートされています。

URL からの PUT BLOB では、部分的な更新はサポートされていません。既存の BLOB の内容は、新しい BLOB の内容で上書きされます。 ソース URL を使用してブロック BLOB のコンテンツの部分的な更新を実行するには、Put Block List と組み合わせて Put Block from URL API を使用します。

SyncUploadFromUriAsync(Uri, Boolean, CancellationToken)

[Uri からのアップロード] 操作では、BLOB の内容が特定の URL から読み取られた新しいブロック BLOB が作成されます。 この API は、2020-04-08 バージョン以降でサポートされています。

URL からの PUT BLOB では、部分的な更新はサポートされていません。既存の BLOB の内容は、新しい BLOB の内容で上書きされます。 ソース URL を使用してブロック BLOB のコンテンツの部分的な更新を実行するには、Put Block List と組み合わせて Put Block from URL API を使用します。

Undelete(CancellationToken)

この操作により Undelete(CancellationToken) 、論理的に削除された BLOB と、関連付けられている論理的に削除されたスナップショットの内容とメタデータが復元されます。

詳細については、「 BLOB の削除を取り消します

(継承元 BlobBaseClient)
UndeleteAsync(CancellationToken)

この操作により UndeleteAsync(CancellationToken) 、論理的に削除された BLOB と、関連付けられている論理的に削除されたスナップショットの内容とメタデータが復元されます。

詳細については、「 BLOB の削除を取り消します

(継承元 BlobBaseClient)
Upload(Stream, BlobUploadOptions, CancellationToken)

この操作によって Upload(Stream, BlobUploadOptions, CancellationToken) BLOB の内容が上書きされ、存在しない場合は新しいブロック BLOB が作成されます。 既存のブロック BLOB を上書きすると、BLOB 上の既存のメタデータが置き換えられます。

既存のデータの上書きを回避するには、 を使用してConditions アクセス条件を設定します。

部分的な更新は Upload(Stream, BlobUploadOptions, CancellationToken) ではサポートされません。既存の BLOB のコンテンツは新しい BLOB のコンテンツで上書きされます。 ブロック BLOB のコンテンツの部分的な更新を実行するには、 操作と CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) 操作をAzure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)使用します。

詳細については、「 BLOB を配置します

UploadAsync(Stream, BlobUploadOptions, CancellationToken)

この操作によって UploadAsync(Stream, BlobUploadOptions, CancellationToken) BLOB の内容が上書きされ、存在しない場合は新しいブロック BLOB が作成されます。 既存のブロック BLOB を上書きすると、BLOB 上の既存のメタデータが置き換えられます。

既存のデータの上書きを回避するには、 を使用してConditions アクセス条件を設定します。

部分的な更新は UploadAsync(Stream, BlobUploadOptions, CancellationToken) ではサポートされません。既存の BLOB のコンテンツは新しい BLOB のコンテンツで上書きされます。 ブロック BLOB のコンテンツの部分的な更新を実行するには、 操作と CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) 操作をAzure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)使用します。

詳細については、「 BLOB を配置します

WithCustomerProvidedKey(Nullable<CustomerProvidedKey>)

同一Uriのソースと指定した を使用してBlockBlobClient、 クラスの新しいインスタンスを初期化しますcustomerProvidedKey

WithEncryptionScope(String)

同一Uriのソースと指定した を使用してBlockBlobClient、 クラスの新しいインスタンスを初期化しますencryptionScope

WithSnapshot(String)

同じUriソースと指定されたsnapshotタイムスタンプを使用してBlockBlobClient、 クラスの新しいインスタンスを初期化します。

詳細については、「 BLOB のスナップショットを作成します

WithSnapshotCore(String)

同一Uriのソースと指定されたsnapshotタイムスタンプをBlockBlobClient持つ クラスの新しいインスタンスを作成します。

WithVersion(String)

同じUriソースと指定されたversionIdタイムスタンプを使用してBlockBlobClient、 クラスの新しいインスタンスを初期化します。

拡張メソッド

GetBlobLeaseClient(BlobBaseClient, String)

BlobLeaseClient クラスの新しいインスタンスを初期化します。

GetParentBlobContainerClient(BlobBaseClient)

この BlobBaseClientの親コンテナーを指す新しい BlobContainerClient を作成します。 新しい BlockBlobClient では、 と同じ要求ポリシー パイプラインが使用されます BlobBaseClient

適用対象