BlobClient Classe

lease_id

str

ID proposta da concessão, em um formato de cadeia de caracteres GUID. O Serviço blob retornará 400 (solicitação inválida) se a ID de concessão proposta não estiver no formato correto.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

length

int

Tamanho do bloco em bytes.

validate_content

bool

Se for true, calculará um hash MD5 do conteúdo do bloco. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é valioso principalmente para detectar bitflips no fio se o uso de http em vez de https, como https (o padrão), já validará. Observe que esse hash MD5 não é armazenado com o blob.

maxsize_condition

int

Cabeçalho condicional opcional. O comprimento máximo em bytes permitido para o blob de acréscimo. Se a operação Anexar Bloco fizer com que o blob exceda esse limite ou se o tamanho do blob já for maior do que o valor especificado neste cabeçalho, a solicitação falhará com o erro MaxBlobSizeConditionNotMet (HTTP status código 412 – Falha na pré-condição).

appendpos_condition

int

Cabeçalho condicional opcional, usado apenas para a operação De bloco de acréscimo. Um número que indica o deslocamento de bytes a ser comparado. O Bloco de Acréscimo terá êxito somente se a posição de acréscimo for igual a esse número. Se não estiver, a solicitação falhará com o erro AppendPositionConditionNotMet (HTTP status código 412 – Falha na pré-condição).

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

encoding

str

O padrão é UTF-8.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

source_offset

int

Isso indica o início do intervalo de bytes (inclusivo) que deve ser obtido da origem da cópia.

source_length

int

Isso indica o fim do intervalo de bytes que deve ser obtido da origem da cópia.

source_content_md5

bytearray

Se fornecido, o serviço calculará o hash MD5 do conteúdo do bloco e será comparado com esse valor.

maxsize_condition

int

Cabeçalho condicional opcional. O comprimento máximo em bytes permitido para o blob de acréscimo. Se a operação Anexar Bloco fizer com que o blob exceda esse limite ou se o tamanho do blob já for maior que o valor especificado nesse cabeçalho, a solicitação falhará com o erro MaxBlobSizeConditionNotMet (HTTP status código 412 – Falha na pré-condição).

appendpos_condition

int

Cabeçalho condicional opcional, usado somente para a operação Anexar Bloco. Um número que indica o deslocamento de bytes a ser comparado. O Bloco de Acréscimo terá êxito somente se a posição de acréscimo for igual a esse número. Se não estiver, a solicitação falhará com o erro AppendPositionConditionNotMet (HTTP status código 412 – Falha na pré-condição).

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

O valor de ETag de destino ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência de destino a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

source_if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso de origem tiver sido modificado desde a hora especificada.

source_if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso de origem não tiver sido modificado desde a data/hora especificada.

source_etag

str

O valor de ETag de origem ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

source_match_condition

MatchConditions

A condição de correspondência de origem a ser usada na etag.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

source_authorization

str

Autentique-se como uma entidade de serviço usando um segredo do cliente para acessar um blob de origem. Verifique se "portador" é o prefixo da cadeia de caracteres source_authorization.

length

int

Número de bytes a serem usados para gravação em uma seção do blob. As páginas devem estar alinhadas com limites de 512 bytes, o deslocamento inicial deve ser um módulo de 512 e o comprimento deve ser um módulo de 512.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_sequence_number_lte

int

Se o número de sequência do blob for menor ou igual ao valor especificado, a solicitação continuará; caso contrário, ele falhará.

if_sequence_number_lt

int

Se o número de sequência do blob for menor que o valor especificado, a solicitação continuará; caso contrário, ele falhará.

if_sequence_number_eq

int

Se o número de sequência do blob for igual ao valor especificado, a solicitação continuará; caso contrário, ele falhará.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

content_settings

ContentSettings

Objeto ContentSettings usado para definir propriedades de blob. Usado para definir o tipo de conteúdo, a codificação, o idioma, a disposição, o md5 e o controle de cache.

metadata

dict[str, str]

Pares de nome-valor associados ao blob como metadados.

tags

dict(str, str)

