blob Paquete

  • Referencia

Paquetes

aio

Clases

AccessPolicy

Clase de directiva de acceso usada por el conjunto y obtención de métodos de directiva de acceso en cada servicio.

Una directiva de acceso almacenada puede especificar la hora de inicio, la hora de expiración y los permisos para las firmas de acceso compartido con las que está asociada. En función de cómo quiera controlar el acceso al recurso, puede especificar todos estos parámetros dentro de la directiva de acceso almacenada y omitirlos de la dirección URL de la firma de acceso compartido. De esta forma, podrá modificar el comportamiento de la firma asociada en cualquier momento, así como revocarla. O puede especificar uno o más de los parámetros de la directiva de acceso en la directiva de acceso almacenada y el resto en la dirección URL. Por último, puede especificar todos los parámetros en la dirección URL. En este caso, puede utilizar la directiva de acceso almacenada para revocar la firma, pero no para modificar su comportamiento.

Es preciso que la firma de acceso compartido y la directiva de acceso almacenada, en su conjunto, incluyan todos los campos necesarios para autenticar la firma. Si falta alguno de los campos necesarios, la solicitud producirá un error. Asimismo, si un campo se especifica en la dirección URL de la firma de acceso compartido y en la directiva de acceso almacenada, la solicitud producirá un error con el código de estado 400 (solicitud incorrecta).
AccountSasPermissions

ResourceTypes Clase que se va a usar con generate_account_sas función y para accessPolicies usada con set_*_acl. Hay dos tipos de SAS que se pueden usar para conceder acceso a los recursos. Uno es conceder acceso a un recurso específico (específico del recurso). Otro es conceder acceso a todo el servicio para una cuenta específica y permitir determinadas operaciones basadas en perms que se encuentran aquí.
ArrowDialect

campo de un esquema de flecha.

Todos los parámetros necesarios deben rellenarse para enviarlos a Azure.
BlobAnalyticsLogging

Configuración de registro de Azure Analytics.
BlobBlock

Clase BlockBlob Block.
BlobClient

Un cliente para interactuar con un blob específico, aunque es posible que ese blob aún no exista.

Para obtener más configuración opcional, haga clic aquí.
BlobLeaseClient

Crea un nuevo BlobLeaseClient.

Este cliente proporciona operaciones de concesión en BlobClient o ContainerClient.
BlobPrefix

Iterable de propiedades de blob.

Se devuelve de walk_blobs cuando se usa un delimitador. Se puede considerar como un directorio de blobs virtuales.
BlobProperties

Propiedades de blob.
BlobQueryError

El error se produjo durante la operación de consulta rápida.
BlobQueryReader

Objeto de streaming para leer los resultados de la consulta.
BlobSasPermissions

Clase BlobSasPermissions que se va a usar con la generate_blob_sas función .
BlobServiceClient

Un cliente para interactuar con Blob Service en el nivel de cuenta.

Este cliente proporciona operaciones para recuperar y configurar las propiedades de la cuenta, así como enumerar, crear y eliminar contenedores dentro de la cuenta. En el caso de las operaciones relacionadas con un contenedor o blob específico, los clientes de esas entidades también se pueden recuperar mediante las funciones get_client .

Para obtener más configuración opcional, haga clic aquí.
ContainerClient

Un cliente para interactuar con un contenedor específico, aunque es posible que ese contenedor aún no exista.

Para las operaciones relacionadas con un blob específico dentro de este contenedor, se puede recuperar un cliente de blobs mediante la get_blob_client función .

Para obtener más configuración opcional, haga clic aquí.
ContainerEncryptionScope

Configuración de ámbito de cifrado predeterminada para un contenedor.

Este ámbito se usa implícitamente para todas las escrituras futuras dentro del contenedor, pero se puede invalidar por operación de blob.

Novedad de la versión 12.2.0.
ContainerProperties

Clase de propiedades del contenedor de blobs.

Las instancias devueltas ContainerProperties exponen estos valores a través de una interfaz de diccionario, por ejemplo: container_props["last_modified"]. Además, el nombre del contenedor está disponible como container_props["name"].
ContainerSasPermissions

Clase ContainerSasPermissions que se va a usar con la generate_container_sas función y para accessPolicies usada con set_container_access_policy.
ContentSettings

