CloudBlob Klasse

Paket:

com.microsoft.azure.storage.blob

• java.lang.Object
• • ListBlobItem
  • • com.microsoft.azure.storage.blob.CloudBlob

public class CloudBlob implements ListBlobItem

Stellt ein Microsoft Azure-Blob dar. Dies ist die Basisklasse für die CloudBlockBlob Klassen und CloudPageBlob .

Feldzusammenfassung

Modifizierer und Typ	Feld und Beschreibung
CloudBlobClient	blobServiceClient Stellt den Blobclient dar.
CloudBlobDirectory	parent Stellt das Verzeichnis des Blobs dar.
int	streamMinimumReadSizeInBytes Enthält die minimale Lesegröße bei Verwendung von BlobInputStream.
int	streamWriteSizeInBytes Enthält die Anzahl der Bytes, die beim Schreiben in ein BlobOutputStream (Block- und Seitenblobs) gepuffert werden sollen.

Zusammenfassung zum Konstruktor

Konstruktor	Beschreibung
CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen URI, der angegebenen Momentaufnahme-ID und des angegebenen Cloudblobclients.
CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen Typs, Namens, Momentaufnahme ID und Containers.
CloudBlob(final CloudBlob otherBlob)	Erstellt eine instance der -Klasse durch Kopieren von Werten aus einem anderen Blob.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
final void	abortCopy(final String copyId) Bricht einen laufenden Blob-Kopiervorgang ab.
final void	abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Bricht einen laufenden Blob-Kopiervorgang ab.
final String	acquireLease() Ruft eine neue unendliche Lease für das Blob ab.
final String	acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId) Ruft eine neue Lease für das Blob mit der angegebenen Leasezeit und der vorgeschlagenen Lease-ID ab.
final String	acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Ruft eine neue Lease für das Blob mit der angegebenen Leasezeit, der vorgeschlagenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext ab.
final void	assertCorrectBlobType() Bestätigt, dass das Blob über den richtigen Blobtyp verfügt, der in den Blobattributen angegeben ist.
void	assertNoWriteOperationForSnapshot() Bestätigt, dass der Schreibvorgang für Momentaufnahme nicht ausgeführt wird.
final long	breakLease(final Integer breakPeriodInSeconds) Bricht die Lease auf und stellt sicher, dass ein anderer Client erst dann eine neue Lease erwerben kann, wenn der aktuelle Leasezeitraum abgelaufen ist.
final long	breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Unterbricht die vorhandene Lease unter Verwendung der angegebenen Anforderungsoptionen und des Vorgangskontexts und stellt sicher, dass ein anderer Client keine neue Lease erwerben kann, bis der aktuelle Leasezeitraum abgelaufen ist.
final String	changeLease(final String proposedLeaseId, final AccessCondition accessCondition) Ändert die vorhandene Lease-ID in die vorgeschlagene Lease-ID.
final String	changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Ändert die vorhandene Lease-ID in die vorgeschlagene Lease-ID mit den angegebenen Zugriffsbedingungen, Anforderungsoptionen und dem angegebenen Vorgangskontext.
final CloudBlob	createSnapshot() Erstellt eine Momentaufnahme des Blobs.
final CloudBlob	createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Erstellt eine Momentaufnahme des Blobs unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.
final CloudBlob	createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Erstellt eine Momentaufnahme des Blobs unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.
final void	delete() Löscht das Blob. Wenn eine Löschaufbewahrungsrichtlinie für den Dienst aktiviert ist, wird das Blob für einen bestimmten Zeitraum aufbewahrt, bevor es von der Garbage Collection dauerhaft entfernt wird.
final void	delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Löscht das Blob mithilfe der angegebenen Momentaufnahme- und Anforderungsoptionen sowie des Vorgangskontexts. Wenn eine Löschaufbewahrungsrichtlinie für den Dienst aktiviert ist, wird das Blob für einen bestimmten Zeitraum aufbewahrt, bevor es von der Garbage Collection dauerhaft entfernt wird. Ein BLOB mit Momentaufnahmen kann nicht gelöscht werden, es sei denn, die Momentaufnahmen werden ebenfalls gelöscht. Wenn ein Blob Über Momentaufnahmen verfügt, verwenden Sie den DELETE_SNAPSHOTS_ONLY Wert oder INCLUDE_SNAPSHOTS im Parameter, um anzugeben, wie die Momentaufnahmen behandelt werden sollen, wenn das Blob gelöscht wird.
final boolean	deleteIfExists() Löscht das Blob, sofern vorhanden. Ein BLOB mit Momentaufnahmen kann nicht gelöscht werden, es sei denn, die Momentaufnahmen werden ebenfalls gelöscht. Wenn ein Blob Über Momentaufnahmen verfügt, verwenden Sie den DELETE_SNAPSHOTS_ONLY Wert oder INCLUDE_SNAPSHOTS im Parameter, um anzugeben, wie die Momentaufnahmen behandelt werden sollen, wenn das Blob gelöscht wird.
final boolean	deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Löscht das Blob, sofern vorhanden, unter Verwendung der angegebenen Momentaufnahme- und Anforderungsoptionen sowie des Vorgangskontexts. Ein BLOB mit Momentaufnahmen kann nicht gelöscht werden, es sei denn, die Momentaufnahmen werden ebenfalls gelöscht. Wenn ein Blob Über Momentaufnahmen verfügt, verwenden Sie den DELETE_SNAPSHOTS_ONLY Wert oder INCLUDE_SNAPSHOTS im Parameter, um anzugeben, wie die Momentaufnahmen behandelt werden sollen, wenn das Blob gelöscht wird.
final void	download(final OutputStream outStream) Lädt den Inhalt eines BLOBs in einen Datenstrom herunter.
final void	download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt den Inhalt eines Blobs mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts in einen Stream herunter.
AccountInformation	downloadAccountInfo() Ruft Informationen im Zusammenhang mit dem Speicherkonto ab, in dem sich dieses Blob befindet.
AccountInformation	downloadAccountInfo(BlobRequestOptions options, OperationContext opContext) Ruft Informationen im Zusammenhang mit dem Speicherkonto ab, in dem sich dieses Blob befindet.
StorageRequest<ServiceClient, CloudBlob, AccountInformation>	downloadAccountInformationImpl(final RequestOptions options)
final void	downloadAttributes() Füllt die Eigenschaften und Metadaten eines Blobs auf. Diese Methode füllt die Systemeigenschaften und benutzerdefinierten Metadaten des Blobs auf. Rufen Sie vor dem Lesen oder Ändern der Eigenschaften oder Metadaten eines Blobs diese Methode oder deren Überladung auf, um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.
final void	downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Füllt die Eigenschaften und Metadaten eines Blobs unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts auf. Diese Methode füllt die Systemeigenschaften und benutzerdefinierten Metadaten des Blobs auf. Rufen Sie vor dem Lesen oder Ändern der Eigenschaften oder Metadaten eines Blobs diese Methode oder deren Überladung auf, um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.
final void	downloadRange(final long offset, final Long length, final OutputStream outStream) Lädt den Inhalt eines BLOBs in einen Datenstrom herunter.
final void	downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt den Inhalt eines Blobs mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts in einen Stream herunter.
final int	downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt einen Bytebereich aus dem Blob in den angegebenen Bytepuffer herunter.
final int	downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset) Lädt einen Bytebereich aus dem Blob in den angegebenen Bytepuffer herunter.
final int	downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt einen Bytebereich aus dem Blob unter Verwendung der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts in den angegebenen Bytepuffer herunter.
final int	downloadToByteArray(final byte[] buffer, final int bufferOffset) Lädt einen Bytebereich aus dem Blob in den angegebenen Bytepuffer herunter.
final int	downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt einen Bytebereich aus dem Blob unter Verwendung der angegebenen Anforderungsoptionen und des Vorgangskontexts in den angegebenen Bytepuffer herunter.
void	downloadToFile(final String path) Lädt ein Blob herunter und speichert den Inhalt in einer Datei.
void	downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt ein Blob herunter und speichert den Inhalt in einer Datei.
final boolean	exists() Überprüft, ob das Blob vorhanden ist.
final boolean	exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Überprüft mithilfe der angegebenen Anforderungsoptionen und des Vorgangskontexts, ob das Blob vorhanden ist.
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier) Gibt eine Shared Access Signature für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) Gibt eine Shared Access Signature für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding) Gibt eine Shared Access Signature für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier) Gibt eine Shared Access Signature für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.
String	generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols) Gibt eine Freigegebene Zugriffssignatur basierend auf einem Benutzerdelegierungsschlüssel für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.
String	generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy) Gibt eine Freigegebene Zugriffssignatur basierend auf einem Benutzerdelegierungsschlüssel für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.
final CloudBlobContainer	getContainer() Gibt den Container des Blobs zurück.
CopyState	getCopyState() Gibt den Kopierstatus des Blobs zurück.
final HashMap<String, String>	getMetadata() Gibt die Metadaten für das Blob zurück.
final String	getName() Gibt den Namen des Blobs zurück.
final CloudBlobDirectory	getParent() Gibt das übergeordnete Element des Blobelements zurück.
String	getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container) Ruft den übergeordneten Namen für einen Blob-URI ab.
final BlobProperties	getProperties() Gibt die Eigenschaften des Blobs zurück.
final StorageUri	getQualifiedStorageUri() Gibt den Momentaufnahme und/oder den qualifizierten URI für die Shared Access Signature für dieses Blob zurück. <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() Gibt den Momentaufnahme oder den qualifizierten URI für die Shared Access Signature für dieses Blob zurück. <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() Gibt den Dem Blob zugeordneten Blobdienstclient zurück.
final String	getSnapshotID() Ruft die Blobmomentaufnahme-ID ab.
final StorageUri	getSnapshotQualifiedStorageUri() Gibt den URI des Blobs sowohl für den primären als auch für den sekundären Speicherort zurück, einschließlich Abfragezeichenfolgeninformationen, wenn das Blob ein Momentaufnahme ist.
final URI	getSnapshotQualifiedUri() Gibt den absoluten URI für das Blob zurück, einschließlich Abfragezeichenfolgeninformationen, wenn das Blob ein Momentaufnahme ist.
final StorageUri	getStorageUri() Gibt die Liste der URIs für alle Speicherorte zurück.
final int	getStreamMinimumReadSizeInBytes() Gibt die minimale Lesegröße zurück, wenn ein verwendet wird BlobInputStream.
final int	getStreamWriteSizeInBytes() Ruft die Anzahl der Bytes ab, die beim Schreiben in ein BlobOutputStream (Block- und Seitenblobs) gepuffert werden sollen.
final StorageUri	getTransformedAddress(final OperationContext opContext) Gibt den transformierten URI für die Ressource zurück, wenn die angegebenen Anmeldeinformationen eine Transformation erfordern.
final URI	getUri() Gibt den URI für dieses Blob zurück.
final boolean	isSnapshot() Gibt an, ob es sich bei diesem Blob um ein Momentaufnahme handelt.
final BlobInputStream	openInputStream() Öffnet einen Blobeingabestream zum Herunterladen des Blobs. Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.
final BlobInputStream	openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Öffnet einen Blobeingabestream, um das Blob mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts herunterzuladen. Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.
final BlobInputStream	openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Öffnet einen Blobeingabestream, um das Blob mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts herunterzuladen. Wenn das Blob beim Herunterladen entschlüsselt wird, wird die endgültige MD5-Überprüfung übersprungen. Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.
final void	releaseLease(final AccessCondition accessCondition) Gibt die Lease für das BLOB frei.
final void	releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Gibt die Lease für das Blob unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts frei.
final void	renewLease(final AccessCondition accessCondition) Erneuert eine vorhandene Lease.
final void	renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Erneuert eine vorhandene Lease mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.
final void	setContainer(final CloudBlobContainer container) Legt den Container für das Blob fest.
final void	setMetadata(final HashMap<String, String> metadata) Legt die Metadaten für das Blob fest.
final void	setProperties(final BlobProperties properties) Legt die Eigenschaften für das Blob fest.
final void	setSnapshotID(final String snapshotID) Legt die Blob-Momentaufnahme-ID fest.
void	setStorageUri(final StorageUri storageUri) Legt die Liste der URIs für alle Speicherorte fest.
void	setStreamMinimumReadSizeInBytes(final int minimumReadSize) Legt die minimale Lesegröße fest, wenn ein verwendet wird BlobInputStream.
abstract void	setStreamWriteSizeInBytes(int streamWriteSizeInBytes) Legt die Anzahl der Bytes fest, die beim Schreiben in ein BlobOutputStream (Block- und Seitenblobs) gepuffert werden sollen.
final String	startCopy(final URI source) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob zu beginnen.
final String	startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.
final String	startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob zu beginnen, wobei die angegebene Premium-Seitenblobebene, Zugriffsbedingungen, Lease-ID, Anforderungsoptionen und Vorgangskontext verwendet werden. Hinweis: Das Festlegen von premiumPageBlobTier wird nur für Premium-Konten unterstützt.
final String	startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob zu beginnen, wobei die angegebene Premium-Seitenblobebene, Zugriffsbedingungen, Lease-ID, Anforderungsoptionen und Vorgangskontext verwendet werden. Hinweis: Das Festlegen von premiumPageBlobTier wird nur für Premium-Konten unterstützt.
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) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob zu beginnen, wobei die angegebene Premium-Seitenblobebene verwendet wird, Priorität, Zugriffsbedingungen, Lease-ID, Anforderungsoptionen und Vorgangskontext aktiviert wird. Hinweis: Das Festlegen von premiumPageBlobTier wird nur für Premium-Konten unterstützt.
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() Hebt ein Blob und alle momentaufnahmen auf, die vorläufig gelöscht wurden.
final void	undelete(BlobRequestOptions options, OperationContext opContext) Löscht ein Blob, das vorläufig gelöscht wurde, unter Verwendung der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts. Der Vorgang zum Aufheben des Löschens von Blobs stellt den Inhalt und die Metadaten des vorläufig gelöschten Blobs und aller zugehörigen Momentaufnahmen wieder her. Der Versuch, ein Blob oder eine Momentaufnahme, die nicht vorläufig gelöscht wurde, wiederherstellen, ist ohne Änderungen erfolgreich.
void	updateEtagAndLastModifiedFromResponse(HttpURLConnection request)
void	updateLengthFromResponse(HttpURLConnection request)
abstract void	upload(InputStream sourceStream, long length) Lädt die Quellstreamdaten in das Blob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.
abstract void	upload(InputStream sourceStream, long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt die Quellstreamdaten mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext in das Blob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length) Lädt ein Blob aus Daten in einem Bytearray hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt ein Blob aus Daten in einem Bytearray hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.
void	uploadFromFile(final String path) Lädt ein Blob aus einer Datei hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.
void	uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt ein Blob aus einer Datei hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.
final void	uploadMetadata() Lädt die Metadaten des Blobs in den Speicherdienst hoch. Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.
final void	uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt die Metadaten des Blobs mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext in den Speicherdienst hoch. Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.
final void	uploadProperties() Updates die Eigenschaften des Blobs an den Speicherdienst. Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.
final void	uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Updates die Eigenschaften des Blobs mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext. Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.
static<T extends CloudBlob, R> void	validateCPKHeaders(StorageRequest<CloudBlobClient, T, R> request, BlobRequestOptions options, boolean upload) Wenn die Anforderungsoptionen einen CPK enthalten, überprüfen Sie die zugeordneten Antwortheader.

