CloudBlob クラス

  • リファレンス
パッケージ:
com.microsoft.azure.storage.blob
  • java.lang.Object

public class CloudBlob implements ListBlobItem

Microsoft Azure BLOB を表します。 これは、 クラスと CloudPageBlob クラスのCloudBlockBlob基本クラスです。

フィールドの概要

修飾子と型 フィールドと説明
CloudBlobClient blobServiceClient

BLOB クライアントを表します。

CloudBlobDirectory parent

BLOB のディレクトリを表します。

int streamMinimumReadSizeInBytes

を使用する場合の最小読み取りサイズを BlobInputStream保持します。

int streamWriteSizeInBytes

(ブロックおよびページ BLOB) への書き込み時にバッファーする BlobOutputStream バイト数を保持します。

コンストラクターの概要

コンストラクター 説明
CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials)

指定した URI、スナップショット ID、クラウド BLOB クライアントを使用して、 クラスのインスタンスを作成します。
CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container)

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

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

メソッドの概要

修飾子と型 メソッドと説明
final void abortCopy(final String copyId)

進行中の BLOB コピー操作を中止します。
final void abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

進行中の BLOB コピー操作を中止します。
final String acquireLease()

BLOB の新しい無限リースを取得します。
final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId)

指定したリース時間と提案されたリース ID を使用して、BLOB の新しいリースを取得します。
final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定されたリース時間、提案されたリース ID、要求オプション、および操作コンテキストを使用して、BLOB の新しいリースを取得します。
final void assertCorrectBlobType()

BLOB に BLOB 属性で指定された正しい BLOB の種類があることをアサートします。
void assertNoWriteOperationForSnapshot()

スナップショットに対して書き込み操作が実行されないことをアサートします。

final long breakLease(final Integer breakPeriodInSeconds)

リースを解除し、現在のリース期間が切れるまで別のクライアントが新しいリースを取得できないようにします。
final long breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して既存のリースを解除し、現在のリース期間が切れるまで別のクライアントが新しいリースを取得できないようにします。
final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition)

既存のリース ID を提案されたリース ID に変更します。
final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

既存のリース ID を、指定されたアクセス条件、要求オプション、および操作コンテキストを使用して、提案されたリース ID に変更します。
final CloudBlob createSnapshot()

BLOB のスナップショットを作成します。
final CloudBlob createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB のスナップショットを作成します。
final CloudBlob createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB のスナップショットを作成します。
final void delete()

BLOB を削除します。

サービスで削除アイテム保持ポリシーが有効になっている場合、BLOB は、ガベージ コレクションによって完全に削除される前に、指定された期間保持されます。
final void delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したスナップショットと要求オプション、および操作コンテキストを使用して BLOB を削除します。

サービスで削除アイテム保持ポリシーが有効になっている場合、BLOB は、ガベージ コレクションによって完全に削除される前に、指定された期間保持されます。

スナップショットを持つ BLOB は、スナップショットが削除されてからでないと、削除できません。 BLOB にスナップショットがある場合は、 パラメーターの または INCLUDE_SNAPSHOTS 値を使用DELETE_SNAPSHOTS_ONLYして、BLOB が削除されたときにスナップショットを処理する方法を指定します。
final boolean deleteIfExists()

BLOB が存在する場合は削除します。

スナップショットを持つ BLOB は、スナップショットが削除されてからでないと、削除できません。 BLOB にスナップショットがある場合は、 パラメーターの または INCLUDE_SNAPSHOTS 値を使用DELETE_SNAPSHOTS_ONLYして、BLOB が削除されたときにスナップショットを処理する方法を指定します。
final boolean deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したスナップショットと要求オプション、および操作コンテキストを使用して、BLOB が存在する場合は削除します。

スナップショットを持つ BLOB は、スナップショットが削除されてからでないと、削除できません。 BLOB にスナップショットがある場合は、 パラメーターの または INCLUDE_SNAPSHOTS 値を使用DELETE_SNAPSHOTS_ONLYして、BLOB が削除されたときにスナップショットを処理する方法を指定します。
final void download(final OutputStream outStream)

BLOB の内容をストリームにダウンロードします。
final void download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB の内容をストリームにダウンロードします。
AccountInformation downloadAccountInfo()

この BLOB が存在するストレージ アカウントに関連する情報を取得します。
AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)

この BLOB が存在するストレージ アカウントに関連する情報を取得します。
StorageRequest<ServiceClient, CloudBlob, AccountInformation> downloadAccountInformationImpl(final RequestOptions options)
final void downloadAttributes()

BLOB のプロパティとメタデータを設定します。

このメソッドは、BLOB のシステム プロパティとユーザー定義メタデータを設定します。 BLOB のプロパティまたはメタデータを読み取ったり変更したりする前に、このメソッドまたはそのオーバーロードを呼び出して、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
final void downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB のプロパティとメタデータを設定します。

このメソッドは、BLOB のシステム プロパティとユーザー定義メタデータを設定します。 BLOB のプロパティまたはメタデータを読み取ったり変更したりする前に、このメソッドまたはそのオーバーロードを呼び出して、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
final void downloadRange(final long offset, final Long length, final OutputStream outStream)

BLOB の内容をストリームにダウンロードします。
final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB の内容をストリームにダウンロードします。
final int downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。
final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)

BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。
final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。
final int downloadToByteArray(final byte[] buffer, final int bufferOffset)

BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。
final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB から指定されたバイト バッファーにバイト範囲をダウンロードします。
void downloadToFile(final String path)

BLOB をダウンロードし、その内容をファイルに格納します。
void downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

