CloudBlob クラス
- java.
lang. Object - ListBlobItem
- com.
microsoft. azure. storage. blob. CloudBlob
- com.
public class CloudBlob implements ListBlobItem
Microsoft Azure BLOB を表します。 これは、 クラスと CloudPageBlob クラスのCloudBlockBlob基本クラスです。
フィールドの概要
修飾子と型 | フィールドと説明 |
---|---|
Cloud |
blobServiceClient
BLOB クライアントを表します。 |
Cloud |
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 から値をコピーして、 クラスのインスタンスを作成します。 |
メソッドの概要
フィールドの詳細
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:
String
該当する場合は、スナップショットバージョンを表す 。
Throws:
CloudBlob
protected CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container)
指定した型、名前、スナップショット ID、およびコンテナーを使用して、 クラスのインスタンスを作成します。
Parameters:
String
該当する場合は、スナップショットバージョンを表す 。
Throws:
CloudBlob
protected CloudBlob(final CloudBlob otherBlob)
別の BLOB から値をコピーして、 クラスのインスタンスを作成します。
Parameters:
CloudBlob
コピーする BLOB を表す オブジェクト。
メソッドの詳細
abortCopy
public final void abortCopy(final String copyId)
進行中の BLOB コピー操作を中止します。
Parameters:
String
コピー操作を識別する オブジェクト。
Throws:
abortCopy
public final void abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
進行中の BLOB コピー操作を中止します。
Parameters:
String
コピー操作を識別する オブジェクト。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
acquireLease
public final String acquireLease()
BLOB の新しい無限リースを取得します。
Returns:
String
リース ID を表す 。Throws:
acquireLease
public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId)
指定したリース時間と提案されたリース ID を使用して、BLOB の新しいリースを取得します。
Parameters:
Integer
リースを取得する期間を秒単位で指定する 。 null の場合、無限リースが取得されます。 null でない場合、値は 0 より大きくする必要があります。
String
新しいリースの提案されたリース ID を表す 。リース ID が提案されていない場合は null。
Returns:
String
リース ID を表す 。Throws:
acquireLease
public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定されたリース時間、提案されたリース ID、要求オプション、および操作コンテキストを使用して、BLOB の新しいリースを取得します。
Parameters:
Integer
リースを取得する期間を秒単位で指定する 。 null の場合、無限リースが取得されます。 null でない場合、値は 0 より大きくする必要があります。
String
新しいリースの提案されたリース ID を表す 。リース ID が提案されていない場合は null。
null
指定すると、関連付けられたサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
リース ID を表す 。Throws:
assertCorrectBlobType
protected final void assertCorrectBlobType()
BLOB に BLOB 属性で指定された正しい BLOB の種類があることをアサートします。
Throws:
assertNoWriteOperationForSnapshot
protected void assertNoWriteOperationForSnapshot()
スナップショットに対して書き込み操作が実行されないことをアサートします。
breakLease
public final long breakLease(final Integer breakPeriodInSeconds)
リースを解除し、現在のリース期間が切れるまで別のクライアントが新しいリースを取得できないようにします。
Parameters:
Returns:
long
リース期間の残りの時間を秒単位で指定する 。Throws:
breakLease
public final long breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して既存のリースを解除し、現在のリース期間が切れるまで別のクライアントが新しいリースを取得できないようにします。
Parameters:
Integer
現在のリースが切断されるまで待機する時間を秒単位で指定する 。 null の場合、中断期間は、現在のリースの残り時間となります。無限リースの場合は 0 です。
null
指定すると、関連付けられたサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
long
リース期間に残っている時間 (秒単位) を表す 。Throws:
changeLease
public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition)
既存のリース ID を提案されたリース ID に変更します。
Parameters:
String
新しいリースの提案されたリース ID を表す 。リース ID が提案されていない場合は null。
Returns:
String
新しいリース ID を表す 。Throws:
changeLease
public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
既存のリース ID を、指定されたアクセス条件、要求オプション、および操作コンテキストを使用して、提案されたリース ID に変更します。
Parameters:
String
新しいリースの提案されたリース ID を表す 。リース ID が提案されていない場合は null。
null
指定すると、関連付けられたサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
新しいリース ID を表す 。Throws:
createSnapshot
public final CloudBlob createSnapshot()
BLOB のスナップショットを作成します。
Returns:
CloudBlob
スナップショットを表す オブジェクト。Throws:
createSnapshot
public final CloudBlob createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、BLOB のスナップショットを作成します。
Parameters:
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
CloudBlob
スナップショットを表す オブジェクト。Throws:
createSnapshot
public final CloudBlob createSnapshot(final HashMap
指定した要求オプションと操作コンテキストを使用して、BLOB のスナップショットを作成します。
Parameters:
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
CloudBlob
スナップショットを表す オブジェクト。Throws:
delete
public final void delete()
BLOB を削除します。
サービスで削除アイテム保持ポリシーが有効になっている場合、BLOB は、ガベージ コレクションによって完全に削除される前に、指定された期間保持されます。
Throws:
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:
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
deleteIfExists
public final boolean deleteIfExists()
BLOB が存在する場合は削除します。
スナップショットを持つ BLOB は、スナップショットが削除されてからでないと、削除できません。 BLOB にスナップショットがある場合は、 パラメーターの または INCLUDE_SNAPSHOTS 値を使用DELETE_SNAPSHOTS_ONLYして、BLOB が削除されたときにスナップショットを処理する方法を指定します。
Returns:
true
BLOB が削除された場合は 。それ以外の場合は false
。
Throws:
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:
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
true
BLOB が存在し、削除された場合は 。それ以外の場合は false
Throws:
download
public final void download(final OutputStream outStream)
BLOB の内容をストリームにダウンロードします。
Parameters:
OutputStream
ターゲット ストリームを表す オブジェクト。
Throws:
download
public final void download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、BLOB の内容をストリームにダウンロードします。
Parameters:
OutputStream
ターゲット ストリームを表す オブジェクト。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
downloadAccountInfo
public AccountInformation downloadAccountInfo()
この BLOB が存在するストレージ アカウントに関連する情報を取得します。
Returns:
Throws:
downloadAccountInfo
public AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)
この BLOB が存在するストレージ アカウントに関連する情報を取得します。
Parameters:
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
downloadAccountInformationImpl
protected StorageRequest
Parameters:
downloadAttributes
public final void downloadAttributes()
BLOB のプロパティとメタデータを設定します。
このメソッドは、BLOB のシステム プロパティとユーザー定義メタデータを設定します。 BLOB のプロパティまたはメタデータを読み取ったり変更したりする前に、このメソッドまたはそのオーバーロードを呼び出して、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
Throws:
downloadAttributes
public final void downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、BLOB のプロパティとメタデータを設定します。
このメソッドは、BLOB のシステム プロパティとユーザー定義メタデータを設定します。 BLOB のプロパティまたはメタデータを読み取ったり変更したりする前に、このメソッドまたはそのオーバーロードを呼び出して、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
Parameters:
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
downloadRange
public final void downloadRange(final long offset, final Long length, final OutputStream outStream)
BLOB の内容をストリームにダウンロードします。
Parameters:
long
ソースの開始点として使用するオフセットを表す 。
Long
読み取るバイト数または null
を表す 。
OutputStream
ターゲット ストリームを表す オブジェクト。
Throws:
downloadRange
public final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、BLOB の内容をストリームにダウンロードします。
Parameters:
long
ソースの開始点として使用するオフセットを表す 。
Long
読み取るバイト数または null
を表す 。
OutputStream
ターゲット ストリームを表す オブジェクト。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
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:
long
ダウンロードを開始する BLOB 内のオフセットを表す 。
Long
読み取るバイト数を表す 。
byte
書き込むバッファーを表す配列。
int
書き込みを開始するバイト バッファー内のオフセットを表す 。
Returns:
Throws:
downloadRangeToByteArray
public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)
BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。
Parameters:
long
ソースの開始点として使用するバイト オフセットを表す 。
Long
読み取るバイト数または null バイト数を表す 。
byte
BLOB バイトがダウンロードされるバッファーを表す配列。
int
ターゲットの開始点として使用するバイト オフセットを表す 。
Returns:
Throws:
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:
long
ソースの開始点として使用するバイト オフセットを表す 。
Long
読み取るバイト数または null
を表す 。
byte
BLOB バイトがダウンロードされるバッファーを表す配列。
int
ターゲットの開始点として使用するバイト オフセットを表す 。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
Throws:
downloadToByteArray
public final int downloadToByteArray(final byte[] buffer, final int bufferOffset)
BLOB から特定のバイト バッファーにバイト範囲をダウンロードします。
Parameters:
byte
BLOB バイトがダウンロードされるバッファーを表す配列。
int
ターゲットの開始点として使用するバイト オフセットを表す 。
Throws:
downloadToByteArray
public final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、BLOB から指定されたバイト バッファーにバイト範囲をダウンロードします。
Parameters:
byte
BLOB バイトがダウンロードされるバッファーを表す配列。
long
ターゲットの開始点として使用するバイト オフセットを表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
downloadToFile
public void downloadToFile(final String path)
BLOB をダウンロードし、その内容をファイルに格納します。
Parameters:
String
BLOB の内容で作成されるファイルへのパスを表す 。
Throws:
downloadToFile
public void downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
BLOB をダウンロードし、その内容をファイルに格納します。
Parameters:
String
BLOB の内容で作成されるファイルへのパスを表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
exists
public final boolean exists()
BLOB が存在するかどうかを確認します。
Returns:
true
BLOB が存在する場合は 。それ以外の場合 false
は 。
Throws:
exists
public final boolean exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、BLOB が存在するかどうかを確認します。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
true
BLOB が存在する場合は、他の賢明な false
。
Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier)
指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
Parameters:
SharedAccessPolicy
共有アクセス署名のアクセス ポリシーを表す オブジェクト。
SharedAccessBlobHeaders
この共有アクセス署名でアクセスされる BLOB に設定する省略可能なヘッダー値を表す オブジェクト。
String
コンテナー レベルのアクセス ポリシーを表す 。
Returns:
String
共有アクセス署名を表す 。Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)
指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
Parameters:
SharedAccessPolicy
共有アクセス署名のアクセス ポリシーを表す オブジェクト。
SharedAccessBlobHeaders
この共有アクセス署名でアクセスされる BLOB に設定する省略可能なヘッダー値を表す オブジェクト。
String
コンテナー レベルのアクセス ポリシーを表す 。
Returns:
String
共有アクセス署名を表す 。Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding)
指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
Parameters:
SharedAccessPolicy
共有アクセス署名のアクセス ポリシーを表す オブジェクト。
SharedAccessBlobHeaders
この共有アクセス署名でアクセスされる BLOB に設定する省略可能なヘッダー値を表す オブジェクト。
String
コンテナー レベルのアクセス ポリシーを表す 。
boolean
署名する前にクエリ パラメーターをデコードしないことを示す 。 これは、渡された値が目的の形式であることを顧客が確認する場合にのみ使用する必要があります。 これは、この SDK を使用して要求を行わないサード パーティに対してクライアントを使用して sas を生成するシナリオで役立つ場合があります。
Returns:
String
共有アクセス署名を表す 。Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier)
指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB の共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
Parameters:
SharedAccessPolicy
共有アクセス署名のアクセス ポリシーを表す オブジェクト。
String
コンテナー レベルのアクセス ポリシーを表す 。
Returns:
String
共有アクセス署名を表す 。Throws:
generateUserDelegationSharedAccessSignature
public String generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols)
指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB のユーザー委任キーに基づいて共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
Parameters:
UserDelegationKey
この署名の署名に使用されるキーを表す 。
SharedAccessPolicy
共有アクセス署名のアクセス ポリシーを表す オブジェクト。
SharedAccessBlobHeaders
この共有アクセス署名でアクセスされる BLOB に設定する省略可能なヘッダー値を表す オブジェクト。
Returns:
String
共有アクセス署名を表す 。Throws:
generateUserDelegationSharedAccessSignature
public String generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy)
指定したグループ ポリシー識別子と操作コンテキストを使用して、BLOB のユーザー委任キーに基づいて共有アクセス署名を返します。 先頭の "?"は含まれていないことに注意してください。
Parameters:
UserDelegationKey
この署名の署名に使用されるキーを表す 。
SharedAccessPolicy
共有アクセス署名のアクセス ポリシーを表す オブジェクト。
Returns:
String
共有アクセス署名を表す 。Throws:
getContainer
public final CloudBlobContainer getContainer()
BLOB のコンテナーを返します。
Overrides:
CloudBlob.getContainer()Returns:
Throws:
getCopyState
getMetadata
public final HashMap
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:
Throws:
getParentNameFromURI
protected static String getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container)
BLOB URI の親名を取得します。
Parameters:
String
使用するディレクトリ区切り記号を指定する 。
Returns:
String
BLOB URI の親アドレスを表す 。Throws:
getProperties
public final BlobProperties getProperties()
BLOB のプロパティを返します。
Returns:
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:
Throws:
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:
getServiceClient
public final CloudBlobClient getServiceClient()
BLOB に関連付けられている BLOB サービス クライアントを返します。
Returns:
getSnapshotID
public final String getSnapshotID()
BLOB スナップショット ID を取得します。
Returns:
String
BLOB スナップショット ID を表す 。getSnapshotQualifiedStorageUri
public final StorageUri getSnapshotQualifiedStorageUri()
BLOB がスナップショットの場合は、クエリ文字列情報を含む、プライマリとセカンダリの両方の場所の BLOB の URI を返します。
Returns:
Throws:
getSnapshotQualifiedUri
public final URI getSnapshotQualifiedUri()
BLOB がスナップショットの場合は、クエリ文字列情報を含む絶対 URI を BLOB に返します。
Returns:
java.net.URI
BLOB がスナップショットである場合のクエリ情報スナップショット含む、BLOB への絶対 URI を指定する オブジェクト。Throws:
getStorageUri
public final StorageUri getStorageUri()
すべての場所の URI の一覧を返します。
Overrides:
CloudBlob.getStorageUri()Returns:
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:
Returns:
Throws:
getUri
public final URI getUri()
この BLOB の URI を返します。
Overrides:
CloudBlob.getUri()Returns:
java.net.URI
BLOB の URI を表す オブジェクト。isSnapshot
public final boolean isSnapshot()
この BLOB がスナップショットかどうかを示します。
Returns:
true
BLOB がスナップショットの場合は 。それ以外の場合false
は 。
openInputStream
public final BlobInputStream openInputStream()
BLOB 入力ストリームを開き、BLOB をダウンロードします。
を使用して setStreamMinimumReadSizeInBytes(final int minimumReadSize) 、読み取りサイズを構成します。
Returns:
InputStream
BLOB からの読み取りに使用するストリームを表す オブジェクト。Throws:
openInputStream
public final BlobInputStream openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して BLOB をダウンロードする BLOB 入力ストリームを開きます。
を使用して setStreamMinimumReadSizeInBytes(final int minimumReadSize) 、読み取りサイズを構成します。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
InputStream
BLOB からの読み取りに使用するストリームを表す オブジェクト。Throws:
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:
long
ソースの開始点として使用するオフセットを表す 。
null
を表す 。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
InputStream
BLOB からの読み取りに使用するストリームを表す オブジェクト。Throws:
releaseLease
public final void releaseLease(final AccessCondition accessCondition)
BLOB のリースを解放します。
Parameters:
Throws:
releaseLease
public final void releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、BLOB のリースを解放します。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
renewLease
public final void renewLease(final AccessCondition accessCondition)
既存のリースを更新します。
Parameters:
Throws:
renewLease
public final void renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、既存のリースを更新します。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
setContainer
protected final void setContainer(final CloudBlobContainer container)
BLOB のコンテナーを設定します。
Parameters:
setMetadata
public final void setMetadata(final HashMap
BLOB のメタデータを設定します。
Parameters:
java.util.HashMap
BLOB に割り当てられているメタデータを格納している オブジェクト。
setProperties
protected final void setProperties(final BlobProperties properties)
BLOB のプロパティを設定します。
Parameters:
setSnapshotID
protected final void setSnapshotID(final String snapshotID)
BLOB スナップショット ID を設定します。
Parameters:
String
BLOB に割り当てられているスナップショット ID を表す 。
setStorageUri
protected void setStorageUri(final StorageUri storageUri)
すべての場所の URI の一覧を設定します。
Parameters:
setStreamMinimumReadSizeInBytes
public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)
を使用する場合の最小読み取りサイズを BlobInputStream設定します。
Parameters:
int
オブジェクトの使用中に BLOB から読み取るための最小ブロック サイズ (バイト単位) をBlobInputStream表す 。 16 KB 以上である必要があります。
Throws:
minimumReadSize
。
setStreamWriteSizeInBytes
public abstract void setStreamWriteSizeInBytes(int streamWriteSizeInBytes)
(ブロックとページ BLOB) への書き込み時にバッファーに格納する BlobOutputStream バイト数を設定します。
Parameters:
int
バッファーに格納するバイト数またはブロックのサイズをバイト単位で表す 。
startCopy
public final String startCopy(final URI source)
URI のコンテンツ、プロパティ、およびメタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
java.net.URI
ソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
startCopy
public final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)
指定したアクセス条件、リース ID、要求オプション、操作コンテキストを使用して、URI のコンテンツ、プロパティ、メタデータの新しい BLOB へのコピーを開始するようにサービスに要求します。
Parameters:
java.net.URI
ソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。
null
指定すると、関連付けられているサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
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:
java.net.URI
ソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。
null
指定すると、関連付けられているサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
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:
java.net.URI
ソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。
null
。
boolean
サービスでコピーを同期的に行う必要があるかどうかを示す 。
null
指定すると、関連付けられているサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
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:
java.net.URI
ソース URI。 Azure 外部のリソースの URI は、ブロック BLOB にのみコピーできます。
null
。
boolean
サービスでコピーを同期的に行う必要があるかどうかを示す 。
String
層を表す オブジェクト。
null
指定すると、関連付けられているサービス クライアント (CloudBlobClient) からの既定の要求オプションが使用されます。
Returns:
String
コピー操作に関連付けられているコピー ID を表す 。Throws:
startCopyImpl
protected StorageRequest
Parameters:
undelete
public final void undelete()
論理的に削除された BLOB とそのすべてのスナップショットを削除解除します。
Throws:
undelete
public final void undelete(BlobRequestOptions options, OperationContext opContext)
指定した要求オプションと操作コンテキストを使用して、論理的に削除された BLOB を削除解除します。
BLOB の削除解除操作では、論理的に削除された BLOB とそのすべてのスナップショットの内容とメタデータが復元されます。 論理的に削除されていない BLOB またはスナップショットの削除を取り消そうとすると、変更なしで成功します。
Parameters:
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
updateEtagAndLastModifiedFromResponse
protected void updateEtagAndLastModifiedFromResponse(HttpURLConnection request)
Parameters:
updateLengthFromResponse
protected void updateLengthFromResponse(HttpURLConnection request)
Parameters:
upload
public abstract void upload(InputStream sourceStream, long length)
ソース ストリーム データを BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
InputStream
アップロードするソース ストリームを表す オブジェクト。
long
ストリーム データの長さをバイト単位で表す 。不明な場合は -1。 ページ BLOB の長さは 0 より大きく、512 の倍数である必要があります。
Throws:
upload
public abstract void upload(InputStream sourceStream, long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、操作コンテキストを使用して、ソース ストリーム データを BLOB にアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
InputStream
アップロードするソース ストリームを表す オブジェクト。
null
指定すると、関連付けられているサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadFromByteArray
public void uploadFromByteArray(final byte[] buffer, final int offset, final int length)
バイト配列内のデータから BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
byte
BLOB に書き込むデータを表す配列。
int
データのアップロードを開始するバイト配列のオフセットを表す 。
int
入力バッファーからアップロードするバイト数を表す 。
Throws:
uploadFromByteArray
public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
バイト配列内のデータから BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
byte
BLOB に書き込むデータを表す配列。
int
データのアップロードを開始するバイト配列のオフセットを表す 。
int
入力バッファーからアップロードするバイト数を表す 。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadFromFile
public void uploadFromFile(final String path)
ファイルから BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
String
アップロードするファイルへのパスを表す 。
Throws:
uploadFromFile
public void uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
ファイルから BLOB をアップロードします。 サービスに BLOB が既に存在する場合は、上書きされます。
Parameters:
String
アップロードするファイルへのパスを表す 。
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadMetadata
public final void uploadMetadata()
BLOB のメタデータをストレージ サービスにアップロードします。
を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
Throws:
uploadMetadata
public final void uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、および操作コンテキストを使用して、BLOB のメタデータをストレージ サービスにアップロードします。
を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
Parameters:
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
uploadProperties
public final void uploadProperties()
BLOB のプロパティをストレージ サービスに更新します。
を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
Throws:
uploadProperties
public final void uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
指定したリース ID、要求オプション、および操作コンテキストを使用して、BLOB のプロパティを更新します。
を使用して downloadAttributes() 、Microsoft Azure ストレージ サービスから BLOB のプロパティとメタデータの最新の値を取得します。
Parameters:
null
指定すると、関連付けられたサービス クライアント ( CloudBlobClient) からの既定の要求オプションが使用されます。
Throws:
validateCPKHeaders
protected static static
要求オプションに CPK が含まれている場合は、関連付けられている応答ヘッダーを検証します。
Parameters:
Throws:
適用対象
Azure SDK for Java