CloudBlobContainer Klasse

Paket:

com.microsoft.azure.storage.blob

• java.lang.Object
• • com.microsoft.azure.storage.blob.CloudBlobContainer

public class CloudBlobContainer

Stellt einen Container im Microsoft Azure-Blobdienst dar.

Container, die als CloudBlobDirectory-Objekte gekapselt sind, enthalten die Verzeichnisse, und die Verzeichnisse enthalten die Block- und Seitenblobs. Die Verzeichnisse können auch Unterverzeichnisse enthalten.

Feldzusammenfassung

Modifizierer und Typ	Feld und Beschreibung
HashMap<String, String>	metadata Stellt die Containermetadaten dar.

Zusammenfassung zum Konstruktor

Konstruktor	Beschreibung
CloudBlobContainer(final StorageUri storageUri)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen URI. Der Blob-URI sollte ein SAS-Token enthalten, es sei denn, anonymer Zugriff wird verwendet.
CloudBlobContainer(final StorageUri storageUri, final StorageCredentials credentials)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen StorageUri und der angegebenen Anmeldeinformationen.
CloudBlobContainer(final String containerName, final CloudBlobClient client)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen Namens und des angegebenen Clients.
CloudBlobContainer(final URI uri)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen URI. Der Blob-URI sollte ein SAS-Token enthalten, es sei denn, anonymer Zugriff wird verwendet.
CloudBlobContainer(final URI uri, final StorageCredentials credentials)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen URI und der angegebenen Anmeldeinformationen.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
final String	acquireLease() Ruft eine neue unendliche Lease für den Container ab.
final String	acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId) Ruft eine neue Lease für den Container 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 den Container mit der angegebenen Leasezeit, der vorgeschlagenen Lease-ID, den Anforderungsoptionen und dem Vorgangskontext ab.
final long	breakLease(final Integer breakPeriodInSeconds) Unterbricht die Lease und stellt sicher, dass ein anderer Client keine neue Lease erwerben kann, bis der aktuelle Leasezeitraum abgelaufen ist.
final long	breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Unterbricht die vorhandene Lease mithilfe 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 Vorgangskontext.
void	create() Erstellt den Container.
void	create(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext) Erstellt den Container mit den angegebenen Optionen und dem angegebenen Vorgangskontext.
void	create(BlobRequestOptions options, OperationContext opContext) Erstellt den Container mit den angegebenen Optionen und dem angegebenen Vorgangskontext.
boolean	createIfNotExists() Erstellt den Container, wenn er nicht vorhanden ist.
boolean	createIfNotExists(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext) Erstellt den Container, falls er nicht vorhanden ist, unter Verwendung der angegebenen Anforderungsoptionen und des Vorgangskontexts.
boolean	createIfNotExists(BlobRequestOptions options, OperationContext opContext) Erstellt den Container, falls er nicht vorhanden ist, unter Verwendung der angegebenen Anforderungsoptionen und des Vorgangskontexts.
void	delete() Löscht den Container.
void	delete(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Löscht den Container unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.
boolean	deleteIfExists() Löscht den Container, sofern er vorhanden ist.
boolean	deleteIfExists(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Löscht den Container, sofern er vorhanden ist, unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.
AccountInformation	downloadAccountInfo() Ruft Informationen im Zusammenhang mit dem Speicherkonto ab, in dem sich dieser Container befindet.
AccountInformation	downloadAccountInfo(BlobRequestOptions options, OperationContext opContext) Ruft Informationen im Zusammenhang mit dem Speicherkonto ab, in dem sich dieser Container befindet.
StorageRequest<ServiceClient, CloudBlobContainer, AccountInformation>	downloadAccountInformationImpl(final RequestOptions options)
void	downloadAttributes() Lädt die Attribute des Containers herunter, die aus Metadaten und Eigenschaften bestehen.
void	downloadAttributes(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt die Attribute des Containers herunter, die aus Metadaten und Eigenschaften bestehen, und verwendet dabei die angegebenen Anforderungsoptionen und den angegebenen Vorgangskontext.
BlobContainerPermissions	downloadPermissions() Lädt die Berechtigungseinstellungen für den Container herunter.
BlobContainerPermissions	downloadPermissions(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt die Berechtigungseinstellungen für den Container mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts herunter.
boolean	exists() Gibt einen Wert zurück, der angibt, ob der Container vorhanden ist.
boolean	exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Gibt einen Wert zurück, der angibt, ob der Container vorhanden ist, wobei die angegebenen Anforderungsoptionen und der angegebene Vorgangskontext verwendet werden.
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier) Gibt eine SAS (Shared Access Signature, Signatur für den gemeinsamen Zugriff) für den Container zurück. Beachten Sie, dass dies nicht das führende "?" enthält.
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) Gibt eine SAS (Shared Access Signature, Signatur für den gemeinsamen Zugriff) für den Container zurück. Beachten Sie, dass dies nicht das führende "?" enthält.
CloudAppendBlob	getAppendBlobReference(final String blobName) Gibt einen Verweis auf ein CloudAppendBlob -Objekt zurück, das ein Anfügeblob in diesem Container darstellt.
CloudAppendBlob	getAppendBlobReference(final String blobName, final String snapshotID) Gibt einen Verweis auf ein CloudAppendBlob Objekt zurück, das ein Anfügeblob im Container darstellt, wobei die angegebene Momentaufnahme-ID verwendet wird.
final CloudBlob	getBlobReferenceFromServer(final String blobName) Ruft einen Verweis auf ein Blob in diesem Container ab. Das Blob muss bereits im Dienst vorhanden sein. Im Gegensatz zu den anderen get*Reference-Methoden führt diese Methode eine Dienstanforderung aus, um die Metadaten und Eigenschaften des Blobs abzurufen. Das zurückgegebene Blob kann direkt als CloudBlob oder cast verwendet werden, indem entweder instanceof oder getProperties().getBlobType() verwendet wird, um den Untertyp zu bestimmen.
final CloudBlob	getBlobReferenceFromServer(final String blobName, final String snapshotID, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Ruft einen Verweis auf ein Blob in diesem Container ab. Das Blob muss bereits im Dienst vorhanden sein. Im Gegensatz zu den anderen get*Reference-Methoden führt diese Methode eine Dienstanforderung aus, um die Metadaten und Eigenschaften des Blobs abzurufen. Das zurückgegebene Blob kann direkt als CloudBlob oder cast verwendet werden, indem entweder instanceof oder getProperties().getBlobType() verwendet wird, um den Untertyp zu bestimmen.
CloudBlockBlob	getBlockBlobReference(final String blobName) Gibt einen Verweis auf ein CloudBlockBlob -Objekt zurück, das ein Blockblob in diesem Container darstellt.
CloudBlockBlob	getBlockBlobReference(final String blobName, final String snapshotID) Gibt einen Verweis auf ein CloudBlockBlob Objekt zurück, das ein Blockblob in diesem Container darstellt, wobei die angegebene Momentaufnahme-ID verwendet wird.
CloudBlobDirectory	getDirectoryReference(String directoryName) Gibt einen Verweis auf ein CloudBlobDirectory -Objekt zurück, das ein virtuelles Blobverzeichnis in diesem Container darstellt.
HashMap<String, String>	getMetadata() Gibt die Metadaten für den Container zurück. Dieser Wert wird mit den Metadaten aus der Warteschlange durch einen Aufruf downloadAttributes()von initialisiert und für die Warteschlange mit einem Aufruf von uploadMetadata()festgelegt.
String	getName() Gibt den Namen des Containers zurück.
CloudPageBlob	getPageBlobReference(final String blobName) Gibt einen Verweis auf ein CloudPageBlob -Objekt zurück, das ein Seitenblob in diesem Container darstellt.
CloudPageBlob	getPageBlobReference(final String blobName, final String snapshotID) Gibt einen Verweis auf ein CloudPageBlob Objekt zurück, das ein Seitenblob im Container darstellt, wobei die angegebene Momentaufnahme-ID verwendet wird.
BlobContainerProperties	getProperties() Gibt die Eigenschaften für den Container zurück.
CloudBlobClient	getServiceClient() Gibt den diesem Container zugeordneten Blobdienstclient zurück.
StorageUri	getStorageUri() Gibt die Liste der URIs für alle Speicherorte zurück.
URI	getUri() Gibt den URI für diesen Container zurück.
Iterable<ListBlobItem>	listBlobs() Gibt eine aufzählbare Auflistung von Blobelementen für den Container zurück.
Iterable<ListBlobItem>	listBlobs(final String prefix) Gibt eine aufzählbare Auflistung von Blobelementen für den Container zurück, dessen Namen mit dem angegebenen Präfix beginnen.
Iterable<ListBlobItem>	listBlobs(final String prefix, final boolean useFlatBlobListing) Gibt mithilfe der angegebenen flachen oder hierarchischen Option eine aufzählbare Auflistung von Blobelementen für den Container zurück, dessen Namen mit dem angegebenen Präfix beginnen.
Iterable<ListBlobItem>	listBlobs(final String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, BlobRequestOptions options, OperationContext opContext) Gibt eine aufzählbare Auflistung von Blobelementen für den Container zurück, dessen Namen mit dem angegebenen Präfix beginnen, wobei die angegebene flache oder hierarchische Option, Optionen für Auflistungsdetails, Anforderungsoptionen und Vorgangskontext verwendet werden.
ResultSegment<ListBlobItem>	listBlobsSegmented() Gibt ein Ergebnissegment einer aufzählbaren Auflistung von Blobelementen im Container zurück.
ResultSegment<ListBlobItem>	listBlobsSegmented(final String prefix) Gibt ein Ergebnissegment zurück, das eine Auflistung von Blobelementen enthält, deren Namen mit dem angegebenen Präfix beginnen.
ResultSegment<ListBlobItem>	listBlobsSegmented(final String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, final Integer maxResults, final ResultContinuation continuationToken, BlobRequestOptions options, OperationContext opContext) Gibt ein Ergebnissegment zurück, das eine Auflistung von Blobelementen enthält, deren Namen mit dem angegebenen Präfix beginnen, wobei die angegebene flache oder hierarchische Option, Optionen für Auflistungsdetails, Anforderungsoptionen und Vorgangskontext verwendet werden.
Iterable<CloudBlobContainer>	listContainers() Gibt eine aufzählbare Auflistung von Containern für den Dienstclient zurück, der diesem Container zugeordnet ist.
Iterable<CloudBlobContainer>	listContainers(final String prefix) Gibt eine aufzählbare Auflistung von Containern zurück, deren Namen mit dem angegebenen Präfix für den Diesem Container zugeordneten Dienstclient beginnen.
Iterable<CloudBlobContainer>	listContainers(final String prefix, final ContainerListingDetails detailsIncluded, final BlobRequestOptions options, final OperationContext opContext) Gibt eine aufzählbare Auflistung von Containern zurück, deren Namen mit dem angegebenen Präfix für den dienstclient beginnen, der diesem Container zugeordnet ist, wobei die angegebene Detaileinstellung, Anforderungsoptionen und der angegebene Vorgangskontext verwendet werden.
ResultSegment<CloudBlobContainer>	listContainersSegmented() Gibt ein Ergebnissegment einer aufzählbaren Auflistung von Containern für den Diesem Container zugeordneten Dienstclient zurück.
ResultSegment<CloudBlobContainer>	listContainersSegmented(final String prefix) Gibt ein Ergebnissegment einer aufzählbaren Auflistung von Containern zurück, deren Namen mit dem angegebenen Präfix für den diesem Container zugeordneten Dienstclient beginnen.
ResultSegment<CloudBlobContainer>	listContainersSegmented(final String prefix, final ContainerListingDetails detailsIncluded, final Integer maxResults, final ResultContinuation continuationToken, final BlobRequestOptions options, final OperationContext opContext) Gibt ein Ergebnissegment zurück, das eine Auflistung von Containern enthält, deren Namen mit dem angegebenen Präfix für den Dienstclient beginnen, der diesem Container zugeordnet ist, wobei die angegebenen Listendetailsoptionen, Anforderungsoptionen und der Vorgangskontext verwendet werden.
final void	releaseLease(final AccessCondition accessCondition) Gibt die Lease für den Container frei.
final void	releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Gibt die Lease für den Container unter Verwendung der angegebenen Zugriffsbedingungen, Anforderungsoptionen und des angegebenen Vorgangskontexts frei.
final void	renewLease(final AccessCondition accessCondition) Erneuert eine vorhandene Lease mit den angegebenen Zugriffsbedingungen.
final void	renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Erneuert eine vorhandene Lease mit den angegebenen Zugriffsbedingungen, Anforderungsoptionen und dem angegebenen Vorgangskontext.
void	setMetadata(final HashMap<String, String> metadata) Legt die Metadatenauflistung von Name-Wert-Paaren fest, die für den Container mit einem uploadMetadata() Aufruf festgelegt werden sollen. Diese Sammlung überschreibt alle vorhandenen Containermetadaten. Wenn dies auf eine leere Sammlung festgelegt ist, werden die Containermetadaten bei einem uploadMetadata() Aufruf gelöscht.
void	setProperties(final BlobContainerProperties properties) Legt die Eigenschaften für den Container fest.
void	setStorageUri(final StorageUri storageUri) Legt die Liste der URIs für alle Speicherorte fest.
void	uploadMetadata() Lädt die Metadaten des Containers hoch.
void	uploadMetadata(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt die Metadaten des Containers mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts hoch.
void	uploadPermissions(final BlobContainerPermissions permissions) Lädt die Berechtigungen des Containers hoch.
void	uploadPermissions(final BlobContainerPermissions permissions, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Lädt die Berechtigungen des Containers mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts hoch.

Felddetails

metadata

protected HashMap metadata= new HashMap()

Stellt die Containermetadaten dar.

Details zum Konstruktor

CloudBlobContainer

public CloudBlobContainer(final StorageUri storageUri)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen URI. Der Blob-URI sollte ein SAS-Token enthalten, es sei denn, anonymer Zugriff wird verwendet.

Parameters:

storageUri - Ein StorageUri -Objekt, das den URI des Containers darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudBlobContainer

public CloudBlobContainer(final StorageUri storageUri, final StorageCredentials credentials)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen StorageUri und der angegebenen Anmeldeinformationen.

Parameters:

storageUri - Ein StorageUri -Objekt, das den absoluten StorageUri des Containers darstellt.

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

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudBlobContainer

protected CloudBlobContainer(final String containerName, final CloudBlobClient client)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen Namens und des angegebenen Clients.

Parameters:

containerName - Ein String , der den Namen des Containers darstellt, der den Containerbenennungsregeln entsprechen muss. Der Containername sollte keine Pfadtrennzeichen (/) enthalten. Containernamen müssen kleingeschrieben sein, zwischen 3 und 63 Zeichen lang sein und mit einem Buchstaben oder einer Zahl beginnen. Containernamen dürfen nur Buchstaben, Zahlen und das Bindestrichzeichen (-) enthalten.

client - Ein CloudBlobClient -Objekt, das den zugeordneten Dienstclient darstellt und den Endpunkt für den Blobdienst angibt. *

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI, der basierend auf containerName erstellt wurde, ungültig ist.

CloudBlobContainer

public CloudBlobContainer(final URI uri)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen URI. Der Blob-URI sollte ein SAS-Token enthalten, es sei denn, anonymer Zugriff wird verwendet.

Parameters:

uri - Ein java.net.URI -Objekt, das den URI des Containers darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudBlobContainer

public CloudBlobContainer(final URI uri, final StorageCredentials credentials)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen URI und der angegebenen Anmeldeinformationen.

Parameters:

uri - Ein java.net.URI -Objekt, das den absoluten URI des Containers darstellt.

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

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

Details zur Methode

acquireLease

public final String acquireLease()

Ruft eine neue unendliche Lease für den Container ab.

Returns:

Eine String , die 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 den Container mit der angegebenen Leasezeit und der vorgeschlagenen Lease-ID ab.

Parameters:

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

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

Returns:

Eine String , die 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 den Container mit der angegebenen Leasezeit, der vorgeschlagenen Lease-ID, den Anforderungsoptionen und dem Vorgangskontext ab.

Parameters:

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

proposedLeaseId - Eine String , die 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 den Container 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:

Eine String , die die Lease-ID darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

breakLease

public final long breakLease(final Integer breakPeriodInSeconds)

Unterbricht die Lease und stellt sicher, dass ein anderer Client keine neue Lease erwerben kann, bis der aktuelle Leasezeitraum abgelaufen ist.

Parameters:

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

Returns:

Die Zeit in Sekunden, die im Leasezeitraum verbleibt.

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 mithilfe 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 - Eine Integer , die die Zeit angibt, die in Sekunden zu warten ist, 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:

Die Zeit in Sekunden, 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 - Eine String , die 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:

Eine String , die 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 Vorgangskontext.

Parameters:

proposedLeaseId - Eine String , die die vorgeschlagene Lease-ID für die neue Lease darstellt. Darf nicht NULL sein.

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:

Eine String , die die neue Lease-ID darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

create

public void create()

Erstellt den Container.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

create

public void create(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext)

Erstellt den Container mit den angegebenen Optionen und dem angegebenen Vorgangskontext.

Parameters:

accessType - Ein BlobContainerPublicAccessType -Objekt, das angibt, ob auf Daten im Container öffentlich zugegriffen werden darf und welche Zugriffsebene zulässig ist.

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.

create

public void create(BlobRequestOptions options, OperationContext opContext)

Erstellt den Container mit den angegebenen Optionen und dem angegebenen Vorgangskontext.

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.

createIfNotExists

public boolean createIfNotExists()

Erstellt den Container, wenn er nicht vorhanden ist.

Returns:

true, wenn der Container noch nicht vorhanden war und erstellt wurde; andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

createIfNotExists

public boolean createIfNotExists(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext)

Erstellt den Container, falls er nicht vorhanden ist, unter Verwendung der angegebenen Anforderungsoptionen und des Vorgangskontexts.

Parameters:

accessType - Ein BlobContainerPublicAccessType -Objekt, das angibt, ob auf Daten im Container öffentlich zugegriffen werden darf und welche Zugriffsebene zulässig ist.

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 der Container noch nicht vorhanden war und erstellt wurde; andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

createIfNotExists

public boolean createIfNotExists(BlobRequestOptions options, OperationContext opContext)

Erstellt den Container, falls er nicht vorhanden ist, unter Verwendung der angegebenen Anforderungsoptionen und des Vorgangskontexts.

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:

true, wenn der Container noch nicht vorhanden war und erstellt wurde; andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

delete

public void delete()

Löscht den Container.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

delete

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

Löscht den Container unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für den Container 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 boolean deleteIfExists()

Löscht den Container, sofern er vorhanden ist.

Returns:

true, wenn der Container noch nicht vorhanden war und erstellt wurde; andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

deleteIfExists

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

Löscht den Container, sofern er vorhanden ist, unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für den Container 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 der Container vorhanden und gelöscht wurde; falseandernfalls .

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadAccountInfo

public AccountInformation downloadAccountInfo()

Ruft Informationen im Zusammenhang mit dem Speicherkonto ab, in dem sich dieser Container 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 dieser Container 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 void downloadAttributes()

Lädt die Attribute des Containers herunter, die aus Metadaten und Eigenschaften bestehen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadAttributes

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

Lädt die Attribute des Containers herunter, die aus Metadaten und Eigenschaften bestehen, und verwendet dabei die angegebenen Anforderungsoptionen und den angegebenen Vorgangskontext.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für den Container 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.

downloadPermissions

public BlobContainerPermissions downloadPermissions()

Lädt die Berechtigungseinstellungen für den Container herunter.

Returns:

Ein BlobContainerPermissions -Objekt, das die Berechtigungen des Containers darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadPermissions

public BlobContainerPermissions downloadPermissions(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Lädt die Berechtigungseinstellungen für den Container mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts herunter.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für den Container 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 BlobContainerPermissions -Objekt, das die Berechtigungen des Containers darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

exists

public boolean exists()

Gibt einen Wert zurück, der angibt, ob der Container vorhanden ist.

Returns:

true , wenn der Container vorhanden ist, andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

exists

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

Gibt einen Wert zurück, der angibt, ob der Container vorhanden ist, wobei die angegebenen Anforderungsoptionen und der angegebene Vorgangskontext verwendet werden.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für den Container 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 der Container vorhanden ist, andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateSharedAccessSignature

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

Gibt eine SAS (Shared Access Signature, Signatur für den gemeinsamen Zugriff) für den Container zurück. Beachten Sie, dass dies nicht das führende "?" enthält.

Parameters:

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

groupPolicyIdentifier - Ein String , der die Zugriffsrichtlinie auf Containerebene darstellt.

Returns:

Eine String , die eine Shared Access Signature für den Container darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

InvalidKeyException - Wenn der Schlüssel ungültig ist.

generateSharedAccessSignature

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

Gibt eine SAS (Shared Access Signature, Signatur für den gemeinsamen Zugriff) für den Container zurück. Beachten Sie, dass dies nicht das führende "?" enthält.

Parameters:

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

groupPolicyIdentifier - Ein String , der 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 eine Shared Access Signature für den Container darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

InvalidKeyException - Wenn der Schlüssel ungültig ist.

getAppendBlobReference

public CloudAppendBlob getAppendBlobReference(final String blobName)

Gibt einen Verweis auf ein CloudAppendBlob -Objekt zurück, das ein Anfügeblob in diesem Container darstellt.

Parameters:

blobName - Ein String , der den Namen des Blobs darstellt.

Returns:

Ein CloudAppendBlob -Objekt, das einen Verweis auf das angegebene Anfügeblob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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

getAppendBlobReference

public CloudAppendBlob getAppendBlobReference(final String blobName, final String snapshotID)

Gibt einen Verweis auf ein CloudAppendBlob Objekt zurück, das ein Anfügeblob im Container darstellt, wobei die angegebene Momentaufnahme-ID verwendet wird.

Parameters:

blobName - Ein String , der den Namen des Blobs darstellt.

snapshotID - Ein String , der die Momentaufnahme-ID des Blobs darstellt.

Returns:

Ein CloudAppendBlob -Objekt, das einen Verweis auf das angegebene Anfügeblob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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

getBlobReferenceFromServer

public final CloudBlob getBlobReferenceFromServer(final String blobName)

Ruft einen Verweis auf ein Blob in diesem Container ab. Das Blob muss bereits im Dienst vorhanden sein.

Im Gegensatz zu den anderen get*Reference-Methoden führt diese Methode eine Dienstanforderung aus, um die Metadaten und Eigenschaften des Blobs abzurufen. Das zurückgegebene Blob kann direkt als CloudBlob oder cast verwendet werden, indem entweder instanceof oder getProperties().getBlobType() verwendet wird, um den Untertyp zu bestimmen.

Parameters:

blobName - Ein String , der den Namen des Blobs darstellt.

Returns:

Ein CloudBlob -Objekt, das einen Verweis auf das angegebene Blob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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

getBlobReferenceFromServer

public final CloudBlob getBlobReferenceFromServer(final String blobName, final String snapshotID, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ruft einen Verweis auf ein Blob in diesem Container ab. Das Blob muss bereits im Dienst vorhanden sein.

Im Gegensatz zu den anderen get*Reference-Methoden führt diese Methode eine Dienstanforderung aus, um die Metadaten und Eigenschaften des Blobs abzurufen. Das zurückgegebene Blob kann direkt als CloudBlob oder cast verwendet werden, indem entweder instanceof oder getProperties().getBlobType() verwendet wird, um den Untertyp zu bestimmen.

Parameters:

blobName - Ein String , der den Namen des Blobs darstellt.

snapshotID - Ein String , der die Momentaufnahme-ID des Blobs 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.

Returns:

Ein CloudBlob -Objekt, das einen Verweis auf das angegebene Blob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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

getBlockBlobReference

public CloudBlockBlob getBlockBlobReference(final String blobName)

Gibt einen Verweis auf ein CloudBlockBlob -Objekt zurück, das ein Blockblob in diesem Container darstellt.

Parameters:

blobName - Ein String , der den Namen des Blobs darstellt.

Returns:

Ein CloudBlockBlob -Objekt, das einen Verweis auf das angegebene Blockblob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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

getBlockBlobReference

public CloudBlockBlob getBlockBlobReference(final String blobName, final String snapshotID)

Gibt einen Verweis auf ein CloudBlockBlob Objekt zurück, das ein Blockblob in diesem Container darstellt, wobei die angegebene Momentaufnahme-ID verwendet wird.

Parameters:

blobName - Ein String , der den Namen des Blobs darstellt.

snapshotID - Ein String , der die Momentaufnahme-ID des Blobs darstellt.

Returns:

Ein CloudBlockBlob -Objekt, das einen Verweis auf das angegebene Blockblob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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

getDirectoryReference

public CloudBlobDirectory getDirectoryReference(String directoryName)

Gibt einen Verweis auf ein CloudBlobDirectory -Objekt zurück, das ein virtuelles Blobverzeichnis in diesem Container darstellt.

Parameters:

directoryName - Ein String , der den Namen des virtuellen Blobverzeichnisses darstellt. Wenn das Stammverzeichnis (das Verzeichnis, das den Container selbst darstellt) gewünscht ist, verwenden Sie eine leere Zeichenfolge.

Returns:

Ein CloudBlobDirectory , das ein virtuelles Blobverzeichnis in diesem Container darstellt.

Throws:

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

getMetadata

public HashMap getMetadata()

Gibt die Metadaten für den Container zurück. Dieser Wert wird mit den Metadaten aus der Warteschlange durch einen Aufruf downloadAttributes()von initialisiert und für die Warteschlange mit einem Aufruf von uploadMetadata()festgelegt.

Returns:

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

getName

public String getName()

Gibt den Namen des Containers zurück.

Returns:

Ein String , der den Namen des Containers darstellt.

getPageBlobReference

public CloudPageBlob getPageBlobReference(final String blobName)

Gibt einen Verweis auf ein CloudPageBlob -Objekt zurück, das ein Seitenblob in diesem Container darstellt.

Parameters:

blobName - Ein String , der den Namen des Blobs darstellt.

Returns:

Ein CloudPageBlob -Objekt, das einen Verweis auf das angegebene Seitenblob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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

getPageBlobReference

public CloudPageBlob getPageBlobReference(final String blobName, final String snapshotID)

Gibt einen Verweis auf ein CloudPageBlob Objekt zurück, das ein Seitenblob im Container darstellt, wobei die angegebene Momentaufnahme-ID verwendet wird.

Parameters:

blobName - Ein String , der den Namen des Blobs darstellt.

snapshotID - Ein String , der die Momentaufnahme-ID des Blobs darstellt.

Returns:

Ein CloudPageBlob -Objekt, das einen Verweis auf das angegebene Seitenblob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

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

getProperties

public BlobContainerProperties getProperties()

Gibt die Eigenschaften für den Container zurück.

Returns:

Ein BlobContainerProperties -Objekt, das die Eigenschaften für den Container darstellt.

getServiceClient

public CloudBlobClient getServiceClient()

Gibt den diesem Container zugeordneten Blobdienstclient zurück.

Returns:

Ein CloudBlobClient -Objekt, das den diesem Container zugeordneten Dienstclient darstellt.

getStorageUri

public StorageUri getStorageUri()

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

Returns:

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

getUri

public URI getUri()

Gibt den URI für diesen Container zurück.

Returns:

Der absolute URI für den Container.

listBlobs

public Iterable listBlobs()

Gibt eine aufzählbare Auflistung von Blobelementen für den Container zurück.

Returns:

Eine aufzählbare Auflistung von ListBlobItem Objekten, die verzögert abgerufen werden und die Elemente in diesem Container darstellen.

listBlobs

public Iterable listBlobs(final String prefix)

Gibt eine aufzählbare Auflistung von Blobelementen für den Container zurück, dessen Namen mit dem angegebenen Präfix beginnen.

Parameters:

prefix - Ein String , der das Blobnamenpräfix darstellt. Diesem Wert muss entweder der Name des Containers oder der absolute Pfad zum Container vorangestellt werden.

Returns:

Eine aufzählbare Auflistung von ListBlobItem Objekten, die verzögert abgerufen werden und die Elemente darstellt, deren Namen mit dem angegebenen Präfix in diesem Container beginnen.

listBlobs

public Iterable listBlobs(final String prefix, final boolean useFlatBlobListing)

Gibt mithilfe der angegebenen flachen oder hierarchischen Option eine aufzählbare Auflistung von Blobelementen für den Container zurück, dessen Namen mit dem angegebenen Präfix beginnen.

Parameters:

prefix - Ein String , der das Blobnamenpräfix darstellt. Diesem Wert muss entweder der Name des Containers oder der absolute Pfad zum Container vorangestellt werden.

useFlatBlobListing -

true , um anzugeben, dass die zurückgegebene Liste flach ist; false , um anzugeben, dass die zurückgegebene Liste hierarchisch ist.

Returns:

Eine aufzählbare Auflistung von ListBlobItem Objekten, die verzögert abgerufen werden und die Elemente darstellt, deren Namen mit dem angegebenen Präfix in diesem Container beginnen.

listBlobs

public Iterable listBlobs(final String prefix, final boolean useFlatBlobListing, final EnumSet listingDetails, BlobRequestOptions options, OperationContext opContext)

Gibt eine aufzählbare Auflistung von Blobelementen für den Container zurück, dessen Namen mit dem angegebenen Präfix beginnen, wobei die angegebene flache oder hierarchische Option, Optionen für Auflistungsdetails, Anforderungsoptionen und Vorgangskontext verwendet werden.

Parameters:

prefix - Ein String , der das Blobnamenpräfix darstellt. Diesem Wert muss entweder der Name des Containers oder der absolute Pfad zum Container vorangestellt werden.

useFlatBlobListing -

true , um anzugeben, dass die zurückgegebene Liste flach ist; false , um anzugeben, dass die zurückgegebene Liste hierarchisch ist.

listingDetails - Ein java.util.EnumSet -Objekt, das Werte enthält BlobListingDetails , die angeben, ob Momentaufnahmen, vorläufig gelöschte Blobs, Metadaten und/oder Blöcke ohne Commit zurückgegeben werden. Committete Blöcke werden immer zurückgegeben.

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:

Eine aufzählbare Auflistung von ListBlobItem Objekten, die verzögert abgerufen werden und die Elemente darstellt, deren Namen mit dem angegebenen Präfix in diesem Container beginnen.

listBlobsSegmented

public ResultSegment listBlobsSegmented()

Gibt ein Ergebnissegment einer aufzählbaren Auflistung von Blobelementen im Container zurück.

Returns:

Ein ResultSegment<T> -Objekt, das ein Segment der aufzählbaren Auflistung von ListBlobItem Objekten enthält, die die Blobelemente im Container darstellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

listBlobsSegmented

public ResultSegment listBlobsSegmented(final String prefix)

Gibt ein Ergebnissegment zurück, das eine Auflistung von Blobelementen enthält, deren Namen mit dem angegebenen Präfix beginnen.

Parameters:

prefix - Ein String , das das Präfix des Blobnamens darstellt.

Returns:

Ein ResultSegment<T> -Objekt, das ein Segment der aufzählbaren Auflistung von ListBlobItem Objekten enthält, die die Blobelemente darstellen, deren Namen mit dem angegebenen Präfix im Container beginnen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

listBlobsSegmented

public ResultSegment listBlobsSegmented(final String prefix, final boolean useFlatBlobListing, final EnumSet listingDetails, final Integer maxResults, final ResultContinuation continuationToken, BlobRequestOptions options, OperationContext opContext)

Gibt ein Ergebnissegment zurück, das eine Auflistung von Blobelementen enthält, deren Namen mit dem angegebenen Präfix beginnen, wobei die angegebene flache oder hierarchische Option, Optionen für Auflistungsdetails, Anforderungsoptionen und Vorgangskontext verwendet werden.

Parameters:

prefix - Ein String , das das Präfix des Blobnamens darstellt.

useFlatBlobListing -

true , um anzugeben, dass die zurückgegebene Liste flach ist; false , um anzugeben, dass die zurückgegebene Liste hierarchisch ist.

listingDetails - Ein java.util.EnumSet -Objekt, das Werte enthält BlobListingDetails , die angeben, ob Momentaufnahmen, vorläufig gelöschte Blobs, Metadaten und/oder Blöcke ohne Commit zurückgegeben werden. Committete Blöcke werden immer zurückgegeben.

maxResults - Die maximale Anzahl der abzurufenden Ergebnisse. Wenn null oder größer als 5000, gibt der Server bis zu 5.000 Elemente zurück. Die Anzahl muss mindestens 1 sein.

continuationToken - Ein ResultContinuation -Objekt, das ein Fortsetzungstoken darstellt, das von einem vorherigen Auflistungsvorgang zurückgegeben wurde.

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 ResultSegment<T> -Objekt, das ein Segment der aufzählbaren Auflistung von ListBlobItem Objekten enthält, die die Blockelemente darstellen, deren Namen mit dem angegebenen Präfix im Container beginnen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

listContainers

public Iterable listContainers()

Gibt eine aufzählbare Auflistung von Containern für den Dienstclient zurück, der diesem Container zugeordnet ist.

Returns:

Eine aufzählbare Auflistung von CloudBlobContainer Objekten, die verzögert abgerufen werden und die die Container für den diesem Container zugeordneten Dienstclient darstellen.

listContainers

public Iterable listContainers(final String prefix)

Gibt eine aufzählbare Auflistung von Containern zurück, deren Namen mit dem angegebenen Präfix für den Diesem Container zugeordneten Dienstclient beginnen.

Parameters:

prefix - Ein String , das das Containernamenpräfix darstellt.

Returns:

Eine aufzählbare Auflistung von CloudBlobContainer Objekten, die verzögert abgerufen werden und die Container darstellen, deren Namen mit dem angegebenen Präfix für den diesem Container zugeordneten Dienstclient beginnen.

listContainers

public Iterable listContainers(final String prefix, final ContainerListingDetails detailsIncluded, final BlobRequestOptions options, final OperationContext opContext)

Gibt eine aufzählbare Auflistung von Containern zurück, deren Namen mit dem angegebenen Präfix für den dienstclient beginnen, der diesem Container zugeordnet ist, wobei die angegebene Detaileinstellung, Anforderungsoptionen und der angegebene Vorgangskontext verwendet werden.

Parameters:

prefix - Ein String , das das Containernamenpräfix darstellt.

detailsIncluded - Ein ContainerListingDetails -Wert, der angibt, ob Containermetadaten zurückgegeben 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.

Returns:

Eine aufzählbare Auflistung von CloudBlobContainer Objekten, die verzögert abgerufen werden und die container für den diesem Container zugeordneten Dienstclient darstellt.

listContainersSegmented

public ResultSegment listContainersSegmented()

Gibt ein Ergebnissegment einer aufzählbaren Auflistung von Containern für den Diesem Container zugeordneten Dienstclient zurück.

Returns:

Ein ResultSegment<T> -Objekt, das ein Segment der aufzählbaren Auflistung von CloudBlobContainer Objekten enthält, die die Container für den diesem Container zugeordneten Dienstclient darstellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

listContainersSegmented

public ResultSegment listContainersSegmented(final String prefix)

Gibt ein Ergebnissegment einer aufzählbaren Auflistung von Containern zurück, deren Namen mit dem angegebenen Präfix für den diesem Container zugeordneten Dienstclient beginnen.

Parameters:

prefix - Ein String , der das Blobnamenpräfix darstellt.

Returns:

Ein ResultSegment<T> -Objekt, das ein Segment der aufzählbaren Auflistung von CloudBlobContainer Objekten enthält, die die Container darstellen, deren Namen mit dem angegebenen Präfix für den diesem Container zugeordneten Dienstclient beginnen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

listContainersSegmented

public ResultSegment listContainersSegmented(final String prefix, final ContainerListingDetails detailsIncluded, final Integer maxResults, final ResultContinuation continuationToken, final BlobRequestOptions options, final OperationContext opContext)

Gibt ein Ergebnissegment zurück, das eine Auflistung von Containern enthält, deren Namen mit dem angegebenen Präfix für den Dienstclient beginnen, der diesem Container zugeordnet ist, wobei die angegebenen Listendetailsoptionen, Anforderungsoptionen und der Vorgangskontext verwendet werden.

Parameters:

prefix - Ein String , der das Präfix des Containernamens darstellt.

detailsIncluded - Ein ContainerListingDetails -Objekt, das angibt, ob Metadaten enthalten sind.

maxResults - Die maximale Anzahl der abzurufenden Ergebnisse. Wenn null oder größer als 5000, gibt der Server bis zu 5.000 Elemente zurück. Die Anzahl muss mindestens 1 sein.

continuationToken - Ein ResultContinuation -Objekt, das ein Fortsetzungstoken darstellt, das von einem vorherigen Auflistungsvorgang zurückgegeben wurde.

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 ResultSegment<T> -Objekt, das ein Segment der aufzählbaren Auflistung von CloudBlobContainer Objekten enthält, die die Container darstellen, deren Namen mit dem angegebenen Präfix für den diesem Container zugeordneten Dienstclient beginnen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

releaseLease

public final void releaseLease(final AccessCondition accessCondition)

Gibt die Lease für den Container frei.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt. Die Lease-ID muss mit einer Zugriffsbedingung 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 den Container unter Verwendung der angegebenen Zugriffsbedingungen, Anforderungsoptionen und des angegebenen Vorgangskontexts frei.

Parameters:

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.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

renewLease

public final void renewLease(final AccessCondition accessCondition)

Erneuert eine vorhandene Lease mit den angegebenen Zugriffsbedingungen.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für den Container darstellt. Die Lease-ID muss mit einer Zugriffsbedingung 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 mit den angegebenen Zugriffsbedingungen, Anforderungsoptionen und dem angegebenen Vorgangskontext.

Parameters:

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.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

setMetadata

public void setMetadata(final HashMap metadata)

Legt die Metadatenauflistung von Name-Wert-Paaren fest, die für den Container mit einem uploadMetadata() Aufruf festgelegt werden sollen. Diese Sammlung überschreibt alle vorhandenen Containermetadaten. Wenn dies auf eine leere Sammlung festgelegt ist, werden die Containermetadaten bei einem uploadMetadata() Aufruf gelöscht.

Parameters:

metadata - Ein java.util.HashMap -Objekt, das die Metadaten darstellt, die dem Container zugewiesen werden.

setProperties

protected void setProperties(final BlobContainerProperties properties)

Legt die Eigenschaften für den Container fest.

Parameters:

properties - Ein BlobContainerProperties -Objekt, das die Eigenschaften darstellt, die dem Container zugewiesen werden.

setStorageUri

protected void setStorageUri(final StorageUri storageUri)

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

Parameters:

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

uploadMetadata

public void uploadMetadata()

Lädt die Metadaten des Containers hoch.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadMetadata

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

Lädt die Metadaten des Containers mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts hoch.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für den Container 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.

uploadPermissions

public void uploadPermissions(final BlobContainerPermissions permissions)

Lädt die Berechtigungen des Containers hoch.

Parameters:

permissions - Ein BlobContainerPermissions -Objekt, das die Berechtigungen zum Hochladen darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadPermissions

public void uploadPermissions(final BlobContainerPermissions permissions, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Lädt die Berechtigungen des Containers mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts hoch.

Parameters:

permissions - Ein BlobContainerPermissions -Objekt, das die Berechtigungen zum Hochladen darstellt.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für den Container 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.