CloudBlob Clase

Paquete:

com.microsoft.azure.storage.blob

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

public class CloudBlob implements ListBlobItem

Representa un blob de Microsoft Azure. Esta es la clase base para las CloudBlockBlob clases y CloudPageBlob .

Resumen del campo

Modificador y tipo	Campo y descripción
CloudBlobClient	blobServiceClient Representa el cliente de blobs.
CloudBlobDirectory	parent Representa el directorio del blob.
int	streamMinimumReadSizeInBytes Contiene el tamaño de lectura mínimo al usar .BlobInputStream
int	streamWriteSizeInBytes Contiene el número de bytes que se van a almacenar en búfer al escribir en un BlobOutputStream (blobs en bloques y en páginas).

Resumen del constructor

Constructor	Description
CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials)	Crea una instancia de la clase mediante el identificador URI, el identificador de instantánea y el cliente de blob en la nube especificados.
CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container)	Crea una instancia de la clase utilizando el tipo, el nombre, el identificador de instantánea y el contenedor especificados.
CloudBlob(final CloudBlob otherBlob)	Crea una instancia de la clase copiando valores de otro blob.

Resumen del método

Modificador y tipo	Método y descripción
final void	abortCopy(final String copyId) Anula una operación en curso de copia de blobs.
final void	abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Anula una operación en curso de copia de blobs.
final String	acquireLease() Adquiere una nueva concesión infinita en el blob.
final String	acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId) Adquiere una nueva concesión en el blob 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 blob con el tiempo de concesión especificado, el identificador de concesión propuesto, las opciones de solicitud y el contexto de operación especificados.
final void	assertCorrectBlobType() Afirma que el blob tiene el tipo de blob correcto especificado en los atributos de blob.
void	assertNoWriteOperationForSnapshot() Confirma que la operación de escritura no se realiza para la instantánea.
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.
final CloudBlob	createSnapshot() Crea una instantánea del blob.
final CloudBlob	createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Crea una instantánea del blob mediante las opciones de solicitud y el contexto de operación especificados.
final CloudBlob	createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Crea una instantánea del blob mediante las opciones de solicitud y el contexto de operación especificados.
final void	delete() Elimina el blob. Si se habilita una directiva de retención de eliminación en el servicio, el blob se conservará durante un período de tiempo especificado, antes de quitarse permanentemente por la recolección de elementos no utilizados.
final void	delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Elimina el blob mediante las opciones de instantánea y solicitud especificadas y el contexto de la operación. Si se habilita una directiva de retención de eliminación en el servicio, el blob se conservará durante un período de tiempo especificado, antes de quitarse permanentemente por la recolección de elementos no utilizados. No se puede eliminar un blob con instantáneas a menos que las instantáneas también se eliminen. Si un blob tiene instantáneas, use el DELETE_SNAPSHOTS_ONLY valor o INCLUDE_SNAPSHOTS en el parámetro para especificar cómo se deben controlar las instantáneas cuando se elimine el blob.
final boolean	deleteIfExists() Elimina el blob si existe. No se puede eliminar un blob con instantáneas a menos que las instantáneas también se eliminen. Si un blob tiene instantáneas, use el DELETE_SNAPSHOTS_ONLY valor o INCLUDE_SNAPSHOTS en el parámetro para especificar cómo se deben controlar las instantáneas cuando se elimine el blob.
final boolean	deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Elimina el blob si existe, mediante las opciones de instantánea y solicitud especificadas y el contexto de la operación. No se puede eliminar un blob con instantáneas a menos que las instantáneas también se eliminen. Si un blob tiene instantáneas, use el DELETE_SNAPSHOTS_ONLY valor o INCLUDE_SNAPSHOTS en el parámetro para especificar cómo se deben controlar las instantáneas cuando se elimine el blob.
final void	download(final OutputStream outStream) Descarga el contenido de un blob en un flujo.
final void	download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Descarga el contenido de un blob en una secuencia 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 blob.
AccountInformation	downloadAccountInfo(BlobRequestOptions options, OperationContext opContext) Obtiene información relacionada con la cuenta de almacenamiento en la que reside este blob.
StorageRequest<ServiceClient, CloudBlob, AccountInformation>	downloadAccountInformationImpl(final RequestOptions options)
final void	downloadAttributes() Rellena las propiedades y los metadatos de un blob. Este método rellena las propiedades del sistema del blob y los metadatos definidos por el usuario. Antes de leer o modificar las propiedades o metadatos de un blob, llame a este método o su sobrecarga para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.
final void	downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Rellena las propiedades y los metadatos de un blob mediante las opciones de solicitud y el contexto de operación especificados. Este método rellena las propiedades del sistema del blob y los metadatos definidos por el usuario. Antes de leer o modificar las propiedades o metadatos de un blob, llame a este método o su sobrecarga para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.
final void	downloadRange(final long offset, final Long length, final OutputStream outStream) Descarga el contenido de un blob en un flujo.
final void	downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Descarga el contenido de un blob en una secuencia mediante las opciones de solicitud y el contexto de operación especificados.
final int	downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Descarga un intervalo de bytes del blob al búfer de bytes especificado.
final int	downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset) Descarga un intervalo de bytes del blob al búfer de bytes especificado.
final int	downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Descarga un intervalo de bytes desde el blob hasta el búfer de bytes especificado, mediante las opciones de solicitud y el contexto de operación especificados.
final int	downloadToByteArray(final byte[] buffer, final int bufferOffset) Descarga un intervalo de bytes del blob al búfer de bytes especificado.
final int	downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Descarga un intervalo de bytes del blob al búfer de bytes especificado, mediante las opciones de solicitud y el contexto de operación especificados.
void	downloadToFile(final String path) Descarga un blob y almacena el contenido en un archivo.
void	downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Descarga un blob y almacena el contenido en un archivo.
final boolean	exists() Comprueba si el blob existe.
final boolean	exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Comprueba si el blob existe mediante las opciones de solicitud y el contexto de operación especificados.
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier) Devuelve una firma de acceso compartido para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) Devuelve una firma de acceso compartido para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding) Devuelve una firma de acceso compartido para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier) Devuelve una firma de acceso compartido para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".
String	generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols) Devuelve una firma de acceso compartido basada en una clave de delegación de usuarios para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".
String	generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy) Devuelve una firma de acceso compartido basada en una clave de delegación de usuarios para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".
final CloudBlobContainer	getContainer() Devuelve el contenedor del blob.
CopyState	getCopyState() Devuelve el estado de copia del blob.
final HashMap<String, String>	getMetadata() Devuelve los metadatos del blob.
final String	getName() Devuelve el nombre del blob.
final CloudBlobDirectory	getParent() Devuelve el elemento primario del elemento de blob.
String	getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container) Recupera el nombre primario de un URI de blob.
final BlobProperties	getProperties() Devuelve las propiedades del blob.
final StorageUri	getQualifiedStorageUri() Devuelve la instantánea o el URI calificado de firma de acceso compartido para este blob. <xreftitle>Deprecated</xreftitle> <xrefdescription> <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedStorageUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedStorageUri()"></xref> instead.</p> </xrefdescription>
final URI	getQualifiedUri() Devuelve el URI completo de la firma de acceso compartido o instantánea para este blob. <xreftitle>Deprecated</xreftitle> <xrefdescription> <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedUri()"></xref> instead.</p> </xrefdescription>
final CloudBlobClient	getServiceClient() Devuelve el cliente de Blob service asociado al blob.
final String	getSnapshotID() Obtiene el identificador de instantánea de blob.
final StorageUri	getSnapshotQualifiedStorageUri() Devuelve el URI del blob para las ubicaciones principales y secundarias, incluida la información de cadena de consulta si el blob es una instantánea.
final URI	getSnapshotQualifiedUri() Devuelve el URI absoluto al blob, incluida la información de cadena de consulta si el blob es una instantánea.
final StorageUri	getStorageUri() Devuelve la lista de URI de todas las ubicaciones.
final int	getStreamMinimumReadSizeInBytes() Devuelve el tamaño de lectura mínimo cuando se usa .BlobInputStream
final int	getStreamWriteSizeInBytes() Obtiene el número de bytes que se van a almacenar en búfer al escribir en un BlobOutputStream (blobs en bloques y en páginas).
final StorageUri	getTransformedAddress(final OperationContext opContext) Devuelve el URI transformado para el recurso si las credenciales especificadas requieren transformación.
final URI	getUri() Devuelve el URI de este blob.
final boolean	isSnapshot() Indica si este blob es una instantánea.
final BlobInputStream	openInputStream() Abre un flujo de entrada de blob para descargar el blob. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura.
final BlobInputStream	openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Abre un flujo de entrada de blobs para descargar el blob mediante las opciones de solicitud y el contexto de operación especificados. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura.
final BlobInputStream	openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Abre un flujo de entrada de blobs para descargar el blob mediante las opciones de solicitud y el contexto de operación especificados. Si el blob se descifra mientras se descarga, se omitirá la validación md5 final. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura.
final void	releaseLease(final AccessCondition accessCondition) Libera la concesión del blob.
final void	releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Libera la concesión en el blob mediante las opciones de solicitud y el contexto de operación especificados.
final void	renewLease(final AccessCondition accessCondition) Renueva una concesión existente.
final void	renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Renueva una concesión existente mediante las opciones de solicitud y el contexto de operación especificados.
final void	setContainer(final CloudBlobContainer container) Establece el contenedor del blob.
final void	setMetadata(final HashMap<String, String> metadata) Establece los metadatos del blob.
final void	setProperties(final BlobProperties properties) Establece las propiedades del blob.
final void	setSnapshotID(final String snapshotID) Establece el identificador de instantánea del blob.
void	setStorageUri(final StorageUri storageUri) Establece la lista de URI para todas las ubicaciones.
void	setStreamMinimumReadSizeInBytes(final int minimumReadSize) Establece el tamaño de lectura mínimo cuando se usa .BlobInputStream
abstract void	setStreamWriteSizeInBytes(int streamWriteSizeInBytes) Establece el número de bytes que se van a almacenar en búfer al escribir en un BlobOutputStream (blobs en bloques y en páginas).
final String	startCopy(final URI source) Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob.
final String	startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob, mediante las condiciones de acceso especificadas, el identificador de concesión, las opciones de solicitud y el contexto de la operación.
final String	startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob, mediante el nivel de blob en páginas Premium, las condiciones de acceso, el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. Nota: Establecer premiumPageBlobTier solo se admite para las cuentas Premium.
final String	startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob, mediante el nivel de blob en páginas Premium, las condiciones de acceso, el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. Nota: Establecer premiumPageBlobTier solo se admite para las cuentas Premium.
final String	startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob, mediante el nivel de blob en páginas Premium especificado, la prioridad de rehidratación, las condiciones de acceso, el identificador de concesión, las opciones de solicitud y el contexto de la operación. Nota: Establecer premiumPageBlobTier solo se admite para las cuentas Premium.
StorageRequest<CloudBlobClient, CloudBlob, String>	startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options)
final void	undelete() Anula la eliminación de un blob y todas sus instantáneas que se han eliminado temporalmente.
final void	undelete(BlobRequestOptions options, OperationContext opContext) Anula la eliminación de un blob que se ha eliminado temporalmente, mediante las opciones de solicitud especificadas y el contexto de la operación. La operación de eliminación de blobs restaura el contenido y los metadatos del blob eliminado temporalmente y todas sus instantáneas. Si se intenta recuperar un blob o una instantánea que no se elimina temporalmente, se realizará correctamente sin realizar ningún cambio.
void	updateEtagAndLastModifiedFromResponse(HttpURLConnection request)
void	updateLengthFromResponse(HttpURLConnection request)
abstract void	upload(InputStream sourceStream, long length) Carga los datos del flujo de origen en el blob. Si el blob ya existe en el servicio, se sobrescribirá.
abstract void	upload(InputStream sourceStream, long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carga los datos del flujo de origen en el blob mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. Si el blob ya existe en el servicio, se sobrescribirá.
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length) Carga un blob de datos en una matriz de bytes. Si el blob ya existe en el servicio, se sobrescribirá.
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carga un blob de datos en una matriz de bytes. Si el blob ya existe en el servicio, se sobrescribirá.
void	uploadFromFile(final String path) Carga un blob desde un archivo. Si el blob ya existe en el servicio, se sobrescribirá.
void	uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carga un blob desde un archivo. Si el blob ya existe en el servicio, se sobrescribirá.
final void	uploadMetadata() Carga los metadatos del blob en el servicio de almacenamiento. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.
final void	uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carga los metadatos del blob en el servicio de almacenamiento mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.
final void	uploadProperties() Novedades las propiedades del blob en el servicio de almacenamiento. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.
final void	uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Novedades las propiedades del blob mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.
static<T extends CloudBlob, R> void	validateCPKHeaders(StorageRequest<CloudBlobClient, T, R> request, BlobRequestOptions options, boolean upload) Si las opciones de solicitud contienen una CPK, valide los encabezados de respuesta asociados.