Pares nome-valor associados ao blob como marca. As marcas diferenciam maiúsculas de minúsculas. O conjunto de marcas pode conter no máximo 10 marcas. As teclas de marca devem ter entre 1 e 128 caracteres e os valores de marca devem ter entre 0 e 256 caracteres. Os caracteres válidos de chave e valor de marca incluem: letras minúsculas e maiúsculas, dígitos (0-9), espaço ( >><<), mais (+), menos (-), ponto (.), solidus (/), dois-pontos (:), igual a (=), sublinhado (_)

Novo na versão 12.4.0.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

immutability_policy

ImmutabilityPolicy

Especifica a política de imutabilidade de um blob, instantâneo de blob ou versão de blob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

legal_hold

bool

Especificado se uma retenção legal deve ser definida no blob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

validate_content

bool

Se for true, calculará um hash MD5 do conteúdo da página. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é valioso principalmente para detectar bitflips na transmissão se usar http em vez de https, como https (o padrão), já será validado. Observe que esse hash MD5 não é armazenado com o blob.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob de destino com um valor correspondente.

Novo na versão 12.4.0.

standard_blob_tier

StandardBlobTier

Um valor de camada de blob padrão para o qual definir o blob. Para esta versão da biblioteca, isso só é aplicável a blobs de blocos em contas de armazenamento padrão.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

metadata

dict(str, str)

Pares de nome-valor associados ao blob como metadados.

tags

dict(str, str)

Pares nome-valor associados ao blob como marca. As marcas diferenciam maiúsculas de minúsculas. O conjunto de marcas pode conter no máximo 10 marcas. As teclas de marca devem ter entre 1 e 128 caracteres e os valores de marca devem ter entre 0 e 256 caracteres. Os caracteres válidos de chave e valor de marca incluem: letras minúsculas e maiúsculas, dígitos (0-9), espaço ( >><<), mais (+), menos (-), ponto (.), solidus (/), dois-pontos (:), igual a (=), sublinhado (_)

Novo na versão 12.4.0.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

immutability_policy

ImmutabilityPolicy

Especifica a política de imutabilidade de um blob, instantâneo de blob ou versão de blob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

legal_hold

bool

Especificado se uma retenção legal deve ser definida no blob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

content_settings

ContentSettings

Objeto ContentSettings usado para definir propriedades de blob. Usado para definir o tipo de conteúdo, a codificação, o idioma, a disposição, o md5 e o controle de cache.

metadata

dict(str, str)

Pares de nome-valor associados ao blob como metadados.

premium_page_blob_tier

PremiumPageBlobTier

Um valor da camada de blob de páginas para o qual definir o blob. A camada correlaciona-se ao tamanho do blob e ao número de IOPS permitidos. Isso só é aplicável a blobs de páginas em contas de armazenamento Premium.

tags

dict(str, str)

Pares nome-valor associados ao blob como marca. As marcas diferenciam maiúsculas de minúsculas. O conjunto de marcas pode conter no máximo 10 marcas. As teclas de marca devem ter entre 1 e 128 caracteres e os valores de marca devem ter entre 0 e 256 caracteres. Os caracteres válidos de chave e valor de marca incluem: letras minúsculas e maiúsculas, dígitos (0-9), espaço ( >><<), mais (+), menos (-), ponto (.), solidus (/), dois-pontos (:), igual a (=), sublinhado (_)

Novo na versão 12.4.0.

sequence_number

int

Somente para blobs de páginas. O número de sequência é um valor controlado pelo usuário que você pode usar para rastrear solicitações. O valor do número de sequência deve ficar entre 0 e 2^63 - 1. O valor padrão é 0.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

immutability_policy

ImmutabilityPolicy

Especifica a política de imutabilidade de um blob, instantâneo de blob ou versão de blob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

legal_hold

bool

Especificado se uma retenção legal deve ser definida no blob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob de destino com um valor correspondente.

Novo na versão 12.4.0.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

version_id

str

O parâmetro version id é um valor opaco DateTime que, quando presente, especifica a versão do blob a ser excluída.

Novo na versão 12.4.0.

Esse argumento palavra-chave foi introduzido na versão da API '2019-12-12'.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. Se especificado, delete_blob só terá êxito se a concessão do blob estiver ativa e corresponder a essa ID. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

length

int

Número de bytes a serem lidos do fluxo. Isso é opcional, mas deve ser fornecido para um desempenho ideal.

version_id

str