Felddetails

blobServiceClient

protected CloudBlobClient blobServiceClient

Stellt den Blobclient dar.

parent

protected CloudBlobDirectory parent

Stellt das Verzeichnis des Blobs dar.

streamMinimumReadSizeInBytes

protected int streamMinimumReadSizeInBytes= Constants.DEFAULT_MINIMUM_READ_SIZE_IN_BYTES

Enthält die minimale Lesegröße bei Verwendung von BlobInputStream.

streamWriteSizeInBytes

protected int streamWriteSizeInBytes= Constants.DEFAULT_STREAM_WRITE_IN_BYTES

Enthält die Anzahl der Bytes, die beim Schreiben in ein BlobOutputStream (Block- und Seitenblobs) gepuffert werden sollen.

Details zum Konstruktor

CloudBlob

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

Erstellt eine instance der -Klasse unter Verwendung des angegebenen URI, der angegebenen Momentaufnahme-ID und des angegebenen Cloudblobclients.

Parameters:

type - Ein BlobType -Wert, der den Typ des Blobs darstellt.

uri - Ein StorageUri -Objekt, das den URI für das Blob darstellt, beginnend mit dem Containernamen.

snapshotID - Ein String , der ggf. die Momentaufnahme Version darstellt.

credentials - Ein StorageCredentials -Objekt, das zum Authentifizieren des Zugriffs verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudBlob

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