Detalles del campo

blobServiceClient

protected CloudBlobClient blobServiceClient

Representa el cliente de blobs.

parent

protected CloudBlobDirectory parent

Representa el directorio del blob.

streamMinimumReadSizeInBytes

protected int streamMinimumReadSizeInBytes= Constants.DEFAULT_MINIMUM_READ_SIZE_IN_BYTES

Contiene el tamaño de lectura mínimo al usar .BlobInputStream

streamWriteSizeInBytes

protected int streamWriteSizeInBytes= Constants.DEFAULT_STREAM_WRITE_IN_BYTES

Contiene el número de bytes que se van a almacenar en búfer al escribir en un BlobOutputStream (blobs en bloques y en páginas).

Detalles del constructor

CloudBlob

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

Crea una instancia de la clase mediante el identificador URI, el identificador de instantánea y el cliente de blob en la nube especificados.

Parameters:

type - Valor BlobType que representa el tipo del blob.

uri - Objeto StorageUri que representa el URI del blob, empezando por el nombre del contenedor.

snapshotID - que String representa la versión de instantánea, si procede.

credentials - Objeto StorageCredentials utilizado para autenticar el acceso.

Throws:

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

CloudBlob

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

Crea una instancia de la clase utilizando el tipo, el nombre, el identificador de instantánea y el contenedor especificados.