Configuración de contenido de un blob.
CopyProperties

Propiedades de copia de blobs.

Estas propiedades serán None si este blob nunca ha sido el destino en una operación copiar blob o si este blob se ha modificado después de una operación de copia de blob concluida, por ejemplo, mediante Establecer propiedades de blob, cargar blob o confirmar lista de bloques.
CorsRule

CORS es una característica de HTTP que permite que una aplicación web que se ejecuta en un dominio tenga acceso a recursos de otro dominio. Los exploradores web implementan una restricción de seguridad denominada directiva del mismo origen que impide que una página web llame a las API de otro dominio diferente; CORS proporciona una forma segura de permitir que un dominio (el dominio de origen) llame a las API de otro dominio.
CustomerProvidedEncryptionKey

Todos los datos de Azure Storage se cifran en reposo mediante una clave de cifrado de nivel de cuenta. En las versiones 2018-06-17 y posteriores, puede administrar la clave que se usa para cifrar el contenido del blob y los metadatos de la aplicación por blob proporcionando una clave de cifrado AES-256 en las solicitudes al servicio de almacenamiento.

Cuando se usa una clave proporcionada por el cliente, Azure Storage no administra ni conserva la clave. Al escribir datos en un blob, la clave proporcionada se usa para cifrar los datos antes de escribirlos en el disco. Se escribe un hash SHA-256 de la clave de cifrado junto con el contenido del blob y se usa para comprobar que todas las operaciones posteriores en el blob usan la misma clave de cifrado. Este hash no se puede usar para recuperar la clave de cifrado ni descifrar el contenido del blob. Al leer un blob, la clave proporcionada se usa para descifrar los datos después de leerlos desde el disco. En ambos casos, la clave de cifrado proporcionada se descarta de forma segura en cuanto se completa el proceso de cifrado o descifrado.
DelimitedJsonDialect

Define la serialización JSON de entrada o salida para una consulta de datos de blob.

delimitador de palabra clave str: el carácter separador de línea, el valor predeterminado es '

'
DelimitedTextDialect

Define la serialización de entrada o salida delimitada (CSV) para una solicitud de consulta de blob.
ExponentialRetry

Reintento exponencial.

Construye un objeto de reintento exponencial. El initial_backoff se usa para el primer reintento. Los reintentos posteriores se reintentan después de initial_backoff + increment_power^retry_count segundos.
FilteredBlob

Información del blob de una llamada API de blobs de filtro.
ImmutabilityPolicy

Parámetros opcionales para establecer la directiva de inmutabilidad de un blob, una instantánea de blob o una versión de blob.

Novedad de la versión 12.10.0: Se introdujo en la versión de API "2020-10-02".
LeaseProperties

Propiedades de concesión de blobs.
LinearRetry

Reintento lineal.

Construye un objeto de reintento lineal.
LocationMode

Especifica la ubicación a la que se debe enviar la solicitud. Este modo solo se aplica a las cuentas de RA-GRS que permiten el acceso de lectura secundario. Todos los demás tipos de cuenta deben usar PRIMARY.
Metrics

Resumen de las estadísticas de solicitud agrupadas por API en agregados de hora o minuto para blobs.
ObjectReplicationPolicy

Id. de directiva y identificadores de regla aplicados a un blob.
ObjectReplicationRule

Id. de directiva y identificadores de regla aplicados a un blob.
PageRange

Intervalo de páginas para blob en páginas.
PartialBatchErrorException

Hay un error parcial en las operaciones por lotes.
ResourceTypes

Especifica los tipos de recursos a los que se puede acceder con la SAS de la cuenta.
RetentionPolicy

La directiva de retención que determina cuánto tiempo deben conservarse los datos asociados.
StaticWebsite

Propiedades que permiten que una cuenta hospede un sitio web estático.
StorageStreamDownloader

Objeto de streaming que se va a descargar de Azure Storage.
UserDelegationKey

Representa una clave de delegación de usuario, proporcionada al usuario por Azure Storage en función de su token de acceso de Azure Active Directory.

Los campos se guardan como cadenas simples, ya que el usuario no tiene que interactuar con este objeto; para generar una SAS de identificación, el usuario simplemente puede pasarla a la API correcta.

