CloudBlobContainer Clase

Referencia

Paquete:: com.microsoft.azure.storage.blob

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

public class CloudBlobContainer

Representa un contenedor en Microsoft Azure Blob Service.

Los contenedores contienen directorios, que se encapsulan como objetos CloudBlobDirectory, y los directorios contienen blobs en bloques y blobs en páginas. Los directorios también pueden contener subdirectorios.

Resumen del campo

Modificador y tipo	Campo y descripción
HashMap<String, String>	metadata Representa los metadatos del contenedor.

Resumen del constructor

Constructor	Description
CloudBlobContainer(final StorageUri storageUri)	Crea una instancia de la clase utilizando el URI especificado. El URI del blob debe incluir un token de SAS a menos que se use el acceso anónimo.
CloudBlobContainer(final StorageUri storageUri, final StorageCredentials credentials)	Crea una instancia de la clase con el storageUri y las credenciales especificados.
CloudBlobContainer(final String containerName, final CloudBlobClient client)	Crea una instancia de la clase utilizando el nombre y el cliente especificados.
CloudBlobContainer(final URI uri)	Crea una instancia de la clase utilizando el URI especificado. El URI del blob debe incluir un token de SAS a menos que se use el acceso anónimo.
CloudBlobContainer(final URI uri, final StorageCredentials credentials)	Crea una instancia de la clase utilizando el URI y las credenciales especificados.

Resumen del método