Parameters:

type - Valor BlobType que representa el tipo del blob.

blobName - Nombre del blob.

snapshotID - que String representa la versión de instantánea, si procede.

container - Referencia al contenedor primario.

Throws:

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

CloudBlob

protected CloudBlob(final CloudBlob otherBlob)

Crea una instancia de la clase copiando valores de otro blob.

Parameters:

otherBlob - Objeto CloudBlob que representa el blob que se va a copiar.

Detalles del método

abortCopy

public final void abortCopy(final String copyId)

Anula una operación en curso de copia de blobs.

Parameters:

copyId - Objeto String que identifica la operación de copia.

Throws:

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

abortCopy

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

Anula una operación en curso de copia de blobs.

Parameters:

copyId - Objeto String que identifica la operación de copia.

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

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

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.

acquireLease

public final String acquireLease()

Adquiere una nueva concesión infinita en el blob.

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 blob 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 blob con el tiempo de concesión especificado, el identificador de concesión propuesto, las opciones de solicitud y el contexto de operación especificados.

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.

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

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

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.

assertCorrectBlobType

protected final void assertCorrectBlobType()

Afirma que el blob tiene el tipo de blob correcto especificado en los atributos de blob.

Throws:

StorageException - Si se usa un tipo de blob incorrecto.

assertNoWriteOperationForSnapshot

protected void assertNoWriteOperationForSnapshot()

Confirma que la operación de escritura no se realiza para la instantánea.

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