Erstellt eine instance der -Klasse unter Verwendung des angegebenen Typs, Namens, Momentaufnahme ID und Containers.

Parameters:

type - Ein BlobType -Wert, der den Typ des Blobs darstellt.

blobName - Der Name des Blobs.

snapshotID - Ein String , der ggf. die Momentaufnahme Version darstellt.

container - Der Verweis auf den übergeordneten Container.

Throws:

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

CloudBlob

protected CloudBlob(final CloudBlob otherBlob)

Erstellt eine instance der -Klasse durch Kopieren von Werten aus einem anderen Blob.

Parameters:

otherBlob - Ein CloudBlob -Objekt, das das zu kopierende Blob darstellt.

Details zur Methode

abortCopy

public final void abortCopy(final String copyId)

Bricht einen laufenden Blob-Kopiervorgang ab.

Parameters:

copyId - Ein String -Objekt, das den Kopiervorgang identifiziert.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

abortCopy

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

Bricht einen laufenden Blob-Kopiervorgang ab.

Parameters:

copyId - Ein String -Objekt, das den Kopiervorgang identifiziert.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

acquireLease

public final String acquireLease()

Ruft eine neue unendliche Lease für das Blob ab.

Returns:

Ein String , der die Lease-ID darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

acquireLease

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

Ruft eine neue Lease für das Blob mit der angegebenen Leasezeit und der vorgeschlagenen Lease-ID ab.

Parameters:

leaseTimeInSeconds - Ein Integer , der die Zeitspanne angibt, für die die Lease in Sekunden abgerufen werden soll. Wenn null, wird eine unendliche Lease erworben. Wenn nicht NULL, muss der Wert größer als 0 sein.

proposedLeaseId - Ein String , der die vorgeschlagene Lease-ID für die neue Lease darstellt, oder NULL, wenn keine Lease-ID vorgeschlagen wird.

Returns:

Ein String , der die Lease-ID darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

acquireLease

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

Ruft eine neue Lease für das Blob mit der angegebenen Leasezeit, der vorgeschlagenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext ab.

Parameters:

leaseTimeInSeconds - Ein Integer , der die Zeitspanne angibt, für die die Lease in Sekunden abgerufen werden soll. Wenn null, wird eine unendliche Lease erworben. Wenn nicht NULL, muss der Wert größer als 0 sein.

proposedLeaseId - Ein String , der die vorgeschlagene Lease-ID für die neue Lease darstellt, oder NULL, wenn keine Lease-ID vorgeschlagen wird.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Der Kontext wird verwendet, um Anforderungen an den Speicherdienst nachzuverfolgen und zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die Lease-ID darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

assertCorrectBlobType

protected final void assertCorrectBlobType()

Bestätigt, dass das Blob über den richtigen Blobtyp verfügt, der in den Blobattributen angegeben ist.

Throws:

StorageException - Wenn ein falscher Blobtyp verwendet wird.

assertNoWriteOperationForSnapshot

protected void assertNoWriteOperationForSnapshot()

Bestätigt, dass der Schreibvorgang für Momentaufnahme nicht ausgeführt wird.