O parâmetro version id é um valor opaco DateTime que, quando presente, especifica a versão do blob a ser baixada.

Novo na versão 12.4.0.

Esse argumento palavra-chave foi introduzido na versão da API '2019-12-12'.

validate_content

bool

Se for true, calculará um hash MD5 para cada parte do blob. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é valioso principalmente para detectar bitflips na transmissão se usar http em vez de https, como https (o padrão), já será validado. Observe que esse hash MD5 não é armazenado com o blob. Observe também que, se habilitado, o algoritmo de upload com eficiência de memória não será usado porque a computação do hash MD5 requer buffer de blocos inteiros e isso derrota a finalidade do algoritmo com eficiência de memória.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. Se especificado, download_blob só terá êxito se a concessão do blob estiver ativa e corresponder a essa ID. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

max_concurrency

int

O número de conexões paralelas com as quais baixar.

encoding

str

Codificação para decodificar os bytes baixados. O padrão é Nenhum, ou seja, nenhuma decodificação.

progress_hook

Callable[[int, int], None]

Um retorno de chamada para acompanhar o progresso de um download de execução prolongada. A assinatura é function(current: int, total: int), em que current é o número de bytes transferidos até agora, e total é o tamanho total do download.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui. Esse método pode fazer várias chamadas para o serviço e o tempo limite será aplicado a cada chamada individualmente. várias chamadas para o serviço do Azure e o tempo limite será aplicado a cada chamada individualmente.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

credential

Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>

As credenciais com as quais autenticar. Isso é opcional se a URL da conta já tiver um token SAS ou se o cadeia de conexão já tiver valores de chave de acesso compartilhado. O valor pode ser uma cadeia de caracteres de token SAS, uma instância de um AzureSasCredential ou AzureNamedKeyCredential de azure.core.credentials, uma chave de acesso compartilhado de conta ou uma instância de uma classe TokenCredentials do azure.identity. Se o URI do recurso já contiver um token SAS, isso será ignorado em favor de uma credencial explícita

• exceto no caso do AzureSasCredential, em que os tokens SAS conflitantes gerarão um ValueError. Se estiver usando uma instância do AzureNamedKeyCredential, "name" deverá ser o nome da conta de armazenamento e "key" deverá ser a chave da conta de armazenamento.

snapshot

str

O blob opcional instantâneo no qual operar. Esse pode ser o instantâneo cadeia de caracteres de ID ou a resposta retornada de create_snapshot. Se especificado, isso substituirá o instantâneo na URL.

version_id

str

O parâmetro id de versão é um valor datetime opaco que, quando presente, especifica a versão do blob no qual operar.

container_name

str

O nome do contêiner para o blob.

blob_name

str

O nome do blob com o qual interagir.

snapshot

str

O blob opcional instantâneo no qual operar. Esse pode ser o instantâneo cadeia de caracteres de ID ou a resposta retornada de create_snapshot.

credential

Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>

As credenciais com as quais autenticar. Isso é opcional se a URL da conta já tiver um token SAS ou se o cadeia de conexão já tiver valores de chave de acesso compartilhado. O valor pode ser uma cadeia de caracteres de token SAS, uma instância de um AzureSasCredential ou AzureNamedKeyCredential de azure.core.credentials, uma chave de acesso compartilhado de conta ou uma instância de uma classe TokenCredentials do azure.identity. As credenciais fornecidas aqui terão precedência sobre as do cadeia de conexão. Se estiver usando uma instância do AzureNamedKeyCredential, "name" deverá ser o nome da conta de armazenamento e "key" deverá ser a chave da conta de armazenamento.

version_id

str

O parâmetro id de versão é um valor datetime opaco que, quando presente, especifica a versão do blob no qual operar.

version_id

str

O parâmetro id de versão é um valor datetime opaco que, quando presente, especifica a versão do blob para obter propriedades.

Novo na versão 12.4.0.

Esse argumento palavra-chave foi introduzido na versão da API '2019-12-12'.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob de destino com um valor correspondente. ex. "\"tagname\"='my tag'"

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob de destino com um valor correspondente.

Novo na versão 12.4.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

offset

int