que long especifica el 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:

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.

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

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

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 long representa el 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. El identificador de concesión debe establecerse 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, o null si no se propone ningún identificador de concesión.

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob. El identificador de concesión debe establecerse con una condición de acceso.

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

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 nuevo identificador de concesión.

Throws:

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

createSnapshot

public final CloudBlob createSnapshot()

Crea una instantánea del blob.

Returns:

Objeto CloudBlob que representa la instantánea del blob.

Throws:

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

createSnapshot

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

Crea una instantánea del blob mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

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

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

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.

Returns:

Objeto CloudBlob que representa la instantánea del blob.

Throws:

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

createSnapshot

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

Crea una instantánea del blob mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

metadata - Colección de pares nombre-valor que definen los metadatos de la instantánea o null.

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

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

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.

Returns:

Objeto CloudBlob que representa la instantánea del blob.

Throws:

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

delete

public final void delete()

Elimina el blob.

Si se habilita una directiva de retención de eliminación en el servicio, el blob se conservará durante un período de tiempo especificado, antes de quitarse permanentemente por la recolección de elementos no utilizados.

Throws:

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

delete

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

Elimina el blob mediante las opciones de instantánea y solicitud especificadas y el contexto de la operación.

Si se habilita una directiva de retención de eliminación en el servicio, el blob se conservará durante un período de tiempo especificado, antes de quitarse permanentemente por la recolección de elementos no utilizados.

No se puede eliminar un blob con instantáneas a menos que las instantáneas también se eliminen. Si un blob tiene instantáneas, use el DELETE_SNAPSHOTS_ONLY valor o INCLUDE_SNAPSHOTS en el parámetro para especificar cómo se deben controlar las instantáneas cuando se elimine el blob.

Parameters:

deleteSnapshotsOption - Objeto DeleteSnapshotsOption que indica si se van a eliminar solo instantáneas, o el blob y sus instantáneas.

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

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

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.

deleteIfExists

public final boolean deleteIfExists()

Elimina el blob si existe.

No se puede eliminar un blob con instantáneas a menos que las instantáneas también se eliminen. Si un blob tiene instantáneas, use el DELETE_SNAPSHOTS_ONLY valor o INCLUDE_SNAPSHOTS en el parámetro para especificar cómo se deben controlar las instantáneas cuando se elimine el blob.

Returns:

true si se eliminó el blob; de lo contrario, false.

Throws:

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

deleteIfExists

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

Elimina el blob si existe, mediante las opciones de instantánea y solicitud especificadas y el contexto de la operación.

No se puede eliminar un blob con instantáneas a menos que las instantáneas también se eliminen. Si un blob tiene instantáneas, use el DELETE_SNAPSHOTS_ONLY valor o INCLUDE_SNAPSHOTS en el parámetro para especificar cómo se deben controlar las instantáneas cuando se elimine el blob.

Parameters:

deleteSnapshotsOption - Objeto DeleteSnapshotsOption que indica si se van a eliminar solo instantáneas, o el blob y sus instantáneas.

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

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

Returns:

true si el blob existía y se eliminó; Lo contrario false

Throws:

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

download

public final void download(final OutputStream outStream)

Descarga el contenido de un blob en un flujo.

Parameters:

outStream - Objeto OutputStream que representa la secuencia de destino.

Throws:

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

download

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

Descarga el contenido de un blob en una secuencia mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

outStream - Objeto OutputStream que representa la secuencia de destino.

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

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

downloadAccountInfo

public AccountInformation downloadAccountInfo()

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

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 blob.

Parameters:

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

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 final void downloadAttributes()

Rellena las propiedades y los metadatos de un blob.

Este método rellena las propiedades del sistema del blob y los metadatos definidos por el usuario. Antes de leer o modificar las propiedades o metadatos de un blob, llame a este método o su sobrecarga para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.

Throws:

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

downloadAttributes

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

Rellena las propiedades y los metadatos de un blob mediante las opciones de solicitud y el contexto de operación especificados.

Este método rellena las propiedades del sistema del blob y los metadatos definidos por el usuario. Antes de leer o modificar las propiedades o metadatos de un blob, llame a este método o su sobrecarga para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.

Parameters:

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

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

downloadRange

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

Descarga el contenido de un blob en un flujo.

Parameters:

offset - que long representa el desplazamiento que se va a usar como punto de partida para el origen.

length - que Long representa el número de bytes que se van a leer o null.

outStream - Objeto OutputStream que representa la secuencia de destino.

Throws:

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

downloadRange

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

Descarga el contenido de un blob en una secuencia mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

offset - que long representa el desplazamiento que se va a usar como punto de partida para el origen.

length - que Long representa el número de bytes que se van a leer o null.

outStream - Objeto OutputStream que representa la secuencia de destino.

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

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

downloadRangeInternal

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

Descarga un intervalo de bytes del blob al búfer de bytes especificado.

Parameters:

blobOffset - que long representa el desplazamiento dentro del blob para empezar a descargarse.

length - que Long representa el número de bytes que se van a leer.

buffer - Matriz byte en la que se representa el búfer en el que se va a escribir.

bufferOffset - que int representa el desplazamiento en el búfer de bytes para empezar a escribir.

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

options - Objeto BlobRequestOptions que especifica las opciones adicionales de la solicitud.

opContext - Objeto OperationContext utilizado para realizar un seguimiento de la ejecución de la operación.

Returns:

Número total de bytes leídos en el búfer.

Throws:

StorageException - una excepción que representa cualquier error que se produjo durante la operación.

downloadRangeToByteArray

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

Descarga un intervalo de bytes del blob al búfer de bytes especificado.

Parameters:

offset - que long representa el desplazamiento de bytes que se va a usar como punto de partida para el origen.

length - que Long representa el número de bytes que se van a leer o null.

buffer - Matriz byte que representa el búfer al que se descargan los bytes del blob.

bufferOffset - que int representa el desplazamiento de bytes que se va a usar como punto de partida para el destino.

Returns:

Número total de bytes leídos en el búfer.

Throws:

StorageException

downloadRangeToByteArray

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

Descarga un intervalo de bytes desde el blob hasta el búfer de bytes especificado, mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

offset - que long representa el desplazamiento de bytes que se va a usar como punto de partida para el origen.

length - que Long representa el número de bytes que se van a leer o null.

buffer - Matriz byte que representa el búfer al que se descargan los bytes del blob.

bufferOffset - que int representa el desplazamiento de bytes que se va a usar como punto de partida para el destino.

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

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

Returns:

Número total de bytes leídos en el búfer.

Throws:

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

downloadToByteArray

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

Descarga un intervalo de bytes del blob al búfer de bytes especificado.

Parameters:

buffer - Matriz byte que representa el búfer al que se descargan los bytes del blob.

bufferOffset - que int representa el desplazamiento de bytes que se va a usar como punto de partida para el destino.

Throws:

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

downloadToByteArray

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

Descarga un intervalo de bytes del blob al búfer de bytes especificado, mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

buffer - Matriz byte que representa el búfer al que se descargan los bytes del blob.

bufferOffset - que long representa el desplazamiento de bytes que se va a usar como punto de partida para el destino.

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

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

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.

downloadToFile

public void downloadToFile(final String path)

Descarga un blob y almacena el contenido en un archivo.

Parameters:

path - que String representa la ruta de acceso al archivo que se creará con el contenido del blob.

Throws:

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

IOException

downloadToFile

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

Descarga un blob y almacena el contenido en un archivo.

Parameters:

path - que String representa la ruta de acceso al archivo que se creará con el contenido del blob.

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

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

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.

IOException

exists

public final boolean exists()

Comprueba si el blob existe.

Returns:

true es si el blob existe; en caso contrario false, es .

Throws:

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

exists

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

Comprueba si el blob existe mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

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

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

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.

Returns:

true si el blob existe, de otro modo false.

Throws:

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

generateSharedAccessSignature

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

Devuelve una firma de acceso compartido para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".

Parameters:

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

headers - Objeto SharedAccessBlobHeaders que representa los valores de encabezado opcionales que se van a establecer para un blob al que se tiene acceso con esta firma de acceso compartido.

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

Returns:

que String representa la firma de acceso compartido.

Throws:

IllegalArgumentException - Si las credenciales no son válidas o el blob es una instantánea.

InvalidKeyException - Si las credenciales no son válidas.

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

generateSharedAccessSignature

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

Devuelve una firma de acceso compartido para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".

Parameters:

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

headers - Objeto SharedAccessBlobHeaders que representa los valores de encabezado opcionales que se van a establecer para un blob al que se tiene acceso con esta 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 la firma de acceso compartido.

Throws:

IllegalArgumentException - Si las credenciales no son válidas o el blob es una instantánea.

InvalidKeyException - Si las credenciales no son válidas.

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

generateSharedAccessSignature

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

Devuelve una firma de acceso compartido para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".

Parameters:

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

headers - Objeto SharedAccessBlobHeaders que representa los valores de encabezado opcionales que se van a establecer para un blob al que se tiene acceso con esta 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.

skipDecoding - que boolean indica que los parámetros de consulta no se deben descodificar antes de firmarse. Esto solo se debe usar si el cliente está seguro de que los valores pasados están en el formato deseado. Esto puede ser útil en algunos escenarios en los que el cliente se usa para generar una sas a un tercero que no usará este sdk para realizar las solicitudes.

Returns:

que String representa la firma de acceso compartido.

Throws:

IllegalArgumentException - Si las credenciales no son válidas o el blob es una instantánea.

InvalidKeyException - Si las credenciales no son válidas.

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 blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".

Parameters:

policy - Objeto SharedAccessPolicy 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 la firma de acceso compartido.

Throws:

IllegalArgumentException - Si las credenciales no son válidas o el blob es una instantánea.

InvalidKeyException - Si las credenciales no son válidas.

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

generateUserDelegationSharedAccessSignature

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

Devuelve una firma de acceso compartido basada en una clave de delegación de usuarios para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".

Parameters:

delegationKey - que UserDelegationKey representa la clave utilizada para firmar esta firma.

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

headers - Objeto SharedAccessBlobHeaders que representa los valores de encabezado opcionales que se van a establecer para un blob al que se tiene acceso con esta firma de acceso compartido.

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

protocols - que SharedAccessProtocols representa los protocolos de Internet permitidos.

Returns:

que String representa la firma de acceso compartido.

Throws:

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

generateUserDelegationSharedAccessSignature

public String generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy)

Devuelve una firma de acceso compartido basada en una clave de delegación de usuarios para el blob mediante el identificador de directiva de grupo y el contexto de operación especificados. Tenga en cuenta que esto no contiene el "?".

Parameters:

delegationKey - que UserDelegationKey representa la clave utilizada para firmar esta firma.

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