Enumeraciones

ArrowType
BlobImmutabilityPolicyMode

Especifica el modo de directiva de inmutabilidad que se va a establecer en el blob. El servicio solo puede devolver "Mutable", no establezca en "Mutable".
BlobType
BlockState

Tipos de bloques de blobs en bloques.
PremiumPageBlobTier

Especifica el nivel de blob en páginas en el que se va a establecer el blob. Esto solo se aplica a los blobs en páginas en cuentas de Premium Storage. Eche un vistazo a: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets para obtener información detallada sobre las IOPS y el rendimiento correspondientes por PageBlobTier.
PublicAccess

Especifica si el acceso a los datos del contenedor es público, así como el nivel de acceso.
QuickQueryDialect

Especifica el dialecto de entrada y salida de consulta rápida.
RehydratePriority

Si un objeto está en estado de rehidratación pendiente, este encabezado se devuelve con prioridad de rehidratación. Los valores válidos son High y Standard.
SequenceNumberAction

Acciones de número de secuencia.
StandardBlobTier

Especifica el nivel de blob en el que se va a establecer el blob. Esto solo es aplicable a blobs en bloques en cuentas de almacenamiento estándar.
StorageErrorCode

Funciones

download_blob_from_url

Descargue el contenido de un blob en un archivo o secuencia local.

download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None

Parámetros

blob_url
str
Requerido

Identificador URI completo del blob. Esto también puede incluir un token de SAS.

output
str o <xref:<xref:writable stream.>>
Requerido

Dónde se deben descargar los datos. Puede tratarse de una ruta de acceso de archivo en la que escribir o un identificador de E/S abierto en el que se va a escribir.

credential
valor predeterminado: None

Credenciales con las que se va a autenticar. Esto es opcional si la dirección URL del blob ya tiene un token de SAS o el blob es público. El valor puede ser una cadena de token de SAS, una instancia de AzureSasCredential o AzureNamedKeyCredential de azure.core.credentials, una clave de acceso compartido de cuenta o una instancia de una clase TokenCredentials de azure.identity. Si el URI del recurso ya contiene un token de SAS, se omitirá en favor de una credencial explícita.

  • excepto en el caso de AzureSasCredential, donde los tokens de SAS en conflicto generarán un valor ValueError. Si usa una instancia de AzureNamedKeyCredential, "name" debe ser el nombre de la cuenta de almacenamiento y "key" debe ser la clave de la cuenta de almacenamiento.
overwrite
bool

Si el archivo local debe sobrescribirse si ya existe. El valor predeterminado es False , en cuyo caso se generará un ValorError si el archivo ya existe. Si se establece en True, se intentará escribir en el archivo existente. Si se pasa un identificador de secuencia, este valor se omite.

max_concurrency
int

Número de conexiones paralelas con las que se va a descargar.

offset
int

Inicio del intervalo de bytes que se va a usar para descargar una sección del blob. Debe establecerse si se proporciona longitud.

length
int

Número de bytes que se van a leer de la secuencia. Esto es opcional, pero debe proporcionarse para obtener un rendimiento óptimo.

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.

Tipo de valor devuelto

None

generate_account_sas

Genera una firma de acceso compartido para blob service.

Use la firma devuelta con el parámetro de credencial de cualquier BlobServiceClient, ContainerClient o BlobClient.

generate_account_sas(account_name: str, account_key: str, resource_types: ResourceTypes | str, permission: AccountSasPermissions | str, expiry: datetime | str | None, start: datetime | str | None = None, ip: str | None = None, **kwargs: Any) -> str

Parámetros

account_name
str
Requerido

Nombre de la cuenta de almacenamiento que se usa para generar la firma de acceso compartido.

account_key
str
Requerido

La clave de cuenta, también denominada clave compartida o clave de acceso, para generar la firma de acceso compartido.

resource_types
str o ResourceTypes
Requerido

Especifica los tipos de recursos a los que se puede acceder con la SAS de la cuenta.

permission
str o AccountSasPermissions
Requerido

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 contiene este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada.

expiry
datetime o str
Requerido

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 contiene este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada. Azure siempre convertirá los valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.

start
datetime o str
valor predeterminado: None

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á los valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.