Início do intervalo de bytes a ser usado para obter intervalos de página válidos. Se nenhum comprimento for fornecido, todos os bytes após o deslocamento serão pesquisados. As páginas devem estar alinhadas com limites de 512 bytes, o deslocamento inicial deve ser um módulo de 512 e o comprimento deve ser um módulo de 512.

length

int

Número de bytes a serem usados para obter intervalos de página válidos. Se o comprimento for fornecido, o deslocamento deverá ser fornecido. Esse intervalo retornará intervalos de página válidos desde a inicialização do deslocamento até o comprimento especificado. As páginas devem estar alinhadas com limites de 512 bytes, o deslocamento inicial deve ser um módulo de 512 e o comprimento deve ser um módulo de 512.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

length

int

Número de bytes a serem usados para obter intervalos de página válidos. Se o comprimento for fornecido, o deslocamento deverá ser fornecido. Esse intervalo retornará intervalos de página válidos desde a inicialização do deslocamento até o comprimento especificado. As páginas devem estar alinhadas com limites de 512 bytes, o deslocamento inicial deve ser um módulo de 512 e o comprimento deve ser um módulo de 512.

previous_snapshot_diff

str

O parâmetro diff instantâneo que contém um valor datetime opaco que especifica um blob anterior instantâneo a ser comparado com um instantâneo mais recente ou o blob atual.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

length

int

Número de bytes a serem usados para obter intervalos de página válidos. Se o comprimento for fornecido, o deslocamento deverá ser fornecido. Esse intervalo retornará intervalos de página válidos desde a inicialização do deslocamento até o comprimento especificado. As páginas devem estar alinhadas com limites de 512 bytes, o deslocamento inicial deve ser um módulo de 512 e o comprimento deve ser um módulo de 512.

previous_snapshot

str ou Dict[str, Any]

Um valor instantâneo que especifica que a resposta conterá apenas páginas que foram alteradas entre o blob de destino e os instantâneo anteriores. As páginas alteradas incluem páginas atualizadas e desmarcadas. O blob de destino pode ser um instantâneo, desde que o instantâneo especificado por previous_snapshot seja o mais antigo dos dois.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

results_per_page

int

O número máximo de intervalos de páginas a serem recuperados por chamada à API.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

on_error

Callable[BlobQueryError]

Uma função a ser chamada em quaisquer erros de processamento retornados pelo serviço.

blob_format

DelimitedTextDialect ou DelimitedJsonDialect ou QuickQueryDialect ou str

Opcional. Define a serialização dos dados armazenados atualmente no blob. O padrão é tratar os dados de blob como dados CSV formatados no dialeto padrão. Isso pode ser substituído por um DelimitedTextDialect personalizado ou DelimitedJsonDialect ou "ParquetDialect" (passado como uma cadeia de caracteres ou enumeração). Esses dialetos podem ser passados por suas respectivas classes, a enumeração QuickQueryDialect ou como uma cadeia de caracteres

output_format

DelimitedTextDialect ou DelimitedJsonDialect ou list[ArrowDialect] ou QuickQueryDialect ou str

Opcional. Define a serialização de saída para o fluxo de dados. Por padrão, os dados serão retornados, pois são representados no blob (formatos Parquet padrão para DelimitedTextDialect). Ao fornecer um formato de saída, os dados de blob serão reformatados de acordo com esse perfil. Esse valor pode ser um DelimitedTextDialect ou um DelimitedJsonDialect ou ArrowDialect. Esses dialetos podem ser passados por suas respectivas classes, a enumeração QuickQueryDialect ou como uma cadeia de caracteres

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

premium_page_blob_tier

PremiumPageBlobTier

Um valor de camada de blob de página para definir o blob. A camada se correlaciona ao tamanho do blob e ao número de IOPS permitidos. Isso só é aplicável a blobs de páginas em contas de armazenamento premium.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

version_id

str

O parâmetro version id é um valor opaco DateTime que, quando presente, especifica a versão do blob à qual adicionar marcas.

validate_content

bool

Se for true, calculará um hash MD5 do conteúdo das marcas. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é valioso principalmente para detectar bitflips na transmissão se usar http em vez de https, como https (o padrão), já será validado. Observe que esse hash MD5 não é armazenado com o blob.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob de destino com um valor correspondente. ex. "\"tagname\"='my tag'"

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

sequence_number

str

