CloudPageBlob クラス

リファレンス

パッケージ:: com.microsoft.azure.storage.blob

java.lang.Object
- ListBlobItem
- - CloudBlob
  - - com.microsoft.azure.storage.blob.CloudPageBlob

public class CloudPageBlob extends CloudBlob

Microsoft Azure ページ BLOB を表します。

コンストラクターの概要

コンストラクター	説明
CloudPageBlob(final CloudPageBlob otherBlob)	別のページ BLOB から値をコピーして、クラスのインスタンスを作成します。
CloudPageBlob(final StorageUri blobAbsoluteUri)	指定した絶対 URI とストレージサービスクライアントを使用して、クラスのインスタンスを作成します。
CloudPageBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)	指定した絶対 StorageUri と資格情報を使用して、クラスのインスタンスを作成します。
CloudPageBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)	指定した絶対 StorageUri、スナップショット ID、資格情報を使用して、クラスのインスタンスを作成します。
CloudPageBlob(final URI blobAbsoluteUri)	指定した絶対 URI とストレージサービスクライアントを使用して、クラスのインスタンスを作成します。
CloudPageBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)	指定した絶対 URI と資格情報を使用して、クラスのインスタンスを作成します。
CloudPageBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)	指定した絶対 URI、スナップショット ID、資格情報を使用して、クラスのインスタンスを作成します。
CloudPageBlob(String blobName, String snapshotID, CloudBlobContainer container)	指定した型、名前、スナップショット ID、およびコンテナーを使用して、クラスのインスタンスを作成します。

メソッドの概要