breakLease

public final long breakLease(final Integer breakPeriodInSeconds)

Bricht die Lease auf und stellt sicher, dass ein anderer Client erst dann eine neue Lease erwerben kann, wenn der aktuelle Leasezeitraum abgelaufen ist.

Parameters:

breakPeriodInSeconds - Gibt die Zeit an, in Sekunden zu warten, bis die aktuelle Lease unterbrochen wird. Falls NULL gilt, ist der Unterbrechungszeitraum der Rest der aktuellen Lease oder 0 (NULL) bei unbegrenzten Leases.

Returns:

Ein long , der die verbleibende Zeit im Leasezeitraum in Sekunden angibt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

breakLease

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

Unterbricht die vorhandene Lease unter Verwendung der angegebenen Anforderungsoptionen und des Vorgangskontexts und stellt sicher, dass ein anderer Client keine neue Lease erwerben kann, bis der aktuelle Leasezeitraum abgelaufen ist.

Parameters:

breakPeriodInSeconds - Ein Integer , der die Zeit angibt, in Sekunden zu warten, bis die aktuelle Lease unterbrochen wird. Falls NULL gilt, ist der Unterbrechungszeitraum der Rest der aktuellen Lease oder 0 (NULL) bei unbegrenzten Leases.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Der Kontext wird verwendet, um Anforderungen an den Speicherdienst nachzuverfolgen und zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein long , der die Zeit in Sekunden darstellt, die im Leasezeitraum verbleibt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

changeLease

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

Ändert die vorhandene Lease-ID in die vorgeschlagene Lease-ID.

Parameters:

proposedLeaseId - Ein String , der die vorgeschlagene Lease-ID für die neue Lease darstellt, oder NULL, wenn keine Lease-ID vorgeschlagen wird.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt. Die Lease-ID muss mit einer Zugriffsbedingung festgelegt werden.

Returns:

Ein String , der die neue Lease-ID darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

changeLease

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

Ändert die vorhandene Lease-ID in die vorgeschlagene Lease-ID mit den angegebenen Zugriffsbedingungen, Anforderungsoptionen und dem angegebenen Vorgangskontext.

Parameters:

proposedLeaseId - Ein String , der die vorgeschlagene Lease-ID für die neue Lease darstellt, oder NULL, wenn keine Lease-ID vorgeschlagen wird.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt. Die Lease-ID muss mit einer Zugriffsbedingung festgelegt werden.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Der Kontext wird verwendet, um Anforderungen an den Speicherdienst nachzuverfolgen und zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die neue Lease-ID darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

createSnapshot

public final CloudBlob createSnapshot()

Erstellt eine Momentaufnahme des Blobs.

Returns:

Ein CloudBlob -Objekt, das die Momentaufnahme des Blobs darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

createSnapshot

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

Erstellt eine Momentaufnahme des Blobs unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein CloudBlob -Objekt, das die Momentaufnahme des Blobs darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

createSnapshot

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

Erstellt eine Momentaufnahme des Blobs unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.

Parameters:

metadata - Eine Auflistung von Name-Wert-Paaren, die die Metadaten des Momentaufnahme oder NULL definieren.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein CloudBlob -Objekt, das die Momentaufnahme des Blobs darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

delete

public final void delete()

Löscht das Blob.

Wenn eine Löschaufbewahrungsrichtlinie für den Dienst aktiviert ist, wird das Blob für einen bestimmten Zeitraum aufbewahrt, bevor es von der Garbage Collection dauerhaft entfernt wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

delete

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

Löscht das Blob mithilfe der angegebenen Momentaufnahme- und Anforderungsoptionen sowie des Vorgangskontexts.

Wenn eine Löschaufbewahrungsrichtlinie für den Dienst aktiviert ist, wird das Blob für einen bestimmten Zeitraum aufbewahrt, bevor es von der Garbage Collection dauerhaft entfernt wird.

Ein BLOB mit Momentaufnahmen kann nicht gelöscht werden, es sei denn, die Momentaufnahmen werden ebenfalls gelöscht. Wenn ein Blob Über Momentaufnahmen verfügt, verwenden Sie den DELETE_SNAPSHOTS_ONLY Wert oder INCLUDE_SNAPSHOTS im Parameter, um anzugeben, wie die Momentaufnahmen behandelt werden sollen, wenn das Blob gelöscht wird.

Parameters:

deleteSnapshotsOption - Ein DeleteSnapshotsOption -Objekt, das angibt, ob nur Momentaufnahmen oder das Blob und seine Momentaufnahmen gelöscht werden sollen.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

deleteIfExists

public final boolean deleteIfExists()

Löscht das Blob, sofern vorhanden.

Ein BLOB mit Momentaufnahmen kann nicht gelöscht werden, es sei denn, die Momentaufnahmen werden ebenfalls gelöscht. Wenn ein Blob Über Momentaufnahmen verfügt, verwenden Sie den DELETE_SNAPSHOTS_ONLY Wert oder INCLUDE_SNAPSHOTS im Parameter, um anzugeben, wie die Momentaufnahmen behandelt werden sollen, wenn das Blob gelöscht wird.

Returns:

true , wenn das Blob gelöscht wurde; falseandernfalls .

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

deleteIfExists

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

Löscht das Blob, sofern vorhanden, unter Verwendung der angegebenen Momentaufnahme- und Anforderungsoptionen sowie des Vorgangskontexts.

Ein BLOB mit Momentaufnahmen kann nicht gelöscht werden, es sei denn, die Momentaufnahmen werden ebenfalls gelöscht. Wenn ein Blob Über Momentaufnahmen verfügt, verwenden Sie den DELETE_SNAPSHOTS_ONLY Wert oder INCLUDE_SNAPSHOTS im Parameter, um anzugeben, wie die Momentaufnahmen behandelt werden sollen, wenn das Blob gelöscht wird.

Parameters:

deleteSnapshotsOption - Ein DeleteSnapshotsOption -Objekt, das angibt, ob nur Momentaufnahmen oder das Blob und seine Momentaufnahmen gelöscht werden sollen.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

true , wenn das Blob vorhanden und gelöscht wurde; Andernfalls false

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

download

public final void download(final OutputStream outStream)

Lädt den Inhalt eines BLOBs in einen Datenstrom herunter.

Parameters:

outStream - Ein OutputStream -Objekt, das den Zieldatenstrom darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

download

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

Lädt den Inhalt eines Blobs mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts in einen Stream herunter.

Parameters:

outStream - Ein OutputStream -Objekt, das den Zieldatenstrom darstellt.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadAccountInfo

public AccountInformation downloadAccountInfo()

Ruft Informationen im Zusammenhang mit dem Speicherkonto ab, in dem sich dieses Blob befindet.