Essa propriedade define o número de sequência do blob. O número de sequência é uma propriedade controlada pelo usuário que você pode usar para monitorar solicitações e gerenciar problemas de simultaneidade.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, supõe-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

rehydrate_priority

RehydratePriority

Indica a prioridade com a qual reidratar um blob arquivado

version_id

str

O parâmetro id de versão é um valor datetime opaco que, quando presente, especifica a versão do blob a ser baixada.

Novo na versão 12.4.0.

Esse argumento palavra-chave foi introduzido na versão da API '2019-12-12'.

if_tags_match_condition

str

Especifique um SQL em que a cláusula em marcas de blob opere somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

data

Os dados do blob.

length

int

Tamanho do bloco.

validate_content

bool

Se for true, calculará um hash MD5 para cada parte do blob. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é valioso principalmente para detectar bitflips no fio se o uso de http em vez de https, como https (o padrão), já validará. Observe que esse hash MD5 não é armazenado com o blob. Observe também que, se habilitado, o algoritmo de carregamento com eficiência de memória não será usado porque a computação do hash MD5 requer buffer de blocos inteiros e isso derrota a finalidade do algoritmo com eficiência de memória.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

encoding

str

O padrão é UTF-8.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, confira aqui.

source_url

str

A URL.

source_offset

int

Início do intervalo de bytes a ser usado para o bloco. Deve ser definido se o comprimento da origem for fornecido.

source_length

int

O tamanho do bloco em bytes.

source_content_md5

bytearray

Especifique o md5 calculado para o intervalo de bytes que deve ser lido da origem da cópia.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

source_authorization

str

Autentique-se como uma entidade de serviço usando um segredo do cliente para acessar um blob de origem. Verifique se "portador" é o prefixo da cadeia de caracteres source_authorization.

metadata

dict(str, str)

Pares de nome-valor associados ao blob como metadados. Se nenhum par nome-valor for especificado, a operação copiará os metadados do blob ou arquivo de origem para o blob de destino. Se um ou mais pares nome-valor forem especificados, o blob de destino será criado com os metadados especificados e os metadados não serão copiados do blob ou arquivo de origem.

incremental_copy

bool

Copia o instantâneo do blob de páginas de origem para um blob de páginas de destino. O instantâneo é copiado de modo que apenas as alterações diferenciais entre as instantâneo copiadas anteriormente sejam transferidas para o destino. Os instantâneos copiados são cópias completas do instantâneo original e podem ser lidos ou copiados de como de costume. Usa False como padrão.

tags

dict(str, str) ou Literal["COPY"]

Pares nome-valor associados ao blob como marca. As marcas diferenciam maiúsculas de minúsculas. O conjunto de marcas pode conter no máximo 10 marcas. As teclas de marca devem ter entre 1 e 128 caracteres e os valores de marca devem ter entre 0 e 256 caracteres. Os caracteres válidos de chave e valor de marca incluem: letras minúsculas e maiúsculas, dígitos (0-9), espaço ( >><<), mais (+), menos (-), ponto (.), solidus (/), dois-pontos (:), igual a (=), sublinhado (_).

Em vez disso, o literal (que diferencia maiúsculas de minúsculas) "COPY" pode ser passado para copiar marcas do blob de origem. Essa opção só estará disponível quando incremental_copy=False e requires_sync=True.

Novo na versão 12.4.0.

immutability_policy

ImmutabilityPolicy

Especifica a política de imutabilidade de um blob, instantâneo de blob ou versão de blob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

legal_hold

bool

Especificado se uma retenção legal deve ser definida no blob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

source_if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho condicional para copiar o blob somente se o blob de origem tiver sido modificado desde a data/hora especificada.

source_if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho condicional para copiar o blob somente se o blob de origem não tiver sido modificado desde a data/hora especificada.

source_etag

str

O valor de ETag de origem ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

source_match_condition

MatchConditions

A condição de correspondência de origem a ser usada na etag.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho condicional para copiar o blob somente se o blob de destino tiver sido modificado desde a data/hora especificada. Se o blob de destino não tiver sido modificado, o serviço Blob retornará o código de status 412 (Falha na Pré-condição).

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho condicional para copiar o blob somente se o blob de destino não tiver sido modificado desde a data/hora especificada. Se o blob de destino tiver sido modificado, o serviço Blob retornará o código de status 412 (Falha na Pré-condição).