BLOB をダウンロードし、その内容をファイルに格納します。
final boolean exists()

BLOB が存在するかどうかを確認します。
final boolean exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB が存在するかどうかを確認します。
String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
String generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB のユーザー委任キーに基づいて共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。

String generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB のユーザー委任キーに基づいて共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。

final CloudBlobContainer getContainer()

BLOB のコンテナーを返します。
CopyState getCopyState()

BLOB のコピー状態を返します。
final HashMap<String, String> getMetadata()

BLOB のメタデータを返します。
final String getName()

BLOB の名前を返します。
final CloudBlobDirectory getParent()

BLOB アイテムの親を返します。
String getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container)

BLOB URI の親名を取得します。
final BlobProperties getProperties()

BLOB のプロパティを返します。
final StorageUri getQualifiedStorageUri()

この BLOB のスナップショットや共有アクセス署名の修飾 URI を返します。

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedStorageUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedStorageUri()"></xref> instead.</p>

</xrefdescription>

final URI getQualifiedUri()

この BLOB のスナップショットまたは Shared Access Signature の修飾 URI を返します。

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedUri()"></xref> instead.</p>

</xrefdescription>

final CloudBlobClient getServiceClient()

BLOB に関連付けられている BLOB サービス クライアントを返します。
final String getSnapshotID()

BLOB スナップショット ID を取得します。
final StorageUri getSnapshotQualifiedStorageUri()

BLOB がスナップショットの場合は、クエリ文字列情報を含む、プライマリとセカンダリの両方の場所の BLOB の URI を返します。
final URI getSnapshotQualifiedUri()

BLOB がスナップショットの場合は、クエリ文字列情報を含む絶対 URI を BLOB に返します。
final StorageUri getStorageUri()

すべての場所の URI の一覧を返します。
final int getStreamMinimumReadSizeInBytes()

を使用する場合の最小読み取りサイズを BlobInputStream返します。
final int getStreamWriteSizeInBytes()

への書き込み BlobOutputStream 時にバッファーするバイト数 (ブロック BLOB とページ BLOB) を取得します。
final StorageUri getTransformedAddress(final OperationContext opContext)

指定された資格情報に変換が必要な場合は、リソースの変換された URI を返します。
final URI getUri()

この BLOB の URI を返します。
final boolean isSnapshot()

この BLOB がスナップショットかどうかを示します。
final BlobInputStream openInputStream()

BLOB 入力ストリームを開き、BLOB をダウンロードします。

を使用して setStreamMinimumReadSizeInBytes(final int minimumReadSize) 、読み取りサイズを構成します。
final BlobInputStream openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して BLOB をダウンロードする BLOB 入力ストリームを開きます。

を使用して setStreamMinimumReadSizeInBytes(final int minimumReadSize) 、読み取りサイズを構成します。
final BlobInputStream openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して BLOB をダウンロードする BLOB 入力ストリームを開きます。 ダウンロード時に BLOB が復号化されると、最終的な MD5 検証はスキップされます。

を使用して setStreamMinimumReadSizeInBytes(final int minimumReadSize) 、読み取りサイズを構成します。
final void releaseLease(final AccessCondition accessCondition)

BLOB のリースを解放します。
final void releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB のリースを解放します。
final void renewLease(final AccessCondition accessCondition)

既存のリースを更新します。
final void renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、既存のリースを更新します。
final void setContainer(final CloudBlobContainer container)

BLOB のコンテナーを設定します。
final void setMetadata(final HashMap<String, String> metadata)

BLOB のメタデータを設定します。
final void setProperties(final BlobProperties properties)

BLOB のプロパティを設定します。
final void setSnapshotID(final String snapshotID)

BLOB スナップショット ID を設定します。
void setStorageUri(final StorageUri storageUri)

すべての場所の URI の一覧を設定します。
void setStreamMinimumReadSizeInBytes(final int minimumReadSize)

を使用する場合の最小読み取りサイズを BlobInputStream設定します。
abstract void setStreamWriteSizeInBytes(int streamWriteSizeInBytes)

(ブロックとページ BLOB) への書き込み時にバッファーに格納する BlobOutputStream バイト数を設定します。
final String startCopy(final URI source)

URI のコンテンツ、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、URI のコンテンツ、プロパティ、メタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
final String startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

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

注: premiumPageBlobTier の設定は、Premium アカウントでのみサポートされています。

final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

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

注: premiumPageBlobTier の設定は、Premium アカウントでのみサポートされています。

final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

指定された Premium ページ BLOB 層、リハイドレート優先度、アクセス条件、リース ID、要求オプション、操作コンテキストを使用して、URI のコンテンツ、プロパティ、メタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。

注: premiumPageBlobTier の設定は、Premium アカウントでのみサポートされています。

StorageRequest<CloudBlobClient, CloudBlob, String> startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options)
final void undelete()