Returns:

Ein AccountInformation -Objekt für das angegebene Speicherkonto.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadAccountInfo

public AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)

Ruft Informationen im Zusammenhang mit dem Speicherkonto ab, in dem sich dieses Blob befindet.

Parameters:

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein AccountInformation -Objekt für das angegebene Speicherkonto.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadAccountInformationImpl

protected StorageRequest downloadAccountInformationImpl(final RequestOptions options)

Parameters:

options

downloadAttributes

public final void downloadAttributes()

Füllt die Eigenschaften und Metadaten eines Blobs auf.

Diese Methode füllt die Systemeigenschaften und benutzerdefinierten Metadaten des Blobs auf. Rufen Sie vor dem Lesen oder Ändern der Eigenschaften oder Metadaten eines Blobs diese Methode oder deren Überladung auf, um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadAttributes

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

Füllt die Eigenschaften und Metadaten eines Blobs unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts auf.

Diese Methode füllt die Systemeigenschaften und benutzerdefinierten Metadaten des Blobs auf. Rufen Sie vor dem Lesen oder Ändern der Eigenschaften oder Metadaten eines Blobs diese Methode oder deren Überladung auf, um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadRange

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

Lädt den Inhalt eines BLOBs in einen Datenstrom herunter.

Parameters:

offset - Ein long , der den Offset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes oder nulldarstellt.

outStream - Ein OutputStream -Objekt, das den Zieldatenstrom darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadRange

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

Lädt den Inhalt eines Blobs mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts in einen Stream herunter.

Parameters:

offset - Ein long , der den Offset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes oder nulldarstellt.

outStream - Ein OutputStream -Objekt, das den Zieldatenstrom darstellt.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadRangeInternal

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

Lädt einen Bytebereich aus dem Blob in den angegebenen Bytepuffer herunter.

Parameters:

blobOffset - Ein long , der den Offset innerhalb des Blobs darstellt, der mit dem Herunterladen beginnen soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes darstellt.

buffer - Ein byte Array, das den Puffer darstellt, in den geschrieben werden soll.

bufferOffset - Ein int , der den Offset im Bytepuffer darstellt, um mit dem Schreiben zu beginnen.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt.

opContext - Ein OperationContext Objekt, das zum Nachverfolgen der Ausführung des Vorgangs verwendet wird.

Returns:

Die Gesamtanzahl der in den Puffer gelesenen Bytes.

Throws:

StorageException - eine Ausnahme, die jeden Fehler darstellt, der während des Vorgangs aufgetreten ist.

downloadRangeToByteArray

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

Lädt einen Bytebereich aus dem Blob in den angegebenen Bytepuffer herunter.

Parameters:

offset - Ein long , der den Byteoffset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes oder NULL darstellt.

buffer - Ein byte Array, das den Puffer darstellt, in den die Blobbytes heruntergeladen werden.

bufferOffset - Ein int , der den Byteoffset darstellt, der als Ausgangspunkt für das Ziel verwendet werden soll.

Returns:

Die Gesamtanzahl der in den Puffer gelesenen Bytes.

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)

Lädt einen Bytebereich aus dem Blob unter Verwendung der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts in den angegebenen Bytepuffer herunter.

Parameters:

offset - Ein long , der den Byteoffset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes oder nulldarstellt.

buffer - Ein byte Array, das den Puffer darstellt, in den die Blobbytes heruntergeladen werden.

bufferOffset - Ein int , der den Byteoffset darstellt, der als Ausgangspunkt für das Ziel verwendet werden soll.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Die Gesamtanzahl der in den Puffer gelesenen Bytes.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadToByteArray

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

Lädt einen Bytebereich aus dem Blob in den angegebenen Bytepuffer herunter.

Parameters:

buffer - Ein byte Array, das den Puffer darstellt, in den die Blobbytes heruntergeladen werden.

bufferOffset - Ein int , der den Byteoffset darstellt, der als Ausgangspunkt für das Ziel verwendet werden soll.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadToByteArray

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

Lädt einen Bytebereich aus dem Blob unter Verwendung der angegebenen Anforderungsoptionen und des Vorgangskontexts in den angegebenen Bytepuffer herunter.

Parameters:

buffer - Ein byte Array, das den Puffer darstellt, in den die Blobbytes heruntergeladen werden.

bufferOffset - Ein long , der den Byteoffset darstellt, der als Ausgangspunkt für das Ziel verwendet werden soll.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadToFile

public void downloadToFile(final String path)

Lädt ein Blob herunter und speichert den Inhalt in einer Datei.

Parameters:

path - Ein String , der den Pfad zu der Datei darstellt, die mit dem Inhalt des Blobs erstellt wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

downloadToFile

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

Lädt ein Blob herunter und speichert den Inhalt in einer Datei.

Parameters:

path - Ein String , der den Pfad zu der Datei darstellt, die mit dem Inhalt des Blobs erstellt wird.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

exists

public final boolean exists()

Überprüft, ob das Blob vorhanden ist.

Returns:

true , wenn das Blob vorhanden ist, andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

exists

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

Überprüft mithilfe der angegebenen Anforderungsoptionen und des Vorgangskontexts, ob das Blob vorhanden ist.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

true , wenn das Blob vorhanden ist, andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateSharedAccessSignature

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

Gibt eine Shared Access Signature für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.

Parameters:

policy - Ein SharedAccessPolicy -Objekt, das die Zugriffsrichtlinie für die Shared Access Signature darstellt.

headers - Ein SharedAccessBlobHeaders -Objekt, das die optionalen Headerwerte darstellt, die für ein Blob festgelegt werden sollen, auf das mit dieser Shared Access Signature zugegriffen wird.

groupPolicyIdentifier - Eine String , die die Zugriffsrichtlinie auf Containerebene darstellt.

Returns:

Eine String , die die Shared Access Signature darstellt.

Throws:

IllegalArgumentException - Wenn die Anmeldeinformationen ungültig sind oder das Blob ein Momentaufnahme ist.

InvalidKeyException - Wenn die Anmeldeinformationen ungültig sind.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateSharedAccessSignature

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

Gibt eine Shared Access Signature für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.

Parameters:

policy - Ein SharedAccessPolicy -Objekt, das die Zugriffsrichtlinie für die Shared Access Signature darstellt.

headers - Ein SharedAccessBlobHeaders -Objekt, das die optionalen Headerwerte darstellt, die für ein Blob festgelegt werden sollen, auf das mit dieser Shared Access Signature zugegriffen wird.

groupPolicyIdentifier - Eine String , die die Zugriffsrichtlinie auf Containerebene darstellt.

ipRange - Ein IPRange Objekt, das den Bereich der zulässigen IP-Adressen enthält.