etag

str

O valor de ETag de destino ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência de destino a ser usada na etag.

destination_lease

BlobLeaseClient ou str

A ID da concessão especificada para esse cabeçalho deve corresponder à ID de concessão do blob de destino. Se a solicitação não incluir a ID de concessão ou não for válida, a operação falhará com o código de status 412 (Falha na Pré-condição).

source_lease

BlobLeaseClient ou str

Especifique isso para executar a operação Copiar Blob somente se a ID de concessão fornecida corresponder à ID de concessão ativa do blob de origem.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

premium_page_blob_tier

PremiumPageBlobTier

Um valor da camada de blob de páginas para o qual definir o blob. A camada correlaciona-se ao tamanho do blob e ao número de IOPS permitidos. Isso só é aplicável a blobs de páginas em contas de armazenamento Premium.

standard_blob_tier

StandardBlobTier

Um valor de camada de blob padrão para o qual definir o blob. Para esta versão da biblioteca, isso só é aplicável a blobs de blocos em contas de armazenamento padrão.

rehydrate_priority

RehydratePriority

Indica a prioridade com a qual reidratar um blob arquivado

seal_destination_blob

bool

Selo do blob de acréscimo de destino. Essa operação destina-se apenas ao blob de acréscimo.

Novo na versão 12.4.0.

requires_sync

bool

Impõe que o serviço não retornará uma resposta até que a cópia seja concluída.

source_authorization

str

Autentique-se como uma entidade de serviço usando um segredo do cliente para acessar um blob de origem. Verifique se "portador" é o prefixo da cadeia de caracteres source_authorization. Essa opção só estará disponível quando incremental_copy estiver definido como False e requires_sync estiver definido como True.

Novo na versão 12.9.0.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no blob copiado de sincronização. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.10.0.

blob_type

BlobType

O tipo do blob. Isso pode ser BlockBlob, PageBlob ou AppendBlob. O valor padrão é BlockBlob.

length

int

Número de bytes a serem lidos do fluxo. Isso é opcional, mas deve ser fornecido para um desempenho ideal.

metadata

dict(str, str)

Pares de nome-valor associados ao blob como metadados.

tags

dict(str, str)

Pares nome-valor associados ao blob como marca. As marcas diferenciam maiúsculas de minúsculas. O conjunto de marcas pode conter no máximo 10 marcas. As teclas de marca devem ter entre 1 e 128 caracteres e os valores de marca devem ter entre 0 e 256 caracteres. Os caracteres válidos de chave e valor de marca incluem: letras minúsculas e maiúsculas, dígitos (0-9), espaço ( >><<), mais (+), menos (-), ponto (.), solidus (/), dois-pontos (:), igual a (=), sublinhado (_)

Novo na versão 12.4.0.

overwrite

bool

Se o blob a ser carregado deve substituir os dados atuais. Se True, upload_blob substituirá os dados existentes. Se definido como False, a operação falhará com ResourceExistsError. A exceção acima é com Os tipos de blob de acréscimo: se definido como False e os dados já existirem, um erro não será gerado e os dados serão acrescentados ao blob existente. Se definido overwrite=True, o blob de acréscimo existente será excluído e um novo será criado. Usa False como padrão.

content_settings

ContentSettings

Objeto ContentSettings usado para definir propriedades de blob. Usado para definir o tipo de conteúdo, a codificação, o idioma, a disposição, o md5 e o controle de cache.

validate_content

bool

Se for true, calculará um hash MD5 para cada parte do blob. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é valioso principalmente para detectar bitflips na transmissão se usar http em vez de https, como https (o padrão), já será validado. Observe que esse hash MD5 não é armazenado com o blob. Observe também que, se habilitado, o algoritmo de upload com eficiência de memória não será usado porque a computação do hash MD5 requer buffer de blocos inteiros e isso derrota a finalidade do algoritmo com eficiência de memória.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. Se especificado, upload_blob só terá êxito se a concessão do blob estiver ativa e corresponder a essa ID. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

premium_page_blob_tier

PremiumPageBlobTier