修飾子と型	メソッドと説明
void	clearPages(final long offset, final long length) ページ BLOB からページを消去します。を呼び出すと、指定したページで使用される記憶域領域が解放されます。クリアされたページは、ページ BLOB の一部として追跡されなくなり、ストレージアカウントに対する料金は発生しなくなりました。
void	clearPages(final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定したリース ID、要求オプション、および操作コンテキストを使用して、ページ BLOB からページをクリアします。を呼び出すと、指定したページで使用される記憶域領域が解放されます。クリアされたページは、ページ BLOB の一部として追跡されなくなり、ストレージアカウントに対する料金は発生しなくなりました。
void	create(final long length) ページ BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。 BLOB が既に存在する場合にエラーをスローするには、でオーバーロードgenerateIfNotExistsCondition()を使用しますcreate(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)。
void	create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキストを使用してページ BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。 BLOB が既に存在する場合にエラーをスローするには、を使用 generateIfNotExistsCondition()します。
void	create(final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキストを使用してページ BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。 BLOB が既に存在する場合にエラーをスローするには、を使用 generateIfNotExistsCondition()します。
ArrayList<PageRange>	downloadPageRanges() ページ範囲のコレクションと、その開始バイトオフセットと終了バイトオフセットを返します。各ページ範囲の開始と終了のバイトオフセットには、その開始値と終了値が含まれます。
ArrayList<PageRange>	downloadPageRanges(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキストを使用して、ページ範囲とその開始バイトオフセットと終了バイトオフセットのコレクションを返します。
List<PageRange>	downloadPageRanges(final long offset, final Long length) ページ範囲のコレクションと、その開始バイトオフセットと終了バイトオフセットを返します。
List<PageRange>	downloadPageRanges(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキストを使用して、ページ範囲とその開始バイトオフセットと終了バイトオフセットのコレクションを返します。
List<PageRangeDiff>	downloadPageRangesDiff(final String previousSnapshot) 指定したスナップショットとこのオブジェクトの間で異なるページ範囲のコレクションを取得します。
List<PageRangeDiff>	downloadPageRangesDiff(final String previousSnapshot, final Long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定したスナップショットとこのオブジェクトの間で異なるページ範囲のコレクションを取得します。
BlobOutputStream	openWriteExisting() ページ BLOB にデータを書き込む出力ストリームオブジェクトを開きます。ページ BLOB は既に存在している必要があり、既存のデータは上書きされる可能性があります。
BlobOutputStream	openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定したリース ID、要求オプション、操作コンテキストを使用して、ページ BLOB にデータを書き込む出力ストリームオブジェクトを開きます。ページ BLOB は既に存在している必要があり、既存のデータは上書きされる可能性があります。
BlobOutputStream	openWriteNew(final long length) ページ BLOB にデータを書き込む出力ストリームオブジェクトを開きます。ページ BLOB はまだ存在する必要はありません。指定された長さで作成されます。サービスに BLOB が既に存在する場合は、上書きされます。上書きを回避し、代わりにエラーをスローするには、適切な AccessConditionと共に openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) オーバーロードを使用してください。
BlobOutputStream	openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定したリース ID、要求オプション、操作コンテキストを使用して、ページ BLOB にデータを書き込む出力ストリームオブジェクトを開きます。ページ BLOB はまだ存在する必要はありません。指定された長さで作成されます。サービスに BLOB が既に存在する場合は、上書きされます。上書きを回避し、代わりにエラーをスローするには、を使用してgenerateIfNotExistsCondition()生成されたをAccessCondition渡してください。
BlobOutputStream	openWriteNew(final long length, final PremiumPageBlobTier premiumBlobTier, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定したリース ID、要求オプション、操作コンテキストを使用して、ページ BLOB にデータを書き込む出力ストリームオブジェクトを開きます。ページ BLOB はまだ存在する必要はありません。指定された長さで作成されます。サービスに BLOB が既に存在する場合は、上書きされます。上書きを回避し、代わりにエラーをスローするには、を使用してgenerateIfNotExistsCondition()生成されたをAccessCondition渡してください。
void	putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset) 指定したソース URL を使用して PageRange を書き込みます。
void	putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset, String md5, AccessCondition accessCondition, AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext) 指定したソース URL を使用して PageRange を書き込みます。
void	resize(long size) ページ BLOB のサイズを指定されたサイズに変更します。
void	resize(long size, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) ページ BLOB のサイズを指定されたサイズに変更します。
void	setStreamWriteSizeInBytes(final int streamWriteSizeInBytes) への書き込み時にバッファーに格納するバイト数を BlobOutputStream設定します。
final String	startCopy(final CloudPageBlob sourceBlob) サービスに対して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するように要求します。
final String	startCopy(final CloudPageBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) 指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
final String	startCopy(final CloudPageBlob sourceBlob, final PremiumPageBlobTier premiumBlobTier, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) 指定した BLOB 層、アクセス条件、リース ID、要求オプション、操作コンテキストを使用して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
final String	startIncrementalCopy(final CloudPageBlob sourceSnapshot) この BLOB への別のページ BLOB の内容、プロパティ、およびメタデータの増分コピーを開始するようにサービスに要求します。
final String	startIncrementalCopy(final CloudPageBlob sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) 指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
final String	startIncrementalCopy(final URI sourceSnapshot) この BLOB への別のページ BLOB の内容、プロパティ、およびメタデータの増分コピーを開始するようにサービスに要求します。
final String	startIncrementalCopy(final URI sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) 指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
void	updateSequenceNumberFromResponse(HttpURLConnection request)
void	upload(final InputStream sourceStream, final long length) ソースストリームデータをページ BLOB にアップロードします。サービスに BLOB が既に存在する場合は、上書きされます。
void	upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定したリース ID、要求オプション、および操作コンテキストを使用して、ソースストリームデータをページ BLOB にアップロードします。サービスに BLOB が既に存在する場合は、上書きされます。
void	upload(final InputStream sourceStream, final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定したリース ID、要求オプション、および操作コンテキストを使用して、ソースストリームデータをページ BLOB にアップロードします。サービスに BLOB が既に存在する場合は、上書きされます。
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) バイト配列内のデータから BLOB をアップロードします。サービスに BLOB が既に存在する場合は、上書きされます。
void	uploadFromFile(final String path, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) ファイルから BLOB をアップロードします。サービスに BLOB が既に存在する場合は、上書きされます。
void	uploadPages(final InputStream sourceStream, final long offset, final long length) ページ BLOB 内の指定したオフセット位置に、最大 4 MB のサイズの連続するページの範囲をアップロードします。
void	uploadPages(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 指定したリース ID、要求オプション、および操作コンテキストを使用して、ページ BLOB 内の指定したオフセットで、最大 4 MB のサイズの連続するページの範囲をアップロードします。
void	uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier) Premium Storage アカウントのページ BLOB に BLOB 層を設定します。
void	uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier, BlobRequestOptions options, OperationContext opContext) Premium Storage アカウントのページ BLOB の層を設定します。

継承メンバー

コンストラクターの詳細

CloudPageBlob

public CloudPageBlob(final CloudPageBlob otherBlob)

別のページ BLOB から値をコピーして、クラスのインスタンスを作成します。

Parameters:

otherBlob - CloudPageBlobコピーするページ BLOB を表すオブジェクト。

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri)

指定した絶対 URI とストレージサービスクライアントを使用して、クラスのインスタンスを作成します。

Parameters:

blobAbsoluteUri - StorageUri BLOB の絶対 URI を表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

指定した絶対 StorageUri と資格情報を使用して、クラスのインスタンスを作成します。

Parameters:

blobAbsoluteUri - StorageUri BLOB の絶対 URI を表すオブジェクト。

credentials - StorageCredentialsアクセスを認証するために使用されるオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

指定した絶対 StorageUri、スナップショット ID、資格情報を使用して、クラスのインスタンスを作成します。

Parameters:

blobAbsoluteUri - StorageUri BLOB の絶対 URI を表すオブジェクト。

snapshotID - String該当する場合は、スナップショットバージョンを表す。

credentials - StorageCredentialsアクセスを認証するために使用されるオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri)

