CloudFileShare Clase

Paquete:

com.microsoft.azure.storage.file

• java.lang.Object
• • com.microsoft.azure.storage.file.CloudFileShare

public class CloudFileShare

Representa un recurso compartido en el servicio Microsoft Azure File.

Los recursos compartidos contienen directorios, que se encapsulan como CloudFileDirectory objetos y directorios contienen archivos. Los directorios también pueden contener subdirectorios.

Resumen del constructor

Constructor	Description
CloudFileShare(final StorageUri storageUri)	Crea una instancia de la clase mediante el URI especificado.
CloudFileShare(final StorageUri storageUri, final StorageCredentials credentials)	Crea una instancia de la clase mediante el storageUri y las credenciales especificados.
CloudFileShare(final String shareName, String snapshotID, final CloudFileClient client)	Crea una instancia de la clase utilizando el nombre y el cliente especificados.
CloudFileShare(final URI uri)	Crea una instancia de la clase mediante el URI especificado.
CloudFileShare(final URI uri, final StorageCredentials credentials)	Crea una instancia de la clase mediante el URI y las credenciales especificados.

Resumen del método

Modificador y tipo	Método y descripción
void	assertNoSnapshot() Afirma que el recurso compartido no es una instantánea.
void	create() Crea el recurso compartido.
void	create(FileRequestOptions options, OperationContext opContext) Crea el recurso compartido mediante las opciones y el contexto de operación especificados.
String	createFilePermission(String permission) Crea un permiso de archivo.
String	createFilePermission(String permission, FileRequestOptions options, OperationContext opContext) Crea un permiso de archivo.
boolean	createIfNotExists() Crea el recurso compartido si no existe.
boolean	createIfNotExists(FileRequestOptions options, OperationContext opContext) Crea el recurso compartido si no existe, con las opciones de solicitud y el contexto de operación especificados.
final CloudFileShare	createSnapshot() Crea una instantánea del recurso compartido.
final CloudFileShare	createSnapshot(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Crea una instantánea del recurso compartido de archivos mediante las opciones de solicitud y el contexto de operación especificados.
final CloudFileShare	createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Crea una instantánea del recurso compartido de archivos mediante las opciones de solicitud y el contexto de operación especificados.
void	delete() Elimina el recurso compartido.
void	delete(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Elimina el recurso compartido mediante las opciones de solicitud y el contexto de operación especificados.
void	delete(DeleteShareSnapshotsOption deleteSnapshotsOption, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Elimina el recurso compartido con las opciones de instantánea y solicitud especificadas y el contexto de operación. Un recurso compartido que tiene instantáneas no se puede eliminar a menos que también se eliminen las instantáneas. Si un recurso compartido tiene instantáneas, use el INCLUDE_SNAPSHOTS valor del parámetro para incluir las instantáneas al eliminar el recurso compartido base.
boolean	deleteIfExists() Elimina el recurso compartido si existe.
boolean	deleteIfExists(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Elimina el recurso compartido si existe mediante las opciones de solicitud y el contexto de operación especificados.
boolean	deleteIfExists(DeleteShareSnapshotsOption deleteSnapshotsOption, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Elimina el recurso compartido si existe, utilizando las opciones de instantánea y solicitud especificadas y el contexto de operación. Un recurso compartido que tiene instantáneas no se puede eliminar a menos que también se eliminen las instantáneas. Si un recurso compartido tiene instantáneas, use el INCLUDE_SNAPSHOTS valor del parámetro para incluir las instantáneas al eliminar el recurso compartido base.
void	downloadAttributes() Descarga los atributos del recurso compartido, que constan de metadatos y propiedades.
void	downloadAttributes(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Descarga los atributos del recurso compartido, que constan de metadatos y propiedades, mediante las opciones de solicitud y el contexto de operación especificados.
FileSharePermissions	downloadPermissions() Descarga la configuración de permisos para el recurso compartido.
FileSharePermissions	downloadPermissions(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Descarga la configuración de permisos para el recurso compartido mediante las opciones de solicitud y el contexto de operación especificados.
boolean	exists() Devuelve un valor que indica si el recurso compartido existe.
boolean	exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Devuelve un valor que indica si el recurso compartido existe, utilizando las opciones de solicitud y el contexto de operación especificados.
String	generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier) Devuelve una firma de acceso compartido para el recurso compartido. Tenga en cuenta que esto no contiene el "?".
String	generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) Devuelve una firma de acceso compartido para el recurso compartido. Tenga en cuenta que esto no contiene el "?".
String	getFilePermission(String filePermissionKey) Obtiene el permiso de archivo asociado a una clave de permiso de archivo.
String	getFilePermission(String filePermissionKey, FileRequestOptions options, OperationContext opContext) Obtiene el permiso de archivo asociado a una clave de permiso de archivo.
HashMap<String, String>	getMetadata() Devuelve los metadatos del recurso compartido. Este valor se inicializa con los metadatos del recurso compartido mediante una llamada a downloadAttributes()y se establece en el recurso compartido con una llamada a uploadMetadata().
String	getName() Devuelve el nombre del recurso compartido.
FileShareProperties	getProperties() Devuelve las propiedades del recurso compartido.
final URI	getQualifiedUri() Devuelve el URI completo de la firma de acceso compartido o instantánea para este recurso compartido.
CloudFileDirectory	getRootDirectoryReference() Devuelve una referencia a un CloudFileDirectory objeto que representa el directorio de archivos raíz dentro de este recurso compartido.
CloudFileClient	getServiceClient() Devuelve el cliente del servicio de archivos asociado a este recurso compartido.
final String	getSnapshot() Devuelve el snapshotID de este recurso compartido.
ShareStats	getStats() Consulta el servicio de este recurso compartido ShareStats.
ShareStats	getStats(FileRequestOptions options, OperationContext opContext) Consulta el servicio de este recurso compartido ShareStats.
StorageUri	getStorageUri() Devuelve la lista de URI para todas las ubicaciones.
URI	getUri() Devuelve el URI de este recurso compartido.
final boolean	isSnapshot() Indica si este recurso compartido es una instantánea.
void	setMetadata(final HashMap<String, String> metadata) Establece la colección de metadatos de pares nombre-valor que se van a establecer en el recurso compartido con una uploadMetadata() llamada. Esta colección sobrescribirá los metadatos de recurso compartido existentes. Si se establece en una colección vacía, los metadatos del recurso compartido se borrarán en una uploadMetadata() llamada.
void	setProperties(final FileShareProperties properties) Establece las propiedades del recurso compartido.
void	uploadMetadata() Carga los metadatos del recurso compartido.
void	uploadMetadata(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Carga los metadatos del recurso compartido mediante las opciones de solicitud y el contexto de operación especificados.
void	uploadPermissions(final FileSharePermissions permissions) Carga los permisos del recurso compartido.
void	uploadPermissions(final FileSharePermissions permissions, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Carga los permisos del recurso compartido mediante las opciones de solicitud y el contexto de operación especificados.
final void	uploadProperties() Novedades las propiedades del recurso compartido en el servicio de almacenamiento. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del recurso compartido del servicio de almacenamiento de Microsoft Azure.
final void	uploadProperties(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Novedades las propiedades del recurso compartido mediante las opciones de solicitud y el contexto de la operación. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del recurso compartido del servicio de almacenamiento de Microsoft Azure.

Detalles del constructor

CloudFileShare

public CloudFileShare(final StorageUri storageUri)

Crea una instancia de la clase mediante el URI especificado.

Parameters:

storageUri - Objeto StorageUri que representa el URI absoluto del recurso compartido.

Throws:

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

CloudFileShare

public CloudFileShare(final StorageUri storageUri, final StorageCredentials credentials)

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

Parameters:

storageUri - Objeto StorageUri que representa el storageUri absoluto del recurso compartido.

credentials - Objeto StorageCredentials utilizado para autenticar el acceso.

Throws:

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

CloudFileShare

public CloudFileShare(final String shareName, String snapshotID, final CloudFileClient client)

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

Parameters:

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

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

client - Objeto CloudFileClient que representa el cliente de servicio asociado y que especifica el punto de conexión para el servicio file.

Throws:

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

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

CloudFileShare

public CloudFileShare(final URI uri)

Crea una instancia de la clase mediante el URI especificado.

Parameters:

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

Throws:

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

CloudFileShare

public CloudFileShare(final URI uri, final StorageCredentials credentials)

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

Parameters:

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

credentials - Objeto StorageCredentials utilizado para autenticar el acceso.

Throws:

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

Detalles del método

assertNoSnapshot

protected void assertNoSnapshot()

Afirma que el recurso compartido no es una instantánea.

create

public void create()

Crea el recurso compartido.

Throws:

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

create

public void create(FileRequestOptions options, OperationContext opContext)

Crea el recurso compartido mediante las opciones y el contexto de operación especificados.

Parameters:

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

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.

createFilePermission

public String createFilePermission(String permission)

Crea un permiso de archivo.

Parameters:

permission - Objeto String que representa el permiso de archivo que se va a crear.

Returns:

String que representa la clave de permiso de archivo asociada al permiso de archivo creado.

Throws:

StorageException

IOException

createFilePermission

public String createFilePermission(String permission, FileRequestOptions options, OperationContext opContext)

Crea un permiso de archivo.

Parameters:

permission - Objeto String que representa el permiso de archivo que se va a crear.

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

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:

String que representa la clave de permiso de archivo asociada al permiso de archivo creado.

Throws:

StorageException

IOException

createIfNotExists

public boolean createIfNotExists()

Crea el recurso compartido si no existe.

Returns:

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

Throws:

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

createIfNotExists

public boolean createIfNotExists(FileRequestOptions options, OperationContext opContext)

Crea el recurso compartido si no existe, con las opciones de solicitud y el contexto de operación especificados.

Parameters:

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

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:

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

Throws:

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

createSnapshot

public final CloudFileShare createSnapshot()

Crea una instantánea del recurso compartido.

Returns:

Objeto CloudFileShare que representa la instantánea del recurso compartido.

Throws:

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

createSnapshot

public final CloudFileShare createSnapshot(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

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

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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 CloudFileShare que representa la instantánea del recurso compartido de archivos.

Throws:

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

createSnapshot

public final CloudFileShare createSnapshot(final HashMap metadata, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Crea una instantánea del recurso compartido de archivos 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 recurso compartido de archivos.

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

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 CloudFileShare que representa la instantánea del recurso compartido de archivos.

Throws:

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

delete

public void delete()

Elimina el recurso compartido.

Throws:

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

delete

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

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

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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.

delete

public void delete(DeleteShareSnapshotsOption deleteSnapshotsOption, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Elimina el recurso compartido con las opciones de instantánea y solicitud especificadas y el contexto de operación.

Un recurso compartido que tiene instantáneas no se puede eliminar a menos que también se eliminen las instantáneas. Si un recurso compartido tiene instantáneas, use el INCLUDE_SNAPSHOTS valor del parámetro para incluir las instantáneas al eliminar el recurso compartido base.

Parameters:

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

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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

Elimina el recurso compartido si existe.

Returns:

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

Throws:

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

deleteIfExists

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

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

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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 recurso compartido existía y se eliminó; de lo contrario, false.

Throws:

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

deleteIfExists

public boolean deleteIfExists(DeleteShareSnapshotsOption deleteSnapshotsOption, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Elimina el recurso compartido si existe, utilizando las opciones de instantánea y solicitud especificadas y el contexto de operación.

Un recurso compartido que tiene instantáneas no se puede eliminar a menos que también se eliminen las instantáneas. Si un recurso compartido tiene instantáneas, use el INCLUDE_SNAPSHOTS valor del parámetro para incluir las instantáneas al eliminar el recurso compartido base.

Parameters:

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

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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 recurso compartido existía y se eliminó; de lo contrario, false.

Throws:

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

downloadAttributes

public void downloadAttributes()

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

Throws:

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

downloadAttributes

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

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

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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.

downloadPermissions

public FileSharePermissions downloadPermissions()

Descarga la configuración de permisos para el recurso compartido.

Returns:

Objeto FileSharePermissions que representa los permisos del recurso compartido.

Throws:

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

downloadPermissions

public FileSharePermissions downloadPermissions(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

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

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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 FileSharePermissions que representa los permisos del recurso compartido.

Throws:

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

exists

public boolean exists()

Devuelve un valor que indica si el recurso compartido existe.

Returns:

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

Throws:

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

exists

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

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

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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 es si el recurso compartido existe; de lo contrario false, es .

Throws:

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

generateSharedAccessSignature

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

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

Parameters:

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

groupPolicyIdentifier - que String representa la directiva de acceso de nivel de recurso compartido.

Returns:

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

Throws:

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

InvalidKeyException - Si la clave no es válida.

generateSharedAccessSignature

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

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

Parameters:

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

groupPolicyIdentifier - que String representa la directiva de acceso de nivel de recurso 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 una firma de acceso compartido para el recurso compartido.

Throws:

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

InvalidKeyException - Si la clave no es válida.

getFilePermission

public String getFilePermission(String filePermissionKey)

Obtiene el permiso de archivo asociado a una clave de permiso de archivo.

Parameters:

filePermissionKey - Objeto String que representa la clave de permiso de archivo.

Returns:

que String representa el permiso de archivo asociado a la clave de permiso de archivo.

Throws:

StorageException

getFilePermission

public String getFilePermission(String filePermissionKey, FileRequestOptions options, OperationContext opContext)

Obtiene el permiso de archivo asociado a una clave de permiso de archivo.

Parameters:

filePermissionKey - Objeto String que representa la clave de permiso de archivo.

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

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 permiso de archivo asociado a la clave de permiso de archivo.

Throws:

StorageException

getMetadata

public HashMap getMetadata()

Devuelve los metadatos del recurso compartido. Este valor se inicializa con los metadatos del recurso compartido mediante una llamada a downloadAttributes()y se establece en el recurso compartido con una llamada a uploadMetadata().

Returns:

Objeto java.util.HashMap que representa los metadatos del recurso compartido.

getName

public String getName()

Devuelve el nombre del recurso compartido.

Returns:

que String representa el nombre del recurso compartido.

getProperties

public FileShareProperties getProperties()

Devuelve las propiedades del recurso compartido.

Returns:

Objeto FileShareProperties que representa las propiedades del recurso compartido.

getQualifiedUri

public final URI getQualifiedUri()

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

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.

getRootDirectoryReference

public CloudFileDirectory getRootDirectoryReference()

Devuelve una referencia a un CloudFileDirectory objeto que representa el directorio de archivos raíz dentro de este recurso compartido.

Returns:

Referencia CloudFileDirectory al directorio raíz de este recurso compartido.

Throws:

StorageException

URISyntaxException

getServiceClient

public CloudFileClient getServiceClient()

Devuelve el cliente del servicio de archivos asociado a este recurso compartido.

Returns:

Objeto CloudFileClient que representa el cliente de servicio asociado a este recurso compartido.

getSnapshot

public final String getSnapshot()

Devuelve el snapshotID de este recurso compartido.

Returns:

SnapshotID como una cadena para este recurso compartido.

getStats

public ShareStats getStats()

Consulta el servicio de este recurso compartido ShareStats.

Returns:

Objeto ShareStats para el servicio de almacenamiento especificado.

Throws:

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

getStats

public ShareStats getStats(FileRequestOptions options, OperationContext opContext)

Consulta el servicio de este recurso compartido ShareStats.

Parameters:

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

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 ShareStats para el servicio de almacenamiento especificado.

Throws:

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

getStorageUri

public StorageUri getStorageUri()

Devuelve la lista de URI para todas las ubicaciones.

Returns:

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

getUri

public URI getUri()

Devuelve el URI de este recurso compartido.

Returns:

URI absoluto para el recurso compartido.

isSnapshot

public final boolean isSnapshot()

Indica si este recurso compartido es una instantánea.

Returns:

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

setMetadata

public void setMetadata(final HashMap metadata)

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

Parameters:

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

setProperties

public void setProperties(final FileShareProperties properties)

Establece las propiedades del recurso compartido.

Parameters:

properties - Objeto FileShareProperties que representa las propiedades que se asignan al recurso compartido.

uploadMetadata

public void uploadMetadata()

Carga los metadatos del recurso compartido.

Throws:

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

uploadMetadata

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

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

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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.

uploadPermissions

public void uploadPermissions(final FileSharePermissions permissions)

Carga los permisos del recurso compartido.

Parameters:

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

Throws:

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

uploadPermissions

public void uploadPermissions(final FileSharePermissions permissions, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

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

Parameters:

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

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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 recurso compartido en el servicio de almacenamiento.

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

Throws:

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

uploadProperties

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

Novedades las propiedades del recurso compartido mediante las opciones de solicitud y el contexto de la operación.

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

Parameters:

accessCondition - Objeto AccessCondition que representa las condiciones de acceso del recurso compartido.

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

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.