protocols - Ein SharedAccessProtocols , der die zulässigen Internetprotokolle darstellt.

Returns:

Eine String , die die Shared Access Signature darstellt.

Throws:

IllegalArgumentException - Wenn die Anmeldeinformationen ungültig sind oder das Blob ein Momentaufnahme ist.

InvalidKeyException - Wenn die Anmeldeinformationen ungültig sind.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateSharedAccessSignature

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

Gibt eine Shared Access Signature für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.

Parameters:

policy - Ein SharedAccessPolicy -Objekt, das die Zugriffsrichtlinie für die Shared Access Signature darstellt.

headers - Ein SharedAccessBlobHeaders -Objekt, das die optionalen Headerwerte darstellt, die für ein Blob festgelegt werden sollen, auf das mit dieser Shared Access Signature zugegriffen wird.

groupPolicyIdentifier - Eine String , die die Zugriffsrichtlinie auf Containerebene darstellt.

ipRange - Ein IPRange Objekt, das den Bereich der zulässigen IP-Adressen enthält.

protocols - Ein SharedAccessProtocols , der die zulässigen Internetprotokolle darstellt.

skipDecoding - Ein boolean , um anzugeben, dass die Abfrageparameter nicht decodiert werden sollen, bevor sie signiert werden. Dies sollte nur verwendet werden, wenn der Kunde sicher ist, dass die übergebenen Werte im gewünschten Format vorliegen. Dies kann in einigen Szenarien nützlich sein, in denen der Client verwendet wird, um eine sas an einen Drittanbieter zu generieren, der dieses SDK nicht zum Senden der Anforderungen verwendet.

Returns:

Eine String , die die Shared Access Signature darstellt.

Throws:

IllegalArgumentException - Wenn die Anmeldeinformationen ungültig sind oder das Blob ein Momentaufnahme ist.

InvalidKeyException - Wenn die Anmeldeinformationen ungültig sind.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateSharedAccessSignature

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

Gibt eine Shared Access Signature für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.

Parameters:

policy - Ein SharedAccessPolicy -Objekt, das die Zugriffsrichtlinie für die Shared Access Signature darstellt.

groupPolicyIdentifier - Eine String , die die Zugriffsrichtlinie auf Containerebene darstellt.

Returns:

Eine String , die die Shared Access Signature darstellt.

Throws:

IllegalArgumentException - Wenn die Anmeldeinformationen ungültig sind oder das Blob ein Momentaufnahme ist.

InvalidKeyException - Wenn die Anmeldeinformationen ungültig sind.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateUserDelegationSharedAccessSignature

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

Gibt eine Freigegebene Zugriffssignatur basierend auf einem Benutzerdelegierungsschlüssel für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.

Parameters:

delegationKey - Ein UserDelegationKey , der den Schlüssel darstellt, der zum Signieren dieser Signatur verwendet wird.

policy - Ein SharedAccessPolicy -Objekt, das die Zugriffsrichtlinie für die Shared Access Signature darstellt.

headers - Ein SharedAccessBlobHeaders -Objekt, das die optionalen Headerwerte darstellt, die für ein Blob festgelegt werden sollen, auf das mit dieser Shared Access Signature zugegriffen wird.

ipRange - Ein IPRange Objekt, das den Bereich der zulässigen IP-Adressen enthält.

protocols - Ein SharedAccessProtocols , der die zulässigen Internetprotokolle darstellt.

Returns:

Eine String , die die Shared Access Signature darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateUserDelegationSharedAccessSignature

public String generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy)

Gibt eine Freigegebene Zugriffssignatur basierend auf einem Benutzerdelegierungsschlüssel für das Blob unter Verwendung des angegebenen Gruppenrichtlinienbezeichners und des angegebenen Vorgangskontexts zurück. Beachten Sie, dass dies nicht das führende "?" enthält.

Parameters:

delegationKey - Ein UserDelegationKey , der den Schlüssel darstellt, der zum Signieren dieser Signatur verwendet wird.

policy - Ein SharedAccessPolicy -Objekt, das die Zugriffsrichtlinie für die Shared Access Signature darstellt.

Returns:

Eine String , die die Shared Access Signature darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

getContainer

public final CloudBlobContainer getContainer()

Gibt den Container des Blobs zurück.

Overrides:

CloudBlob.getContainer()

Returns:

Ein CloudBlobContainer -Objekt, das den Container des Blobs darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getCopyState

public CopyState getCopyState()

Gibt den Kopierstatus des Blobs zurück.

Returns:

Ein CopyState -Objekt, das den Kopierzustand des Blobs darstellt.

getMetadata

public final HashMap getMetadata()

Gibt die Metadaten für das Blob zurück.

Returns:

Ein java.util.HashMap -Objekt, das die Metadaten für das Blob darstellt.

getName

public final String getName()

Gibt den Namen des Blobs zurück.

Returns:

Eine String , die den Namen des Blobs darstellt.

getParent

public final CloudBlobDirectory getParent()

Gibt das übergeordnete Element des Blobelements zurück.

Overrides:

CloudBlob.getParent()

Returns:

Ein CloudBlobDirectory -Objekt, das das übergeordnete Verzeichnis für das Blob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getParentNameFromURI

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

Ruft den übergeordneten Namen für einen Blob-URI ab.

Parameters:

resourceAddress - Ein StorageUri -Objekt, das den Ressourcen-URI darstellt.

delimiter - Ein String , der das zu verwendende Verzeichnistrennzeichen angibt.

container - Ein CloudBlobContainer -Objekt, das den Blobcontainer darstellt.

Returns:

Ein String , der die übergeordnete Adresse für einen Blob-URI darstellt.

Throws:

URISyntaxException

getProperties

public final BlobProperties getProperties()

Gibt die Eigenschaften des Blobs zurück.

Returns:

Ein BlobProperties -Objekt, das die Eigenschaften des Blobs darstellt.

getQualifiedStorageUri

public final StorageUri getQualifiedStorageUri()

Gibt den Momentaufnahme und/oder den qualifizierten URI für die Shared Access Signature für dieses Blob zurück.

<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:

Ein StorageUri -Objekt, das die Momentaufnahme oder Shared Access Signature darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getQualifiedUri

public final URI getQualifiedUri()

Gibt den Momentaufnahme oder den qualifizierten URI für die Shared Access Signature für dieses Blob zurück.

<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:

Ein java.net.URI -Objekt, das die Momentaufnahme oder Shared Access Signature darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getServiceClient

public final CloudBlobClient getServiceClient()

Gibt den Dem Blob zugeordneten Blobdienstclient zurück.

Returns:

Ein CloudBlobClient -Objekt, das den Client darstellt.

getSnapshotID

public final String getSnapshotID()

Ruft die Blobmomentaufnahme-ID ab.