指定した絶対 URI とストレージサービスクライアントを使用して、クラスのインスタンスを作成します。

Parameters:

blobAbsoluteUri - java.net.URI BLOB の絶対 URI を表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

指定した絶対 URI と資格情報を使用して、クラスのインスタンスを作成します。

Parameters:

blobAbsoluteUri - java.net.URI BLOB の絶対 URI を表すオブジェクト。

credentials - StorageCredentialsアクセスを認証するために使用されるオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

指定した絶対 URI、スナップショット ID、資格情報を使用して、クラスのインスタンスを作成します。

Parameters:

blobAbsoluteUri - java.net.URI BLOB の絶対 URI を表すオブジェクト。

snapshotID - String該当する場合は、スナップショットバージョンを表す。

credentials - StorageCredentialsアクセスを認証するために使用されるオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

CloudPageBlob

protected CloudPageBlob(String blobName, String snapshotID, CloudBlobContainer container)

指定した型、名前、スナップショット ID、およびコンテナーを使用して、クラスのインスタンスを作成します。

Parameters:

blobName - BLOB の名前です。

snapshotID - String該当する場合は、スナップショットバージョンを表す。

container - 親コンテナーへの参照。

Throws:

URISyntaxException - リソース URI が無効な場合。

メソッドの詳細

clearPages

public void clearPages(final long offset, final long length)

ページ BLOB からページを消去します。

を呼び出すと、指定したページで使用される記憶域領域が解放されます。クリアされたページは、ページ BLOB の一部として追跡されなくなり、ストレージアカウントに対する料金は発生しなくなりました。

Parameters:

offset - ページのクリアを開始するオフセット (バイト単位)。この値は 512 の倍数にする必要があります。

length - 消去するデータ範囲の長さ (バイト単位)。この値は 512 の倍数にする必要があります。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

clearPages