Returns:

que String representa la firma de acceso compartido.

Throws:

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

getContainer

public final CloudBlobContainer getContainer()

Devuelve el contenedor del blob.

Overrides:

CloudBlob.getContainer()

Returns:

Objeto CloudBlobContainer que representa el contenedor del blob.

Throws:

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

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

getCopyState

public CopyState getCopyState()

Devuelve el estado de copia del blob.

Returns:

Objeto CopyState que representa el estado de copia del blob.

getMetadata

public final HashMap getMetadata()

Devuelve los metadatos del blob.

Returns:

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

getName

public final String getName()

Devuelve el nombre del blob.

Returns:

que String representa el nombre del blob.

getParent

public final CloudBlobDirectory getParent()

Devuelve el elemento primario del elemento de blob.

Overrides:

CloudBlob.getParent()

Returns:

Objeto CloudBlobDirectory que representa el directorio primario del blob.

Throws:

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

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

getParentNameFromURI

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

Recupera el nombre primario de un URI de blob.

Parameters:

resourceAddress - Objeto StorageUri que representa el URI del recurso.

delimiter - que String especifica el delimitador de directorio que se va a usar.

container - Objeto CloudBlobContainer que representa el contenedor de blobs.

Returns:

que String representa la dirección primaria de un URI de blob.

Throws:

URISyntaxException

getProperties

public final BlobProperties getProperties()

Devuelve las propiedades del blob.

Returns:

Objeto BlobProperties que representa las propiedades del blob.

getQualifiedStorageUri

public final StorageUri getQualifiedStorageUri()

Devuelve la instantánea o el URI calificado de firma de acceso compartido para este blob.

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

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

</xrefdescription>

Returns:

Objeto StorageUri que representa la instantánea o la firma de acceso compartido.

Throws:

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

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

getQualifiedUri

public final URI getQualifiedUri()

Devuelve el URI completo de la firma de acceso compartido o instantánea para este blob.

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

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

</xrefdescription>

Returns:

Objeto java.net.URI que representa la instantánea o la firma de acceso compartido.

Throws:

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

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

getServiceClient

public final CloudBlobClient getServiceClient()

Devuelve el cliente de Blob service asociado al blob.

Returns:

Objeto CloudBlobClient que representa el cliente.

getSnapshotID

public final String getSnapshotID()

Obtiene el identificador de instantánea de blob.

Returns:

que String representa el identificador de instantánea de blob.

getSnapshotQualifiedStorageUri

public final StorageUri getSnapshotQualifiedStorageUri()

Devuelve el URI del blob para las ubicaciones principales y secundarias, incluida la información de cadena de consulta si el blob es una instantánea.

Returns:

Objeto StorageUri que contiene los URI del blob para las ubicaciones principales y secundarias, incluida la información de consulta de instantáneas si el blob es una instantánea.

Throws:

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

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

getSnapshotQualifiedUri

public final URI getSnapshotQualifiedUri()

Devuelve el URI absoluto al blob, incluida la información de cadena de consulta si el blob es una instantánea.

Returns:

Objeto java.net.URI que especifica el URI absoluto para el blob, incluida la información de consulta de instantáneas si el blob es una instantánea.

Throws:

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

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

getStorageUri

public final StorageUri getStorageUri()

Devuelve la lista de URI de todas las ubicaciones.

Overrides:

CloudBlob.getStorageUri()

Returns:

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

getStreamMinimumReadSizeInBytes

public final int getStreamMinimumReadSizeInBytes()

Devuelve el tamaño de lectura mínimo cuando se usa .BlobInputStream

Returns:

que int representa el tamaño de lectura mínimo, en bytes, cuando se usa un BlobInputStream objeto .

getStreamWriteSizeInBytes

public final int getStreamWriteSizeInBytes()

Obtiene el número de bytes que se van a almacenar en búfer al escribir en un BlobOutputStream (blobs en bloques y en páginas).

Returns:

que int representa el número de bytes que se van a almacenar en búfer o el tamaño de un bloque, en bytes.

getTransformedAddress

protected final StorageUri getTransformedAddress(final OperationContext opContext)

Devuelve el URI transformado para el recurso si las credenciales especificadas requieren transformación.

Parameters:

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.

Returns:

Objeto StorageUri que representa el URI transformado.

Throws:

IllegalArgumentException - Si el URI no es absoluto.

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

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

getUri

public final URI getUri()

Devuelve el URI de este blob.

Overrides:

CloudBlob.getUri()

Returns:

Objeto java.net.URI que representa el URI del blob.

isSnapshot

public final boolean isSnapshot()

Indica si este blob es una instantánea.

Returns:

true es si el blob es una instantánea; de lo contrario false, es .

openInputStream

public final BlobInputStream openInputStream()

Abre un flujo de entrada de blob para descargar el blob.

Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura.

Returns:

Objeto InputStream que representa la secuencia que se va a usar para leer desde el blob.

Throws:

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

openInputStream

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

Abre un flujo de entrada de blobs para descargar el blob mediante las opciones de solicitud y el contexto de operación especificados.

Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura.

Parameters:

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

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

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.

Returns:

Objeto InputStream que representa la secuencia que se va a usar para leer desde el blob.

Throws:

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

openInputStream

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

Abre un flujo de entrada de blobs para descargar el blob mediante las opciones de solicitud y el contexto de operación especificados. Si el blob se descifra mientras se descarga, se omitirá la validación md5 final.

Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura.