Returns:

Ein String , der die Blobmomentaufnahme-ID darstellt.

getSnapshotQualifiedStorageUri

public final StorageUri getSnapshotQualifiedStorageUri()

Gibt den URI des Blobs sowohl für den primären als auch für den sekundären Speicherort zurück, einschließlich Abfragezeichenfolgeninformationen, wenn das Blob ein Momentaufnahme ist.

Returns:

Ein StorageUri Objekt, das die URIs des Blobs sowohl für den primären als auch für den sekundären Speicherort enthält, einschließlich Momentaufnahme Abfrageinformationen, wenn das Blob ein Momentaufnahme ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getSnapshotQualifiedUri

public final URI getSnapshotQualifiedUri()

Gibt den absoluten URI für das Blob zurück, einschließlich Abfragezeichenfolgeninformationen, wenn das Blob ein Momentaufnahme ist.

Returns:

Ein java.net.URI Objekt, das den absoluten URI für das Blob angibt, einschließlich Momentaufnahme Abfrageinformationen, wenn das Blob ein Momentaufnahme ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getStorageUri

public final StorageUri getStorageUri()

Gibt die Liste der URIs für alle Speicherorte zurück.

Overrides:

CloudBlob.getStorageUri()

Returns:

Ein StorageUri , der die Liste der URIs für alle Speicherorte darstellt.

getStreamMinimumReadSizeInBytes

public final int getStreamMinimumReadSizeInBytes()

Gibt die minimale Lesegröße zurück, wenn ein verwendet wird BlobInputStream.

Returns:

Ein int , der die minimale Lesegröße in Byte darstellt, wenn ein BlobInputStream -Objekt verwendet wird.

getStreamWriteSizeInBytes

public final int getStreamWriteSizeInBytes()

Ruft die Anzahl der Bytes ab, die beim Schreiben in ein BlobOutputStream (Block- und Seitenblobs) gepuffert werden sollen.

Returns:

Ein int , der die Anzahl der zu pufferden Bytes oder die Größe eines Blocks in Bytes darstellt.

getTransformedAddress

protected final StorageUri getTransformedAddress(final OperationContext opContext)

Gibt den transformierten URI für die Ressource zurück, wenn die angegebenen Anmeldeinformationen eine Transformation erfordern.

Parameters:

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein StorageUri -Objekt, das den transformierten URI darstellt.

Throws:

IllegalArgumentException - Wenn der URI nicht absolut ist.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getUri

public final URI getUri()

Gibt den URI für dieses Blob zurück.

Overrides:

CloudBlob.getUri()

Returns:

Ein java.net.URI -Objekt, das den URI für das Blob darstellt.

isSnapshot

public final boolean isSnapshot()

Gibt an, ob es sich bei diesem Blob um ein Momentaufnahme handelt.

Returns:

true, wenn das Blob ein Momentaufnahme ist, andernfalls false.

openInputStream

public final BlobInputStream openInputStream()

Öffnet einen Blobeingabestream zum Herunterladen des Blobs.

Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.

Returns:

Ein InputStream -Objekt, das den Stream darstellt, der zum Lesen aus dem Blob verwendet werden soll.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

openInputStream

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

Öffnet einen Blobeingabestream, um das Blob mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts herunterzuladen.

Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein InputStream -Objekt, das den Stream darstellt, der zum Lesen aus dem Blob verwendet werden soll.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

openInputStream

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

Öffnet einen Blobeingabestream, um das Blob mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts herunterzuladen. Wenn das Blob beim Herunterladen entschlüsselt wird, wird die endgültige MD5-Überprüfung übersprungen.

Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.

Parameters:

offset - Ein long , der den Offset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes oder nulldarstellt.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein InputStream -Objekt, das den Stream darstellt, der zum Lesen aus dem Blob verwendet werden soll.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

releaseLease

public final void releaseLease(final AccessCondition accessCondition)

Gibt die Lease für das BLOB frei.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt. Die LeaseID muss für AccessCondition festgelegt werden.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

releaseLease

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

Gibt die Lease für das Blob unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts frei.

Parameters:

accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt. Die LeaseID muss für AccessCondition festgelegt werden.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

renewLease

public final void renewLease(final AccessCondition accessCondition)

Erneuert eine vorhandene Lease.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt. Die LeaseID muss für AccessCondition festgelegt werden.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

renewLease

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

Erneuert eine vorhandene Lease mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt. Die LeaseID muss für AccessCondition festgelegt werden.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

setContainer

protected final void setContainer(final CloudBlobContainer container)

Legt den Container für das Blob fest.

Parameters:

container - Ein CloudBlobContainer -Objekt, das den Container darstellt, der dem Blob zugewiesen wird.

setMetadata

public final void setMetadata(final HashMap metadata)

Legt die Metadaten für das Blob fest.

Parameters:

metadata - Ein java.util.HashMap -Objekt, das die Metadaten enthält, die dem Blob zugewiesen werden.

setProperties

protected final void setProperties(final BlobProperties properties)

Legt die Eigenschaften für das Blob fest.

Parameters:

properties - Ein BlobProperties -Objekt, das die Eigenschaften darstellt, die dem Blob zugewiesen werden.

setSnapshotID

protected final void setSnapshotID(final String snapshotID)

Legt die Blob-Momentaufnahme-ID fest.

Parameters:

snapshotID - Ein String , der die Momentaufnahme-ID darstellt, die dem Blob zugewiesen wird.

setStorageUri

protected void setStorageUri(final StorageUri storageUri)

Legt die Liste der URIs für alle Speicherorte fest.

Parameters:

storageUri - Ein StorageUri , der die Liste der URIs für alle Speicherorte darstellt.

setStreamMinimumReadSizeInBytes

public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)

Legt die minimale Lesegröße fest, wenn ein verwendet wird BlobInputStream.

Parameters:

minimumReadSize - Ein int , der die minimale Blockgröße in Bytes für das Lesen aus einem Blob darstellt, während ein BlobInputStream -Objekt verwendet wird. Muss größer oder gleich 16 KB sein.

Throws:

IllegalArgumentException - Wenn minimumReadSize kleiner als 16 KB ist.

setStreamWriteSizeInBytes

public abstract void setStreamWriteSizeInBytes(int streamWriteSizeInBytes)

Legt die Anzahl der Bytes fest, die beim Schreiben in ein BlobOutputStream (Block- und Seitenblobs) gepuffert werden sollen.

Parameters:

streamWriteSizeInBytes - Ein int , das die Anzahl der zu pufferden Bytes oder die Größe eines Blocks in Bytes darstellt.

startCopy

public final String startCopy(final URI source)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob zu beginnen.

Parameters:

source - Ein java.net.URI Der Quell-URI. URIs für Ressourcen außerhalb von Azure können nur in Blockblobs kopiert werden.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

startCopy

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

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.

Parameters:

source - Ein java.net.URI Der Quell-URI. URIs für Ressourcen außerhalb von Azure können nur in Blockblobs kopiert werden.

sourceAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Quelle darstellt.

destinationAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Ziel darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

startCopy

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

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob zu beginnen, wobei die angegebene Premium-Seitenblobebene, Zugriffsbedingungen, Lease-ID, Anforderungsoptionen und Vorgangskontext verwendet werden.

Hinweis: Das Festlegen von premiumPageBlobTier wird nur für Premium-Konten unterstützt.

Parameters:

source - Ein java.net.URI Der Quell-URI. URIs für Ressourcen außerhalb von Azure können nur in Blockblobs kopiert werden.

blobTierString - Eine Zeichenfolge, die die Ebene des Blobs darstellt.

sourceAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Quelle darstellt.

destinationAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Ziel darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob zu beginnen, wobei die angegebene Premium-Seitenblobebene, Zugriffsbedingungen, Lease-ID, Anforderungsoptionen und Vorgangskontext verwendet werden.

Hinweis: Das Festlegen von premiumPageBlobTier wird nur für Premium-Konten unterstützt.

Parameters:

source - Ein java.net.URI Der Quell-URI. URIs für Ressourcen außerhalb von Azure können nur in Blockblobs kopiert werden.

contentMd5 - Ein optionaler Hashwert, der verwendet wird, um die Transaktionsintegrität für den Vorgang sicherzustellen. Kann leer oder sein null .

syncCopy - Ein boolean , der angibt, ob die Kopie synchron für den Dienst erfolgen soll.

blobTierString - Eine Zeichenfolge, die die Ebene des Blobs darstellt.

sourceAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Quelle darstellt.

destinationAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Ziel darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in ein neues Blob zu beginnen, wobei die angegebene Premium-Seitenblobebene verwendet wird, Priorität, Zugriffsbedingungen, Lease-ID, Anforderungsoptionen und Vorgangskontext aktiviert wird.

Hinweis: Das Festlegen von premiumPageBlobTier wird nur für Premium-Konten unterstützt.

Parameters:

source - Ein java.net.URI Der Quell-URI. URIs für Ressourcen außerhalb von Azure können nur in Blockblobs kopiert werden.

contentMd5 - Ein optionaler Hashwert, der verwendet wird, um die Transaktionsintegrität für den Vorgang sicherzustellen. Kann leer oder sein null .

syncCopy - Ein boolean , der angibt, ob die Kopie synchron für den Dienst erfolgen soll.

blobTierString - Ein String -Objekt, das die Ebene des Blobs darstellt.

rehydratePriority - Ein RehydratePriority -Objekt, das die Rehydrierungspriorität darstellt.

sourceAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Quelle darstellt.

destinationAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Ziel darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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()

Hebt ein Blob und alle momentaufnahmen auf, die vorläufig gelöscht wurden.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

undelete

public final void undelete(BlobRequestOptions options, OperationContext opContext)

Löscht ein Blob, das vorläufig gelöscht wurde, unter Verwendung der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts.

Der Vorgang zum Aufheben des Löschens von Blobs stellt den Inhalt und die Metadaten des vorläufig gelöschten Blobs und aller zugehörigen Momentaufnahmen wieder her. Der Versuch, ein Blob oder eine Momentaufnahme, die nicht vorläufig gelöscht wurde, wiederherstellen, ist ohne Änderungen erfolgreich.

Parameters:

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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)

Lädt die Quellstreamdaten in das Blob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

sourceStream - Ein InputStream -Objekt, das den hochzuladenden Quelldatenstrom darstellt.

length - Ein long , das die Länge der Streamdaten in Bytes darstellt, oder -1, wenn unbekannt. Die Länge muss größer als 0 (null) und ein Vielfaches von 512 für Seitenblobs sein.

Throws:

IOException - Wenn eine E/A-Ausnahme aufgetreten ist.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

upload

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

Lädt die Quellstreamdaten mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext in das Blob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

sourceStream - Ein InputStream -Objekt, das den hochzuladenden Quelldatenstrom darstellt.

length - Die Länge der Datenstromdaten in Bytes oder -1, wenn unbekannt. Die Länge muss größer als 0 (null) und ein Vielfaches von 512 für Seitenblobs sein.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

IOException - Wenn eine E/A-Ausnahme aufgetreten ist.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadFromByteArray

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

Lädt ein Blob aus Daten in einem Bytearray hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

buffer - Ein byte Array, das die Daten darstellt, die in das Blob geschrieben werden sollen.

offset - Ein int , der den Offset des Bytearrays darstellt, aus dem der Datenupload gestartet werden soll.

length - Ein int , der die Anzahl der Bytes darstellt, die aus dem Eingabepuffer hochgeladen werden sollen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

uploadFromByteArray

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

Lädt ein Blob aus Daten in einem Bytearray hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

buffer - Ein byte Array, das die Daten darstellt, die in das Blob geschrieben werden sollen.

offset - Ein int , der den Offset des Bytearrays darstellt, aus dem der Datenupload gestartet werden soll.

length - Ein int , der die Anzahl der Bytes darstellt, die aus dem Eingabepuffer hochgeladen werden sollen.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

uploadFromFile

public void uploadFromFile(final String path)

Lädt ein Blob aus einer Datei hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

path - Ein String , der den Pfad zur datei darstellt, die hochgeladen werden soll.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

uploadFromFile

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

Lädt ein Blob aus einer Datei hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

path - Ein String , der den Pfad zur datei darstellt, die hochgeladen werden soll.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

uploadMetadata

public final void uploadMetadata()

Lädt die Metadaten des Blobs in den Speicherdienst hoch.

Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadMetadata

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

Lädt die Metadaten des Blobs mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext in den Speicherdienst hoch.

Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadProperties

public final void uploadProperties()

Updates die Eigenschaften des Blobs an den Speicherdienst.

Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadProperties

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

Updates die Eigenschaften des Blobs mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext.

Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten des Blobs aus dem Microsoft Azure-Speicherdienst abzurufen.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.

options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

validateCPKHeaders

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

Wenn die Anforderungsoptionen einen CPK enthalten, überprüfen Sie die zugeordneten Antwortheader.

Parameters:

request - Die Speicheranforderung, von der die Antwort überprüft werden soll.

options - Die für die Anforderung verwendeten Bloboptionen.

upload - Ob dies ein Upload war oder ob wir nur Daten abrufen.

Throws:

StorageException - Löst aus, wenn CPK in der Anforderung verwendet wurde und die Überprüfung der Antwort fehlgeschlagen ist.