CloudPageBlob クラス
- java.
lang. Object - ListBlobItem
- CloudBlob
- com.
microsoft. azure. storage. blob. CloudPageBlob
- com.
public class CloudPageBlob extends CloudBlob
Microsoft Azure ページ BLOB を表します。
コンストラクターの概要
メソッドの概要
継承メンバー
コンストラクターの詳細
CloudPageBlob
public CloudPageBlob(final CloudPageBlob otherBlob)
別のページ BLOB から値をコピーして、 クラスのインスタンスを作成します。
Parameters:
CloudPageBlob
コピーするページ BLOB を表す オブジェクト。
CloudPageBlob
public CloudPageBlob(final StorageUri blobAbsoluteUri)
指定した絶対 URI とストレージ サービス クライアントを使用して、 クラスのインスタンスを作成します。
Parameters:
Throws:
CloudPageBlob
public CloudPageBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)
指定した絶対 StorageUri と資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
Throws:
CloudPageBlob
public CloudPageBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)
指定した絶対 StorageUri、スナップショット ID、資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
String
該当する場合は、スナップショットバージョンを表す 。
Throws:
CloudPageBlob
public CloudPageBlob(final URI blobAbsoluteUri)
指定した絶対 URI とストレージ サービス クライアントを使用して、 クラスのインスタンスを作成します。
Parameters:
java.net.URI
BLOB の絶対 URI を表す オブジェクト。
Throws:
CloudPageBlob
public CloudPageBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)
指定した絶対 URI と資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
java.net.URI
BLOB の絶対 URI を表す オブジェクト。
Throws:
CloudPageBlob
public CloudPageBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)
指定した絶対 URI、スナップショット ID、資格情報を使用して、 クラスのインスタンスを作成します。
Parameters:
java.net.URI
BLOB の絶対 URI を表す オブジェクト。
String
該当する場合は、スナップショットバージョンを表す 。
Throws:
CloudPageBlob
protected CloudPageBlob(String blobName, String snapshotID, CloudBlobContainer container)
指定した型、名前、スナップショット ID、およびコンテナーを使用して、 クラスのインスタンスを作成します。
Parameters:
String
該当する場合は、スナップショットバージョンを表す 。
Throws:
メソッドの詳細
clearPages
public void clearPages(final long offset, final long length)
ページ BLOB からページを消去します。
を呼び出すと、指定したページで使用される記憶域領域が解放されます。 クリアされたページは、ページ BLOB の一部として追跡されなくなり、ストレージ アカウントに対する料金は発生しなくなりました。
Parameters:
Throws:
clearPages
public void clearPages(final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、および操作コンテキストを使用して、ページ BLOB からページをクリアします。
を呼び出すと、指定したページで使用される記憶域領域が解放されます。 クリアされたページは、ページ BLOB の一部として追跡されなくなり、ストレージ アカウントに対する料金は発生しなくなりました。
Parameters:
long
ページのクリアを開始するオフセットをバイト単位で表す 。 この値は 512 の倍数にする必要があります。
long
クリアするデータ範囲の長さをバイト単位で表す 。 この値は 512 の倍数にする必要があります。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
create
public void create(final long length)
ページ BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。 BLOB が既に存在する場合にエラーをスローするには、 でオーバーロードgenerateIfNotExistsCondition()を使用しますcreate(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)。
Parameters:
long
ページ BLOB のサイズをバイト単位で表す 。
Throws:
create
public void create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用してページ BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。 BLOB が既に存在する場合にエラーをスローするには、 を使用 generateIfNotExistsCondition()します。
Parameters:
long
ページ BLOB のサイズをバイト単位で表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
create
public void create(final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用してページ BLOB を作成します。 BLOB が既に存在する場合は、これが置き換えられます。 BLOB が既に存在する場合にエラーをスローするには、 を使用 generateIfNotExistsCondition()します。
Parameters:
long
ページ BLOB のサイズをバイト単位で表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
downloadPageRanges
public ArrayList
ページ範囲のコレクションと、その開始バイトオフセットと終了バイト オフセットを返します。
各ページ範囲の開始と終了のバイト オフセットには、その開始値と終了値が含まれます。
Returns:
ArrayList
ページ範囲のセットと、その開始および終了バイト オフセットを表す オブジェクト。Throws:
downloadPageRanges
public ArrayList
指定した要求オプションと操作コンテキストを使用して、ページ範囲とその開始バイト オフセットと終了バイト オフセットのコレクションを返します。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
ArrayList
ページ範囲のセットと、その開始および終了バイト オフセットを表す オブジェクト。Throws:
downloadPageRanges
public List
ページ範囲のコレクションと、その開始バイトオフセットと終了バイト オフセットを返します。
Parameters:
Returns:
List
ページ範囲のセットとその開始バイト オフセットと終了バイト オフセットを表す オブジェクト。Throws:
downloadPageRanges
public List
指定した要求オプションと操作コンテキストを使用して、ページ範囲とその開始バイト オフセットと終了バイト オフセットのコレクションを返します。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
List
ページ範囲のセットとその開始バイト オフセットと終了バイト オフセットを表す オブジェクト。Throws:
downloadPageRangesDiff
public List
指定したスナップショットとこのオブジェクトの間で異なるページ範囲のコレクションを取得します。
Parameters:
Returns:
List
異なるページ範囲のセットを含む オブジェクト。Throws:
downloadPageRangesDiff
public List
指定したスナップショットとこのオブジェクトの間で異なるページ範囲のコレクションを取得します。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
List
異なるページ範囲のセットを含む オブジェクト。Throws:
openWriteExisting
public BlobOutputStream openWriteExisting()
ページ BLOB にデータを書き込む出力ストリーム オブジェクトを開きます。 ページ BLOB は既に存在している必要があり、既存のデータは上書きされる可能性があります。
Returns:
Throws:
openWriteExisting
public BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、操作コンテキストを使用して、ページ BLOB にデータを書き込む出力ストリーム オブジェクトを開きます。 ページ BLOB は既に存在している必要があり、既存のデータは上書きされる可能性があります。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
openWriteNew
public BlobOutputStream openWriteNew(final long length)
ページ BLOB にデータを書き込む出力ストリーム オブジェクトを開きます。 ページ BLOB はまだ存在する必要はありません。指定された長さで作成されます。 サービスに BLOB が既に存在する場合は、上書きされます。
上書きを回避し、代わりにエラーをスローするには、適切な AccessConditionと共に openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) オーバーロードを使用してください。
Parameters:
long
作成するストリームの長さをバイト単位で表す 。 この値は 512 の倍数にする必要があります。
Returns:
Throws:
openWriteNew
public BlobOutputStream openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、操作コンテキストを使用して、ページ BLOB にデータを書き込む出力ストリーム オブジェクトを開きます。 ページ BLOB はまだ存在する必要はありません。指定された長さで作成されます。サービスに BLOB が既に存在する場合は、上書きされます。
上書きを回避し、代わりにエラーをスローするには、 を使用してgenerateIfNotExistsCondition()生成された をAccessCondition渡してください。
Parameters:
long
作成するストリームの長さをバイト単位で表す 。 この値は 512 の倍数にする必要があります。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
openWriteNew
public BlobOutputStream openWriteNew(final long length, final PremiumPageBlobTier premiumBlobTier, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、操作コンテキストを使用して、ページ BLOB にデータを書き込む出力ストリーム オブジェクトを開きます。 ページ BLOB はまだ存在する必要はありません。指定された長さで作成されます。サービスに BLOB が既に存在する場合は、上書きされます。
上書きを回避し、代わりにエラーをスローするには、 を使用してgenerateIfNotExistsCondition()生成された をAccessCondition渡してください。
Parameters:
long
作成するストリームの長さをバイト単位で表す 。 この値は 512 の倍数にする必要があります。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
putPagesFromURI
public void putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset)
指定したソース URL を使用して PageRange を書き込みます。
Parameters:
URI
ソース データの 。 パブリックである任意の Azure BLOB またはファイルを指すか、URL に共有アクセス署名を含めることができます。
long
ソースの開始点として使用するオフセットを表す 。 ソースからコピーするデータの長さは、ソース長パラメーターから取得されます。
Throws:
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:
URI
ソース データの 。 パブリックである任意の Azure BLOB またはファイルを指すか、URL に共有アクセス署名を含めることができます。
long
ソースの開始点として使用するオフセットを表す 。 ソースからコピーするデータの長さは、ソース長パラメーターから取得されます。
String
データの MD5 ハッシュを表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
resize
public void resize(long size)
ページ BLOB のサイズを指定されたサイズに変更します。
Parameters:
long
ページ BLOB のサイズをバイト単位で表す 。
Throws:
resize
public void resize(long size, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
ページ BLOB のサイズを指定されたサイズに変更します。
Parameters:
long
ページ BLOB のサイズをバイト単位で表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
setStreamWriteSizeInBytes
public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
への書き込み時にバッファーに格納するバイト数を BlobOutputStream設定します。
Parameters:
int
ページ BLOB ストリームへの書き込み時にバッファーに格納する最大バイト数を表す 。 この値は、512 の倍数で、4 MB 以下である必要があります。
Throws:
streamWriteSizeInBytes
。
startCopy
public final String startCopy(final CloudPageBlob sourceBlob)
サービスに対して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するように要求します。
Parameters:
CloudPageBlob
コピーするソース BLOB を表す オブジェクト。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
startCopy
public final String startCopy(final CloudPageBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudPageBlob
コピーするソース BLOB を表す オブジェクト。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
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:
CloudPageBlob
コピーするソース BLOB を表す オブジェクト。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
startIncrementalCopy
public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot)
この BLOB への別のページ BLOB の内容、プロパティ、およびメタデータの増分コピーを開始するようにサービスに要求します。
Parameters:
CloudPageBlob
コピーするソース BLOB を表す オブジェクト。 スナップショットである必要があります。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
startIncrementalCopy
public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudPageBlob
コピーするソース BLOB を表す オブジェクト。 スナップショットである必要があります。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
startIncrementalCopy
public final String startIncrementalCopy(final URI sourceSnapshot)
この BLOB への別のページ BLOB の内容、プロパティ、およびメタデータの増分コピーを開始するようにサービスに要求します。
Parameters:
CloudPageBlob
コピーするソース BLOB を表す オブジェクト。 スナップショットである必要があります。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
startIncrementalCopy
public final String startIncrementalCopy(final URI sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、BLOB の内容、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
CloudPageBlob
コピーするソース BLOB を表す オブジェクト。 スナップショットである必要があります。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
updateSequenceNumberFromResponse
protected void updateSequenceNumberFromResponse(HttpURLConnection request)
Parameters:
upload
public void upload(final InputStream sourceStream, final long length)
ソース ストリーム データをページ BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
long
、0 以外で、512 の倍数である必要があります。
Throws:
upload
public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、および操作コンテキストを使用して、ソース ストリーム データをページ BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
long
ストリーム データの長さをバイト単位で表す 。 これは、0 と 512 の倍数よりも優れた値である必要があります。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
upload
public void upload(final InputStream sourceStream, final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、および操作コンテキストを使用して、ソース ストリーム データをページ BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
long
ストリーム データの長さをバイト単位で表す 。 これは、0 と 512 の倍数よりも優れた値である必要があります。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
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:
byte
BLOB に書き込むデータを表す配列。
int
データのアップロードを開始するバイト配列のオフセットを表す 。
int
入力バッファーからアップロードするバイト数を表す 。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadFromFile
public void uploadFromFile(final String path, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
ファイルから BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
String
アップロードするファイルへのパスを表す 。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadPages
public void uploadPages(final InputStream sourceStream, final long offset, final long length)
ページ BLOB 内の指定したオフセット位置に、最大 4 MB のサイズの連続するページの範囲をアップロードします。
Parameters:
long
データの書き込みを開始するオフセットをバイト数で表す 。 この値は 512 の倍数にする必要があります。
long
書き込むデータの長さをバイト単位で表す 。 この値は 512 の倍数にする必要があります。
Throws:
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:
long
データの書き込みを開始するオフセットをバイト数で表す 。 この値は 512 の倍数にする必要があります。
long
書き込むデータの長さをバイト単位で表す 。 この値は 512 の倍数にする必要があります。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadPremiumPageBlobTier
public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier)
Premium Storage アカウントのページ BLOB に BLOB 層を設定します。
Parameters:
Throws:
uploadPremiumPageBlobTier
public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier, BlobRequestOptions options, OperationContext opContext)
Premium Storage アカウントのページ BLOB の層を設定します。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
適用対象
Azure SDK for Java