Modificador y tipo	Método y descripción
final String	acquireLease() Adquiere una nueva concesión infinita en el contenedor.
final String	acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId) Adquiere una nueva concesión en el contenedor con el tiempo de concesión especificado y el identificador de concesión propuesto.
final String	acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Adquiere una nueva concesión en el contenedor con el tiempo de concesión especificado, el identificador de concesión propuesto, las opciones de solicitud y el contexto de la operación.
final long	breakLease(final Integer breakPeriodInSeconds) Interrumpe la concesión y garantiza que otro cliente no pueda adquirir una nueva concesión hasta que haya expirado el período de concesión actual.
final long	breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Interrumpe la concesión existente, con las opciones de solicitud y el contexto de operación especificados, y garantiza que otro cliente no pueda adquirir una nueva concesión hasta que haya expirado el período de concesión actual.
final String	changeLease(final String proposedLeaseId, final AccessCondition accessCondition) Cambia el identificador de concesión existente al identificador de concesión propuesto.
final String	changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Cambia el identificador de concesión existente al identificador de concesión propuesto con las condiciones de acceso, las opciones de solicitud y el contexto de operación especificados.
void	create() Crea el contenedor.
void	create(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext) Crea el contenedor con las opciones y el contexto de operación especificados.
void	create(BlobRequestOptions options, OperationContext opContext) Crea el contenedor con las opciones y el contexto de operación especificados.
boolean	createIfNotExists() Crea el contenedor si no existe.
boolean	createIfNotExists(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext) Crea el contenedor si no existe, mediante las opciones de solicitud y el contexto de operación especificados.
boolean	createIfNotExists(BlobRequestOptions options, OperationContext opContext) Crea el contenedor si no existe, mediante las opciones de solicitud y el contexto de operación especificados.
void	delete() Elimina el contenedor.
void	delete(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Elimina el contenedor mediante las opciones de solicitud y el contexto de operación especificados.
boolean	deleteIfExists() Elimina el contenedor si existe.
boolean	deleteIfExists(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Elimina el contenedor si existe mediante las opciones de solicitud y el contexto de operación especificados.
AccountInformation	downloadAccountInfo() Obtiene información relacionada con la cuenta de almacenamiento en la que reside este contenedor.
AccountInformation	downloadAccountInfo(BlobRequestOptions options, OperationContext opContext) Obtiene información relacionada con la cuenta de almacenamiento en la que reside este contenedor.
StorageRequest<ServiceClient, CloudBlobContainer, AccountInformation>	downloadAccountInformationImpl(final RequestOptions options)
void	downloadAttributes() Descarga los atributos del contenedor, que constan de metadatos y propiedades.
void	downloadAttributes(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Descarga los atributos del contenedor, que constan de metadatos y propiedades, mediante las opciones de solicitud y el contexto de operación especificados.
BlobContainerPermissions	downloadPermissions() Descarga la configuración de permisos para el contenedor.
BlobContainerPermissions	downloadPermissions(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Descarga la configuración de permisos para el contenedor mediante las opciones de solicitud y el contexto de operación especificados.
boolean	exists() Devuelve un valor que indica si el contenedor existe.
boolean	exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Devuelve un valor que indica si el contenedor existe, utilizando las opciones de solicitud y el contexto de operación especificados.
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier) Devuelve una firma de acceso compartido para el contenedor. Tenga en cuenta que esto no contiene el "?".
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) Devuelve una firma de acceso compartido para el contenedor. Tenga en cuenta que esto no contiene el "?".
CloudAppendBlob	getAppendBlobReference(final String blobName) Devuelve una referencia a un CloudAppendBlob objeto que representa un blob en anexos de este contenedor.
CloudAppendBlob	getAppendBlobReference(final String blobName, final String snapshotID) Devuelve una referencia a un CloudAppendBlob objeto que representa un blob en anexos en el contenedor, utilizando el identificador de instantánea especificado.
final CloudBlob	getBlobReferenceFromServer(final String blobName) Obtiene una referencia a un blob de este contenedor. El blob ya debe existir en el servicio. A diferencia de los otros métodos get*Reference, este método realiza una solicitud de servicio para recuperar los metadatos y las propiedades del blob. El blob devuelto se puede usar directamente como cloudBlob o convertir mediante instanceof o getProperties().getBlobType() para determinar su subtipo.
final CloudBlob	getBlobReferenceFromServer(final String blobName, final String snapshotID, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Obtiene una referencia a un blob de este contenedor. El blob ya debe existir en el servicio. A diferencia de los otros métodos get*Reference, este método realiza una solicitud de servicio para recuperar los metadatos y las propiedades del blob. El blob devuelto se puede usar directamente como cloudBlob o convertir mediante instanceof o getProperties().getBlobType() para determinar su subtipo.
CloudBlockBlob	getBlockBlobReference(final String blobName) Devuelve una referencia a un CloudBlockBlob objeto que representa un blob en bloques en este contenedor.
CloudBlockBlob	getBlockBlobReference(final String blobName, final String snapshotID) Devuelve una referencia a un CloudBlockBlob objeto que representa un blob en bloques en este contenedor, utilizando el identificador de instantánea especificado.
CloudBlobDirectory	getDirectoryReference(String directoryName) Devuelve una referencia a un CloudBlobDirectory objeto que representa un directorio de blobs virtuales dentro de este contenedor.
HashMap<String, String>	getMetadata() Devuelve los metadatos del contenedor. Este valor se inicializa con los metadatos de la cola mediante una llamada a downloadAttributes()y se establece en la cola con una llamada a uploadMetadata().
String	getName() Devuelve el nombre del contenedor.
CloudPageBlob	getPageBlobReference(final String blobName) Devuelve una referencia a un CloudPageBlob objeto que representa un blob en páginas de este contenedor.
CloudPageBlob	getPageBlobReference(final String blobName, final String snapshotID) Devuelve una referencia a un CloudPageBlob objeto que representa un blob en páginas del contenedor, utilizando el identificador de instantánea especificado.
BlobContainerProperties	getProperties() Devuelve las propiedades del contenedor.
CloudBlobClient	getServiceClient() Devuelve el cliente de Blob service asociado a este contenedor.
StorageUri	getStorageUri() Devuelve la lista de URI de todas las ubicaciones.
URI	getUri() Devuelve el URI de este contenedor.
Iterable<ListBlobItem>	listBlobs() Devuelve una colección enumerable de elementos de blob para el contenedor.
Iterable<ListBlobItem>	listBlobs(final String prefix) Devuelve una colección enumerable de elementos de blob para el contenedor cuyos nombres comienzan por el prefijo especificado.
Iterable<ListBlobItem>	listBlobs(final String prefix, final boolean useFlatBlobListing) Devuelve una colección enumerable de elementos de blob para el contenedor cuyos nombres comienzan por el prefijo especificado mediante la opción plana o jerárquica especificada.
Iterable<ListBlobItem>	listBlobs(final String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, BlobRequestOptions options, OperationContext opContext) Devuelve una colección enumerable de elementos de blob para el contenedor cuyos nombres comienzan por el prefijo especificado, utilizando la opción plana o jerárquica especificada, enumerando opciones de detalles, opciones de solicitud y contexto de operación.
ResultSegment<ListBlobItem>	listBlobsSegmented() Devuelve un segmento de resultado de una colección enumerable de elementos de blob en el contenedor.
ResultSegment<ListBlobItem>	listBlobsSegmented(final String prefix) Devuelve un segmento de resultado que contiene una colección de elementos de blob cuyos nombres comienzan por el prefijo especificado.
ResultSegment<ListBlobItem>	listBlobsSegmented(final String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, final Integer maxResults, final ResultContinuation continuationToken, BlobRequestOptions options, OperationContext opContext) Devuelve un segmento de resultado que contiene una colección de elementos de blob cuyos nombres comienzan por el prefijo especificado, utilizando la opción plana o jerárquica especificada, enumerando opciones de detalles, opciones de solicitud y contexto de operación.
Iterable<CloudBlobContainer>	listContainers() Devuelve una colección enumerable de contenedores para el cliente de servicio asociado a este contenedor.
Iterable<CloudBlobContainer>	listContainers(final String prefix) Devuelve una colección enumerable de contenedores cuyos nombres comienzan por el prefijo especificado para el cliente de servicio asociado a este contenedor.
Iterable<CloudBlobContainer>	listContainers(final String prefix, final ContainerListingDetails detailsIncluded, final BlobRequestOptions options, final OperationContext opContext) Devuelve una colección enumerable de contenedores cuyos nombres comienzan por el prefijo especificado para el cliente de servicio asociado a este contenedor, utilizando la configuración de detalles, las opciones de solicitud y el contexto de operación especificados.
ResultSegment<CloudBlobContainer>	listContainersSegmented() Devuelve un segmento de resultado de una colección enumerable de contenedores para el cliente de servicio asociado a este contenedor.
ResultSegment<CloudBlobContainer>	listContainersSegmented(final String prefix) Devuelve un segmento de resultado de una colección enumerable de contenedores cuyos nombres comienzan con el prefijo especificado para el cliente de servicio asociado a este contenedor.
ResultSegment<CloudBlobContainer>	listContainersSegmented(final String prefix, final ContainerListingDetails detailsIncluded, final Integer maxResults, final ResultContinuation continuationToken, final BlobRequestOptions options, final OperationContext opContext) Devuelve un segmento de resultado que contiene una colección de contenedores cuyos nombres comienzan con el prefijo especificado para el cliente de servicio asociado a este contenedor, utilizando las opciones de detalles de la lista especificadas, las opciones de solicitud y el contexto de la operación.
final void	releaseLease(final AccessCondition accessCondition) Libera la concesión en el contenedor.
final void	releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Libera la concesión en el contenedor mediante las condiciones de acceso, las opciones de solicitud y el contexto de operación especificados.
final void	renewLease(final AccessCondition accessCondition) Renueva una concesión existente con las condiciones de acceso especificadas.
final void	renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Renueva una concesión existente con las condiciones de acceso, las opciones de solicitud y el contexto de operación especificados.
void	setMetadata(final HashMap<String, String> metadata) Establece la colección de metadatos de pares nombre-valor que se van a establecer en el contenedor con una uploadMetadata() llamada. Esta colección sobrescribirá los metadatos de contenedor existentes. Si se establece en una colección vacía, los metadatos del contenedor se borrarán en una uploadMetadata() llamada.
void	setProperties(final BlobContainerProperties properties) Establece las propiedades del contenedor.
void	setStorageUri(final StorageUri storageUri) Establece la lista de URI para todas las ubicaciones.
void	uploadMetadata() Carga los metadatos del contenedor.
void	uploadMetadata(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carga los metadatos del contenedor mediante las opciones de solicitud y el contexto de operación especificados.
void	uploadPermissions(final BlobContainerPermissions permissions) Carga los permisos del contenedor.
void	uploadPermissions(final BlobContainerPermissions permissions, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carga los permisos del contenedor mediante las opciones de solicitud y el contexto de operación especificados.

Detalles del campo

metadata

protected HashMap metadata= new HashMap()

Representa los metadatos del contenedor.

Detalles del constructor

CloudBlobContainer

public CloudBlobContainer(final StorageUri storageUri)

Crea una instancia de la clase utilizando el URI especificado. El URI del blob debe incluir un token de SAS a menos que se use el acceso anónimo.

Parameters:

storageUri - Objeto StorageUri que representa el URI del contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

CloudBlobContainer

public CloudBlobContainer(final StorageUri storageUri, final StorageCredentials credentials)

Crea una instancia de la clase con el storageUri y las credenciales especificados.

Parameters:

storageUri - Objeto StorageUri que representa el storageUri absoluto del contenedor.

credentials - Objeto StorageCredentials utilizado para autenticar el acceso.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

CloudBlobContainer

protected CloudBlobContainer(final String containerName, final CloudBlobClient client)

Crea una instancia de la clase utilizando el nombre y el cliente especificados.

Parameters:

containerName - que String representa el nombre del contenedor, que debe cumplir las reglas de nomenclatura del contenedor. El nombre del contenedor no debe incluir ningún carácter separador de ruta de acceso (/). Los nombres de contenedor deben estar en minúsculas, entre 3 y 63 caracteres y deben comenzar con una letra o un número. Los nombres de contenedor solo pueden contener letras, números y el carácter de guión (-).

client - Objeto CloudBlobClient que representa el cliente de servicio asociado y que especifica el punto de conexión para Blob service. *

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

URISyntaxException - Si el URI del recurso construido basado en containerName no es válido.

CloudBlobContainer

public CloudBlobContainer(final URI uri)

Crea una instancia de la clase utilizando el URI especificado. El URI del blob debe incluir un token de SAS a menos que se use el acceso anónimo.

Parameters:

uri - Objeto java.net.URI que representa el URI del contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

CloudBlobContainer

public CloudBlobContainer(final URI uri, final StorageCredentials credentials)

Crea una instancia de la clase utilizando el URI y las credenciales especificados.

Parameters:

uri - Objeto java.net.URI que representa el URI absoluto del contenedor.

credentials - Objeto StorageCredentials utilizado para autenticar el acceso.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

Detalles del método

acquireLease

public final String acquireLease()

Adquiere una nueva concesión infinita en el contenedor.

Returns:

que String representa el identificador de concesión.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

acquireLease

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

Adquiere una nueva concesión en el contenedor con el tiempo de concesión especificado y el identificador de concesión propuesto.

Parameters:

leaseTimeInSeconds - que Integer especifica el intervalo de tiempo para el que se va a adquirir la concesión, en segundos. Si es null, se adquirirá una concesión infinita. Si no es null, el valor debe ser mayor que cero.

proposedLeaseId - que String representa el identificador de concesión propuesto para la nueva concesión, o null si no se propone ningún identificador de concesión.

Returns:

que String representa el identificador de concesión.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

acquireLease

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

Adquiere una nueva concesión en el contenedor con el tiempo de concesión especificado, el identificador de concesión propuesto, las opciones de solicitud y el contexto de la operación.

Parameters:

proposedLeaseId - que String representa el identificador de concesión propuesto para la nueva concesión, o null si no se propone ningún identificador de concesión.

accessCondition - Un objeto AccessCondition que representa las condiciones de acceso para el contenedor.

options - Objeto BlobRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null , se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado (CloudBlobClient).

opContext - Objeto OperationContext que representa el contexto para la operación actual. El contexto se usa para realizar un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.

Returns:

que String representa el identificador de concesión.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

breakLease

public final long breakLease(final Integer breakPeriodInSeconds)

Interrumpe la concesión y garantiza que otro cliente no pueda adquirir una nueva concesión hasta que haya expirado el período de concesión actual.

Parameters:

breakPeriodInSeconds - que Integer especifica el tiempo de espera, en segundos, hasta que se interrumpe la concesión actual. Si es null, el período de interrupción es el resto de la concesión actual, o cero en el caso de las concesiones infinitas.

Returns:

Tiempo, en segundos, restante en el período de concesión.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

breakLease

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

Interrumpe la concesión existente, con las opciones de solicitud y el contexto de operación especificados, y garantiza que otro cliente no pueda adquirir una nueva concesión hasta que haya expirado el período de concesión actual.

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob.

Returns:

Tiempo, en segundos, restante en el período de concesión.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

changeLease

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

Cambia el identificador de concesión existente al identificador de concesión propuesto.

Parameters:

proposedLeaseId - que String representa el identificador de concesión propuesto para la nueva concesión, o null si no se propone ningún identificador de concesión.

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob. Es necesario establecer el identificador de concesión con una condición de acceso.

Returns:

que String representa el nuevo identificador de concesión.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

changeLease

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

Cambia el identificador de concesión existente al identificador de concesión propuesto con las condiciones de acceso, las opciones de solicitud y el contexto de operación especificados.

Parameters:

proposedLeaseId - que String representa el identificador de concesión propuesto para la nueva concesión. Su valor no puede ser null.

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob. Es necesario establecer el identificador de concesión con una condición de acceso.

Returns:

que String representa el nuevo identificador de concesión.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

create

public void create()

Crea el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

create

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

Crea el contenedor con las opciones y el contexto de operación especificados.

Parameters:

accessType - Objeto BlobContainerPublicAccessType que especifica si se puede acceder a los datos del contenedor públicamente y a qué nivel de acceso se va a permitir.

opContext - Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

create

public void create(BlobRequestOptions options, OperationContext opContext)

Crea el contenedor con las opciones y el contexto de operación especificados.

Parameters:

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

createIfNotExists

public boolean createIfNotExists()

Crea el contenedor si no existe.

Returns:

Es true si el contenedor no existía todavía y se creó; en caso contrario, es false.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

createIfNotExists

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

Crea el contenedor si no existe, mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessType - Objeto BlobContainerPublicAccessType que especifica si se puede acceder a los datos del contenedor públicamente y a qué nivel de acceso se va a permitir.

Returns:

Es true si el contenedor no existía todavía y se creó; en caso contrario, es false.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

createIfNotExists

public boolean createIfNotExists(BlobRequestOptions options, OperationContext opContext)

Crea el contenedor si no existe, mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

Returns:

Es true si el contenedor no existía todavía y se creó; en caso contrario, es false.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

delete

public void delete()

Elimina el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

delete

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

Elimina el contenedor mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessCondition - Un objeto AccessCondition que representa las condiciones de acceso para el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

deleteIfExists

public boolean deleteIfExists()

Elimina el contenedor si existe.

Returns:

Es true si el contenedor no existía todavía y se creó; en caso contrario, es false.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

deleteIfExists

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

Elimina el contenedor si existe mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessCondition - Un objeto AccessCondition que representa las condiciones de acceso para el contenedor.

options - Objeto BlobRequestOptions que especifica las opciones adicionales para la solicitud. Al especificar null se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudBlobClient).

Returns:

true si el contenedor existía y se eliminó; de lo contrario, false.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

downloadAccountInfo

public AccountInformation downloadAccountInfo()

Obtiene información relacionada con la cuenta de almacenamiento en la que reside este contenedor.

Returns:

Objeto AccountInformation para la cuenta de almacenamiento especificada.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

downloadAccountInfo

public AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)

Obtiene información relacionada con la cuenta de almacenamiento en la que reside este contenedor.

Parameters:

Returns:

Objeto AccountInformation para la cuenta de almacenamiento especificada.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

downloadAccountInformationImpl

protected StorageRequest downloadAccountInformationImpl(final RequestOptions options)

Parameters:

options

downloadAttributes

public void downloadAttributes()

Descarga los atributos del contenedor, que constan de metadatos y propiedades.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

downloadAttributes

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

Descarga los atributos del contenedor, que constan de metadatos y propiedades, mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessCondition - Un objeto AccessCondition que representa las condiciones de acceso para el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

downloadPermissions

public BlobContainerPermissions downloadPermissions()

Descarga la configuración de permisos para el contenedor.

Returns:

Objeto BlobContainerPermissions que representa los permisos del contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

downloadPermissions

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

Descarga la configuración de permisos para el contenedor mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessCondition - Un objeto AccessCondition que representa las condiciones de acceso para el contenedor.

Returns:

Objeto BlobContainerPermissions que representa los permisos del contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

exists

public boolean exists()

Devuelve un valor que indica si el contenedor existe.

Returns:

true es si el contenedor existe; de lo contrario false, es .

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

exists

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

Devuelve un valor que indica si el contenedor existe, utilizando las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessCondition - Un objeto AccessCondition que representa las condiciones de acceso para el contenedor.

Returns:

true es si el contenedor existe; de lo contrario false, es .

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

generateSharedAccessSignature

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

Devuelve una firma de acceso compartido para el contenedor. Tenga en cuenta que esto no contiene el "?".

Parameters:

policy - Objeto SharedAccessBlobPolicy que representa la directiva de acceso para la firma de acceso compartido.

groupPolicyIdentifier - que String representa la directiva de acceso de nivel de contenedor.

Returns:

que String representa una firma de acceso compartido para el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

InvalidKeyException - Si la clave no es válida.

generateSharedAccessSignature

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

Devuelve una firma de acceso compartido para el contenedor. Tenga en cuenta que esto no contiene el "?".

Parameters:

policy - Objeto SharedAccessBlobPolicy que representa la directiva de acceso para la firma de acceso compartido.

groupPolicyIdentifier - que String representa la directiva de acceso de nivel de contenedor.

ipRange - Objeto IPRange que contiene el intervalo de direcciones IP permitidas.

protocols - que SharedAccessProtocols representa los protocolos de Internet permitidos.

Returns:

que String representa una firma de acceso compartido para el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

InvalidKeyException - Si la clave no es válida.

getAppendBlobReference

public CloudAppendBlob getAppendBlobReference(final String blobName)

Devuelve una referencia a un CloudAppendBlob objeto que representa un blob en anexos de este contenedor.

Parameters:

blobName - que String representa el nombre del blob.

Returns:

Objeto CloudAppendBlob que representa una referencia al blob en anexos especificado.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

URISyntaxException - Si el URI del recurso no es válido.

getAppendBlobReference

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

Devuelve una referencia a un CloudAppendBlob objeto que representa un blob en anexos en el contenedor, utilizando el identificador de instantánea especificado.

Parameters:

blobName - que String representa el nombre del blob.

snapshotID - que String representa el identificador de instantánea del blob.

Returns:

Objeto CloudAppendBlob que representa una referencia al blob en anexos especificado.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

URISyntaxException - Si el URI del recurso no es válido.

getBlobReferenceFromServer

public final CloudBlob getBlobReferenceFromServer(final String blobName)

Obtiene una referencia a un blob de este contenedor. El blob ya debe existir en el servicio.

A diferencia de los otros métodos get*Reference, este método realiza una solicitud de servicio para recuperar los metadatos y las propiedades del blob. El blob devuelto se puede usar directamente como cloudBlob o convertir mediante instanceof o getProperties().getBlobType() para determinar su subtipo.

Parameters:

blobName - que String representa el nombre del blob.

Returns:

Objeto CloudBlob que representa una referencia al blob especificado.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

URISyntaxException - Si el URI del recurso no es válido.

getBlobReferenceFromServer

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

Obtiene una referencia a un blob de este contenedor. El blob ya debe existir en el servicio.

Parameters:

blobName - que String representa el nombre del blob.

snapshotID - que String representa el identificador de instantánea del blob.

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob.

Returns:

Objeto CloudBlob que representa una referencia al blob especificado.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

URISyntaxException - Si el URI del recurso no es válido.

getBlockBlobReference

public CloudBlockBlob getBlockBlobReference(final String blobName)

Devuelve una referencia a un CloudBlockBlob objeto que representa un blob en bloques en este contenedor.

Parameters:

blobName - que String representa el nombre del blob.

Returns:

Objeto CloudBlockBlob que representa una referencia al blob en bloques especificado.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

URISyntaxException - Si el URI del recurso no es válido.

getBlockBlobReference

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

Devuelve una referencia a un CloudBlockBlob objeto que representa un blob en bloques en este contenedor, utilizando el identificador de instantánea especificado.

Parameters:

blobName - que String representa el nombre del blob.

snapshotID - que String representa el identificador de instantánea del blob.

Returns:

Objeto CloudBlockBlob que representa una referencia al blob en bloques especificado.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

URISyntaxException - Si el URI del recurso no es válido.

getDirectoryReference

public CloudBlobDirectory getDirectoryReference(String directoryName)

Devuelve una referencia a un CloudBlobDirectory objeto que representa un directorio de blobs virtuales dentro de este contenedor.

Parameters:

directoryName - que String representa el nombre del directorio de blobs virtuales. Si se desea el directorio raíz (el directorio que representa el propio contenedor), use una cadena vacía.

Returns:

que CloudBlobDirectory representa un directorio de blobs virtuales dentro de este contenedor.

Throws:

URISyntaxException - Si el URI del recurso no es válido.

getMetadata

public HashMap getMetadata()

Devuelve los metadatos del contenedor. Este valor se inicializa con los metadatos de la cola mediante una llamada a downloadAttributes()y se establece en la cola con una llamada a uploadMetadata().

Returns:

Objeto java.util.HashMap que representa los metadatos del contenedor.

getName

public String getName()

Devuelve el nombre del contenedor.

Returns:

que String representa el nombre del contenedor.

getPageBlobReference

public CloudPageBlob getPageBlobReference(final String blobName)

Devuelve una referencia a un CloudPageBlob objeto que representa un blob en páginas de este contenedor.

Parameters:

blobName - que String representa el nombre del blob.

Returns:

Objeto CloudPageBlob que representa una referencia al blob en páginas especificado.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

URISyntaxException - Si el URI del recurso no es válido.

getPageBlobReference

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

Devuelve una referencia a un CloudPageBlob objeto que representa un blob en páginas del contenedor, utilizando el identificador de instantánea especificado.

Parameters:

blobName - que String representa el nombre del blob.

snapshotID - que String representa el identificador de instantánea del blob.

Returns:

Objeto CloudPageBlob que representa una referencia al blob en páginas especificado.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

URISyntaxException - Si el URI del recurso no es válido.

getProperties

public BlobContainerProperties getProperties()

Devuelve las propiedades del contenedor.

Returns:

Objeto BlobContainerProperties que representa las propiedades del contenedor.

getServiceClient

public CloudBlobClient getServiceClient()

Devuelve el cliente de Blob service asociado a este contenedor.

Returns:

Objeto CloudBlobClient que representa el cliente de servicio asociado a este contenedor.

getStorageUri

public StorageUri getStorageUri()

Devuelve la lista de URI de todas las ubicaciones.

Returns:

Objeto StorageUri que representa la lista de URI para todas las ubicaciones.

getUri

public URI getUri()

Devuelve el URI de este contenedor.

Returns:

Identificador URI absoluto para el contenedor.

listBlobs

public Iterable listBlobs()

Devuelve una colección enumerable de elementos de blob para el contenedor.

Returns:

Colección enumerable de ListBlobItem objetos recuperados de forma diferida que representa los elementos de este contenedor.

listBlobs

public Iterable listBlobs(final String prefix)

Devuelve una colección enumerable de elementos de blob para el contenedor cuyos nombres comienzan por el prefijo especificado.

Parameters:

prefix - que String representa el prefijo del nombre del blob. Este valor debe ir precedido por el nombre del contenedor o por la ruta de acceso absoluta al contenedor.

Returns:

Colección enumerable de ListBlobItem objetos recuperados de forma diferida que representa los elementos cuyos nombres comienzan por el prefijo especificado en este contenedor.

listBlobs

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

Devuelve una colección enumerable de elementos de blob para el contenedor cuyos nombres comienzan por el prefijo especificado mediante la opción plana o jerárquica especificada.

Parameters:

prefix - que String representa el prefijo del nombre del blob. Este valor debe ir precedido por el nombre del contenedor o por la ruta de acceso absoluta al contenedor.

useFlatBlobListing -

true para indicar que la lista devuelta será plana; false para indicar que la lista devuelta será jerárquica.

Returns:

Colección enumerable de ListBlobItem objetos recuperados de forma diferida que representa los elementos cuyos nombres comienzan por el prefijo especificado en este contenedor.

listBlobs

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

Devuelve una colección enumerable de elementos de blob para el contenedor cuyos nombres comienzan por el prefijo especificado, utilizando la opción plana o jerárquica especificada, enumerando opciones de detalles, opciones de solicitud y contexto de operación.

Parameters:

prefix - que String representa el prefijo del nombre del blob. Este valor debe ir precedido por el nombre del contenedor o por la ruta de acceso absoluta al contenedor.

useFlatBlobListing -

true para indicar que la lista devuelta será plana; false para indicar que la lista devuelta será jerárquica.

listingDetails - Objeto java.util.EnumSet que contiene BlobListingDetails valores que indican si se devuelven instantáneas, blobs eliminados temporalmente, metadatos o bloques no confirmados. Los bloques confirmados siempre se devuelven.

Returns:

Colección enumerable de ListBlobItem objetos recuperados de forma diferida que representa los elementos cuyos nombres comienzan por el prefijo especificado en este contenedor.

listBlobsSegmented

public ResultSegment listBlobsSegmented()

Devuelve un segmento de resultado de una colección enumerable de elementos de blob en el contenedor.

Returns:

Objeto ResultSegment<T> que contiene un segmento de la colección enumerable de ListBlobItem objetos que representan los elementos de blob del contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

listBlobsSegmented

public ResultSegment listBlobsSegmented(final String prefix)

Devuelve un segmento de resultado que contiene una colección de elementos de blob cuyos nombres comienzan por el prefijo especificado.

Parameters:

prefix - que String representa el prefijo del nombre del blob.

Returns:

Objeto ResultSegment<T> que contiene un segmento de la colección enumerable de ListBlobItem objetos que representan los elementos de blob cuyos nombres comienzan por el prefijo especificado en el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

listBlobsSegmented

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

Devuelve un segmento de resultado que contiene una colección de elementos de blob cuyos nombres comienzan por el prefijo especificado, utilizando la opción plana o jerárquica especificada, enumerando opciones de detalles, opciones de solicitud y contexto de operación.

Parameters:

prefix - que String representa el prefijo del nombre del blob.

useFlatBlobListing -

true para indicar que la lista devuelta será plana; false para indicar que la lista devuelta será jerárquica.

maxResults - Número máximo de resultados que se van a recuperar. Si null o mayor que 5000, el servidor devolverá hasta 5000 elementos. Debe ser 1 como mínimo.

continuationToken - Objeto ResultContinuation que representa un token de continuación devuelto por una operación de enumeración anterior.

Returns:

Objeto ResultSegment<T> que contiene un segmento de la colección enumerable de objetos que representan los elementos de ListBlobItem bloque cuyos nombres comienzan por el prefijo especificado en el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

listContainers

public Iterable listContainers()

Devuelve una colección enumerable de contenedores para el cliente de servicio asociado a este contenedor.

Returns:

Colección enumerable de CloudBlobContainer objetos recuperados de forma diferida que representan los contenedores del cliente de servicio asociado a este contenedor.

listContainers

public Iterable listContainers(final String prefix)

Devuelve una colección enumerable de contenedores cuyos nombres comienzan por el prefijo especificado para el cliente de servicio asociado a este contenedor.

Parameters:

prefix - que String representa el prefijo del nombre del contenedor.

Returns:

Colección enumerable de CloudBlobContainer objetos recuperados de forma diferida que representan los contenedores cuyos nombres comienzan por el prefijo especificado para el cliente de servicio asociado a este contenedor.

listContainers

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

Devuelve una colección enumerable de contenedores cuyos nombres comienzan por el prefijo especificado para el cliente de servicio asociado a este contenedor, utilizando la configuración de detalles, las opciones de solicitud y el contexto de operación especificados.

Parameters:

prefix - que String representa el prefijo del nombre del contenedor.

detailsIncluded - Valor ContainerListingDetails que indica si se devolverán los metadatos del contenedor.

Returns:

Colección enumerable de CloudBlobContainer objetos recuperados de forma diferida que representa los contenedores del cliente de servicio asociado a este contenedor.

listContainersSegmented

public ResultSegment listContainersSegmented()

Devuelve un segmento de resultado de una colección enumerable de contenedores para el cliente de servicio asociado a este contenedor.

Returns:

Objeto ResultSegment<T> que contiene un segmento de la colección enumerable de CloudBlobContainer objetos que representan los contenedores del cliente de servicio asociado a este contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

listContainersSegmented

public ResultSegment listContainersSegmented(final String prefix)

Devuelve un segmento de resultado de una colección enumerable de contenedores cuyos nombres comienzan con el prefijo especificado para el cliente de servicio asociado a este contenedor.

Parameters:

prefix - que String representa el prefijo del nombre del blob.

Returns:

Objeto ResultSegment<T> que contiene un segmento de la colección enumerable de CloudBlobContainer objetos que representan los contenedores cuyos nombres comienzan con el prefijo especificado para el cliente de servicio asociado a este contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

listContainersSegmented

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

Devuelve un segmento de resultado que contiene una colección de contenedores cuyos nombres comienzan con el prefijo especificado para el cliente de servicio asociado a este contenedor, utilizando las opciones de detalles de la lista especificadas, las opciones de solicitud y el contexto de la operación.

Parameters:

prefix - que String representa el prefijo del nombre del contenedor.

detailsIncluded - Objeto ContainerListingDetails que indica si se incluyen metadatos.

maxResults - Número máximo de resultados que se van a recuperar. Si null o superior a 5000, el servidor devolverá hasta 5000 elementos. Debe ser 1 como mínimo.

continuationToken - Objeto ResultContinuation que representa un token de continuación devuelto por una operación de lista anterior.

Returns:

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

releaseLease

public final void releaseLease(final AccessCondition accessCondition)

Libera la concesión en el contenedor.

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob. Es necesario establecer el identificador de concesión con una condición de acceso.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

releaseLease

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

Libera la concesión en el contenedor mediante las condiciones de acceso, las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob. Es necesario establecer el identificador de concesión con una condición de acceso.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

renewLease

public final void renewLease(final AccessCondition accessCondition)

Renueva una concesión existente con las condiciones de acceso especificadas.

Parameters:

accessCondition - Un objeto AccessCondition que representa las condiciones de acceso para el contenedor. Es necesario establecer el identificador de concesión con una condición de acceso.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

renewLease

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

Renueva una concesión existente con las condiciones de acceso, las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob. Es necesario establecer el identificador de concesión con una condición de acceso.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

setMetadata

public void setMetadata(final HashMap metadata)

Establece la colección de metadatos de pares nombre-valor que se van a establecer en el contenedor con una uploadMetadata() llamada. Esta colección sobrescribirá los metadatos de contenedor existentes. Si se establece en una colección vacía, los metadatos del contenedor se borrarán en una uploadMetadata() llamada.

Parameters:

metadata - Objeto java.util.HashMap que representa los metadatos que se asignan al contenedor.

setProperties

protected void setProperties(final BlobContainerProperties properties)

Establece las propiedades del contenedor.

Parameters:

properties - Objeto BlobContainerProperties que representa las propiedades que se asignan al contenedor.

setStorageUri

protected void setStorageUri(final StorageUri storageUri)

Establece la lista de URI para todas las ubicaciones.

Parameters:

storageUri - Objeto StorageUri que representa la lista de URI para todas las ubicaciones.

uploadMetadata

public void uploadMetadata()

Carga los metadatos del contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

uploadMetadata

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

Carga los metadatos del contenedor mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessCondition - Un objeto AccessCondition que representa las condiciones de acceso para el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

uploadPermissions

public void uploadPermissions(final BlobContainerPermissions permissions)

Carga los permisos del contenedor.

Parameters:

permissions - Objeto BlobContainerPermissions que representa los permisos que se van a cargar.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

uploadPermissions

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

Carga los permisos del contenedor mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

permissions - Objeto BlobContainerPermissions que representa los permisos que se van a cargar.

accessCondition - Un objeto AccessCondition que representa las condiciones de acceso para el contenedor.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

Compartir a través de

CloudBlobContainer Clase

Resumen del campo

Resumen del constructor

Resumen del método

Detalles del campo

metadata

Detalles del constructor

CloudBlobContainer

CloudBlobContainer

CloudBlobContainer

CloudBlobContainer

CloudBlobContainer

Detalles del método

acquireLease

acquireLease

acquireLease

breakLease

breakLease

changeLease

changeLease

create

create

create

createIfNotExists

createIfNotExists

createIfNotExists

delete

delete

deleteIfExists

deleteIfExists

downloadAccountInfo

downloadAccountInfo

downloadAccountInformationImpl

downloadAttributes

downloadAttributes

downloadPermissions

downloadPermissions

exists

exists

generateSharedAccessSignature

generateSharedAccessSignature

getAppendBlobReference

getAppendBlobReference

getBlobReferenceFromServer

getBlobReferenceFromServer

getBlockBlobReference

getBlockBlobReference

getDirectoryReference

getMetadata

getName

getPageBlobReference

getPageBlobReference

getProperties

getServiceClient

getStorageUri

getUri

listBlobs

listBlobs

listBlobs

listBlobs

listBlobsSegmented

listBlobsSegmented

listBlobsSegmented

listContainers

listContainers

listContainers

listContainersSegmented

listContainersSegmented

listContainersSegmented

releaseLease

releaseLease

renewLease

renewLease

setMetadata

setProperties

setStorageUri

uploadMetadata

uploadMetadata

uploadPermissions