論理的に削除された BLOB とそのすべてのスナップショットを削除解除します。
final void undelete(BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、論理的に削除された BLOB を削除解除します。

BLOB の削除解除操作では、論理的に削除された BLOB とそのすべてのスナップショットの内容とメタデータが復元されます。 論理的に削除されていない BLOB またはスナップショットの削除を取り消そうとすると、変更なしで成功します。
void updateEtagAndLastModifiedFromResponse(HttpURLConnection request)
void updateLengthFromResponse(HttpURLConnection request)
abstract void upload(InputStream sourceStream, long length)

ソース ストリーム データを BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
abstract void upload(InputStream sourceStream, long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、操作コンテキストを使用して、ソース ストリーム データを BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
void uploadFromByteArray(final byte[] buffer, final int offset, final int length)

バイト配列内のデータから BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

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

ファイルから BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
void uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

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

BLOB のメタデータをストレージ サービスにアップロードします。

を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
final void uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、および操作コンテキストを使用して、BLOB のメタデータをストレージ サービスにアップロードします。

を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
final void uploadProperties()

BLOB のプロパティをストレージ サービスに更新します。

を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
final void uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、および操作コンテキストを使用して、BLOB のプロパティを更新します。

を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
static<T extends CloudBlob, R> void validateCPKHeaders(StorageRequest<CloudBlobClient, T, R> request, BlobRequestOptions options, boolean upload)

要求オプションに CPK が含まれている場合は、関連付けられている応答ヘッダーを検証します。

フィールドの詳細

blobServiceClient

protected CloudBlobClient blobServiceClient

BLOB クライアントを表します。

parent

protected CloudBlobDirectory parent

BLOB のディレクトリを表します。

streamMinimumReadSizeInBytes

protected int streamMinimumReadSizeInBytes= Constants.DEFAULT_MINIMUM_READ_SIZE_IN_BYTES

を使用する場合の最小読み取りサイズを BlobInputStream保持します。

streamWriteSizeInBytes

protected int streamWriteSizeInBytes= Constants.DEFAULT_STREAM_WRITE_IN_BYTES

(ブロックおよびページ BLOB) への書き込み時にバッファーする BlobOutputStream バイト数を保持します。

コンストラクターの詳細

CloudBlob

protected CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials)

指定した URI、スナップショット ID、クラウド BLOB クライアントを使用して、 クラスのインスタンスを作成します。

Parameters:

type - BLOB の BlobType 種類を表す 値。
uri - StorageUriコンテナー名で始まる BLOB の URI を表す オブジェクト。
snapshotID - String該当する場合は、スナップショットバージョンを表す 。
credentials - StorageCredentialsアクセスを認証するために使用される オブジェクト。

Throws:

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

CloudBlob

protected CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container)

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

Parameters:

type - BLOB の BlobType 種類を表す 値。
blobName - BLOB の名前です。
snapshotID - String該当する場合は、スナップショットバージョンを表す 。
container - 親コンテナーへの参照。

Throws:

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

CloudBlob

protected CloudBlob(final CloudBlob otherBlob)

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

Parameters:

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

メソッドの詳細

abortCopy

public final void abortCopy(final String copyId)

進行中の BLOB コピー操作を中止します。

Parameters:

copyId - Stringコピー操作を識別する オブジェクト。

Throws:

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

abortCopy

public final void abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

進行中の BLOB コピー操作を中止します。

Parameters:

copyId - Stringコピー操作を識別する オブジェクト。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

acquireLease

public final String acquireLease()

BLOB の新しい無限リースを取得します。

Returns:

Stringリース ID を表す 。

Throws:

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

acquireLease

public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId)

指定したリース時間と提案されたリース ID を使用して、BLOB の新しいリースを取得します。

Parameters:

leaseTimeInSeconds - Integerリースを取得する期間を秒単位で指定する 。 null の場合、無限リースが取得されます。 null でない場合、値は 0 より大きくする必要があります。
proposedLeaseId - String新しいリースの提案されたリース ID を表す 。リース ID が提案されていない場合は null。

Returns:

Stringリース ID を表す 。

Throws:

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

acquireLease

public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定されたリース時間、提案されたリース ID、要求オプション、および操作コンテキストを使用して、BLOB の新しいリースを取得します。

Parameters:

leaseTimeInSeconds - Integerリースを取得する期間を秒単位で指定する 。 null の場合、無限リースが取得されます。 null でない場合、値は 0 より大きくする必要があります。
proposedLeaseId - String新しいリースの提案されたリース ID を表す 。リース ID が提案されていない場合は null。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 コンテキストは、ストレージ サービスへの要求を追跡し、操作に関する追加のランタイム情報を提供するために使用されます。

Returns:

Stringリース ID を表す 。

Throws:

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

assertCorrectBlobType

protected final void assertCorrectBlobType()

BLOB に BLOB 属性で指定された正しい BLOB の種類があることをアサートします。

Throws:

StorageException - 正しくない BLOB の種類が使用されている場合。

assertNoWriteOperationForSnapshot

protected void assertNoWriteOperationForSnapshot()

スナップショットに対して書き込み操作が実行されないことをアサートします。

breakLease

public final long breakLease(final Integer breakPeriodInSeconds)

リースを解除し、現在のリース期間が切れるまで別のクライアントが新しいリースを取得できないようにします。

Parameters:

breakPeriodInSeconds - 現在のリースが切断されるまで待機する時間を秒単位で指定します。 null の場合、中断期間は、現在のリースの残り時間となります。無限リースの場合は 0 です。

Returns:

longリース期間の残りの時間を秒単位で指定する 。

Throws:

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

breakLease

public final long breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して既存のリースを解除し、現在のリース期間が切れるまで別のクライアントが新しいリースを取得できないようにします。

Parameters:

breakPeriodInSeconds - Integer現在のリースが切断されるまで待機する時間を秒単位で指定する 。 null の場合、中断期間は、現在のリースの残り時間となります。無限リースの場合は 0 です。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 コンテキストは、ストレージ サービスへの要求を追跡し、操作に関する追加のランタイム情報を提供するために使用されます。

Returns:

longリース期間に残っている時間 (秒単位) を表す 。

Throws:

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

changeLease

public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition)

既存のリース ID を提案されたリース ID に変更します。

Parameters:

proposedLeaseId - String新しいリースの提案されたリース ID を表す 。リース ID が提案されていない場合は null。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。 リース ID は、アクセス条件で設定する必要があります。

Returns:

String新しいリース ID を表す 。

Throws:

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

changeLease

public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

既存のリース ID を、指定されたアクセス条件、要求オプション、および操作コンテキストを使用して、提案されたリース ID に変更します。

Parameters:

proposedLeaseId - String新しいリースの提案されたリース ID を表す 。リース ID が提案されていない場合は null。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。 リース ID は、アクセス条件で設定する必要があります。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 コンテキストは、ストレージ サービスへの要求を追跡し、操作に関する追加のランタイム情報を提供するために使用されます。

Returns:

String新しいリース ID を表す 。

Throws:

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

createSnapshot

public final CloudBlob createSnapshot()

BLOB のスナップショットを作成します。

Returns:

BLOB のCloudBlobスナップショットを表す オブジェクト。

Throws:

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

createSnapshot

public final CloudBlob createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB のスナップショットを作成します。

Parameters:

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

BLOB のCloudBlobスナップショットを表す オブジェクト。

Throws:

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

createSnapshot

public final CloudBlob createSnapshot(final HashMap metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB のスナップショットを作成します。

Parameters:

metadata - スナップショットのメタデータを定義する名前と値のペアのコレクション(null)。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

BLOB のCloudBlobスナップショットを表す オブジェクト。

Throws:

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

delete

public final void delete()

BLOB を削除します。

サービスで削除アイテム保持ポリシーが有効になっている場合、BLOB は、ガベージ コレクションによって完全に削除される前に、指定された期間保持されます。

Throws:

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

delete

public final void delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したスナップショットと要求オプション、および操作コンテキストを使用して BLOB を削除します。

サービスで削除アイテム保持ポリシーが有効になっている場合、BLOB は、ガベージ コレクションによって完全に削除される前に、指定された期間保持されます。

スナップショットを持つ BLOB は、スナップショットが削除されてからでないと、削除できません。 BLOB にスナップショットがある場合は、 パラメーターの または INCLUDE_SNAPSHOTS 値を使用DELETE_SNAPSHOTS_ONLYして、BLOB が削除されたときにスナップショットを処理する方法を指定します。

Parameters:

deleteSnapshotsOption - DeleteSnapshotsOptionスナップショットのみを削除するか、BLOB とそのスナップショットを削除するかを示す オブジェクト。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

deleteIfExists

public final boolean deleteIfExists()

BLOB が存在する場合は削除します。

スナップショットを持つ BLOB は、スナップショットが削除されてからでないと、削除できません。 BLOB にスナップショットがある場合は、 パラメーターの または INCLUDE_SNAPSHOTS 値を使用DELETE_SNAPSHOTS_ONLYして、BLOB が削除されたときにスナップショットを処理する方法を指定します。

Returns:

true BLOB が削除された場合は 。それ以外の場合は false。

Throws:

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

deleteIfExists

public final boolean deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したスナップショットと要求オプション、および操作コンテキストを使用して、BLOB が存在する場合は削除します。

スナップショットを持つ BLOB は、スナップショットが削除されてからでないと、削除できません。 BLOB にスナップショットがある場合は、 パラメーターの または INCLUDE_SNAPSHOTS 値を使用DELETE_SNAPSHOTS_ONLYして、BLOB が削除されたときにスナップショットを処理する方法を指定します。

Parameters:

deleteSnapshotsOption - DeleteSnapshotsOptionスナップショットのみを削除するか、BLOB とそのスナップショットを削除するかを示す オブジェクト。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

true BLOB が存在し、削除された場合は 。それ以外の場合は false

Throws:

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

download

public final void download(final OutputStream outStream)

BLOB の内容をストリームにダウンロードします。

Parameters:

outStream - OutputStreamターゲット ストリームを表す オブジェクト。

Throws:

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

download

public final void download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB の内容をストリームにダウンロードします。

Parameters:

outStream - OutputStreamターゲット ストリームを表す オブジェクト。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

downloadAccountInfo

public AccountInformation downloadAccountInfo()

この BLOB が存在するストレージ アカウントに関連する情報を取得します。

Returns:

AccountInformation指定されたストレージ アカウントの オブジェクト。

Throws:

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

downloadAccountInfo

public AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)

この BLOB が存在するストレージ アカウントに関連する情報を取得します。

Parameters:

options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

AccountInformation指定されたストレージ アカウントの オブジェクト。

Throws:

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

downloadAccountInformationImpl

protected StorageRequest downloadAccountInformationImpl(final RequestOptions options)

Parameters:

options

downloadAttributes

public final void downloadAttributes()

BLOB のプロパティとメタデータを設定します。

このメソッドは、BLOB のシステム プロパティとユーザー定義メタデータを設定します。 BLOB のプロパティまたはメタデータを読み取ったり変更したりする前に、このメソッドまたはそのオーバーロードを呼び出して、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。

Throws:

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

downloadAttributes

public final void downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB のプロパティとメタデータを設定します。

このメソッドは、BLOB のシステム プロパティとユーザー定義メタデータを設定します。 BLOB のプロパティまたはメタデータを読み取ったり変更したりする前に、このメソッドまたはそのオーバーロードを呼び出して、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。

Parameters:

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

downloadRange

public final void downloadRange(final long offset, final Long length, final OutputStream outStream)

BLOB の内容をストリームにダウンロードします。

Parameters:

offset - longソースの開始点として使用するオフセットを表す 。
length - Long読み取るバイト数または nullを表す 。
outStream - OutputStreamターゲット ストリームを表す オブジェクト。