ip
str
valor predeterminado: None

Especifica una dirección IP o un intervalo de direcciones IP desde las que se van a aceptar las 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, especificar ip=168.1.5.65 o ip=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.

encryption_scope
str

Especifica el ámbito de cifrado de una solicitud realizada para que todas las operaciones de escritura se cifren.

Devoluciones

Un token de firma de acceso compartido (sas).

Tipo de valor devuelto

str

generate_blob_sas

Genera una firma de acceso compartido para un blob.

Use la firma devuelta con el parámetro de credencial de cualquier BlobServiceClient, ContainerClient o BlobClient.

generate_blob_sas(account_name: str, container_name: str, blob_name: str, snapshot: str | None = None, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: BlobSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parámetros

account_name
str
Requerido

Nombre de la cuenta de almacenamiento que se usa para generar la firma de acceso compartido.

container_name
str
Requerido

nombre del contenedor.

blob_name
str
Requerido

Nombre del blob.

snapshot
str
valor predeterminado: None

Un identificador de instantánea de blob opcional.

account_key
str
valor predeterminado: None

La clave de cuenta, también denominada clave compartida o clave de acceso, para generar la firma de acceso compartido. Se deben especificar account_key o user_delegation_key .

user_delegation_key
UserDelegationKey
valor predeterminado: None

En lugar de una clave compartida 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 mediante una llamada a get_user_delegation_key. Cuando está presente, la SAS se firma con la clave de delegación de usuarios en su lugar.

permission
str o BlobSasPermissions
valor predeterminado: None

Permisos asociados a la firma de acceso compartido. El usuario está restringido a las operaciones permitidas por los permisos. Los permisos deben ordenarse racwdxytmei. Obligatorio a menos que se especifique un identificador que haga referencia a una directiva de acceso almacenada que contiene este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada.

expiry
datetime o str
valor predeterminado: None

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 contiene este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada. Azure siempre convertirá los valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.

start
datetime o str
valor predeterminado: None

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á los valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.

policy_id
str
valor predeterminado: None

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

ip
str
valor predeterminado: None

Especifica una dirección IP o un intervalo de direcciones IP desde las que se van a aceptar las 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, especificar ip=168.1.5.65 o ip=168.1.5.60-168.1.5.70 en la SAS restringe la solicitud a esas direcciones IP.

version_id
str

Un identificador de versión de blob opcional. Este parámetro solo es aplicable a las cuentas de almacenamiento habilitadas para el control de versiones. Tenga en cuenta que el parámetro de consulta "versionid" no se incluye en la SAS de salida. Por lo tanto, proporcione el parámetro "version_id" a cualquier API al usar la SAS de salida para funcionar en una versión específica.

Novedad de la versión 12.4.0: este argumento de palabra clave se introdujo en la versión de API "2019-12-12".

protocol
str

Especifica el protocolo permitido para una solicitud realizada. El valor predeterminado es https.

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 de encabezado de respuesta para Content-Disposition cuando se accede al recurso mediante esta firma de acceso compartido.

content_encoding
str

Valor de encabezado de respuesta para Content-Encoding cuando se accede al recurso mediante esta firma de acceso compartido.

content_language
str

Valor de encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.

content_type
str

Valor de encabezado de respuesta para Content-Type cuando se obtiene acceso al recurso mediante esta firma de acceso compartido.

encryption_scope
str

Especifica el ámbito de cifrado de una solicitud realizada para que todas las operaciones de escritura se cifren.

correlation_id
str

Identificador de correlación para correlacionar los registros de auditoría de almacenamiento con los registros de auditoría usados por la entidad de seguridad que genera y distribuye la SAS. Esto solo se puede usar al generar una SAS con clave de delegación.

Devoluciones

Un token de firma de acceso compartido (sas).

Tipo de valor devuelto

str

generate_container_sas

Genera una firma de acceso compartido para un contenedor.

Use la firma devuelta con el parámetro de credencial de cualquier BlobServiceClient, ContainerClient o BlobClient.

generate_container_sas(account_name: str, container_name: str, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: ContainerSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parámetros

account_name
str
Requerido

Nombre de la cuenta de almacenamiento que se usa para generar la firma de acceso compartido.

container_name
str
Requerido

nombre del contenedor.

account_key
str
valor predeterminado: None

La clave de cuenta, también denominada clave compartida o clave de acceso, para generar la firma de acceso compartido. Se deben especificar account_key o user_delegation_key .

user_delegation_key
UserDelegationKey
valor predeterminado: None

En lugar de una clave compartida 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 mediante una llamada a get_user_delegation_key. Cuando está presente, la SAS se firma con la clave de delegación de usuarios en su lugar.

permission
str o ContainerSasPermissions
valor predeterminado: None

Permisos asociados a la firma de acceso compartido. El usuario está restringido a las operaciones permitidas por los permisos. Los permisos deben ordenarse racwdxyltfmei. Obligatorio a menos que se especifique un identificador que haga referencia a una directiva de acceso almacenada que contiene este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada.

expiry
datetime o str
valor predeterminado: None

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 contiene este campo. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada. Azure siempre convertirá los valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.

start
datetime o str
valor predeterminado: None

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á los valores a UTC. Si se pasa una fecha sin información de zona horaria, se supone que es UTC.

policy_id
str
valor predeterminado: None

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

ip
str
valor predeterminado: None

Especifica una dirección IP o un intervalo de direcciones IP desde las que se van a aceptar las 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, especificar ip=168.1.5.65 o ip=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.

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 de encabezado de respuesta para Content-Disposition cuando se accede al recurso mediante esta firma de acceso compartido.

content_encoding
str

Valor de encabezado de respuesta para Content-Encoding cuando se accede al recurso mediante esta firma de acceso compartido.

content_language
str

Valor de encabezado de respuesta para Content-Language cuando se accede al recurso mediante esta firma de acceso compartido.

content_type
str

Valor de encabezado de respuesta para Content-Type cuando se obtiene acceso al recurso mediante esta firma de acceso compartido.

encryption_scope
str

Especifica el ámbito de cifrado de una solicitud realizada para que todas las operaciones de escritura se cifren.

correlation_id
str

Identificador de correlación para correlacionar los registros de auditoría de almacenamiento con los registros de auditoría usados por la entidad de seguridad que genera y distribuye la SAS. Esto solo se puede usar al generar una SAS con clave de delegación.

Devoluciones

Un token de firma de acceso compartido (sas).

Tipo de valor devuelto

str

upload_blob_to_url

Carga de datos en una dirección URL determinada

Los datos se cargarán como un blob en bloques.

upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> Dict[str, Any]

Parámetros

blob_url
str
Requerido

Identificador URI completo del blob. Esto también puede incluir un token de SAS.

data
bytes o str o Iterable
Requerido

Datos que se van a cargar. Puede ser bytes, texto, un objeto iterable o similar a un archivo.

credential
valor predeterminado: None

Credenciales con las que se va a autenticar. Esto es opcional si la dirección URL del blob ya tiene un token de SAS. El valor puede ser una cadena de token de SAS, una instancia de AzureSasCredential o AzureNamedKeyCredential de azure.core.credentials, una clave de acceso compartido de cuenta o una instancia de una clase TokenCredentials de azure.identity. Si el URI del recurso ya contiene un token de SAS, se omitirá en favor de una credencial explícita.

  • excepto en el caso de AzureSasCredential, donde los tokens de SAS en conflicto generarán un valor ValueError. Si usa una instancia de AzureNamedKeyCredential, "name" debe ser el nombre de la cuenta de almacenamiento y "key" debe ser la clave de la cuenta de almacenamiento.
overwrite
bool

Si el blob que se va a cargar debe sobrescribir los datos actuales. Si es True, upload_blob_to_url sobrescribirá los datos existentes. Si se establece en False, se producirá un error en la operación con un resourceExistsError.

max_concurrency
int

Número de conexiones paralelas con las que se va a descargar.

length
int

Número de bytes que se van a leer de la secuencia. Esto es opcional, pero debe proporcionarse para obtener un rendimiento óptimo.

metadata
dict(str,str)

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.

encoding
str

Codificación que se va a usar si se proporciona texto como entrada. El valor predeterminado es UTF-8.

Devoluciones

Dict de propiedad actualizada por blobs (Etag y última modificación)

Tipo de valor devuelto

dict(str, Any)