Um valor da camada de blob de páginas para o qual definir o blob. A camada correlaciona-se ao tamanho do blob e ao número de IOPS permitidos. Isso só é aplicável a blobs de páginas em contas de armazenamento Premium.

standard_blob_tier

StandardBlobTier

Um valor de camada de blob padrão para o qual definir o blob. Para esta versão da biblioteca, isso só é aplicável a blobs de blocos em contas de armazenamento padrão.

immutability_policy

ImmutabilityPolicy

Especifica a política de imutabilidade de um blob, instantâneo de blob ou versão de blob. Atualmente, esse parâmetro da API upload_blob() é apenas para BlockBlob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

legal_hold

bool

Especificado se uma retenção legal deve ser definida no blob. Atualmente, esse parâmetro da API upload_blob() é apenas para BlockBlob.

Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.

maxsize_condition

int

Cabeçalho condicional opcional. O comprimento máximo em bytes permitido para o blob de acréscimo. Se a operação Anexar Bloco fizer com que o blob exceda esse limite ou se o tamanho do blob já for maior que o valor especificado nesse cabeçalho, a solicitação falhará com o erro MaxBlobSizeConditionNotMet (HTTP status código 412 – Falha na pré-condição).

max_concurrency

int

Número máximo de conexões paralelas a serem usadas quando o tamanho do blob exceder 64 MB.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

encoding

str

O padrão é UTF-8.

progress_hook

Callable[[int, Optional[int]], None]

Um retorno de chamada para acompanhar o progresso de um upload de execução prolongada. A assinatura é function(current: int, total: Optional[int]), em que current é o número de bytes transferidos até agora, e total é o tamanho do blob ou None se o tamanho for desconhecido.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui. Esse método pode fazer várias chamadas para o serviço e o tempo limite será aplicado a cada chamada individualmente.

overwrite

bool

Se o blob a ser carregado deve substituir os dados atuais. Se True, upload_blob substituirá os dados existentes. Se definido como False, a operação falhará com ResourceExistsError.

include_source_blob_properties

bool

Indica se as propriedades do blob de origem devem ser copiadas. O padrão é True.

tags

dict(str, str)

Pares nome-valor associados ao blob como marca. As marcas diferenciam maiúsculas de minúsculas. O conjunto de marcas pode conter no máximo 10 marcas. As teclas de marca devem ter entre 1 e 128 caracteres e os valores de marca devem ter entre 0 e 256 caracteres. Os caracteres válidos de chave e valor de marca incluem: letras minúsculas e maiúsculas, dígitos (0-9), espaço ( >><<), mais (+), menos (-), ponto (.), solidus (/), dois-pontos (:), igual a (=), sublinhado (_)

source_content_md5

bytearray

Especifique o md5 usado para verificar a integridade dos bytes de origem.

source_if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso de origem tiver sido modificado desde a hora especificada.

source_if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso de origem não tiver sido modificado desde a data/hora especificada.

source_etag

str

O valor de ETag de origem ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

source_match_condition

MatchConditions

A condição de correspondência de origem a ser usada na etag.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

O valor de ETag de destino ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência de destino a ser usada na etag.

destination_lease

BlobLeaseClient ou str

A ID da concessão especificada para esse cabeçalho deve corresponder à ID de concessão do blob de destino. Se a solicitação não incluir a ID de concessão ou não for válida, a operação falhará com o código de status 412 (Falha na Pré-condição).

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

content_settings

ContentSettings

Objeto ContentSettings usado para definir propriedades de blob. Usado para definir o tipo de conteúdo, a codificação, o idioma, a disposição, o md5 e o controle de cache.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

standard_blob_tier

StandardBlobTier

Um valor de camada de blob padrão para o qual definir o blob. Para esta versão da biblioteca, isso só é aplicável a blobs de blocos em contas de armazenamento padrão.

source_authorization

str

Autentique-se como uma entidade de serviço usando um segredo do cliente para acessar um blob de origem. Verifique se "portador" é o prefixo da cadeia de caracteres source_authorization.

offset

int

Início do intervalo de bytes a ser usado para gravar em uma seção do blob. As páginas devem estar alinhadas com limites de 512 bytes, o deslocamento inicial deve ser um módulo de 512 e o comprimento deve ser um módulo de 512.

length

int