Throws:

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

downloadRange

public final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB の内容をストリームにダウンロードします。

Parameters:

offset - longソースの開始点として使用するオフセットを表す 。
length - Long読み取るバイト数または nullを表す 。
outStream - OutputStreamターゲット ストリームを表す オブジェクト。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

downloadRangeInternal

protected final int downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。

Parameters:

blobOffset - longダウンロードを開始する BLOB 内のオフセットを表す 。
length - Long読み取るバイト数を表す 。
buffer - byte書き込むバッファーを表す配列。
bufferOffset - int書き込みを開始するバイト バッファー内のオフセットを表す 。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。
opContext - 操作の OperationContext 実行を追跡するために使用される オブジェクト。

Returns:

バッファーに読み取られた合計バイト数。

Throws:

StorageException - 操作中に発生したエラーを表す例外。

downloadRangeToByteArray

public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)

BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。

Parameters:

offset - longソースの開始点として使用するバイト オフセットを表す 。
length - Long読み取るバイト数または null バイト数を表す 。
buffer - byte BLOB バイトがダウンロードされるバッファーを表す配列。
bufferOffset - intターゲットの開始点として使用するバイト オフセットを表す 。

Returns:

バッファーに読み取られた合計バイト数。

Throws:

StorageException

downloadRangeToByteArray

public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。

Parameters:

offset - longソースの開始点として使用するバイト オフセットを表す 。
length - Long読み取るバイト数または nullを表す 。
buffer - byte BLOB バイトがダウンロードされるバッファーを表す配列。
bufferOffset - intターゲットの開始点として使用するバイト オフセットを表す 。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

バッファーに読み取られた合計バイト数。

Throws:

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

downloadToByteArray

public final int downloadToByteArray(final byte[] buffer, final int bufferOffset)

BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。

Parameters:

buffer - byte BLOB バイトがダウンロードされるバッファーを表す配列。
bufferOffset - intターゲットの開始点として使用するバイト オフセットを表す 。

Throws:

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

downloadToByteArray

public final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB から指定されたバイト バッファーにバイト範囲をダウンロードします。

Parameters:

buffer - byte BLOB バイトがダウンロードされるバッファーを表す配列。
bufferOffset - longターゲットの開始点として使用するバイト オフセットを表す 。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

downloadToFile

public void downloadToFile(final String path)

BLOB をダウンロードし、その内容をファイルに格納します。

Parameters:

path - String BLOB の内容で作成されるファイルへのパスを表す 。

Throws:

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

downloadToFile

public void downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

BLOB をダウンロードし、その内容をファイルに格納します。

Parameters:

path - String BLOB の内容で作成されるファイルへのパスを表す 。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

exists

public final boolean exists()

BLOB が存在するかどうかを確認します。

Returns:

true BLOB が存在する場合は 。それ以外の場合 falseは 。

Throws:

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

exists

public final boolean exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB が存在するかどうかを確認します。

Parameters:

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

true BLOB が存在する場合は、他の賢明な false。

Throws:

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

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。

Parameters:

policy - SharedAccessPolicy共有アクセス署名のアクセス ポリシーを表す オブジェクト。
headers - SharedAccessBlobHeadersこの共有アクセス署名でアクセスされる BLOB に設定する省略可能なヘッダー値を表す オブジェクト。
groupPolicyIdentifier - Stringコンテナー レベルのアクセス ポリシーを表す 。

Returns:

String共有アクセス署名を表す 。

Throws:

IllegalArgumentException - 資格情報が無効であるか、BLOB がスナップショットである場合。
InvalidKeyException - 資格情報が無効な場合。
StorageException - ストレージ サービス エラーが発生した場合。

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。

Parameters:

policy - SharedAccessPolicy共有アクセス署名のアクセス ポリシーを表す オブジェクト。
headers - SharedAccessBlobHeadersこの共有アクセス署名でアクセスされる BLOB に設定する省略可能なヘッダー値を表す オブジェクト。
groupPolicyIdentifier - Stringコンテナー レベルのアクセス ポリシーを表す 。
ipRange - IPRange許可される IP アドレスの範囲を含む オブジェクト。
protocols - SharedAccessProtocols許可されているインターネット プロトコルを表す 。

Returns:

String共有アクセス署名を表す 。

Throws:

IllegalArgumentException - 資格情報が無効であるか、BLOB がスナップショットである場合。
InvalidKeyException - 資格情報が無効な場合。
StorageException - ストレージ サービス エラーが発生した場合。

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。

Parameters:

policy - SharedAccessPolicy共有アクセス署名のアクセス ポリシーを表す オブジェクト。
headers - SharedAccessBlobHeadersこの共有アクセス署名でアクセスされる BLOB に設定する省略可能なヘッダー値を表す オブジェクト。
groupPolicyIdentifier - Stringコンテナー レベルのアクセス ポリシーを表す 。
ipRange - IPRange許可される IP アドレスの範囲を含む オブジェクト。
protocols - SharedAccessProtocols許可されているインターネット プロトコルを表す 。
skipDecoding - boolean署名する前にクエリ パラメーターをデコードしないことを示す 。 これは、渡された値が目的の形式であることを顧客が確認する場合にのみ使用する必要があります。 これは、この SDK を使用して要求を行わないサード パーティに対してクライアントを使用して sas を生成するシナリオで役立つ場合があります。

Returns:

String共有アクセス署名を表す 。

Throws:

IllegalArgumentException - 資格情報が無効であるか、BLOB がスナップショットである場合。
InvalidKeyException - 資格情報が無効な場合。
StorageException - ストレージ サービス エラーが発生した場合。

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。