public void clearPages(final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、および操作コンテキストを使用して、ページ BLOB からページをクリアします。

Parameters:

offset - longページのクリアを開始するオフセットをバイト単位で表す。この値は 512 の倍数にする必要があります。

length - longクリアするデータ範囲の長さをバイト単位で表す。この値は 512 の倍数にする必要があります。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

options - BlobRequestOptions要求の追加オプションを指定するオブジェクト。を null 指定すると、関連付けられているサービスクライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。

opContext - 現在の OperationContext 操作のコンテキストを表すオブジェクト。このオブジェクトを使用して、ストレージサービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

create

public void create(final long length)

ページ BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。 BLOB が既に存在する場合にエラーをスローするには、でオーバーロードgenerateIfNotExistsCondition()を使用しますcreate(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)。

Parameters:

length - longページ BLOB のサイズをバイト単位で表す。

Throws:

IllegalArgumentException - 長さが 512 の倍数でない場合。

StorageException - ストレージサービスエラーが発生した場合。

create

public void create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用してページ BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。 BLOB が既に存在する場合にエラーをスローするには、を使用 generateIfNotExistsCondition()します。

Parameters:

length - longページ BLOB のサイズをバイト単位で表す。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Throws:

IllegalArgumentException - 長さが 512 の倍数でない場合。

StorageException - ストレージサービスエラーが発生した場合。

create

public void create(final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Parameters:

length - longページ BLOB のサイズをバイト単位で表す。

premiumBlobTier - BLOB の PremiumPageBlobTier 層を表すオブジェクト。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Throws:

IllegalArgumentException - 長さが 512 の倍数でない場合。

StorageException - ストレージサービスエラーが発生した場合。

downloadPageRanges

public ArrayList downloadPageRanges()

ページ範囲のコレクションと、その開始バイトオフセットと終了バイトオフセットを返します。

各ページ範囲の開始と終了のバイトオフセットには、その開始値と終了値が含まれます。

Returns:

ArrayListページ範囲のセットと、その開始および終了バイトオフセットを表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

downloadPageRanges

public ArrayList downloadPageRanges(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、ページ範囲とその開始バイトオフセットと終了バイトオフセットのコレクションを返します。

Parameters:

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Returns:

ArrayListページ範囲のセットと、その開始および終了バイトオフセットを表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

downloadPageRanges

public List downloadPageRanges(final long offset, final Long length)

ページ範囲のコレクションと、その開始バイトオフセットと終了バイトオフセットを返します。

Parameters:

offset - ページ範囲の一覧を作成するデータ範囲の開始オフセット (バイト単位) です。 512 の倍数を指定する必要があります。

length - ページ範囲の一覧を作成するデータ範囲の長さ (バイト単位) です。 512 の倍数を指定する必要があります。

Returns:

Listページ範囲のセットとその開始バイトオフセットと終了バイトオフセットを表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

downloadPageRanges

public List downloadPageRanges(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Parameters:

offset - ページ範囲の一覧を作成するデータ範囲の開始オフセット (バイト単位) です。 512 の倍数を指定する必要があります。

length - ページ範囲の一覧を作成するデータ範囲の長さ (バイト単位) です。 512 の倍数を指定する必要があります。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Returns:

Listページ範囲のセットとその開始バイトオフセットと終了バイトオフセットを表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

downloadPageRangesDiff

public List downloadPageRangesDiff(final String previousSnapshot)

指定したスナップショットとこのオブジェクトの間で異なるページ範囲のコレクションを取得します。

Parameters:

previousSnapshot - diffの開始点として使用するスナップショットを表す文字列。この CloudPageBlob がスナップショットを表す場合は、previousSnapshot パラメーターが現在のスナップショットより前である必要があります。

Returns:

List異なるページ範囲のセットを含むオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

downloadPageRangesDiff

public List downloadPageRangesDiff(final String previousSnapshot, final Long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したスナップショットとこのオブジェクトの間で異なるページ範囲のコレクションを取得します。

Parameters:

previousSnapshot - diffの開始点として使用するスナップショットタイムスタンプを表す文字列。この CloudPageBlob がスナップショットを表す場合は、previousSnapshot パラメーターが現在のスナップショットより前である必要があります。

offset - ページ範囲の一覧を作成するデータ範囲の開始オフセット (バイト単位) です。 512 の倍数を指定する必要があります。

length - ページ範囲の一覧を作成するデータ範囲の長さ (バイト単位) です。 512 の倍数を指定する必要があります。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Returns:

List異なるページ範囲のセットを含むオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

openWriteExisting

public BlobOutputStream openWriteExisting()

ページ BLOB にデータを書き込む出力ストリームオブジェクトを開きます。ページ BLOB は既に存在している必要があり、既存のデータは上書きされる可能性があります。

Returns:

BlobOutputStream BLOB にデータを書き込む際に使用されるオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

openWriteExisting

public BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、操作コンテキストを使用して、ページ BLOB にデータを書き込む出力ストリームオブジェクトを開きます。ページ BLOB は既に存在している必要があり、既存のデータは上書きされる可能性があります。

Parameters:

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Returns:

BlobOutputStream BLOB にデータを書き込む際に使用されるオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

openWriteNew

public BlobOutputStream openWriteNew(final long length)

ページ BLOB にデータを書き込む出力ストリームオブジェクトを開きます。ページ BLOB はまだ存在する必要はありません。指定された長さで作成されます。サービスに BLOB が既に存在する場合は、上書きされます。

上書きを回避し、代わりにエラーをスローするには、適切な AccessConditionと共に openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) オーバーロードを使用してください。

Parameters:

length - long作成するストリームの長さをバイト単位で表す。この値は 512 の倍数にする必要があります。

Returns:

BlobOutputStream BLOB にデータを書き込む際に使用されるオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

openWriteNew

public BlobOutputStream openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、操作コンテキストを使用して、ページ BLOB にデータを書き込む出力ストリームオブジェクトを開きます。ページ BLOB はまだ存在する必要はありません。指定された長さで作成されます。サービスに BLOB が既に存在する場合は、上書きされます。

上書きを回避し、代わりにエラーをスローするには、を使用してgenerateIfNotExistsCondition()生成されたをAccessCondition渡してください。

Parameters:

length - long作成するストリームの長さをバイト単位で表す。この値は 512 の倍数にする必要があります。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Returns:

BlobOutputStream BLOB にデータを書き込む際に使用されるオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

openWriteNew

public BlobOutputStream openWriteNew(final long length, final PremiumPageBlobTier premiumBlobTier, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

上書きを回避し、代わりにエラーをスローするには、を使用してgenerateIfNotExistsCondition()生成されたをAccessCondition渡してください。

Parameters:

length - long作成するストリームの長さをバイト単位で表す。この値は 512 の倍数にする必要があります。

premiumBlobTier - BLOB の PremiumPageBlobTier 層を表すオブジェクト。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Returns:

BlobOutputStream BLOB にデータを書き込む際に使用されるオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

putPagesFromURI

public void putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset)

指定したソース URL を使用して PageRange を書き込みます。

Parameters:

offset - ページの書き込みを開始するオフセット (バイト単位)。この値は 512 の倍数にする必要があります。

length - 書き込むデータ範囲の長さ (バイト単位)。この値は 512 の倍数にする必要があります。この値は、ソースからコピーするデータの長さとしても使用されます。

copySource - URIソースデータの。パブリックである任意の Azure BLOB またはファイルを指すか、URL に共有アクセス署名を含めることができます。

sourceOffset - longソースの開始点として使用するオフセットを表す。ソースからコピーするデータの長さは、ソース長パラメーターから取得されます。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

putPagesFromURI

public void putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset, String md5, AccessCondition accessCondition, AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext)

指定したソース URL を使用して PageRange を書き込みます。

Parameters:

offset - ページの書き込みを開始するオフセット (バイト単位)。この値は 512 の倍数にする必要があります。

copySource - URIソースデータの。パブリックである任意の Azure BLOB またはファイルを指すか、URL に共有アクセス署名を含めることができます。

md5 - Stringデータの MD5 ハッシュを表す。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

sourceAccessCondition - AccessConditionソース BLOB のアクセス条件を表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

resize

public void resize(long size)

ページ BLOB のサイズを指定されたサイズに変更します。

Parameters:

size - longページ BLOB のサイズをバイト単位で表す。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

resize

public void resize(long size, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

ページ BLOB のサイズを指定されたサイズに変更します。

Parameters:

size - longページ BLOB のサイズをバイト単位で表す。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

setStreamWriteSizeInBytes

public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

への書き込み時にバッファーに格納するバイト数を BlobOutputStream設定します。

Parameters:

streamWriteSizeInBytes - intページ BLOB ストリームへの書き込み時にバッファーに格納する最大バイト数を表す。この値は、512 の倍数で、4 MB 以下である必要があります。

Throws:

IllegalArgumentException - が 512 未満、4 MB を超える場合、または倍数または 512 ではない場合 streamWriteSizeInBytes 。

startCopy

public final String startCopy(final CloudPageBlob sourceBlob)

サービスに対して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するように要求します。

Parameters:

sourceBlob - CloudPageBlobコピーするソース BLOB を表すオブジェクト。

Returns:

Stringコピー操作に関連付けられているコピー ID を表す。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

URISyntaxException

startCopy

public final String startCopy(final CloudPageBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。

Parameters:

sourceBlob - CloudPageBlobコピーするソース BLOB を表すオブジェクト。

sourceAccessCondition - AccessConditionソース BLOB のアクセス条件を表すオブジェクト。

destinationAccessCondition - AccessConditionターゲット BLOB のアクセス条件を表すオブジェクト。

options - BlobRequestOptions要求の追加オプションを指定するオブジェクト。を null 指定すると、関連付けられたサービスクライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。

opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。このオブジェクトを使用して、ストレージサービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

Stringコピー操作に関連付けられているコピー ID を表す。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

URISyntaxException

startCopy

public final String startCopy(final CloudPageBlob sourceBlob, final PremiumPageBlobTier premiumBlobTier, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

指定した BLOB 層、アクセス条件、リース ID、要求オプション、操作コンテキストを使用して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。

Parameters:

sourceBlob - CloudPageBlobコピーするソース BLOB を表すオブジェクト。

premiumBlobTier - BLOB の PremiumPageBlobTier 層を表すオブジェクト。

sourceAccessCondition - AccessConditionソース BLOB のアクセス条件を表すオブジェクト。

destinationAccessCondition - AccessConditionターゲット BLOB のアクセス条件を表すオブジェクト。

Returns:

Stringコピー操作に関連付けられているコピー ID を表す。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot)

この BLOB への別のページ BLOB の内容、プロパティ、およびメタデータの増分コピーを開始するようにサービスに要求します。

Parameters:

sourceSnapshot - CloudPageBlobコピーするソース BLOB を表すオブジェクト。スナップショットである必要があります。

Returns:

Stringコピー操作に関連付けられているコピー ID を表す。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Parameters:

sourceSnapshot - CloudPageBlobコピーするソース BLOB を表すオブジェクト。スナップショットである必要があります。

destinationAccessCondition - AccessConditionターゲット BLOB のアクセス条件を表すオブジェクト。

Returns:

Stringコピー操作に関連付けられているコピー ID を表す。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final URI sourceSnapshot)

この BLOB への別のページ BLOB の内容、プロパティ、およびメタデータの増分コピーを開始するようにサービスに要求します。

Parameters:

sourceSnapshot - CloudPageBlobコピーするソース BLOB を表すオブジェクト。スナップショットである必要があります。

Returns:

Stringコピー操作に関連付けられているコピー ID を表す。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final URI sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Parameters:

sourceSnapshot - CloudPageBlobコピーするソース BLOB を表すオブジェクト。スナップショットである必要があります。

destinationAccessCondition - AccessConditionターゲット BLOB のアクセス条件を表すオブジェクト。

Returns:

Stringコピー操作に関連付けられているコピー ID を表す。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

URISyntaxException

updateSequenceNumberFromResponse

protected void updateSequenceNumberFromResponse(HttpURLConnection request)

Parameters:

request

upload

public void upload(final InputStream sourceStream, final long length)

ソースストリームデータをページ BLOB にアップロードします。サービスに BLOB が既に存在する場合は、上書きされます。

Parameters:

sourceStream - InputStream読み取り元のオブジェクト。

length - ストリームデータの長さをバイト単位で表すは long 、0 以外で、512 の倍数である必要があります。

Throws:

IOException - I/O 例外が発生した場合。

StorageException - ストレージサービスエラーが発生した場合。

upload

public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、および操作コンテキストを使用して、ソースストリームデータをページ BLOB にアップロードします。サービスに BLOB が既に存在する場合は、上書きされます。

Parameters:

sourceStream - InputStream読み取り元のオブジェクト。

length - longストリームデータの長さをバイト単位で表す。これは、0 と 512 の倍数よりも優れた値である必要があります。

accessCondition - BLOB の AccessCondition アクセス条件を表すオブジェクト。

Throws:

IOException - I/O 例外が発生した場合。

StorageException - ストレージサービスエラーが発生した場合。

upload

public void upload(final InputStream sourceStream, final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Parameters:

sourceStream - InputStream読み取り元のオブジェクト。

length - longストリームデータの長さをバイト単位で表す。これは、0 と 512 の倍数よりも優れた値である必要があります。

premiumBlobTier - BLOB の PremiumPageBlobTier 層を表すオブジェクト。

accessCondition - BLOB の AccessCondition アクセス条件を表すオブジェクト。

Throws:

IOException - I/O 例外が発生した場合。

StorageException - ストレージサービスエラーが発生した場合。

uploadFromByteArray

public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

バイト配列内のデータから BLOB をアップロードします。サービスに BLOB が既に存在する場合は、上書きされます。

Parameters:

buffer - byte BLOB に書き込むデータを表す配列。

offset - intデータのアップロードを開始するバイト配列のオフセットを表す。

length - int入力バッファーからアップロードするバイト数を表す。

premiumBlobTier - BLOB の PremiumPageBlobTier 層を表すオブジェクト。

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

IOException

uploadFromFile

public void uploadFromFile(final String path, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

ファイルから BLOB をアップロードします。サービスに BLOB が既に存在する場合は、上書きされます。

Parameters:

path - Stringアップロードするファイルへのパスを表す。

premiumBlobTier - BLOB の PremiumPageBlobTier 層を表すオブジェクト。

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

IOException

uploadPages

public void uploadPages(final InputStream sourceStream, final long offset, final long length)

ページ BLOB 内の指定したオフセット位置に、最大 4 MB のサイズの連続するページの範囲をアップロードします。

Parameters:

sourceStream - InputStreamページ BLOB に書き込む入力ストリームを表すオブジェクト。

offset - longデータの書き込みを開始するオフセットをバイト数で表す。この値は 512 の倍数にする必要があります。

length - long書き込むデータの長さをバイト単位で表す。この値は 512 の倍数にする必要があります。

Throws:

IllegalArgumentException - オフセットまたは長さが 512 の倍数でない場合、または長さが 4 MB を超える場合。

IOException - I/O 例外が発生した場合。

StorageException - ストレージサービスエラーが発生した場合。

uploadPages

public void uploadPages(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、および操作コンテキストを使用して、ページ BLOB 内の指定したオフセットで、最大 4 MB のサイズの連続するページの範囲をアップロードします。

Parameters:

sourceStream - InputStreamページ BLOB に書き込む入力ストリームを表すオブジェクト。

offset - longデータの書き込みを開始するオフセットをバイト数で表す。この値は 512 の倍数にする必要があります。

length - long書き込むデータの長さをバイト単位で表す。この値は 512 の倍数にする必要があります。

accessCondition - AccessCondition BLOB のアクセス条件を表すオブジェクト。

Throws:

IllegalArgumentException - オフセットまたは長さが 512 の倍数でない場合、または長さが 4 MB を超える場合。

IOException - I/O 例外が発生した場合。

StorageException - ストレージサービスエラーが発生した場合。

uploadPremiumPageBlobTier

public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier)

Premium Storage アカウントのページ BLOB に BLOB 層を設定します。

Parameters:

premiumBlobTier - BLOB の PremiumPageBlobTier 層を表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

uploadPremiumPageBlobTier

public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier, BlobRequestOptions options, OperationContext opContext)

Premium Storage アカウントのページ BLOB の層を設定します。

Parameters:

premiumBlobTier - BLOB の PremiumPageBlobTier 層を表すオブジェクト。

Throws:

StorageException - ストレージサービスエラーが発生した場合。

次の方法で共有

CloudPageBlob クラス

コンストラクターの概要

メソッドの概要

継承メンバー

コンストラクターの詳細

CloudPageBlob

CloudPageBlob

CloudPageBlob

CloudPageBlob

CloudPageBlob

CloudPageBlob

CloudPageBlob

CloudPageBlob

メソッドの詳細

clearPages

clearPages

create

create

create

downloadPageRanges

downloadPageRanges

downloadPageRanges

downloadPageRanges

downloadPageRangesDiff

downloadPageRangesDiff

openWriteExisting

openWriteExisting

openWriteNew

openWriteNew

openWriteNew

putPagesFromURI

putPagesFromURI

resize

resize

setStreamWriteSizeInBytes

startCopy

startCopy

startCopy

startIncrementalCopy

startIncrementalCopy

startIncrementalCopy

startIncrementalCopy

updateSequenceNumberFromResponse

upload

upload

upload

uploadFromByteArray

uploadFromFile

uploadPages

uploadPages

uploadPremiumPageBlobTier

uploadPremiumPageBlobTier

適用対象

その他のリソース