Parameters:

offset - que long representa el desplazamiento que se va a usar como punto de partida para el origen.

length - que Long representa el número de bytes que se van a leer o null.

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

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

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.

Returns:

Objeto InputStream que representa la secuencia que se va a usar para leer desde el blob.

Throws:

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

releaseLease

public final void releaseLease(final AccessCondition accessCondition)

Libera la concesión del blob.

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob. Es necesario establecer leaseID en AccessCondition.

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 blob mediante las opciones de solicitud y el contexto de operación especificados.

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del blob. Es necesario establecer leaseID en AccessCondition.

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

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.

renewLease

public final void renewLease(final AccessCondition accessCondition)

Renueva una concesión existente.

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso para el blob. Es necesario establecer leaseID en AccessCondition.

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 mediante 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 leaseID en AccessCondition.

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

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.

setContainer

protected final void setContainer(final CloudBlobContainer container)

Establece el contenedor del blob.

Parameters:

container - Objeto CloudBlobContainer que representa el contenedor que se asigna al blob.

setMetadata

public final void setMetadata(final HashMap metadata)

Establece los metadatos del blob.

Parameters:

metadata - Objeto java.util.HashMap que contiene los metadatos que se asignan al blob.

setProperties

protected final void setProperties(final BlobProperties properties)

Establece las propiedades del blob.

Parameters:

properties - Objeto BlobProperties que representa las propiedades que se asignan al blob.

setSnapshotID

protected final void setSnapshotID(final String snapshotID)

Establece el identificador de instantánea del blob.

Parameters:

snapshotID - que String representa el identificador de instantánea que se asigna al blob.

setStorageUri

protected void setStorageUri(final StorageUri storageUri)

Establece la lista de URI para todas las ubicaciones.

Parameters:

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

setStreamMinimumReadSizeInBytes

public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)

Establece el tamaño de lectura mínimo cuando se usa .BlobInputStream

Parameters:

minimumReadSize - que int representa el tamaño mínimo de bloque, en bytes, para leer desde un blob mientras se usa un BlobInputStream objeto . Debe ser mayor o igual que 16 KB.

Throws:

IllegalArgumentException - Si minimumReadSize es inferior a 16 KB.

setStreamWriteSizeInBytes

public abstract void setStreamWriteSizeInBytes(int streamWriteSizeInBytes)

Establece el número de bytes que se van a almacenar en búfer al escribir en un BlobOutputStream (blobs en bloques y en páginas).

Parameters:

streamWriteSizeInBytes - que int representa el número de bytes que se van a almacenar en búfer o el tamaño de un bloque, en bytes.

startCopy

public final String startCopy(final URI source)

Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob.

Parameters:

source - Un java.net.URI URI de origen. Los URI de los recursos fuera de Azure solo se pueden copiar en blobs en bloques.

Returns:

que String representa el identificador de copia asociado a la operación de copia.

Throws:

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

startCopy

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

Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob, mediante las condiciones de acceso especificadas, el identificador de concesión, las opciones de solicitud y el contexto de la operación.

Parameters:

source - Un java.net.URI URI de origen. Los URI de los recursos fuera de Azure solo se pueden copiar en blobs en bloques.

sourceAccessCondition - Objeto AccessCondition que representa las condiciones de acceso del origen.

destinationAccessCondition - Objeto AccessCondition que representa las condiciones de acceso para el destino.

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

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.

Returns:

que String representa el identificador de copia asociado a la operación de copia.

Throws:

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

startCopy

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

Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob, mediante el nivel de blob en páginas Premium, las condiciones de acceso, el identificador de concesión, las opciones de solicitud y el contexto de operación especificados.

Nota: Establecer premiumPageBlobTier solo se admite para las cuentas Premium.

Parameters:

source - Un java.net.URI URI de origen. Los URI de los recursos fuera de Azure solo se pueden copiar en blobs en bloques.

blobTierString - Cadena que representa el nivel del blob.

sourceAccessCondition - Objeto AccessCondition que representa las condiciones de acceso del origen.

destinationAccessCondition - Objeto AccessCondition que representa las condiciones de acceso para el destino.

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

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.

Returns:

que String representa el identificador de copia asociado a la operación de copia.

Throws:

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

startCopy

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

Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob, mediante el nivel de blob en páginas Premium, las condiciones de acceso, el identificador de concesión, las opciones de solicitud y el contexto de operación especificados.

Nota: Establecer premiumPageBlobTier solo se admite para las cuentas Premium.

Parameters:

source - Un java.net.URI URI de origen. Los URI de los recursos fuera de Azure solo se pueden copiar en blobs en bloques.

contentMd5 - Valor hash opcional que se usa para garantizar la integridad transaccional de la operación. Puede estar null o estar vacío.

syncCopy - que boolean indica si la copia se debe realizar de forma sincrónica en el servicio.

blobTierString - Cadena que representa el nivel del blob.

sourceAccessCondition - Objeto AccessCondition que representa las condiciones de acceso del origen.

destinationAccessCondition - Objeto AccessCondition que representa las condiciones de acceso para el destino.

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

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.

Returns:

que String representa el identificador de copia asociado a la operación de copia.

Throws:

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

startCopy

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

Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo blob, mediante el nivel de blob en páginas Premium especificado, la prioridad de rehidratación, las condiciones de acceso, el identificador de concesión, las opciones de solicitud y el contexto de la operación.