Parameters:

policy - SharedAccessPolicy共有アクセス署名のアクセス ポリシーを表す オブジェクト。
groupPolicyIdentifier - Stringコンテナー レベルのアクセス ポリシーを表す 。

Returns:

String共有アクセス署名を表す 。

Throws:

IllegalArgumentException - 資格情報が無効であるか、BLOB がスナップショットである場合。
InvalidKeyException - 資格情報が無効な場合。
StorageException - ストレージ サービス エラーが発生した場合。

generateUserDelegationSharedAccessSignature

public String generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB のユーザー委任キーに基づいて共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。

Parameters:

delegationKey - UserDelegationKeyこの署名の署名に使用されるキーを表す 。
policy - SharedAccessPolicy共有アクセス署名のアクセス ポリシーを表す オブジェクト。
headers - SharedAccessBlobHeadersこの共有アクセス署名でアクセスされる BLOB に設定する省略可能なヘッダー値を表す オブジェクト。
ipRange - IPRange許可される IP アドレスの範囲を含む オブジェクト。
protocols - SharedAccessProtocols許可されているインターネット プロトコルを表す 。

Returns:

String共有アクセス署名を表す 。

Throws:

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

generateUserDelegationSharedAccessSignature

public String generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy)

指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB のユーザー委任キーに基づいて共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。

Parameters:

delegationKey - UserDelegationKeyこの署名の署名に使用されるキーを表す 。
policy - SharedAccessPolicy共有アクセス署名のアクセス ポリシーを表す オブジェクト。

Returns:

String共有アクセス署名を表す 。

Throws:

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

getContainer

public final CloudBlobContainer getContainer()

BLOB のコンテナーを返します。

Overrides:

CloudBlob.getContainer()

Returns:

CloudBlobContainer BLOB のコンテナーを表す オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。
URISyntaxException - リソース URI が無効な場合。

getCopyState

public CopyState getCopyState()

BLOB のコピー状態を返します。

Returns:

CopyState BLOB のコピー状態を表す オブジェクト。

getMetadata

public final HashMap getMetadata()

BLOB のメタデータを返します。

Returns:

java.util.HashMap BLOB のメタデータを表す オブジェクト。

getName

public final String getName()

BLOB の名前を返します。

Returns:

String BLOB の名前を表す 。

getParent

public final CloudBlobDirectory getParent()

BLOB アイテムの親を返します。

Overrides:

CloudBlob.getParent()

Returns:

CloudBlobDirectory BLOB の親ディレクトリを表す オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。
URISyntaxException - リソース URI が無効な場合。

getParentNameFromURI

protected static String getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container)

BLOB URI の親名を取得します。

Parameters:

resourceAddress - StorageUriリソース URI を表す オブジェクト。
delimiter - String使用するディレクトリ区切り記号を指定する 。
container - CloudBlobContainer BLOB コンテナーを表す オブジェクト。

Returns:

String BLOB URI の親アドレスを表す 。

Throws:

URISyntaxException

getProperties

public final BlobProperties getProperties()

BLOB のプロパティを返します。

Returns:

BlobProperties BLOB のプロパティを表す オブジェクト。

getQualifiedStorageUri

public final StorageUri getQualifiedStorageUri()

この BLOB のスナップショットや共有アクセス署名の修飾 URI を返します。

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedStorageUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedStorageUri()"></xref> instead.</p>

</xrefdescription>

Returns:

StorageUriスナップショットまたは共有アクセス署名を表す オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。
URISyntaxException - リソース URI が無効な場合。

getQualifiedUri

public final URI getQualifiedUri()

この BLOB のスナップショットまたは Shared Access Signature の修飾 URI を返します。

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedUri()"></xref> instead.</p>

</xrefdescription>

Returns:

java.net.URIスナップショットまたは共有アクセス署名を表す オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。
URISyntaxException - リソース URI が無効な場合。

getServiceClient

public final CloudBlobClient getServiceClient()

BLOB に関連付けられている BLOB サービス クライアントを返します。

Returns:

CloudBlobClientクライアントを表す オブジェクト。

getSnapshotID

public final String getSnapshotID()

BLOB スナップショット ID を取得します。

Returns:

String BLOB スナップショット ID を表す 。

getSnapshotQualifiedStorageUri

public final StorageUri getSnapshotQualifiedStorageUri()

BLOB がスナップショットの場合は、クエリ文字列情報を含む、プライマリとセカンダリの両方の場所の BLOB の URI を返します。

Returns:

StorageUri BLOB がスナップショットの場合にクエリ情報をスナップショットするなど、プライマリとセカンダリの両方の場所に対する BLOB の URI を含む オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。
URISyntaxException - リソース URI が無効な場合。

getSnapshotQualifiedUri

public final URI getSnapshotQualifiedUri()

BLOB がスナップショットの場合は、クエリ文字列情報を含む絶対 URI を BLOB に返します。

Returns:

java.net.URI BLOB がスナップショットである場合のクエリ情報スナップショット含む、BLOB への絶対 URI を指定する オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。
URISyntaxException - リソース URI が無効な場合。

getStorageUri

public final StorageUri getStorageUri()

すべての場所の URI の一覧を返します。

Overrides:

CloudBlob.getStorageUri()

Returns:

StorageUriすべての場所の URI の一覧を表す 。

getStreamMinimumReadSizeInBytes

public final int getStreamMinimumReadSizeInBytes()

を使用する場合の最小読み取りサイズを BlobInputStream返します。

Returns:

intオブジェクトを使用する場合の最小読み取りサイズ (バイト単位) をBlobInputStream表す 。

getStreamWriteSizeInBytes

public final int getStreamWriteSizeInBytes()

への書き込み BlobOutputStream 時にバッファーするバイト数 (ブロック BLOB とページ BLOB) を取得します。

Returns:

intバッファーに格納するバイト数またはブロックのサイズをバイト単位で表す 。

getTransformedAddress

protected final StorageUri getTransformedAddress(final OperationContext opContext)

指定された資格情報に変換が必要な場合は、リソースの変換された URI を返します。

Parameters:

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

Returns:

StorageUri変換された URI を表す オブジェクト。

Throws:

IllegalArgumentException - URI が絶対でない場合。
StorageException - ストレージ サービス エラーが発生した場合。
URISyntaxException - リソース URI が無効な場合。

getUri

public final URI getUri()

この BLOB の URI を返します。

Overrides:

CloudBlob.getUri()

Returns:

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

isSnapshot

public final boolean isSnapshot()

この BLOB がスナップショットかどうかを示します。

Returns:

trueBLOB がスナップショットの場合は 。それ以外の場合falseは 。

openInputStream

public final BlobInputStream openInputStream()

BLOB 入力ストリームを開き、BLOB をダウンロードします。

を使用して setStreamMinimumReadSizeInBytes(final int minimumReadSize) 、読み取りサイズを構成します。

Returns:

InputStream BLOB からの読み取りに使用するストリームを表す オブジェクト。

Throws:

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

openInputStream

public final BlobInputStream openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して BLOB をダウンロードする BLOB 入力ストリームを開きます。

を使用して setStreamMinimumReadSizeInBytes(final int minimumReadSize) 、読み取りサイズを構成します。

Parameters:

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

InputStream BLOB からの読み取りに使用するストリームを表す オブジェクト。

Throws:

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

openInputStream

public final BlobInputStream openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して BLOB をダウンロードする BLOB 入力ストリームを開きます。 ダウンロード時に BLOB が復号化されると、最終的な MD5 検証はスキップされます。

を使用して setStreamMinimumReadSizeInBytes(final int minimumReadSize) 、読み取りサイズを構成します。

Parameters:

offset - longソースの開始点として使用するオフセットを表す 。
length - Long読み取るバイト数または nullを表す 。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

InputStream BLOB からの読み取りに使用するストリームを表す オブジェクト。

Throws:

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

releaseLease

public final void releaseLease(final AccessCondition accessCondition)

BLOB のリースを解放します。

Parameters:

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。 AccessCondition で LeaseID を設定する必要があります。

Throws:

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

releaseLease

public final void releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、BLOB のリースを解放します。

Parameters:

accessCondition - AccessCondition BLOB のアクセス条件を表す オブジェクト。AccessCondition で LeaseID を設定する必要があります。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

renewLease

public final void renewLease(final AccessCondition accessCondition)

既存のリースを更新します。

Parameters:

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。 AccessCondition で LeaseID を設定する必要があります。

Throws:

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

renewLease

public final void renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、既存のリースを更新します。

Parameters:

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。 AccessCondition で LeaseID を設定する必要があります。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

setContainer

protected final void setContainer(final CloudBlobContainer container)

BLOB のコンテナーを設定します。

Parameters:

container - CloudBlobContainer BLOB に割り当てられているコンテナーを表す オブジェクト。

setMetadata

public final void setMetadata(final HashMap metadata)

BLOB のメタデータを設定します。

Parameters:

metadata - java.util.HashMap BLOB に割り当てられているメタデータを格納している オブジェクト。

setProperties

protected final void setProperties(final BlobProperties properties)

BLOB のプロパティを設定します。

Parameters:

properties - BlobProperties BLOB に割り当てられているプロパティを表す オブジェクト。

setSnapshotID

protected final void setSnapshotID(final String snapshotID)

BLOB スナップショット ID を設定します。

Parameters:

snapshotID - String BLOB に割り当てられているスナップショット ID を表す 。

setStorageUri

protected void setStorageUri(final StorageUri storageUri)

すべての場所の URI の一覧を設定します。

Parameters:

storageUri - StorageUriすべての場所の URI の一覧を表す 。

setStreamMinimumReadSizeInBytes

public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)

を使用する場合の最小読み取りサイズを BlobInputStream設定します。

Parameters:

minimumReadSize - intオブジェクトの使用中に BLOB から読み取るための最小ブロック サイズ (バイト単位) をBlobInputStream表す 。 16 KB 以上である必要があります。

Throws:

IllegalArgumentException - が 16 KB 未満の場合 minimumReadSize 。

setStreamWriteSizeInBytes

public abstract void setStreamWriteSizeInBytes(int streamWriteSizeInBytes)

(ブロックとページ BLOB) への書き込み時にバッファーに格納する BlobOutputStream バイト数を設定します。

Parameters:

streamWriteSizeInBytes - intバッファーに格納するバイト数またはブロックのサイズをバイト単位で表す 。

startCopy

public final String startCopy(final URI source)

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

Parameters:

source - java.net.URIソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。

Returns:

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

Throws:

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

startCopy

public final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

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

Parameters:

source - java.net.URIソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。
sourceAccessCondition - AccessConditionソースのアクセス条件を表す オブジェクト。
destinationAccessCondition - AccessCondition宛先のアクセス条件を表す オブジェクト。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

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

Throws:

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

startCopy

protected final String startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

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

注: premiumPageBlobTier の設定は、Premium アカウントでのみサポートされています。

Parameters:

source - java.net.URIソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。
blobTierString - BLOB の層を表す文字列。
sourceAccessCondition - AccessConditionソースのアクセス条件を表す オブジェクト。
destinationAccessCondition - AccessCondition宛先のアクセス条件を表す オブジェクト。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

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

Throws:

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

startCopy

protected final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

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

注: premiumPageBlobTier の設定は、Premium アカウントでのみサポートされています。

Parameters:

source - java.net.URIソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。
contentMd5 - 操作のトランザクション整合性を確保するために使用される省略可能なハッシュ値。 または空の場合があります null 。
syncCopy - booleanサービスでコピーを同期的に行う必要があるかどうかを示す 。
blobTierString - BLOB の層を表す文字列。
sourceAccessCondition - AccessConditionソースのアクセス条件を表す オブジェクト。
destinationAccessCondition - AccessCondition宛先のアクセス条件を表す オブジェクト。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

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

Throws:

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

startCopy

protected final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

指定された Premium ページ BLOB 層、リハイドレート優先度、アクセス条件、リース ID、要求オプション、操作コンテキストを使用して、URI のコンテンツ、プロパティ、メタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。

注: premiumPageBlobTier の設定は、Premium アカウントでのみサポートされています。

Parameters:

source - java.net.URIソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。
contentMd5 - 操作のトランザクション整合性を確保するために使用される省略可能なハッシュ値。 または空の場合があります null 。
syncCopy - booleanサービスでコピーを同期的に行う必要があるかどうかを示す 。
blobTierString - BLOB の String 層を表す オブジェクト。
rehydratePriority - RehydratePriorityリハイドレート優先度を表す オブジェクト。
sourceAccessCondition - AccessConditionソースのアクセス条件を表す オブジェクト。
destinationAccessCondition - AccessCondition宛先のアクセス条件を表す オブジェクト。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

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

Throws:

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

startCopyImpl

protected StorageRequest startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options)

Parameters:

source
contentMd5
syncCopy
incrementalCopy
blobTierString
rehydratePriority
sourceAccessCondition
destinationAccessCondition
options

undelete

public final void undelete()

論理的に削除された BLOB とそのすべてのスナップショットを削除解除します。

Throws:

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

undelete

public final void undelete(BlobRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、論理的に削除された BLOB を削除解除します。

BLOB の削除解除操作では、論理的に削除された BLOB とそのすべてのスナップショットの内容とメタデータが復元されます。 論理的に削除されていない BLOB またはスナップショットの削除を取り消そうとすると、変更なしで成功します。

Parameters:

options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

updateEtagAndLastModifiedFromResponse

protected void updateEtagAndLastModifiedFromResponse(HttpURLConnection request)

Parameters:

request

updateLengthFromResponse

protected void updateLengthFromResponse(HttpURLConnection request)

Parameters:

request

upload

public abstract void upload(InputStream sourceStream, long length)

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

Parameters:

sourceStream - InputStreamアップロードするソース ストリームを表す オブジェクト。
length - longストリーム データの長さをバイト単位で表す 。不明な場合は -1。 ページ BLOB の長さは 0 より大きく、512 の倍数である必要があります。

Throws:

IOException - I/O 例外が発生した場合。
StorageException - ストレージ サービス エラーが発生した場合。

upload

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

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

Parameters:

sourceStream - InputStreamアップロードするソース ストリームを表す オブジェクト。
length - ストリーム データの長さ (バイト単位)、不明な場合は -1。 ページ BLOB の長さは 0 より大きく、512 の倍数である必要があります。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

IOException - I/O 例外が発生した場合。
StorageException - ストレージ サービス エラーが発生した場合。

uploadFromByteArray

public void uploadFromByteArray(final byte[] buffer, final int offset, final int length)

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

Parameters:

buffer - byte BLOB に書き込むデータを表す配列。
offset - intデータのアップロードを開始するバイト配列のオフセットを表す 。
length - int入力バッファーからアップロードするバイト数を表す 。

Throws:

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

uploadFromByteArray

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

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

Parameters:

buffer - byte BLOB に書き込むデータを表す配列。
offset - intデータのアップロードを開始するバイト配列のオフセットを表す 。
length - int入力バッファーからアップロードするバイト数を表す 。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

uploadFromFile

public void uploadFromFile(final String path)

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

Parameters:

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

Throws:

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

uploadFromFile

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

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

Parameters:

path - Stringアップロードするファイルへのパスを表す 。
accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

uploadMetadata

public final void uploadMetadata()

BLOB のメタデータをストレージ サービスにアップロードします。

を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。

Throws:

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

uploadMetadata

public final void uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、および操作コンテキストを使用して、BLOB のメタデータをストレージ サービスにアップロードします。

を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。

Parameters:

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

uploadProperties

public final void uploadProperties()

BLOB のプロパティをストレージ サービスに更新します。

を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。

Throws:

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

uploadProperties

public final void uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

指定したリース ID、要求オプション、および操作コンテキストを使用して、BLOB のプロパティを更新します。

を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。

Parameters:

accessCondition - BLOB のアクセス条件を表す AccessCondition オブジェクトです。
options - BlobRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

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

validateCPKHeaders

protected static static void validateCPKHeaders(StorageRequest request, BlobRequestOptions options, boolean upload)

要求オプションに CPK が含まれている場合は、関連付けられている応答ヘッダーを検証します。

Parameters:

request - の応答をチェックするストレージ要求。
options - 要求で使用される BLOB オプション。
upload - これがアップロードだったのか、それともデータを取得しているだけなのか。

Throws:

StorageException - 要求で CPK が使用され、応答が検証に失敗した場合にをスローします。

適用対象