BlockBlobService Clase
Los blobs en bloques permiten cargar blobs grandes de manera eficiente. Los blobs en bloques están formados por bloques, cada uno de los cuales se identifica mediante un identificador de bloque. Es posible crear o modificar un blob en bloques escribiendo un conjunto de bloques y confirmándolos mediante sus identificadores de bloque. Cada bloque puede tener un tamaño diferente, hasta un máximo de 100 MB, y un blob en bloques puede incluir hasta 50 000 bloques. Por lo tanto, el tamaño máximo de un blob en bloques es de aproximadamente 4,75 TB (100 MB X 50 000 bloques). Si está escribiendo un blob en bloques que no tiene más de 64 MB de tamaño, puede cargarlo en su totalidad con una sola operación de escritura; consulte create_blob_from_bytes.
:type ~azure.storage.common.TokenCredential
- Herencia
-
BlockBlobService
Constructor
BlockBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)Parámetros
- account_name
- str
El nombre de la cuenta de almacenamiento. Se usa para autenticar las solicitudes firmadas con una clave de cuenta y para construir el punto de conexión de almacenamiento. Se requiere a menos que se especifique un cadena de conexión o si se usa un dominio personalizado con autenticación anónima.
- account_key
- str
La clave de la cuenta de almacenamiento. Se usa para la autenticación de clave compartida. Si no se especifica ninguna clave de cuenta o token sas, se usará el acceso anónimo.
- sas_token
- str
Un token de firma de acceso compartido que se va a usar para autenticar solicitudes en lugar de la clave de cuenta. Si se especifican la clave de cuenta y el token sas, se usará la clave de cuenta para firmar. Si no se especifica ninguno, se usará el acceso anónimo.
- is_emulated
- bool
Si se va a usar el emulador. El valor predeterminado es False. Si se especifica, invalidará todos los demás parámetros además de cadena de conexión y la sesión de solicitud.
- protocol
- str
Protocolo que se va a usar para las solicitudes. El valor predeterminado es https.
- endpoint_suffix
- str
Componente base de host de la dirección URL, menos el nombre de la cuenta. El valor predeterminado es Azure (core.windows.net). Invalide esta opción para usar la nube de China (core.chinacloudapi.cn).
- custom_domain
- str
Dominio personalizado que se va a usar. Esto se puede establecer en Azure Portal. Por ejemplo, "www.mydomain.com".
- request_session
- <xref:requests.Session>
Objeto de sesión que se usará para las solicitudes HTTP.
- connection_string
- str
Si se especifica, esto invalidará todos los demás parámetros además de la sesión de solicitud. Consulte http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ para obtener el formato cadena de conexión.
- socket_timeout
- int
Si se especifica, esto invalidará el tiempo de espera de socket predeterminado. El tiempo de espera especificado es en segundos. Consulte DEFAULT_SOCKET_TIMEOUT en _constants.py para obtener el valor predeterminado.
- token_credential
Credencial de token usada para autenticar solicitudes HTTPS. El valor del token debe actualizarse antes de su expiración.
Variables
- MAX_SINGLE_PUT_SIZE
- int
La carga de tamaño más grande admitida en una sola llamada put. Los métodos create_blob_from_* lo usan los métodos si se conoce la longitud del contenido y es menor que este valor.
- MAX_BLOCK_SIZE
- int
Tamaño de los bloques colocados por métodos create_blob_from_* si se desconoce la longitud del contenido o es mayor que MAX_SINGLE_PUT_SIZE. Se pueden colocar bloques más pequeños. El tamaño máximo de bloque que admite el servicio es de 100 MB.
- MIN_LARGE_BLOCK_UPLOAD_THRESHOLD
- int
Tamaño mínimo de bloque en el que se considera el algoritmo de carga de bloques optimizado para memoria. Este algoritmo solo se aplica a los métodos create_blob_from_file y create_blob_from_stream y evitará el almacenamiento en búfer completo de bloques. Además del tamaño de bloque, la validación y el cifrado de ContentMD5 deben deshabilitarse, ya que estas opciones requieren que los bloques se almacenen en búfer.
Métodos
| abort_copy_blob |
Anula una operación de copy_blob pendiente y deja un blob de destino con una longitud cero y metadatos completos. |
| acquire_blob_lease |
Solicita una nueva concesión. Si el blob no tiene una concesión activa, el servicio Blob crea una concesión sobre el blob y devuelve un nuevo identificador de concesión. |
| acquire_container_lease |
Solicita una nueva concesión. Si el contenedor no tiene una concesión activa, Blob service crea una concesión sobre el contenedor y devuelve un nuevo identificador de concesión. |
| batch_delete_blobs |
Envía un lote de varias solicitudes de eliminación de blobs. El método de eliminación de blobs elimina el blob o la instantánea especificados. Tenga en cuenta que la eliminación de un blob también elimina todas sus instantáneas. Para obtener más información, vea https://docs.microsoft.com/rest/api/storageservices/delete-blob. |
| batch_set_standard_blob_tier |
Envía un lote de varias solicitudes de niveles de blob en bloques establecidos. Esta API solo se admite para blobs en bloques en cuentas de almacenamiento estándar. |
| break_blob_lease |
Interrumpe la concesión, si el blob tiene una concesión activa. Una vez que se interrumpe una concesión, no es posible renovarla. Cualquier solicitud autorizada puede interrumpir la concesión; no es necesario que la solicitud especifique un identificador de concesión que coincida. Cuando se interrumpe una concesión, el período de interrupción de la concesión puede transcurrir, durante el cual no se puede realizar ninguna operación de concesión, excepto la interrupción y liberación en el blob. Cuando una concesión se interrumpe correctamente, la respuesta indica el intervalo en segundos que debe transcurrir hasta que se pueda obtener una nueva concesión. Una concesión interrumpida también puede liberarse, en cuyo caso otro cliente puede adquirir inmediatamente la concesión sobre el blob. |
| break_container_lease |
Interrumpa la concesión, si el contenedor tiene una concesión activa. Una vez que se interrumpe una concesión, no es posible renovarla. Cualquier solicitud autorizada puede interrumpir la concesión; no es necesario que la solicitud especifique un identificador de concesión que coincida. Cuando se interrumpe una concesión, el período de interrupción de la concesión puede transcurrir, durante el cual no se puede realizar ninguna operación de concesión excepto la interrupción y liberación en el contenedor. Cuando una concesión se interrumpe correctamente, la respuesta indica el intervalo en segundos que debe transcurrir hasta que se pueda obtener una nueva concesión. |
| change_blob_lease |
Cambia el identificador de concesión de una concesión activa. Un cambio debe incluir el identificador de concesión actual y un nuevo identificador de concesión. |
| change_container_lease |
Cambie el identificador de concesión de una concesión activa. Un cambio debe incluir el identificador de concesión actual y un nuevo identificador de concesión. |
| copy_blob |
Copia un blob. Esta operación devuelve un objeto de propiedades de operación de copia. La operación de copia se puede configurar para que sea una operación asincrónica, de mejor esfuerzo o de una operación sincrónica. El origen debe ser un blob en bloques si requires_sync es true. Si existe un blob de destino, se sobrescribirá. El blob de destino no puede modificarse mientras haya una operación de copia en curso. Al copiar desde un blob en bloques, se copian todos los bloques confirmados y sus identificadores de bloque. Los bloques no confirmados no se copian. Al final de la operación de copia, el blob de destino tendrá el mismo número de bloques confirmados que el origen. Puede llamar a get_blob_properties en el blob de destino para comprobar el estado de la operación de copia. El blob final se confirmará cuando se complete la copia. Nombre del contenedor de destino. El contenedor debe existir. :p aram str blob_name: nombre del blob de destino. Si el blob de destino existe, se sobrescribirá. De lo contrario, se creará. :p aram str copy_source: una dirección URL de hasta 2 KB de longitud que especifica un archivo o un blob de Azure. El valor debe estar codificado para URL tal y como aparecería en un URI de solicitud. Si el origen está en otra cuenta, el origen debe ser público o debe autenticarse a través de una firma de acceso compartido. Si el origen es público, no se requiere autenticación. Ejemplos: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken metadatos de :p aram: pares nombre-valor asociados al blob como metadatos. Si no se especifica ningún par nombre-valor, la operación copiará los metadatos del blob o archivo de origen en el blob de destino. Si se especifican uno o varios pares nombre-valor, el blob de destino se crea con los metadatos especificados y los metadatos no se copian del blob o archivo de origen. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de origen se ha modificado desde la fecha u hora especificadas. :p aram datetime source_if_unmodified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de origen no se ha modificado desde la fecha u hora especificadas. :p aram ETag source_if_match: un valor ETag o el carácter comodín (). Especifique este encabezado condicional para copiar el blob de origen solo si su ETag coincide con el valor especificado. Si los valores de ETag no coinciden, Blob service devuelve el código de estado 412 (error de condición previa). Este encabezado no se puede especificar si el origen es un archivo de Azure. :p aram ETag source_if_none_match: un valor ETag o el carácter comodín (). Especifique este encabezado condicional para copiar el blob de origen solo si la ETag no coincide con el valor especificado. Si los valores son idénticos, Blob service devuelve el código de estado 412 (Error de condición previa). Este encabezado no se puede especificar si el origen es un archivo de Azure. :p aram datetime destination_if_modified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de destino se ha modificado desde la fecha u hora especificadas. Si el blob de destino no se ha modificado, el servicio Blob devuelve el código de estado 412 (Error de condición previa). :p aram datetime destination_if_unmodified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de destino no se ha modificado desde la fecha u hora especificadas. Si el blob de destino se ha modificado, el servicio Blob devuelve el código de estado 412 (Error de condición previa). :p aram ETag destination_if_match: un valor ETag o el carácter comodín (). Especifique un valor ETag para este encabezado condicional para copiar el blob solo si el valor de ETag especificado coincide con el valor ETag de un blob de destino existente. Si la ETag del blob de destino no coincide con la ETag especificada para If-Match, Blob service devuelve el código de estado 412 (error de condición previa). :p aram ETag destination_if_none_match: un valor ETag o el carácter comodín (). Especifique un valor ETag para este encabezado condicional para copiar el blob solo si el valor ETag especificado no coincide con el del blob de destino. Especifique el carácter comodín (*) para realizar la operación solo si no existe el blob de destino. Si no se cumple la condición especificada, Blob service devuelve el código de estado 412 (Error de condición previa). :p aram str destination_lease_id: el identificador de concesión especificado para este encabezado debe coincidir con el identificador de concesión del blob de destino. Si la solicitud no incluye el identificador de concesión o este no es válido, la operación produce un error con el código de estado 412 (Error de condición previa). :p aram str source_lease_id: especifique esto para realizar la operación Copiar blob solo si el identificador de concesión dado coincide con el identificador de concesión activo del blob de origen. :p aram int timeout: el parámetro timeout se expresa en segundos. :p aram bool requires_sync: exige que el servicio no devuelva una respuesta hasta que se complete la copia. :p aram StandardBlobTier standard_blob_tier: un valor de nivel de blob estándar en el que establecer el blob. Para esta versión de la biblioteca, esto solo se aplica a blobs en bloques en cuentas de almacenamiento estándar. :p aram RehydratePriority rehydrate_priority: indica la prioridad con la que rehidratar un blob archivado :return: copiar propiedades de operación como el estado, el origen y el identificador. :rtype: CopyProperties |
| create_blob_from_bytes |
Crea un nuevo blob a partir de una matriz de bytes o actualiza el contenido de un blob existente, con notificaciones automáticas de fragmentación y progreso. |
| create_blob_from_path |
Crea un nuevo blob a partir de una ruta de acceso de archivo o actualiza el contenido de un blob existente, con notificaciones automáticas de fragmentación y progreso. |
| create_blob_from_stream |
Crea un nuevo blob a partir de un archivo o secuencia, o actualiza el contenido de un blob existente, con notificaciones automáticas de fragmentación y progreso. |
| create_blob_from_text |
Crea un nuevo blob a partir de str/unicode, o actualiza el contenido de un blob existente, con notificaciones automáticas de fragmentación y progreso. |
| create_container |
Crea un nuevo contenedor en la cuenta especificada. Si el contenedor con el mismo nombre ya existe, se produce un error en la operación si fail_on_exist es True. |
| delete_blob |
Marca el blob o la instantánea especificados para su eliminación. El blob se elimina posteriormente durante la recolección de elementos no utilizados. Tenga en cuenta que para eliminar un blob, debe eliminar todas sus instantáneas. Puede eliminar ambos al mismo tiempo con la operación Eliminar blob. Si se habilita una directiva de retención de eliminación para el servicio, esta operación elimina temporalmente el blob o la instantánea y conserva el blob o la instantánea durante el número de días especificado. Después del número especificado de días, los datos del blob se quitan del servicio durante la recolección de elementos no utilizados. Se puede acceder a blobs o instantáneas eliminadas temporalmente a través de list Blobs API que especifica la opción include=Include.Deleted. El blob o la instantánea eliminados temporalmente se pueden restaurar mediante la API Undelete. |
| delete_container |
Marca el contenedor especificado para su eliminación. El contenedor y los blobs incluidos en él se eliminan posteriormente durante la recolección de elementos no utilizados. |
| exists |
Devuelve un valor booleano que indica si el contenedor existe (si blob_name es None) o un valor booleano que indica si el blob existe. |
| extract_date_and_request_id | |
| generate_account_shared_access_signature |
Genera una firma de acceso compartido para blob service. Use la firma devuelta con el parámetro sas_token de cualquier BlobService. |
| generate_blob_shared_access_signature |
Genera una firma de acceso compartido para el blob o una de sus instantáneas. Use la firma devuelta con el parámetro sas_token de cualquier BlobService. |
| generate_container_shared_access_signature |
Genera una firma de acceso compartido para el contenedor. Use la firma devuelta con el parámetro sas_token de cualquier BlobService. |
| get_blob_account_information |
Obtiene información relacionada con la cuenta de almacenamiento. La información también se puede recuperar si el usuario tiene una SAS en un contenedor o blob. |
| get_blob_metadata |
Devuelve todos los metadatos definidos por el usuario para el blob o la instantánea especificados. |
| get_blob_properties |
Devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para el blob. No devuelve el contenido de los blobs. Devuelve Blob con BlobProperties y un dict de metadatos. |
| get_blob_service_properties |
Obtiene las propiedades de Blob service de una cuenta de almacenamiento, incluido Azure Storage Analytics. |
| get_blob_service_stats |
Recupera las estadísticas relacionadas con la replicación para el servicio Blob. Solo está disponible cuando la replicación con redundancia geográfica con acceso de lectura está habilitada para la cuenta de almacenamiento. Con la replicación con redundancia geográfica, Azure Storage mantiene los datos duraderos en dos ubicaciones. En las dos ubicaciones, Azure Storage mantiene constantemente réplicas en estado correcto de los datos. La ubicación en la que lee, crea, actualiza o elimina los datos es la ubicación de la cuenta de almacenamiento principal. La ubicación principal existe en la región que elija en el momento en que cree una cuenta a través del Portal de Administración de Azure clásico de Azure, por ejemplo, Centro-norte de EE. UU. La ubicación en la que se replican los datos es la ubicación secundaria. La ubicación secundaria se determina automáticamente según la ubicación de la principal; está en un segundo centro de datos que se encuentra en la misma región que la ubicación principal. El acceso de solo lectura está disponible en la ubicación secundaria, si la replicación con redundancia geográfica con acceso de lectura está habilitada para la cuenta de almacenamiento. |
| get_blob_to_bytes |
Descarga un blob como una matriz de bytes, con notificaciones automáticas de fragmentación y progreso. Devuelve una instancia de Blob con propiedades, metadatos y contenido. |
| get_blob_to_path |
Descarga un blob en una ruta de acceso de archivo, con notificaciones automáticas de fragmentación y progreso. Devuelve una instancia de Blob con propiedades y metadatos. |
| get_blob_to_stream |
Descarga un blob en una secuencia, con notificaciones automáticas de fragmentación y progreso. Devuelve una instancia de Blob con propiedades y metadatos. |
| get_blob_to_text |
Descarga un blob como texto Unicode, con notificaciones automáticas de fragmentación y progreso. Devuelve una instancia de Blob con propiedades, metadatos y contenido. |
| get_block_list |
Recupera la lista de bloques que se han cargado como parte de un blob en bloques. Para cada blob se mantienen dos listas de bloques: Lista de bloques confirmadas: la lista de bloques que se han confirmado correctamente en un blob determinado con Put Block List. Lista de bloques sin confirmar: la lista de bloques que se han cargado para un blob mediante Put Block, pero que aún no se han confirmado. Estos bloques se almacenan en Azure asociados a un blob, pero aún no forman parte de él. |
| get_container_acl |
Obtiene los permisos para el contenedor especificado. Los permisos indican si el acceso a los datos de un contenedor es público. |
| get_container_metadata |
Devuelve todos los metadatos definidos por el usuario para el contenedor especificado. |
| get_container_properties |
Devuelve todos los metadatos definidos por el usuario y las propiedades del sistema para el contenedor especificado. Los datos devueltos no incluyen la lista de blobs del contenedor. |
| get_user_delegation_key |
Obtenga una clave de delegación de usuarios con el fin de firmar tokens de SAS. Una credencial de token debe estar presente en el objeto de servicio para que esta solicitud se realice correctamente. |
| list_blob_names |
Devuelve un generador para enumerar los nombres de blob en el contenedor especificado. El generador seguirá de forma diferida los tokens de continuación devueltos por el servicio y se detendrá cuando se hayan devuelto todos los blobs o se alcance num_results. Si se especifica num_results y la cuenta tiene más de ese número de blobs, el generador tendrá un campo next_marker rellenado una vez que finalice. Este marcador se puede usar para crear un nuevo generador si se desean más resultados. |
| list_blobs |
Devuelve un generador para enumerar los blobs en el contenedor especificado. El generador seguirá de forma diferida los tokens de continuación devueltos por el servicio y se detendrá cuando se devuelvan todos los blobs o num_results se alcance. Si se especifica num_results y la cuenta tiene más de ese número de blobs, el generador tendrá un campo next_marker rellenado una vez que termine. Este marcador se puede usar para crear un nuevo generador si se desean más resultados. |
| list_containers |
Devuelve un generador para enumerar los contenedores de la cuenta especificada. El generador seguirá de forma diferida los tokens de continuación devueltos por el servicio y se detendrá cuando se devuelvan todos los contenedores o num_results se alcance. Si se especifica num_results y la cuenta tiene más de ese número de contenedores, el generador tendrá un campo next_marker rellenado una vez que termine. Este marcador se puede usar para crear un nuevo generador si se desean más resultados. |
| make_blob_url |
Crea la dirección URL para acceder a un blob. |
| make_container_url |
Crea la dirección URL para acceder a un contenedor. |
| put_block |
Crea un nuevo bloque que se confirmará como parte de un blob. |
| put_block_from_url |
Crea un nuevo bloque que se confirmará como parte de un blob. |
| put_block_list |
Escribe un blob especificando la lista de identificadores de bloque que conforman el blob. Para poder escribirse como parte de un blob, un bloque debe haberse escrito correctamente en el servidor en una operación Put Block anterior. Puede llamar a Put Block List para actualizar un blob cargando solo los bloques que han cambiado y, a continuación, confirmando los bloques nuevos y existentes juntos. Puede hacerlo especificando si se debe confirmar un bloque de la lista de bloques confirmados o de la lista de bloques sin confirmar, o bien confirmar la versión del bloque que se ha cargado en último lugar, independientemente de la lista a la que pertenezca. |
| release_blob_lease |
Libera la concesión. La concesión se puede liberar si el identificador de concesión especificado en la solicitud coincide con el que está asociado al blob. Liberar la concesión permite a otro cliente adquirir inmediatamente la concesión sobre el blob en cuanto finaliza la operación de liberación. |
| release_container_lease |
Liberar la concesión. La concesión se puede liberar si el lease_id especificado coincide con el asociado al contenedor. Liberar la concesión permite a otro cliente adquirir inmediatamente la concesión sobre el contenedor en cuanto finaliza la operación de liberación. |
| renew_blob_lease |
Renueva la concesión. La concesión se puede renovar si el identificador de concesión especificado en la solicitud coincide con el que está asociado al blob. Tenga en cuenta que la concesión se puede renovar incluso si ha expirado, siempre que el blob no se haya modificado o concedido de nuevo desde la caducidad de la concesión. Cuando se renueva una concesión, el reloj que controla su duración se reinicia. |
| renew_container_lease |
Renueva la concesión. La concesión se puede renovar si el identificador de concesión especificado coincide con el asociado al contenedor. Tenga en cuenta que la concesión se puede renovar incluso si ha expirado, siempre que el contenedor no se haya concedido de nuevo desde la caducidad de la concesión. Cuando se renueva una concesión, el reloj que controla su duración se reinicia. |
| set_blob_metadata |
Establece los metadatos definidos por el usuario para el blob especificado como uno o varios pares de nombre y valor. |
| set_blob_properties |
Establece las propiedades del sistema en el blob. Si se establece una propiedad para el content_settings, se invalidarán todas las propiedades. |
| set_blob_service_properties |
Establece las propiedades de Blob service de una cuenta de almacenamiento, incluido Azure Storage Analytics. Si un elemento (por ejemplo, Registro) se deja como None, se conservan los valores existentes en el servicio para esa funcionalidad. |
| set_container_acl |
Establece los permisos para el contenedor especificado o las directivas de acceso almacenadas que se pueden usar con firmas de acceso compartido. Los permisos indican si el acceso a los blobs de un contenedor es público. |
| set_container_metadata |
Establece uno o varios pares nombre-valor definidos por el usuario para el contenedor especificado. Cada llamada a esta operación reemplaza todos los metadatos existentes adjuntados al contenedor. Para quitar todos los metadatos del contenedor, llame a esta operación sin dict de metadatos. |
| set_proxy |
Establece el host y el puerto del servidor proxy para la tunelización HTTP CONNECT. |
| set_standard_blob_tier |
Establece los niveles de blob en bloques en el blob. Esta API solo se admite para blobs en bloques en cuentas de almacenamiento estándar. :p aram RehydratePriority rehydrate_priority: indica la prioridad con la que rehidratar un blob archivado. |
| snapshot_blob |
Crea una instantánea de solo lectura de un blob. |
| undelete_blob |
La operación undelete Blob restaura el contenido y los metadatos del blob o la instantánea eliminados temporalmente. Si se intenta recuperar un blob o una instantánea que no se elimina temporalmente, se realizará correctamente sin realizar ningún cambio. |
abort_copy_blob
Anula una operación de copy_blob pendiente y deja un blob de destino con una longitud cero y metadatos completos.
abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)Parámetros
- copy_id
- str
Copie el identificador proporcionado en el copy.id de la operación de copy_blob original.
- lease_id
- str
Obligatorio si el blob de destino tiene una concesión infinita activa.
acquire_blob_lease
Solicita una nueva concesión. Si el blob no tiene una concesión activa, el servicio Blob crea una concesión sobre el blob y devuelve un nuevo identificador de concesión.
acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parámetros
- lease_duration
- int
Especifica la duración de la concesión, en segundos, o bien un valor negativo (-1) para una concesión que no expira nunca. Un concesión no infinita puede durar entre 15 y 60 segundos. No se puede cambiar una duración de concesión mediante renovación o cambio. El valor predeterminado es -1 (concesión infinita).
- proposed_lease_id
- str
Identificador de concesión propuesto, con formato de cadena de GUID. Blob service devuelve 400 (solicitud no válida) si el identificador de concesión propuesto no tiene el formato correcto.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
Devoluciones
str
acquire_container_lease
Solicita una nueva concesión. Si el contenedor no tiene una concesión activa, Blob service crea una concesión sobre el contenedor y devuelve un nuevo identificador de concesión.
acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parámetros
- lease_duration
- int
Especifica la duración de la concesión, en segundos, o bien un valor negativo (-1) para una concesión que no expira nunca. Un concesión no infinita puede durar entre 15 y 60 segundos. No se puede cambiar una duración de concesión mediante renovación o cambio. El valor predeterminado es -1 (concesión infinita).
- proposed_lease_id
- str
Identificador de concesión propuesto, con formato de cadena de GUID. Blob service devuelve 400 (solicitud no válida) si el identificador de concesión propuesto no tiene el formato correcto.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
Devoluciones
str
batch_delete_blobs
Envía un lote de varias solicitudes de eliminación de blobs.
El método de eliminación de blobs elimina el blob o la instantánea especificados. Tenga en cuenta que la eliminación de un blob también elimina todas sus instantáneas. Para obtener más información, vea https://docs.microsoft.com/rest/api/storageservices/delete-blob.
batch_delete_blobs(batch_delete_sub_requests, timeout=None)Parámetros
- batch_delete_sub_requests
- list(BatchDeleteSubRequest)
Las solicitudes de eliminación de blobs que se van a enviar como un lote.
Devoluciones
Respuesta HTTP de eliminación por lotes analizada
Tipo de valor devuelto
batch_set_standard_blob_tier
Envía un lote de varias solicitudes de niveles de blob en bloques establecidos. Esta API solo se admite para blobs en bloques en cuentas de almacenamiento estándar.
batch_set_standard_blob_tier(batch_set_blob_tier_sub_requests, timeout=None)Parámetros
- batch_set_blob_tier_sub_requests
- list(BatchSetBlobTierSubRequest)
El nivel de blob en bloques establecido solicita que se envíe como un lote.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
Devoluciones
Respuesta HTTP del nivel de conjunto de lotes analizado que indica si cada sub-solicitud es correcta.
Tipo de valor devuelto
break_blob_lease
Interrumpe la concesión, si el blob tiene una concesión activa. Una vez que se interrumpe una concesión, no es posible renovarla. Cualquier solicitud autorizada puede interrumpir la concesión; no es necesario que la solicitud especifique un identificador de concesión que coincida. Cuando se interrumpe una concesión, el período de interrupción de la concesión puede transcurrir, durante el cual no se puede realizar ninguna operación de concesión, excepto la interrupción y liberación en el blob. Cuando una concesión se interrumpe correctamente, la respuesta indica el intervalo en segundos que debe transcurrir hasta que se pueda obtener una nueva concesión.
Una concesión interrumpida también puede liberarse, en cuyo caso otro cliente puede adquirir inmediatamente la concesión sobre el blob.
break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parámetros
- lease_break_period
- int
Para una operación de interrupción, se trata de la duración propuesta de segundos que la concesión debe continuar antes de que se interrumpa, entre 0 y 60 segundos. Este período de interrupción solo se utiliza si es menor que el tiempo restante de la concesión. Si es más largo, se utiliza el tiempo restante de la concesión. Hasta que no haya expirado el período de interrupción no habrá disponible una nueva concesión, pero la concesión se puede mantener durante un tiempo más largo que el período de interrupción. Si este encabezado no aparece con una operación de interrupción, se interrumpe una concesión de duración fija después de que transcurre el período de concesión restante y se interrumpe inmediatamente una concesión infinita.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
Devoluciones
int
break_container_lease
Interrumpa la concesión, si el contenedor tiene una concesión activa. Una vez que se interrumpe una concesión, no es posible renovarla. Cualquier solicitud autorizada puede interrumpir la concesión; no es necesario que la solicitud especifique un identificador de concesión que coincida. Cuando se interrumpe una concesión, el período de interrupción de la concesión puede transcurrir, durante el cual no se puede realizar ninguna operación de concesión excepto la interrupción y liberación en el contenedor. Cuando una concesión se interrumpe correctamente, la respuesta indica el intervalo en segundos que debe transcurrir hasta que se pueda obtener una nueva concesión.
break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parámetros
- lease_break_period
- int
Esta es la duración propuesta de segundos que la concesión debe continuar antes de que se rompa, entre 0 y 60 segundos. Este período de interrupción solo se utiliza si es menor que el tiempo restante de la concesión. Si es más largo, se utiliza el tiempo restante de la concesión. Hasta que no haya expirado el período de interrupción no habrá disponible una nueva concesión, pero la concesión se puede mantener durante un tiempo más largo que el período de interrupción. Si este encabezado no aparece con una operación de interrupción, se interrumpe una concesión de duración fija después de que transcurre el período de concesión restante y se interrumpe inmediatamente una concesión infinita.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
Devoluciones
int
change_blob_lease
Cambia el identificador de concesión de una concesión activa. Un cambio debe incluir el identificador de concesión actual y un nuevo identificador de concesión.
change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parámetros
- proposed_lease_id
- str
Identificador de concesión propuesto, con formato de cadena de GUID. Blob service devuelve 400 (solicitud no válida) si el identificador de concesión propuesto no tiene el formato correcto.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
change_container_lease
Cambie el identificador de concesión de una concesión activa. Un cambio debe incluir el identificador de concesión actual y un nuevo identificador de concesión.
change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parámetros
- proposed_lease_id
- str
Identificador de concesión propuesto, con formato de cadena de GUID. Blob service devuelve 400 (solicitud no válida) si el identificador de concesión propuesto no tiene el formato correcto.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
copy_blob
Copia un blob. Esta operación devuelve un objeto de propiedades de operación de copia. La operación de copia se puede configurar para que sea una operación asincrónica, de mejor esfuerzo o de una operación sincrónica.
El origen debe ser un blob en bloques si requires_sync es true. Si existe un blob de destino, se sobrescribirá. El blob de destino no puede modificarse mientras haya una operación de copia en curso.
Al copiar desde un blob en bloques, se copian todos los bloques confirmados y sus identificadores de bloque. Los bloques no confirmados no se copian. Al final de la operación de copia, el blob de destino tendrá el mismo número de bloques confirmados que el origen.
Puede llamar a get_blob_properties en el blob de destino para comprobar el estado de la operación de copia. El blob final se confirmará cuando se complete la copia.
Nombre del contenedor de destino. El contenedor debe existir. :p aram str blob_name: nombre del blob de destino. Si el blob de destino existe, se sobrescribirá. De lo contrario, se creará. :p aram str copy_source: una dirección URL de hasta 2 KB de longitud que especifica un archivo o un blob de Azure. El valor debe estar codificado para URL tal y como aparecería en un URI de solicitud. Si el origen está en otra cuenta, el origen debe ser público o debe autenticarse a través de una firma de acceso compartido. Si el origen es público, no se requiere autenticación. Ejemplos: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken metadatos de :p aram: pares nombre-valor asociados al blob como metadatos. Si no se especifica ningún par nombre-valor, la operación copiará los metadatos del blob o archivo de origen en el blob de destino. Si se especifican uno o varios pares nombre-valor, el blob de destino se crea con los metadatos especificados y los metadatos no se copian del blob o archivo de origen. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de origen se ha modificado desde la fecha u hora especificadas. :p aram datetime source_if_unmodified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de origen no se ha modificado desde la fecha u hora especificadas. :p aram ETag source_if_match: un valor ETag o el carácter comodín (). Especifique este encabezado condicional para copiar el blob de origen solo si su ETag coincide con el valor especificado. Si los valores de ETag no coinciden, Blob service devuelve el código de estado 412 (error de condición previa). Este encabezado no se puede especificar si el origen es un archivo de Azure. :p aram ETag source_if_none_match: un valor ETag o el carácter comodín (). Especifique este encabezado condicional para copiar el blob de origen solo si la ETag no coincide con el valor especificado. Si los valores son idénticos, Blob service devuelve el código de estado 412 (Error de condición previa). Este encabezado no se puede especificar si el origen es un archivo de Azure. :p aram datetime destination_if_modified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de destino se ha modificado desde la fecha u hora especificadas. Si el blob de destino no se ha modificado, el servicio Blob devuelve el código de estado 412 (Error de condición previa). :p aram datetime destination_if_unmodified_since: un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado condicional para copiar el blob solo si el blob de destino no se ha modificado desde la fecha u hora especificadas. Si el blob de destino se ha modificado, el servicio Blob devuelve el código de estado 412 (Error de condición previa). :p aram ETag destination_if_match: un valor ETag o el carácter comodín (). Especifique un valor ETag para este encabezado condicional para copiar el blob solo si el valor de ETag especificado coincide con el valor ETag de un blob de destino existente. Si la ETag del blob de destino no coincide con la ETag especificada para If-Match, Blob service devuelve el código de estado 412 (error de condición previa). :p aram ETag destination_if_none_match: un valor ETag o el carácter comodín (). Especifique un valor ETag para este encabezado condicional para copiar el blob solo si el valor ETag especificado no coincide con el del blob de destino. Especifique el carácter comodín (*) para realizar la operación solo si no existe el blob de destino. Si no se cumple la condición especificada, Blob service devuelve el código de estado 412 (Error de condición previa). :p aram str destination_lease_id: el identificador de concesión especificado para este encabezado debe coincidir con el identificador de concesión del blob de destino. Si la solicitud no incluye el identificador de concesión o este no es válido, la operación produce un error con el código de estado 412 (Error de condición previa). :p aram str source_lease_id: especifique esto para realizar la operación Copiar blob solo si el identificador de concesión dado coincide con el identificador de concesión activo del blob de origen. :p aram int timeout: el parámetro timeout se expresa en segundos. :p aram bool requires_sync: exige que el servicio no devuelva una respuesta hasta que se complete la copia. :p aram StandardBlobTier standard_blob_tier: un valor de nivel de blob estándar en el que establecer el blob. Para esta versión de la biblioteca, esto solo se aplica a blobs en bloques en cuentas de almacenamiento estándar. :p aram RehydratePriority rehydrate_priority: indica la prioridad con la que rehidratar un blob archivado :return: copiar propiedades de operación como el estado, el origen y el identificador. :rtype: CopyProperties
copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None, requires_sync=None, standard_blob_tier=None, rehydrate_priority=None)Parámetros
- container_name
- str
- blob_name
- copy_source
- metadata
- source_if_modified_since
- source_if_unmodified_since
- source_if_match
- source_if_none_match
- destination_if_modified_since
- destination_if_unmodified_since
- destination_if_match
- destination_if_none_match
- destination_lease_id
- source_lease_id
- timeout
- requires_sync
- standard_blob_tier
- rehydrate_priority
create_blob_from_bytes
Crea un nuevo blob a partir de una matriz de bytes o actualiza el contenido de un blob existente, con notificaciones automáticas de fragmentación y progreso.
create_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)Parámetros
- count
- int
Número de bytes que se van a cargar. Establezca en Ninguno o valor negativo para cargar todos los bytes a partir del índice.
- content_settings
- ContentSettings
Objeto ContentSettings usado para establecer propiedades de blob.
Pares nombre-valor asociados al blob como metadatos.
- validate_content
- bool
Si es true, calcula un hash MD5 para cada fragmento del blob. El servicio de almacenamiento comprueba el hash del contenido que ha llegado con el hash que se envió. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (valor predeterminado) ya se validará. Tenga en cuenta que este hash MD5 no se almacena con el blob.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Devolución de llamada para el progreso con la función de firma (actual, total) donde current es el número de bytes transferidos hasta ahora, y el total es el tamaño del blob o Ninguno si se desconoce el tamaño total.
- max_connections
- int
Número máximo de conexiones paralelas que se usarán cuando el tamaño del blob supera los 64 MB.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
- standard_blob_tier
- StandardBlobTier
Valor de nivel de blob estándar en el que se va a establecer el blob. Para esta versión de la biblioteca, esto solo se aplica a blobs en bloques en cuentas de almacenamiento estándar.
Devoluciones
ETag y propiedades modificadas por última vez para el blob en bloques
Tipo de valor devuelto
create_blob_from_path
Crea un nuevo blob a partir de una ruta de acceso de archivo o actualiza el contenido de un blob existente, con notificaciones automáticas de fragmentación y progreso.
create_blob_from_path(container_name, blob_name, file_path, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)Parámetros
- content_settings
- ContentSettings
Objeto ContentSettings usado para establecer propiedades de blob.
Pares nombre-valor asociados al blob como metadatos.
- validate_content
- bool
Si es true, calcula un hash MD5 para cada fragmento del blob. El servicio de almacenamiento comprueba el hash del contenido que ha llegado con el hash que se envió. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (el valor predeterminado) ya se validará. Tenga en cuenta que este hash MD5 no se almacena con el blob. Tenga en cuenta también que si está habilitado, no se usará el algoritmo de carga eficaz para memoria, ya que calcular el hash MD5 requiere almacenar en búfer bloques completos y, al hacerlo, se anula el propósito del algoritmo eficiente en memoria.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Devolución de llamada para el progreso con la función de firma (actual, total) donde current es el número de bytes transferidos hasta ahora, y el total es el tamaño del blob o None si se desconoce el tamaño total.
- max_connections
- int
Número máximo de conexiones paralelas que se usarán cuando el tamaño del blob supere los 64 MB.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si el valor de ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
- standard_blob_tier
- StandardBlobTier
Valor de nivel de blob estándar en el que se va a establecer el blob. Para esta versión de la biblioteca, esto solo se aplica a blobs en bloques en cuentas de almacenamiento estándar.
Devoluciones
ETag y propiedades modificadas por última vez para el blob en bloques
Tipo de valor devuelto
create_blob_from_stream
Crea un nuevo blob a partir de un archivo o secuencia, o actualiza el contenido de un blob existente, con notificaciones automáticas de fragmentación y progreso.
create_blob_from_stream(container_name, blob_name, stream, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, use_byte_buffer=False, standard_blob_tier=None, cpk=None)Parámetros
- stream
- IOBase
Se ha abierto el archivo o la secuencia para cargarlo como contenido del blob.
- count
- int
Número de bytes que se van a leer de la secuencia. Esto es opcional, pero debe proporcionarse para obtener un rendimiento óptimo.
- content_settings
- ContentSettings
Objeto ContentSettings usado para establecer propiedades de blob.
Pares nombre-valor asociados al blob como metadatos.
- validate_content
- bool
Si es true, calcula un hash MD5 para cada fragmento del blob. El servicio de almacenamiento comprueba el hash del contenido que ha llegado con el hash que se envió. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (el valor predeterminado) ya se validará. Tenga en cuenta que este hash MD5 no se almacena con el blob. Tenga en cuenta también que si está habilitado, no se usará el algoritmo de carga eficaz para memoria, ya que calcular el hash MD5 requiere almacenar en búfer bloques completos y, al hacerlo, se anula el propósito del algoritmo eficiente en memoria.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Devolución de llamada para el progreso con la función de firma (actual, total) donde current es el número de bytes transferidos hasta ahora, y el total es el tamaño del blob o None si se desconoce el tamaño total.
- max_connections
- int
Número máximo de conexiones paralelas que se usarán cuando el tamaño del blob supere los 64 MB. Tenga en cuenta que la carga en paralelo requiere que se pueda buscar la secuencia.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si el valor de ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
- use_byte_buffer
- bool
Si es True, esto forzará el uso de la ruta de carga de almacenamiento en búfer de bloques completo original. De forma predeterminada, este valor es False y usará un algoritmo de carga de streaming eficiente en memoria en las condiciones siguientes: La secuencia proporcionada es buscable, "require_encryption" es False y MAX_BLOCK_SIZE >= MIN_LARGE_BLOCK_UPLOAD_THRESHOLD. Uno debe tener en cuenta las desventajas de usar este enfoque. Para lograr la eficacia de la memoria, una secuencia de IOBase o un objeto similar a un archivo se segmenta en bloques lógicos mediante un contenedor SubStream. Para leer los datos correctos, cada SubStream debe adquirir un bloqueo para que pueda buscar de forma segura la posición correcta en la secuencia subyacente compartida. Si max_connections > 1, la simultaneidad dará lugar a una cantidad considerable de búsquedas en la secuencia subyacente. Para las entradas más comunes, como un objeto de secuencia similar a un archivo, la búsqueda es una operación económica y esto no es una preocupación. Sin embargo, para otras variantes de secuencias, puede que esto no sea así. La compensación de la eficiencia de la memoria debe pesarse contra el costo de la búsqueda con el flujo de entrada. La clase SubStream intentará almacenar en búfer hasta 4 MB internamente para reducir la cantidad de llamadas de búsqueda y lectura a la secuencia subyacente. Esto es especialmente beneficioso al cargar bloques más grandes.
- standard_blob_tier
- StandardBlobTier
Valor de nivel de blob estándar en el que se va a establecer el blob. Para esta versión de la biblioteca, esto solo se aplica a blobs en bloques en cuentas de almacenamiento estándar.
Devoluciones
ETag y propiedades modificadas por última vez para el blob en bloques
Tipo de valor devuelto
create_blob_from_text
Crea un nuevo blob a partir de str/unicode, o actualiza el contenido de un blob existente, con notificaciones automáticas de fragmentación y progreso.
create_blob_from_text(container_name, blob_name, text, encoding='utf-8', content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)Parámetros
- encoding
- str
Codificación de Python que se va a usar para convertir el texto en bytes.
- content_settings
- ContentSettings
Objeto ContentSettings usado para establecer propiedades de blob.
Pares nombre-valor asociados al blob como metadatos.
- validate_content
- bool
Si es true, calcula un hash MD5 para cada fragmento del blob. El servicio de almacenamiento comprueba el hash del contenido que ha llegado con el hash que se envió. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (el valor predeterminado) ya se validará. Tenga en cuenta que este hash MD5 no se almacena con el blob.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Devolución de llamada para el progreso con la función de firma (actual, total) donde current es el número de bytes transferidos hasta ahora, y el total es el tamaño del blob o None si se desconoce el tamaño total.
- max_connections
- int
Número máximo de conexiones paralelas que se usarán cuando el tamaño del blob supere los 64 MB.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
- standard_blob_tier
- StandardBlobTier
Valor de nivel de blob estándar en el que se va a establecer el blob. Para esta versión de la biblioteca, esto solo se aplica a blobs en bloques en cuentas de almacenamiento estándar.
Devoluciones
ETag y propiedades modificadas por última vez para el blob en bloques
Tipo de valor devuelto
create_container
Crea un nuevo contenedor en la cuenta especificada. Si el contenedor con el mismo nombre ya existe, se produce un error en la operación si fail_on_exist es True.
create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)Parámetros
- container_name
- str
Nombre del contenedor que se va a crear. El nombre del contenedor solo puede contener letras minúsculas, números y guiones, y debe comenzar con una letra o un número. Antes y después de cada guion debe ir un carácter que no sea otro guión. El nombre debe tener entre 3 y 63 caracteres.
Un dict con pares de name_value que se van a asociar al contenedor como metadatos. Ejemplo:{'Category':'test'}
- public_access
- PublicAccess
Entre los valores posibles se incluyen: contenedor, blob.
- fail_on_exist
- bool
Especifique si se va a producir una excepción cuando existe el contenedor.
Devoluciones
True si se crea el contenedor, False si el contenedor ya existe.
Tipo de valor devuelto
delete_blob
Marca el blob o la instantánea especificados para su eliminación. El blob se elimina posteriormente durante la recolección de elementos no utilizados.
Tenga en cuenta que para eliminar un blob, debe eliminar todas sus instantáneas. Puede eliminar ambos al mismo tiempo con la operación Eliminar blob.
Si se habilita una directiva de retención de eliminación para el servicio, esta operación elimina temporalmente el blob o la instantánea y conserva el blob o la instantánea durante el número de días especificado. Después del número especificado de días, los datos del blob se quitan del servicio durante la recolección de elementos no utilizados. Se puede acceder a blobs o instantáneas eliminadas temporalmente a través de list Blobs API que especifica la opción include=Include.Deleted. El blob o la instantánea eliminados temporalmente se pueden restaurar mediante la API Undelete.
delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parámetros
- snapshot
- str
El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a eliminar.
- delete_snapshots
- DeleteSnapshot
Obligatorio si el blob tiene instantáneas asociadas.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
delete_container
Marca el contenedor especificado para su eliminación. El contenedor y los blobs incluidos en él se eliminan posteriormente durante la recolección de elementos no utilizados.
delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parámetros
- fail_not_exist
- bool
Especifique si se va a producir una excepción cuando el contenedor no existe.
- lease_id
- str
Si se especifica, delete_container solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador. Obligatorio si el contenedor tiene una concesión activa.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
Devoluciones
True si se elimina el contenedor, el contenedor False no existe.
Tipo de valor devuelto
exists
Devuelve un valor booleano que indica si el contenedor existe (si blob_name es None) o un valor booleano que indica si el blob existe.
exists(container_name, blob_name=None, snapshot=None, timeout=None)Parámetros
- blob_name
- str
Nombre de un blob. Si no, se comprobará la existencia del contenedor.
- snapshot
- str
El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea.
Devoluciones
Valor booleano que indica si el recurso existe.
Tipo de valor devuelto
extract_date_and_request_id
static extract_date_and_request_id(retry_context)Parámetros
- retry_context
generate_account_shared_access_signature
Genera una firma de acceso compartido para blob service. Use la firma devuelta con el parámetro sas_token de cualquier BlobService.
generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)Parámetros
- resource_types
- <xref:ResourceTypes>
Especifica los tipos de recursos a los que se puede acceder con la SAS de la cuenta.
- permission
- <xref:AccountPermissions>
Permisos asociados a la firma de acceso compartido. El usuario está restringido a las operaciones permitidas por los permisos. Obligatorio a menos que se especifique un identificador que haga referencia a una directiva de acceso almacenada que contenga este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada.
Hora en la que la firma de acceso compartido deja de ser válida. Obligatorio a menos que se especifique un identificador que haga referencia a una directiva de acceso almacenada que contenga este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada. Azure siempre convertirá valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.
Hora en la que la firma de acceso compartido es válida. Si se omite, se supone que la hora de inicio de esta llamada es la hora a la que el servicio de almacenamiento recibe la solicitud. Azure siempre convertirá valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.
- ip
- str
Especifica una dirección IP o un intervalo de direcciones IP de las que se van a aceptar solicitudes. Si la dirección IP desde la que se origina la solicitud no coincide con la dirección IP o el intervalo de direcciones especificado en el token de SAS, la solicitud no se autentica. Por ejemplo, especificando sip=168.1.5.65 o sip=168.1.5.60-168.1.5.70 en la SAS restringe la solicitud a esas direcciones IP.
- protocol
- str
Especifica el protocolo permitido para una solicitud realizada. El valor predeterminado es https,http. Vea Protocol para conocer los valores posibles.
Devoluciones
Un token de firma de acceso compartido (sas).
Tipo de valor devuelto
generate_blob_shared_access_signature
Genera una firma de acceso compartido para el blob o una de sus instantáneas. Use la firma devuelta con el parámetro sas_token de cualquier BlobService.
generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)Parámetros
- snapshot
- str
El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a conceder permiso.
- permission
- BlobPermissions
Permisos asociados a la firma de acceso compartido. El usuario está restringido a las operaciones permitidas por los permisos. Los permisos deben ordenarse de lectura, escritura, eliminación, lista. Obligatorio a menos que se especifique un identificador que haga referencia a una directiva de acceso almacenada que contenga este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada.
Hora en la que la firma de acceso compartido deja de ser válida. Obligatorio a menos que se especifique un identificador que haga referencia a una directiva de acceso almacenada que contenga este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada. Azure siempre convertirá valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.
Hora en la que la firma de acceso compartido es válida. Si se omite, se supone que la hora de inicio de esta llamada es la hora a la que el servicio de almacenamiento recibe la solicitud. Azure siempre convertirá valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.
- id
- str
Valor único de hasta 64 caracteres de longitud que se correlaciona con una directiva de acceso almacenada. Para crear una directiva de acceso almacenada, use set_container_acl.
- ip
- str
Especifica una dirección IP o un intervalo de direcciones IP de las que se van a aceptar solicitudes. Si la dirección IP desde la que se origina la solicitud no coincide con la dirección IP o el intervalo de direcciones especificado en el token de SAS, la solicitud no se autentica. Por ejemplo, especificando sip=168.1.5.65 o sip=168.1.5.60-168.1.5.70 en la SAS restringe la solicitud a esas direcciones IP.
- protocol
- str
Especifica el protocolo permitido para una solicitud realizada. El valor predeterminado es https,http. Vea Protocol para conocer los valores posibles.
- cache_control
- str
Valor del encabezado de respuesta para Cache-Control cuando se accede al recurso mediante esta firma de acceso compartido.
- content_disposition
- str
Valor del encabezado de respuesta para Content-Disposition cuando se accede a un recurso mediante esta firma de acceso compartido.
- content_encoding
- str
Valor del encabezado de respuesta para Content-Encoding cuando se accede a un recurso mediante esta firma de acceso compartido.
- content_language
- str
Valor del encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.
- content_type
- str
Valor del encabezado de respuesta para Content-Type cuando se accede a un recurso mediante esta firma de acceso compartido.
- user_delegation_key
- UserDelegationKey
En lugar de una clave de cuenta, el usuario podría pasar una clave de delegación de usuarios. Se puede obtener una clave de delegación de usuarios del servicio mediante la autenticación con una identidad de AAD; Esto se puede lograr llamando a get_user_delegation_key. Cuando está presente, la SAS se firma con la clave de delegación de usuarios en su lugar.
Devoluciones
Un token de firma de acceso compartido (sas).
Tipo de valor devuelto
generate_container_shared_access_signature
Genera una firma de acceso compartido para el contenedor. Use la firma devuelta con el parámetro sas_token de cualquier BlobService.
generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)Parámetros
- permission
- ContainerPermissions
Permisos asociados a la firma de acceso compartido. El usuario está restringido a las operaciones permitidas por los permisos. Los permisos deben ordenarse de lectura, escritura, eliminación, lista. Obligatorio a menos que se especifique un identificador que haga referencia a una directiva de acceso almacenada que contenga este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada.
Hora en la que la firma de acceso compartido deja de ser válida. Obligatorio a menos que se especifique un identificador que haga referencia a una directiva de acceso almacenada que contenga este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada. Azure siempre convertirá valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.
Hora en la que la firma de acceso compartido es válida. Si se omite, se supone que la hora de inicio de esta llamada es la hora a la que el servicio de almacenamiento recibe la solicitud. Azure siempre convertirá valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.
- id
- str
Valor único de hasta 64 caracteres de longitud que se correlaciona con una directiva de acceso almacenada. Para crear una directiva de acceso almacenada, use set_blob_service_properties.
- ip
- str
Especifica una dirección IP o un intervalo de direcciones IP de las que se van a aceptar solicitudes. Si la dirección IP desde la que se origina la solicitud no coincide con la dirección IP o el intervalo de direcciones especificado en el token de SAS, la solicitud no se autentica. Por ejemplo, especificando sip=168.1.5.65 o sip=168.1.5.60-168.1.5.70 en la SAS restringe la solicitud a esas direcciones IP.
- protocol
- str
Especifica el protocolo permitido para una solicitud realizada. El valor predeterminado es https,http. Vea Protocol para conocer los valores posibles.
- cache_control
- str
Valor del encabezado de respuesta para Cache-Control cuando se accede al recurso mediante esta firma de acceso compartido.
- content_disposition
- str
Valor del encabezado de respuesta para Content-Disposition cuando se accede a un recurso mediante esta firma de acceso compartido.
- content_encoding
- str
Valor del encabezado de respuesta para Content-Encoding cuando se accede a un recurso mediante esta firma de acceso compartido.
- content_language
- str
Valor del encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.
- content_type
- str
Valor del encabezado de respuesta para Content-Type cuando se accede a un recurso mediante esta firma de acceso compartido.
- user_delegation_key
- UserDelegationKey
En lugar de una clave de cuenta, el usuario podría pasar una clave de delegación de usuarios. Se puede obtener una clave de delegación de usuarios del servicio mediante la autenticación con una identidad de AAD; Esto se puede lograr llamando a get_user_delegation_key. Cuando está presente, la SAS se firma con la clave de delegación de usuarios en su lugar.
Devoluciones
Un token de firma de acceso compartido (sas).
Tipo de valor devuelto
get_blob_account_information
Obtiene información relacionada con la cuenta de almacenamiento. La información también se puede recuperar si el usuario tiene una SAS en un contenedor o blob.
get_blob_account_information(container_name=None, blob_name=None, timeout=None)Parámetros
- container_name
- str
Nombre del contenedor existente. Opcional, a menos que se use un token de SAS en un contenedor o blob específico, en cuyo caso es necesario.
- blob_name
- str
Nombre del blob existente. Opcional, a menos que se use un token de SAS en un blob específico, en cuyo caso es necesario.
Devoluciones
El parámetro de cadena de consulta AccountInformation.
get_blob_metadata
Devuelve todos los metadatos definidos por el usuario para el blob o la instantánea especificados.
get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parámetros
- snapshot
- str
El parámetro snapshot es un valor opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si el valor de ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.
Descifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
Devoluciones
Diccionario que representa el nombre de los metadatos del blob, los pares de valores.
Tipo de valor devuelto
get_blob_properties
Devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para el blob. No devuelve el contenido de los blobs. Devuelve Blob con BlobProperties y un dict de metadatos.
get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parámetros
- snapshot
- str
El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea del blob que se va a recuperar.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si el valor de ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.
Descifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
Devoluciones
un objeto de blob que incluye propiedades y metadatos.
Tipo de valor devuelto
get_blob_service_properties
Obtiene las propiedades de Blob service de una cuenta de almacenamiento, incluido Azure Storage Analytics.
get_blob_service_properties(timeout=None)Parámetros
Devoluciones
Blob ServiceProperties con una propiedad de target_version adjunta.
get_blob_service_stats
Recupera las estadísticas relacionadas con la replicación para el servicio Blob. Solo está disponible cuando la replicación con redundancia geográfica con acceso de lectura está habilitada para la cuenta de almacenamiento.
Con la replicación con redundancia geográfica, Azure Storage mantiene los datos duraderos en dos ubicaciones. En las dos ubicaciones, Azure Storage mantiene constantemente réplicas en estado correcto de los datos. La ubicación en la que lee, crea, actualiza o elimina los datos es la ubicación de la cuenta de almacenamiento principal. La ubicación principal existe en la región que elija en el momento en que cree una cuenta a través del Portal de Administración de Azure clásico de Azure, por ejemplo, Centro-norte de EE. UU. La ubicación en la que se replican los datos es la ubicación secundaria. La ubicación secundaria se determina automáticamente según la ubicación de la principal; está en un segundo centro de datos que se encuentra en la misma región que la ubicación principal. El acceso de solo lectura está disponible en la ubicación secundaria, si la replicación con redundancia geográfica con acceso de lectura está habilitada para la cuenta de almacenamiento.
get_blob_service_stats(timeout=None)Parámetros
Devoluciones
Las estadísticas del servicio BLOB.
Tipo de valor devuelto
get_blob_to_bytes
Descarga un blob como una matriz de bytes, con notificaciones automáticas de fragmentación y progreso. Devuelve una instancia de Blob con propiedades, metadatos y contenido.
get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parámetros
- snapshot
- str
El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea del blob que se va a recuperar.
- start_range
- int
Inicio del intervalo de bytes que se va a usar para descargar una sección del blob. Si no se da ningún end_range, se descargarán todos los bytes después del start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes del blob.
- end_range
- int
Fin del intervalo de bytes que se va a usar para descargar una sección del blob. Si se proporciona end_range, se debe proporcionar start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes del blob.
- validate_content
- bool
Si se establece en true, valida un hash MD5 para cada parte recuperada del blob. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (el valor predeterminado) ya se validará. Tenga en cuenta que el servicio solo devolverá MD5 transaccional para fragmentos de 4 MB o menos, por lo que la primera solicitud get será de tamaño propio. MAX_CHUNK_GET_SIZE en lugar de sí mismo. MAX_SINGLE_GET_SIZE. Si es yo. MAX_CHUNK_GET_SIZE se estableció en mayor que 4 MB, se producirá un error. A medida que la computación md5 tarda tiempo de procesamiento y es necesario realizar más solicitudes debido al tamaño reducido del fragmento, puede haber algún aumento en la latencia.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Devolución de llamada para el progreso con la función de firma (actual, total) donde current es el número de bytes transferidos hasta ahora, y el total es el tamaño del blob si se conoce.
- max_connections
- int
Si se establece en 2 o superior, se realizará una obtención inicial para el primer auto. MAX_SINGLE_GET_SIZE bytes del blob. Si se trata de todo el blob, el método devuelve en este momento. Si no es así, descargará los datos restantes en paralelo con el número de subprocesos iguales a max_connections. Cada fragmento será de tamaño propio. MAX_CHUNK_GET_SIZE. Si se establece en 1, se realizará una única solicitud get grande. Esto no se recomienda generalmente, pero está disponible si se deben usar muy pocos subprocesos, las solicitudes de red son muy costosas o una secuencia no buscable impide la descarga en paralelo. Esto también puede ser útil si se espera que muchos blobs estén vacíos, ya que se requiere una solicitud adicional para blobs vacíos si max_connections es mayor que 1.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si el valor de ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.
Descifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
Devoluciones
Un blob con propiedades y metadatos. Si max_connections es mayor que 1, no se devolverá el content_md5 (si se establece en el blob). Si necesita este valor, use get_blob_properties o establezca max_connections en 1.
Tipo de valor devuelto
get_blob_to_path
Descarga un blob en una ruta de acceso de archivo, con notificaciones automáticas de fragmentación y progreso. Devuelve una instancia de Blob con propiedades y metadatos.
get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parámetros
- open_mode
- str
Modo que se va a usar al abrir el archivo. Tenga en cuenta que especificar append only open_mode impide la descarga en paralelo. Por lo tanto, max_connections debe establecerse en 1 si se usa este open_mode.
- snapshot
- str
El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.
- start_range
- int
Inicio del intervalo de bytes que se va a usar para descargar una sección del blob. Si no se da ningún end_range, se descargarán todos los bytes después del start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes del blob.
- end_range
- int
Final del intervalo de bytes que se va a usar para descargar una sección del blob. Si se proporciona end_range, se debe proporcionar start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes del blob.
- validate_content
- bool
Si se establece en true, valida un hash MD5 para cada parte recuperada del blob. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (valor predeterminado) ya se validará. Tenga en cuenta que el servicio solo devolverá MD5 transaccional para fragmentos de 4 MB o menos, por lo que la primera solicitud get será de tamaño propio. MAX_CHUNK_GET_SIZE en lugar de sí mismo. MAX_SINGLE_GET_SIZE. Si es yo. MAX_CHUNK_GET_SIZE se estableció en mayor que 4 MB, se producirá un error. A medida que la computación md5 tarda tiempo en procesarse y es necesario realizar más solicitudes debido al tamaño reducido del fragmento, puede haber algún aumento en la latencia.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Devolución de llamada para el progreso con la función de firma (actual, total) donde current es el número de bytes transferidos hasta ahora, y el total es el tamaño del blob si se conoce.
- max_connections
- int
Si se establece en 2 o superior, se realizará una obtención inicial para el primer auto. MAX_SINGLE_GET_SIZE bytes del blob. Si se trata de todo el blob, el método devuelve en este momento. Si no es así, descargará los datos restantes en paralelo con el número de subprocesos iguales a max_connections. Cada fragmento será de tamaño propio. MAX_CHUNK_GET_SIZE. Si se establece en 1, se realizará una única solicitud get grande. Esto no se recomienda generalmente, pero está disponible si se deben usar muy pocos subprocesos, las solicitudes de red son muy costosas o una secuencia no buscable impide la descarga en paralelo. Esto también puede ser útil si se espera que muchos blobs estén vacíos, ya que se requiere una solicitud adicional para blobs vacíos si max_connections es mayor que 1.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
Descifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
Devoluciones
Un blob con propiedades y metadatos. Si max_connections es mayor que 1, no se devolverá el content_md5 (si se establece en el blob). Si necesita este valor, use get_blob_properties o establezca max_connections en 1.
Tipo de valor devuelto
get_blob_to_stream
Descarga un blob en una secuencia, con notificaciones automáticas de fragmentación y progreso. Devuelve una instancia de Blob con propiedades y metadatos.
get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parámetros
- snapshot
- str
El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.
- start_range
- int
Inicio del intervalo de bytes que se va a usar para descargar una sección del blob. Si no se da ningún end_range, se descargarán todos los bytes después del start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes del blob.
- end_range
- int
Final del intervalo de bytes que se va a usar para descargar una sección del blob. Si se proporciona end_range, se debe proporcionar start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes del blob.
- validate_content
- bool
Si se establece en true, valida un hash MD5 para cada parte recuperada del blob. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (valor predeterminado) ya se validará. Tenga en cuenta que el servicio solo devolverá MD5 transaccional para fragmentos de 4 MB o menos, por lo que la primera solicitud get será de tamaño propio. MAX_CHUNK_GET_SIZE en lugar de sí mismo. MAX_SINGLE_GET_SIZE. Si es yo. MAX_CHUNK_GET_SIZE se estableció en mayor que 4 MB, se producirá un error. A medida que la computación md5 tarda tiempo en procesarse y es necesario realizar más solicitudes debido al tamaño reducido del fragmento, puede haber algún aumento en la latencia.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Devolución de llamada para el progreso con la función de firma (actual, total) donde current es el número de bytes transferidos hasta ahora, y el total es el tamaño del blob si se conoce.
- max_connections
- int
Si se establece en 2 o superior, se realizará una obtención inicial para el primer auto. MAX_SINGLE_GET_SIZE bytes del blob. Si se trata de todo el blob, el método devuelve en este momento. Si no es así, descargará los datos restantes en paralelo con el número de subprocesos iguales a max_connections. Cada fragmento será de tamaño propio. MAX_CHUNK_GET_SIZE. Si se establece en 1, se realizará una única solicitud get grande. Esto no se recomienda generalmente, pero está disponible si se deben usar muy pocos subprocesos, las solicitudes de red son muy costosas o una secuencia no buscable impide la descarga en paralelo. Esto también puede ser útil si se espera que muchos blobs estén vacíos, ya que se requiere una solicitud adicional para blobs vacíos si max_connections es mayor que 1.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
Descifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
Devoluciones
Un blob con propiedades y metadatos. Si max_connections es mayor que 1, no se devolverá el content_md5 (si se establece en el blob). Si necesita este valor, use get_blob_properties o establezca max_connections en 1.
Tipo de valor devuelto
get_blob_to_text
Descarga un blob como texto Unicode, con notificaciones automáticas de fragmentación y progreso. Devuelve una instancia de Blob con propiedades, metadatos y contenido.
get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parámetros
- encoding
- str
Codificación de Python que se va a usar al descodificar los datos del blob.
- snapshot
- str
El parámetro snapshot es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.
- start_range
- int
Inicio del intervalo de bytes que se va a usar para descargar una sección del blob. Si no se da ningún end_range, se descargarán todos los bytes después del start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes del blob.
- end_range
- int
Fin del intervalo de bytes que se va a usar para descargar una sección del blob. Si se proporciona end_range, se debe proporcionar start_range. Los parámetros start_range y end_range son inclusivos. Por ejemplo: start_range=0, end_range=511 descargará los primeros 512 bytes del blob.
- validate_content
- bool
Si se establece en true, valida un hash MD5 para cada parte recuperada del blob. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (el valor predeterminado) ya se validará. Tenga en cuenta que el servicio solo devolverá MD5 transaccional para fragmentos de 4 MB o menos, por lo que la primera solicitud get será de tamaño propio. MAX_CHUNK_GET_SIZE en lugar de sí mismo. MAX_SINGLE_GET_SIZE. Si es yo. MAX_CHUNK_GET_SIZE se estableció en mayor que 4 MB, se producirá un error. A medida que la computación md5 tarda tiempo de procesamiento y es necesario realizar más solicitudes debido al tamaño reducido del fragmento, puede haber algún aumento en la latencia.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Devolución de llamada para el progreso con la función de firma (actual, total) donde current es el número de bytes transferidos hasta ahora, y el total es el tamaño del blob si se conoce.
- max_connections
- int
Si se establece en 2 o superior, se realizará una obtención inicial para el primer auto. MAX_SINGLE_GET_SIZE bytes del blob. Si se trata de todo el blob, el método devuelve en este momento. Si no es así, descargará los datos restantes en paralelo con el número de subprocesos iguales a max_connections. Cada fragmento será de tamaño propio. MAX_CHUNK_GET_SIZE. Si se establece en 1, se realizará una única solicitud get grande. Esto no se recomienda generalmente, pero está disponible si se deben usar muy pocos subprocesos, las solicitudes de red son muy costosas o una secuencia no buscable impide la descarga en paralelo. Esto también puede ser útil si se espera que muchos blobs estén vacíos, ya que se requiere una solicitud adicional para blobs vacíos si max_connections es mayor que 1.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si el valor de ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.
Descifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
Devoluciones
Un blob con propiedades y metadatos. Si max_connections es mayor que 1, no se devolverá el content_md5 (si se establece en el blob). Si necesita este valor, use get_blob_properties o establezca max_connections en 1.
Tipo de valor devuelto
get_block_list
Recupera la lista de bloques que se han cargado como parte de un blob en bloques. Para cada blob se mantienen dos listas de bloques:
Lista de bloques confirmadas: la lista de bloques que se han confirmado correctamente en un blob determinado con Put Block List.
Lista de bloques sin confirmar: la lista de bloques que se han cargado para un blob mediante Put Block, pero que aún no se han confirmado. Estos bloques se almacenan en Azure asociados a un blob, pero aún no forman parte de él.
get_block_list(container_name, blob_name, snapshot=None, block_list_type=None, lease_id=None, timeout=None)Parámetros
- block_list_type
- str
Especifica si se debe devolver la lista de bloques confirmados, la lista de bloques sin confirmar o ambas listas. Los valores válidos son: committed, uncommitted o all.
Devoluciones
enumerar bloques confirmados o no confirmados para blobs en bloques
Tipo de valor devuelto
get_container_acl
Obtiene los permisos para el contenedor especificado. Los permisos indican si el acceso a los datos de un contenedor es público.
get_container_acl(container_name, lease_id=None, timeout=None)Parámetros
- lease_id
Si se especifica, get_container_acl solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.
Devoluciones
Diccionario de directivas de acceso asociadas al contenedor. dict de str a AccessPolicy y una propiedad public_access si el acceso público está activado
get_container_metadata
Devuelve todos los metadatos definidos por el usuario para el contenedor especificado.
get_container_metadata(container_name, lease_id=None, timeout=None)Parámetros
- lease_id
- str
Si se especifica, get_container_metadata solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.
Devoluciones
Diccionario que representa el nombre de los metadatos del contenedor, los pares de valores.
Tipo de valor devuelto
get_container_properties
Devuelve todos los metadatos definidos por el usuario y las propiedades del sistema para el contenedor especificado. Los datos devueltos no incluyen la lista de blobs del contenedor.
get_container_properties(container_name, lease_id=None, timeout=None)Parámetros
- lease_id
- str
Si se especifica, get_container_properties solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.
Devoluciones
propiedades del contenedor especificado dentro de un objeto contenedor.
Tipo de valor devuelto
get_user_delegation_key
Obtenga una clave de delegación de usuarios con el fin de firmar tokens de SAS. Una credencial de token debe estar presente en el objeto de servicio para que esta solicitud se realice correctamente.
get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)Parámetros
Devoluciones
Clave de delegación de usuarios.
Tipo de valor devuelto
list_blob_names
Devuelve un generador para enumerar los nombres de blob en el contenedor especificado. El generador seguirá de forma diferida los tokens de continuación devueltos por el servicio y se detendrá cuando se hayan devuelto todos los blobs o se alcance num_results.
Si se especifica num_results y la cuenta tiene más de ese número de blobs, el generador tendrá un campo next_marker rellenado una vez que finalice. Este marcador se puede usar para crear un nuevo generador si se desean más resultados.
list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parámetros
- prefix
- str
Filtra los resultados para devolver solo los blobs cuyos nombres empiezan por el prefijo especificado.
- num_results
- int
Especifica el número máximo de blobs que se van a devolver, incluidos todos los elementos <xref:azure.storage.blob.blockblobservice.BlobPrefix>. Si la solicitud no especifica num_results o especifica un valor mayor que 5000, el servidor devolverá hasta 5000 elementos. Establecer num_results en un valor menor o igual que cero da como resultado el código de respuesta de error 400 (solicitud incorrecta).
- include
- Include
Especifica uno o varios conjuntos de datos adicionales que se van a incluir en la respuesta.
- delimiter
- str
Cuando la solicitud incluye este parámetro, la operación devuelve un BlobPrefix elemento de la lista de resultados que actúa como marcador de posición para todos los blobs cuyos nombres comienzan con la misma subcadena hasta la apariencia del carácter delimitador. El delimitador puede ser un carácter o una cadena.
- marker
- str
Un token de continuación opaco. Este valor se puede recuperar del campo next_marker de un objeto generador anterior si se especificó num_results y ese generador ha terminado de enumerar los resultados. Si se especifica, este generador comenzará a devolver resultados desde el punto en el que se detuvo el generador anterior.
list_blobs
Devuelve un generador para enumerar los blobs en el contenedor especificado. El generador seguirá de forma diferida los tokens de continuación devueltos por el servicio y se detendrá cuando se devuelvan todos los blobs o num_results se alcance.
Si se especifica num_results y la cuenta tiene más de ese número de blobs, el generador tendrá un campo next_marker rellenado una vez que termine. Este marcador se puede usar para crear un nuevo generador si se desean más resultados.
list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parámetros
- prefix
- str
Filtra los resultados para devolver solo los blobs cuyos nombres empiezan por el prefijo especificado.
- num_results
- int
Especifica el número máximo de blobs que se van a devolver, incluidos todos los elementos <xref:azure.storage.blob.blockblobservice.BlobPrefix>. Si la solicitud no especifica num_results o especifica un valor mayor que 5000, el servidor devolverá hasta 5000 elementos. Establecer num_results en un valor menor o igual que cero da como resultado el código de respuesta de error 400 (solicitud incorrecta).
- include
- Include
Especifica uno o varios conjuntos de datos adicionales que se van a incluir en la respuesta.
- delimiter
- str
Cuando la solicitud incluye este parámetro, la operación devuelve un BlobPrefix elemento de la lista de resultados que actúa como marcador de posición para todos los blobs cuyos nombres comienzan con la misma subcadena hasta la apariencia del carácter delimitador. El delimitador puede ser un carácter o una cadena.
- marker
- str
Un token de continuación opaco. Este valor se puede recuperar del campo next_marker de un objeto generador anterior si se especificó num_results y ese generador ha terminado de enumerar los resultados. Si se especifica, este generador comenzará a devolver resultados desde el punto donde se detuvo el generador anterior.
list_containers
Devuelve un generador para enumerar los contenedores de la cuenta especificada. El generador seguirá de forma diferida los tokens de continuación devueltos por el servicio y se detendrá cuando se devuelvan todos los contenedores o num_results se alcance.
Si se especifica num_results y la cuenta tiene más de ese número de contenedores, el generador tendrá un campo next_marker rellenado una vez que termine. Este marcador se puede usar para crear un nuevo generador si se desean más resultados.
list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)Parámetros
- prefix
- str
Filtra los resultados para devolver solo los contenedores cuyos nombres comienzan por el prefijo especificado.
- num_results
- int
Especifica el número máximo de contenedores que se van a devolver. Una única solicitud de lista puede devolver hasta 1000 contianers y potencialmente un token de continuación que se debe seguir para obtener resutls adicionales.
- include_metadata
- bool
Especifica que los metadatos del contenedor se devuelven en la respuesta.
- marker
- str
Un token de continuación opaco. Este valor se puede recuperar del campo next_marker de un objeto generador anterior si se especificó num_results y ese generador ha terminado de enumerar los resultados. Si se especifica, este generador comenzará a devolver resultados desde el punto donde se detuvo el generador anterior.
make_blob_url
Crea la dirección URL para acceder a un blob.
make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)Parámetros
- protocol
- str
Protocolo que se va a usar: "http" o "https". Si no se especifica, usa el protocolo especificado cuando se inicializó BaseBlobService.
- sas_token
- str
Token de firma de acceso compartido creado con generate_shared_access_signature.
- snapshot
- str
Valor de cadena que identifica de forma única la instantánea. El valor de este parámetro de consulta indica la versión de instantánea.
Devoluciones
Dirección URL de acceso de blob.
Tipo de valor devuelto
make_container_url
Crea la dirección URL para acceder a un contenedor.
make_container_url(container_name, protocol=None, sas_token=None)Parámetros
- protocol
- str
Protocolo que se va a usar: "http" o "https". Si no se especifica, usa el protocolo especificado cuando se inicializó BaseBlobService.
- sas_token
- str
Token de firma de acceso compartido creado con generate_shared_access_signature.
Devoluciones
dirección URL de acceso del contenedor.
Tipo de valor devuelto
put_block
Crea un nuevo bloque que se confirmará como parte de un blob.
put_block(container_name, blob_name, block, block_id, validate_content=False, lease_id=None, timeout=None, cpk=None)Parámetros
- block_id
- str
Valor de cadena que identifica el bloque. La cadena debe tener un tamaño menor o igual que 64 bytes. Para un blob determinado, el block_id debe tener el mismo tamaño para cada bloque.
- validate_content
- bool
Si es true, calcula un hash MD5 del contenido del bloque. El servicio de almacenamiento comprueba el hash del contenido que ha llegado con el hash que se envió. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (valor predeterminado) ya se validará. Tenga en cuenta que este hash MD5 no se almacena con el blob.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
put_block_from_url
Crea un nuevo bloque que se confirmará como parte de un blob.
put_block_from_url(container_name, blob_name, copy_source_url, block_id, source_range_start=None, source_range_end=None, source_content_md5=None, lease_id=None, timeout=None, cpk=None)Parámetros
- copy_source_url
- str
Dirección URL de los datos de origen. Puede apuntar a cualquier blob o archivo de Azure, que sea público o tenga asociada una firma de acceso compartido.
- source_range_start
- int
Esto indica el inicio del intervalo de bytes (inclusive) que se debe tomar del origen de copia.
- source_range_end
- int
Esto indica el final del intervalo de bytes (inclusive) que se debe tomar del origen de copia.
- block_id
- str
Valor de cadena que identifica el bloque. La cadena debe tener un tamaño menor o igual que 64 bytes. Para un blob determinado, el block_id debe tener el mismo tamaño para cada bloque.
- source_content_md5
- str
Si se da, el servicio calculará el hash MD5 del contenido del bloque y comparará con este valor.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
put_block_list
Escribe un blob especificando la lista de identificadores de bloque que conforman el blob. Para poder escribirse como parte de un blob, un bloque debe haberse escrito correctamente en el servidor en una operación Put Block anterior.
Puede llamar a Put Block List para actualizar un blob cargando solo los bloques que han cambiado y, a continuación, confirmando los bloques nuevos y existentes juntos. Puede hacerlo especificando si se debe confirmar un bloque de la lista de bloques confirmados o de la lista de bloques sin confirmar, o bien confirmar la versión del bloque que se ha cargado en último lugar, independientemente de la lista a la que pertenezca.
put_block_list(container_name, blob_name, block_list, content_settings=None, metadata=None, validate_content=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)Parámetros
- block_list
- list(BlobBlock)
Lista de que contiene los identificadores de <xref:azure.storeage.blob.models.BlobBlock> bloque y el estado de bloque.
- content_settings
- ContentSettings
Objeto ContentSettings usado para establecer propiedades en el blob.
Pares nombre-valor asociados al blob como metadatos.
- validate_content
- bool
Si es true, calcula un hash MD5 del contenido de la lista de bloques. El servicio de almacenamiento comprueba el hash del contenido de la lista de bloqueos que ha llegado con el hash que se envió. Esto es principalmente útil para detectar bitflips en la conexión si el uso de http en lugar de https como https (valor predeterminado) ya se validará. Tenga en cuenta que esta comprobación está asociada con el contenido de la lista de bloques y no con el contenido del propio blob.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
- standard_blob_tier
- StandardBlobTier
Valor de nivel de blob estándar en el que se va a establecer el blob. Para esta versión de la biblioteca, esto solo se aplica a blobs en bloques en cuentas de almacenamiento estándar.
Devoluciones
ETag y propiedades modificadas por última vez para el blob en bloques actualizado
Tipo de valor devuelto
release_blob_lease
Libera la concesión. La concesión se puede liberar si el identificador de concesión especificado en la solicitud coincide con el que está asociado al blob. Liberar la concesión permite a otro cliente adquirir inmediatamente la concesión sobre el blob en cuanto finaliza la operación de liberación.
release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parámetros
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
release_container_lease
Liberar la concesión. La concesión se puede liberar si el lease_id especificado coincide con el asociado al contenedor. Liberar la concesión permite a otro cliente adquirir inmediatamente la concesión sobre el contenedor en cuanto finaliza la operación de liberación.
release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parámetros
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
renew_blob_lease
Renueva la concesión. La concesión se puede renovar si el identificador de concesión especificado en la solicitud coincide con el que está asociado al blob. Tenga en cuenta que la concesión se puede renovar incluso si ha expirado, siempre que el blob no se haya modificado o concedido de nuevo desde la caducidad de la concesión. Cuando se renueva una concesión, el reloj que controla su duración se reinicia.
renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parámetros
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y producirá un error en la operación si existe.
Devoluciones
str
renew_container_lease
Renueva la concesión. La concesión se puede renovar si el identificador de concesión especificado coincide con el asociado al contenedor. Tenga en cuenta que la concesión se puede renovar incluso si ha expirado, siempre que el contenedor no se haya concedido de nuevo desde la caducidad de la concesión. Cuando se renueva una concesión, el reloj que controla su duración se reinicia.
renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parámetros
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
Devoluciones
str
set_blob_metadata
Establece los metadatos definidos por el usuario para el blob especificado como uno o varios pares de nombre y valor.
set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parámetros
Dict que contiene pares nombre y valor. Cada llamada a esta operación reemplaza todos los metadatos existentes adjuntados al blob. Para quitar todos los metadatos del blob, llame a esta operación sin encabezados de metadatos.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si el valor de ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
Devoluciones
ETag y las propiedades modificadas por última vez para el blob actualizado
Tipo de valor devuelto
set_blob_properties
Establece las propiedades del sistema en el blob. Si se establece una propiedad para el content_settings, se invalidarán todas las propiedades.
set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parámetros
- content_settings
- ContentSettings
Objeto ContentSettings usado para establecer propiedades de blob.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si el valor de ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
Devoluciones
ETag y las propiedades modificadas por última vez para el blob actualizado
Tipo de valor devuelto
set_blob_service_properties
Establece las propiedades de Blob service de una cuenta de almacenamiento, incluido Azure Storage Analytics. Si un elemento (por ejemplo, Registro) se deja como None, se conservan los valores existentes en el servicio para esa funcionalidad.
set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)Parámetros
- hour_metrics
- Metrics
La configuración de métricas de hora proporciona un resumen de las estadísticas de solicitud agrupadas por API en agregados por hora para blobs.
- minute_metrics
- Metrics
La configuración de métricas por minuto proporciona estadísticas de solicitud para cada minuto para los blobs.
- cors
- list(CorsRule)
Puede incluir hasta cinco elementos CorsRule en la lista. Si se especifica una lista vacía, se eliminarán todas las reglas de CORS y CORS se deshabilitará para el servicio.
- target_version
- str
Indica la versión predeterminada que se va a usar para las solicitudes si no se especifica la versión de una solicitud entrante.
- delete_retention_policy
- DeleteRetentionPolicy
La directiva de retención de eliminación especifica si se deben conservar los blobs eliminados. También especifica el número de días y versiones del blob que se van a conservar.
- static_website
- StaticWebsite
Especifica si la característica de sitio web estático está habilitada y, si es así, indica el documento de índice y el documento de error 404 que se va a usar.
set_container_acl
Establece los permisos para el contenedor especificado o las directivas de acceso almacenadas que se pueden usar con firmas de acceso compartido. Los permisos indican si el acceso a los blobs de un contenedor es público.
set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parámetros
- signed_identifiers
- dict(str, AccessPolicy)
Diccionario de directivas de acceso que se van a asociar al contenedor. El diccionario puede contener hasta 5 elementos. Un diccionario vacío borrará las directivas de acceso establecidas en el servicio.
- public_access
- PublicAccess
Entre los valores posibles se incluyen: contenedor, blob.
- lease_id
- str
Si se especifica, set_container_acl solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.
- if_modified_since
- datetime
Valor datetime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si el recurso se ha modificado desde la fecha y hora especificadas.
- if_unmodified_since
- datetime
Valor datetime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
Devoluciones
ETag y propiedades modificadas por última vez para el contenedor actualizado
Tipo de valor devuelto
set_container_metadata
Establece uno o varios pares nombre-valor definidos por el usuario para el contenedor especificado. Cada llamada a esta operación reemplaza todos los metadatos existentes adjuntados al contenedor. Para quitar todos los metadatos del contenedor, llame a esta operación sin dict de metadatos.
set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)Parámetros
Un dict que contiene pares nombre-valor que se van a asociar al contenedor como metadatos. Ejemplo: {'category':'test'}
- lease_id
- str
Si se especifica, set_container_metadata solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
Devoluciones
ETag y propiedades modificadas por última vez para el contenedor actualizado
Tipo de valor devuelto
set_proxy
Establece el host y el puerto del servidor proxy para la tunelización HTTP CONNECT.
set_proxy(host, port, user=None, password=None)Parámetros
set_standard_blob_tier
Establece los niveles de blob en bloques en el blob. Esta API solo se admite para blobs en bloques en cuentas de almacenamiento estándar.
:p aram RehydratePriority rehydrate_priority: indica la prioridad con la que rehidratar un blob archivado.
set_standard_blob_tier(container_name, blob_name, standard_blob_tier, timeout=None, rehydrate_priority=None)Parámetros
- standard_blob_tier
- StandardBlobTier
Valor de nivel de blob estándar en el que se va a establecer el blob. Para esta versión de la biblioteca, esto solo se aplica a blobs en bloques en cuentas de almacenamiento estándar.
- timeout
- int
El parámetro de tiempo de espera se expresa en segundos. Este método puede realizar varias llamadas al servicio de Azure y el tiempo de espera se aplicará a cada llamada individualmente.
- rehydrate_priority
snapshot_blob
Crea una instantánea de solo lectura de un blob.
snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)Parámetros
Especifica un par nombre-valor definido por el usuario asociado al blob. Si no se especifica ningún par nombre-valor, la operación copiará los metadatos del blob base en la instantánea. Si se especifican uno o varios pares nombre-valor, la instantánea se crea con los metadatos especificados, y los metadatos no se copian del blob base.
- if_modified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si se ha modificado el recurso desde la hora especificada.
- if_unmodified_since
- datetime
Un valor DateTime. Azure espera que el valor de fecha pasado sea UTC. Si se incluye la zona horaria, las fechas y horas no UTC se convertirán a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC. Especifique este encabezado para realizar la operación solo si no se ha modificado el recurso desde la fecha u hora especificada.
- if_match
- str
Valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.
- if_none_match
- str
Un valor ETag o el carácter comodín (). Especifique este encabezado para realizar la operación solo si el valor de ETag del recurso no coincide con el valor especificado. Especifique el carácter comodín () para realizar la operación solo si el recurso no existe y produce un error en la operación si existe.
Cifra los datos en el lado del servicio con la clave especificada. El uso de claves proporcionadas por el cliente debe realizarse a través de HTTPS. Como la propia clave de cifrado se proporciona en la solicitud, se debe establecer una conexión segura para transferir la clave.
Devoluciones
propiedades de instantánea
Tipo de valor devuelto
undelete_blob
La operación undelete Blob restaura el contenido y los metadatos del blob o la instantánea eliminados temporalmente. Si se intenta recuperar un blob o una instantánea que no se elimina temporalmente, se realizará correctamente sin realizar ningún cambio.
undelete_blob(container_name, blob_name, timeout=None)Parámetros
Atributos
protocol
request_session
socket_timeout
MAX_BLOCK_SIZE
MAX_BLOCK_SIZE = 4194304MAX_CHUNK_GET_SIZE
MAX_CHUNK_GET_SIZE = 4194304MAX_SINGLE_GET_SIZE
MAX_SINGLE_GET_SIZE = 33554432MAX_SINGLE_PUT_SIZE
MAX_SINGLE_PUT_SIZE = 67108864MIN_LARGE_BLOCK_UPLOAD_THRESHOLD
MIN_LARGE_BLOCK_UPLOAD_THRESHOLD = 4194305
Azure SDK for Python