Nota: Establecer premiumPageBlobTier solo se admite para las cuentas Premium.

Parameters:

source - Un java.net.URI URI de origen. Los URI de los recursos fuera de Azure solo se pueden copiar en blobs en bloques.

contentMd5 - Valor hash opcional que se usa para garantizar la integridad transaccional de la operación. Puede estar null o estar vacío.

syncCopy - que boolean indica si la copia se debe realizar de forma sincrónica en el servicio.

blobTierString - Objeto String que representa el nivel del blob.

rehydratePriority - Objeto RehydratePriority que representa la prioridad de rehidratación.

sourceAccessCondition - Objeto AccessCondition que representa las condiciones de acceso del origen.

destinationAccessCondition - Objeto AccessCondition que representa las condiciones de acceso para el destino.

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

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.

Returns:

que String representa el identificador de copia asociado a la operación de copia.

Throws:

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

startCopyImpl

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

Parameters:

source

contentMd5

syncCopy

incrementalCopy

blobTierString

rehydratePriority

sourceAccessCondition

destinationAccessCondition

options

undelete

public final void undelete()

Anula la eliminación de un blob y todas sus instantáneas que se han eliminado temporalmente.

Throws:

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

undelete

public final void undelete(BlobRequestOptions options, OperationContext opContext)

Anula la eliminación de un blob que se ha eliminado temporalmente, mediante las opciones de solicitud especificadas y el contexto de la operación.

La operación de eliminación de blobs restaura el contenido y los metadatos del blob eliminado temporalmente y todas sus instantáneas. Si se intenta recuperar un blob o una instantánea que no se elimina temporalmente, se realizará correctamente sin realizar ningún cambio.

Parameters:

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

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.

updateEtagAndLastModifiedFromResponse

protected void updateEtagAndLastModifiedFromResponse(HttpURLConnection request)

Parameters:

request

updateLengthFromResponse

protected void updateLengthFromResponse(HttpURLConnection request)

Parameters:

request

upload

public abstract void upload(InputStream sourceStream, long length)

Carga los datos del flujo de origen en el blob. Si el blob ya existe en el servicio, se sobrescribirá.

Parameters:

sourceStream - Objeto InputStream que representa la secuencia de origen que se va a cargar.

length - que long representa la longitud de los datos de flujo en bytes o -1 si se desconoce. La longitud debe ser mayor que cero y un múltiplo de 512 para blobs en páginas.

Throws:

IOException - Si se ha producido una excepción de E/S.

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

upload

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

Carga los datos del flujo de origen en el blob mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. Si el blob ya existe en el servicio, se sobrescribirá.

Parameters:

sourceStream - Objeto InputStream que representa la secuencia de origen que se va a cargar.

length - Longitud de los datos de flujo en bytes o -1 si se desconoce. La longitud debe ser mayor que cero y un múltiplo de 512 para blobs en páginas.

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

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

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:

IOException - Si se ha producido una excepción de E/S.

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

uploadFromByteArray

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

Carga un blob de datos en una matriz de bytes. Si el blob ya existe en el servicio, se sobrescribirá.

Parameters:

buffer - Matriz byte que representa los datos que se van a escribir en el blob.

offset - que int representa el desplazamiento de la matriz de bytes desde la que se va a iniciar la carga de datos.

length - que int representa el número de bytes que se van a cargar desde el búfer de entrada.

Throws:

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

IOException

uploadFromByteArray

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

Carga un blob de datos en una matriz de bytes. Si el blob ya existe en el servicio, se sobrescribirá.

Parameters:

buffer - Matriz byte que representa los datos que se van a escribir en el blob.

offset - que int representa el desplazamiento de la matriz de bytes desde la que se va a iniciar la carga de datos.

length - que int representa el número de bytes que se van a cargar desde el búfer de entrada.

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

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

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.

IOException

uploadFromFile

public void uploadFromFile(final String path)

Carga un blob desde un archivo. Si el blob ya existe en el servicio, se sobrescribirá.

Parameters:

path - que String representa la ruta de acceso al archivo que se va a cargar.

Throws:

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

IOException

uploadFromFile

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

Carga un blob desde un archivo. Si el blob ya existe en el servicio, se sobrescribirá.

Parameters:

path - que String representa la ruta de acceso al archivo que se va a cargar.

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

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

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.

IOException

uploadMetadata

public final void uploadMetadata()

Carga los metadatos del blob en el servicio de almacenamiento.

Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.

Throws:

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

uploadMetadata

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

Carga los metadatos del blob en el servicio de almacenamiento mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados.

Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.

Parameters:

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

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

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.

uploadProperties

public final void uploadProperties()

Novedades las propiedades del blob en el servicio de almacenamiento.

Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.

Throws:

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

uploadProperties

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

Novedades las propiedades del blob mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados.

Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del blob del servicio de almacenamiento de Microsoft Azure.

Parameters:

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

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

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.

validateCPKHeaders

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

Si las opciones de solicitud contienen una CPK, valide los encabezados de respuesta asociados.

Parameters:

request - Solicitud de almacenamiento de la que se va a comprobar la respuesta.

options - Las opciones de blob usadas en la solicitud.

upload - Si se trata de una carga o si solo se recuperan datos.

Throws:

StorageException - Produce si se usó CPK en la solicitud y la respuesta produjo un error de validación.