Número de bytes a serem usados para gravação em uma seção do blob. As páginas devem estar alinhadas com limites de 512 bytes, o deslocamento inicial deve ser um módulo de 512 e o comprimento deve ser um módulo de 512.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

validate_content

bool

Se for true, calculará um hash MD5 do conteúdo da página. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é valioso principalmente para detectar bitflips na transmissão se usar http em vez de https, como https (o padrão), já será validado. Observe que esse hash MD5 não é armazenado com o blob.

if_sequence_number_lte

int

Se o número de sequência do blob for menor ou igual ao valor especificado, a solicitação continuará; caso contrário, ele falhará.

if_sequence_number_lt

int

Se o número de sequência do blob for menor que o valor especificado, a solicitação continuará; caso contrário, ele falhará.

if_sequence_number_eq

int

Se o número de sequência do blob for igual ao valor especificado, a solicitação continuará; caso contrário, ele falhará.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

Um valor de ETag ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

encoding

str

O padrão é UTF-8.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

offset

int

Início do intervalo de bytes a ser usado para gravar em uma seção do blob. As páginas devem estar alinhadas com limites de 512 bytes, o deslocamento inicial deve ser um módulo de 512 e o comprimento deve ser um módulo de 512.

length

int

Número de bytes a serem usados para gravação em uma seção do blob. As páginas devem estar alinhadas com limites de 512 bytes, o deslocamento inicial deve ser um módulo de 512 e o comprimento deve ser um módulo de 512.

source_offset

int

Isso indica o início do intervalo de bytes (inclusivo) que deve ser retirado da origem da cópia. O serviço lerá o mesmo número de bytes que o intervalo de destino (deslocamento de comprimento).

source_content_md5

bytes

Se fornecido, o serviço calculará o hash MD5 do conteúdo do bloco e será comparado com esse valor.

source_if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso de origem tiver sido modificado desde a hora especificada.

source_if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso de origem não tiver sido modificado desde a data/hora especificada.

source_etag

str

O valor de ETag de origem ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

source_match_condition

MatchConditions

A condição de correspondência de origem a ser usada na etag.

lease

BlobLeaseClient ou str

Obrigatório se o blob tiver uma concessão ativa. O valor pode ser um objeto BlobLeaseClient ou a ID de concessão como uma cadeia de caracteres.

if_sequence_number_lte

int

Se o número de sequência do blob for menor ou igual ao valor especificado, a solicitação continuará; caso contrário, ele falhará.

if_sequence_number_lt

int

Se o número de sequência do blob for menor que o valor especificado, a solicitação continuará; caso contrário, ele falhará.

if_sequence_number_eq

int

Se o número de sequência do blob for igual ao valor especificado, a solicitação continuará; caso contrário, ele falhará.

if_modified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a hora especificada.

if_unmodified_since

datetime

Um valor Datetime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário for incluído, todos os datetimes não UTC serão convertidos em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada.

etag

str

O valor de ETag de destino ou o caractere curinga (*). Usado para marcar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition.

match_condition

MatchConditions

A condição de correspondência de destino a ser usada na etag.

if_tags_match_condition

str

Especifique uma cláusula SQL em que as marcas de blob operem somente no blob com um valor correspondente. ex. "\"tagname\"='my tag'"

Novo na versão 12.4.0.

cpk

CustomerProvidedEncryptionKey

Criptografa os dados no lado do serviço com a chave fornecida. O uso de chaves fornecidas pelo cliente deve ser feito por HTTPS. Como a própria chave de criptografia é fornecida na solicitação, uma conexão segura deve ser estabelecida para transferir a chave.

encryption_scope

str

Um escopo de criptografia predefinido usado para criptografar os dados no serviço. Um escopo de criptografia pode ser criado usando a API de Gerenciamento e referenciado aqui por nome. Se um escopo de criptografia padrão tiver sido definido no contêiner, esse valor o substituirá se o escopo no nível do contêiner estiver configurado para permitir substituições. Caso contrário, um erro será gerado.

Novo na versão 12.2.0.

timeout

int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://zcusa.951200.xyz/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte aqui.

source_authorization

str

Autentique-se como uma entidade de serviço usando um segredo do cliente para acessar um blob de origem. Verifique se "portador" é o prefixo da cadeia de caracteres source_authorization.