BaseBlobService Classe
Esta é a classe principal que gere os recursos do Blob.
O serviço Blob armazena texto e dados binários como blobs na cloud. O serviço Blob oferece os seguintes três recursos: a conta de armazenamento, os contentores e os blobs. Na sua conta de armazenamento, os contentores fornecem uma forma de organizar conjuntos de blobs. Para obter mais informações, consulte: https://msdn.microsoft.com/en-us/library/azure/ee691964.aspx
:type ~azure.storage.common.TokenCredential
- Herança
-
BaseBlobService
Construtor
BaseBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)Parâmetros
- account_name
- str
O nome da conta de armazenamento. Isto é utilizado para autenticar pedidos assinados com uma chave de conta e para construir o ponto final de armazenamento. É necessário, a menos que seja dada uma cadeia de ligação ou se um domínio personalizado é utilizado com autenticação anónima.
- account_key
- str
A chave da conta de armazenamento. Isto é utilizado para autenticação de chave partilhada. Se não for especificado nenhum token de chave de conta ou sas, será utilizado o acesso anónimo.
- sas_token
- str
Um token de assinatura de acesso partilhado a utilizar para autenticar pedidos em vez da chave de conta. Se a chave da conta e o token sas forem ambos especificados, a chave de conta será utilizada para assinar. Se nenhum dos dois for especificado, será utilizado o acesso anónimo.
- is_emulated
- bool
Se pretende utilizar o emulador. A predefinição é Falso. Se especificado, substituirá todos os outros parâmetros para além da sessão de pedido e cadeia de ligação.
- endpoint_suffix
- str
O componente base do anfitrião do URL, menos o nome da conta. É predefinida para o Azure (core.windows.net). Substitua esta opção para utilizar a cloud da China (core.chinacloudapi.cn).
- custom_domain
- str
O domínio personalizado a utilizar. Isto pode ser definido no portal do Azure. Por exemplo, "www.mydomain.com".
- request_session
- <xref:requests.Session>
O objeto de sessão a utilizar para pedidos http.
- connection_string
- str
Se for especificado, esta ação substituirá todos os outros parâmetros para além da sessão de pedido. Veja http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ o formato cadeia de ligação
- socket_timeout
- int
Se for especificado, isto substituirá o tempo limite do socket predefinido. O tempo limite especificado é em segundos. Veja DEFAULT_SOCKET_TIMEOUT em _constants.py para obter o valor predefinido.
- token_credential
Uma credencial de token utilizada para autenticar pedidos HTTPS. O valor do token deve ser atualizado antes da expiração.
Variáveis
- MAX_SINGLE_GET_SIZE
- int
O tamanho do primeiro intervalo é executado por métodos get_blob_to_* se max_connections for superior a 1. Serão devolvidos menos dados se o blob for menor do que este.
- MAX_CHUNK_GET_SIZE
- int
O tamanho do intervalo subsequente é executado por métodos get_blob_to_* se max_connections for superior a 1 e o blob for maior do que MAX_SINGLE_GET_SIZE. Serão devolvidos menos dados se o resto do blob for menor do que este. Se estiver definido como superior a 4 MB, content_validation emitirá um erro se estiver ativado. No entanto, se não for desejado content_validation um tamanho superior a 4 MB pode ser ideal. A definição abaixo de 4 MB não é recomendada.
- key_encryption_key
- object
A chave-encriptação-chave opcionalmente fornecida pelo utilizador. Se for fornecido, será utilizado para encriptar/desencriptar em métodos suportados. Para métodos que exijam a desencriptação, o key_encryption_key OU a resolução tem de ser fornecida. Se ambos forem fornecidos, a resolução terá precedência. Tem de implementar os seguintes métodos para APIs que requerem encriptação: wrap_key(chave)– molda a chave especificada (bytes) com um algoritmo à escolha do utilizador. Devolve a chave encriptada como bytes. get_key_wrap_algorithm()– devolve o algoritmo utilizado para moldar a chave simétrica especificada. get_kid()– devolve um ID de chave de cadeia para esta chave de encriptação de chave. Tem de implementar os seguintes métodos para APIs que requerem desencriptação: unwrap_key(chave, algoritmo)– devolve a forma desembrulhada da chave simétrica especificada com o algoritmo especificado pela cadeia. get_kid()– devolve um ID de chave de cadeia para esta chave de encriptação de chave.
- key_resolver_function
- kid) (<xref:function>
Uma função para resolver as chaves opcionalmente fornecidas pelo utilizador. Se for fornecido, será utilizado para desencriptar em métodos suportados. Para métodos que exijam a desencriptação, o key_encryption_key OU a resolução tem de ser fornecida. Se ambos forem fornecidos, a resolução terá precedência. Utiliza a cadeia de carateres para devolver uma chave de encriptação de chaves que implementa a interface definida acima.
- require_encryption
- bool
Um sinalizador que pode ser definido para garantir que todas as mensagens carregadas com êxito para a fila e todas as que foram transferidas e lidas com êxito a partir da fila são/foram encriptadas enquanto estavam no servidor. Se este sinalizador estiver definido, todos os parâmetros necessários para encriptação/desencriptação têm de ser fornecidos. Veja os comentários acima no key_encryption_key e resolver.
Métodos
| abort_copy_blob |
Aborta uma operação de copy_blob pendente e deixa um blob de destino com comprimento zero e metadados completos. |
| acquire_blob_lease |
Pede uma nova concessão. Se o blob não tiver uma concessão ativa, o serviço Blob cria uma concessão no blob e devolve um novo ID de concessão. |
| acquire_container_lease |
Pede uma nova concessão. Se o contentor não tiver uma concessão ativa, o serviço Blob cria uma concessão no contentor e devolve um novo ID de concessão. |
| batch_delete_blobs |
Envia um lote de vários pedidos de eliminação de blobs. O método de eliminação de blobs elimina o blob ou instantâneo especificado. Tenha em atenção que eliminar um blob também elimina todos os respetivos instantâneos. Para mais informações, consulte https://docs.microsoft.com/rest/api/storageservices/delete-blob |
| break_blob_lease |
Interrompe a concessão, se o blob tiver uma concessão ativa. Depois de uma concessão ser interrompida, não pode ser renovada. Qualquer pedido autorizado pode interromper a concessão; o pedido não é necessário para especificar um ID de concessão correspondente. Quando uma concessão é interrompida, o período de interrupção da concessão é permitido decorrido, período durante o qual nenhuma operação de concessão, exceto quebra e libertação, pode ser realizada no blob. Quando uma concessão é quebrada com êxito, a resposta indica o intervalo em segundos até que uma nova concessão possa ser adquirida. Uma concessão que tenha sido interrompida também pode ser libertada, caso em que outro cliente pode adquirir imediatamente a concessão no blob. |
| break_container_lease |
Quebre a concessão, se o contentor tiver uma concessão ativa. Depois de uma concessão ser interrompida, não pode ser renovada. Qualquer pedido autorizado pode interromper a concessão; o pedido não é necessário para especificar um ID de concessão correspondente. Quando uma concessão é interrompida, o período de interrupção da concessão é permitido decorrido, período durante o qual nenhuma operação de concessão, exceto quebra e libertação, pode ser realizada no contentor. Quando uma concessão é quebrada com êxito, a resposta indica o intervalo em segundos até que uma nova concessão possa ser adquirida. |
| change_blob_lease |
Altera o ID de concessão de uma concessão ativa. Uma alteração tem de incluir o ID de concessão atual e um novo ID de concessão. |
| change_container_lease |
Altere o ID de concessão de uma concessão ativa. Uma alteração tem de incluir o ID de concessão atual e um novo ID de concessão. |
| copy_blob |
Copia um blob de forma assíncrona. Esta operação devolve um objeto de propriedades da operação de cópia, incluindo um ID de cópia que pode utilizar para verificar ou abortar a operação de cópia. O serviço Blob copia os blobs com base no melhor esforço. O blob de origem para uma operação de cópia pode ser um blob de blocos, um blob de acréscimo ou um blob de páginas. Se o blob de destino já existir, tem de ser do mesmo tipo de blob que o blob de origem. Qualquer blob de destino existente será substituído. Não é possível modificar o blob de destino enquanto estiver em curso uma operação de cópia. Ao copiar de um blob de páginas, o serviço Blob cria um blob de página de destino do comprimento do blob de origem, inicialmente contendo todos os zeros. Em seguida, os intervalos de páginas de origem são enumerados e os intervalos não vazios são copiados. Para um blob de blocos ou um blob de acréscimo, o serviço Blob cria um blob consolidado de comprimento zero antes de regressar desta operação. Ao copiar de um blob de blocos, todos os blocos consolidados e os respetivos IDs de bloco são copiados. Os blocos não consolidados não são copiados. No final da operação de cópia, o blob de destino terá a mesma contagem de blocos consolidada que a origem. Ao copiar de um blob de acréscimo, todos os blocos consolidados são copiados. No final da operação de cópia, o blob de destino terá a mesma contagem de blocos consolidada que a origem. Para todos os tipos de blobs, pode chamar get_blob_properties no blob de destino para verificar o estado da operação de cópia. O blob final será consolidado quando a cópia for concluída. |
| create_container |
Cria um novo contentor na conta especificada. Se o contentor com o mesmo nome já existir, a operação falhará se fail_on_exist for Verdadeiro. |
| delete_blob |
Marca o blob ou instantâneo especificado para eliminação. O blob é posteriormente eliminado durante a libertação da memória. Tenha em atenção que, para eliminar um blob, tem de eliminar todos os respetivos instantâneos. Pode eliminar ambos ao mesmo tempo com a operação Eliminar Blob. Se uma política de retenção de eliminação estiver ativada para o serviço, esta operação elimina de forma recuperável o blob ou instantâneo e mantém o blob ou instantâneo durante um número especificado de dias. Após o número especificado de dias, os dados do blob são removidos do serviço durante a libertação da memória. O blob ou instantâneo eliminado de forma recuperável está acessível através da API de Blobs de Lista que especifica a opção include=Include.Deleted. O blob ou instantâneo eliminado de forma recuperável pode ser restaurado com a API Undelete. |
| delete_container |
Marca o contentor especificado para eliminação. O contentor e quaisquer blobs contidos no mesmo são posteriormente eliminados durante a recolha de lixo. |
| exists |
Devolve um valor booleano que indica se o contentor existe (se blob_name for Nenhum) ou um valor booleano que indica se o blob existe. |
| extract_date_and_request_id | |
| generate_account_shared_access_signature |
Gera uma assinatura de acesso partilhado para o serviço de blobs. Utilize a assinatura devolvida com o parâmetro sas_token de qualquer BlobService. |
| generate_blob_shared_access_signature |
Gera uma assinatura de acesso partilhado para o blob ou um dos respetivos instantâneos. Utilize a assinatura devolvida com o parâmetro sas_token de qualquer BlobService. |
| generate_container_shared_access_signature |
Gera uma assinatura de acesso partilhado para o contentor. Utilize a assinatura devolvida com o parâmetro sas_token de qualquer BlobService. |
| get_blob_account_information |
Obtém informações relacionadas com a conta de armazenamento. As informações também podem ser obtidas se o utilizador tiver uma SAS para um contentor ou blob. |
| get_blob_metadata |
Devolve todos os metadados definidos pelo utilizador para o blob ou instantâneo especificado. |
| get_blob_properties |
Devolve todos os metadados definidos pelo utilizador, propriedades HTTP padrão e propriedades do sistema para o blob. Não devolve o conteúdo do blob. Devolve Blob com BlobProperties e um ditado de metadados. |
| get_blob_service_properties |
Obtém as propriedades do serviço Blob de uma conta de armazenamento, incluindo o Azure Análise de Armazenamento. |
| get_blob_service_stats |
Obtém estatísticas relacionadas com a replicação do serviço Blob. Só está disponível quando a replicação georredundante de acesso de leitura está ativada para a conta de armazenamento. Com a replicação georredundante, o Armazenamento do Azure mantém os seus dados duráveis em duas localizações. Em ambas as localizações, o Armazenamento do Azure mantém constantemente múltiplas réplicas em bom estado de funcionamento dos seus dados. A localização onde lê, cria, atualiza ou elimina dados é a localização da conta de armazenamento principal. A localização primária existe na região que escolher no momento em que cria uma conta através do portal clássico do Azure Management do Azure, por exemplo, E.U.A. Centro-Norte. A localização para a qual os seus dados são replicados é a localização secundária. A localização secundária é determinada automaticamente com base na localização da localização primária; é num segundo datacenter que reside na mesma região que a localização primária. O acesso só de leitura está disponível a partir da localização secundária, se a replicação georredundante de acesso de leitura estiver ativada para a sua conta de armazenamento. |
| get_blob_to_bytes |
Transfere um blob como uma matriz de bytes, com segmentações automáticas e notificações de progresso. Devolve uma instância com Blob propriedades, metadados e conteúdo. |
| get_blob_to_path |
Transfere um blob para um caminho de ficheiro, com segmentação automática e notificações de progresso. Devolve uma instância de Blob com propriedades e metadados. |
| get_blob_to_stream |
Transfere um blob para um fluxo, com segmentação automática e notificações de progresso. Devolve uma instância de Blob com propriedades e metadados. |
| get_blob_to_text |
Transfere um blob como texto unicode, com segmentação automática e notificações de progresso. Devolve uma instância de Blob com propriedades, metadados e conteúdo. |
| get_container_acl |
Obtém as permissões para o contentor especificado. As permissões indicam se os dados de contentor podem ser acedidos publicamente. |
| get_container_metadata |
Devolve todos os metadados definidos pelo utilizador para o contentor especificado. |
| get_container_properties |
Devolve todos os metadados definidos pelo utilizador e as propriedades do sistema para o contentor especificado. Os dados devolvidos não incluem a lista de blobs do contentor. |
| get_user_delegation_key |
Obtenha uma chave de delegação de utilizador para fins de assinatura de tokens SAS. Tem de estar presente uma credencial de token no objeto de serviço para que este pedido seja bem-sucedido. |
| list_blob_names |
Devolve um gerador para listar os nomes dos blobs no contentor especificado. O gerador seguirá preguiçosamente os tokens de continuação devolvidos pelo serviço e parará quando todos os blobs tiverem sido devolvidos ou num_results for atingido. Se num_results for especificado e a conta tiver mais do que esse número de blobs, o gerador terá um campo de next_marker preenchido assim que terminar. Este marcador pode ser utilizado para criar um novo gerador se forem desejados mais resultados. |
| list_blobs |
Devolve um gerador para listar os blobs no contentor especificado. O gerador seguirá preguiçosamente os tokens de continuação devolvidos pelo serviço e parará quando todos os blobs tiverem sido devolvidos ou num_results for atingido. Se num_results for especificado e a conta tiver mais do que esse número de blobs, o gerador terá um campo de next_marker preenchido assim que terminar. Este marcador pode ser utilizado para criar um novo gerador se forem desejados mais resultados. |
| list_containers |
Devolve um gerador para listar os contentores na conta especificada. O gerador seguirá preguiçosamente os tokens de continuação devolvidos pelo serviço e parará quando todos os contentores tiverem sido devolvidos ou num_results for atingido. Se num_results for especificado e a conta tiver mais do que esse número de contentores, o gerador terá um campo de next_marker preenchido assim que terminar. Este marcador pode ser utilizado para criar um novo gerador se forem desejados mais resultados. |
| make_blob_url |
Cria o URL para aceder a um blob. |
| make_container_url |
Cria o URL para aceder a um contentor. |
| release_blob_lease |
Liberta a concessão. A concessão poderá ser libertada se o ID de concessão especificado no pedido corresponder ao associado ao blob. Libertar a concessão permite que outro cliente adquira imediatamente a concessão do blob assim que a versão estiver concluída. |
| release_container_lease |
Liberte a concessão. A concessão poderá ser lançada se o lease_id especificado corresponder ao associado ao contentor. A libertação da concessão permite que outro cliente adquira imediatamente a concessão do contentor assim que a versão estiver concluída. |
| renew_blob_lease |
Renova a concessão. A concessão pode ser renovada se o ID de concessão especificado no pedido corresponder ao associado ao blob. Tenha em atenção que a concessão pode ser renovada mesmo que tenha expirado desde que o blob não tenha sido modificado ou arrendado novamente desde a expiração dessa concessão. Quando renova uma concessão, o relógio de duração da concessão é reposto. |
| renew_container_lease |
Renova a concessão. A concessão pode ser renovada se o ID de concessão especificado corresponder ao associado ao contentor. Tenha em atenção que a concessão pode ser renovada mesmo que tenha expirado desde que o contentor não tenha sido arrendado novamente desde a expiração dessa concessão. Quando renova uma concessão, o relógio de duração da concessão é reposto. |
| set_blob_metadata |
Define metadados definidos pelo utilizador para o blob especificado como um ou mais pares nome-valor. |
| set_blob_properties |
Define as propriedades do sistema no blob. Se uma propriedade estiver definida para o content_settings, todas as propriedades serão substituídas. |
| set_blob_service_properties |
Define as propriedades do serviço Blob de uma conta de armazenamento, incluindo o Azure Análise de Armazenamento. Se um elemento (ex Registo) for deixado como Nenhum, as definições existentes no serviço para essa funcionalidade serão preservadas. |
| set_container_acl |
Define as permissões para o contentor especificado ou políticas de acesso armazenado que podem ser utilizadas com Assinaturas de Acesso Partilhado. As permissões indicam se os blobs num contentor podem ser acedidos publicamente. |
| set_container_metadata |
Define um ou mais pares nome-valor definidos pelo utilizador para o contentor especificado. Cada chamada para esta operação substitui todos os metadados existentes anexados ao contentor. Para remover todos os metadados do contentor, chame esta operação sem dict de metadados. |
| set_proxy |
Define o anfitrião e a porta do servidor proxy para o Túnel HTTP CONNECT. |
| snapshot_blob |
Cria um instantâneo só de leitura de um blob. |
| undelete_blob |
A operação anular a eliminação de Blobs restaura os conteúdos e metadados do blob ou instantâneo eliminado de forma recuperável. Tentar anular a eliminação de um blob ou instantâneo que não seja eliminado de forma recuperável será bem-sucedido sem quaisquer alterações. |
abort_copy_blob
Aborta uma operação de copy_blob pendente e deixa um blob de destino com comprimento zero e metadados completos.
abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)Parâmetros
- copy_id
- str
Identificador de cópia fornecido na copy.id da operação de copy_blob original.
- lease_id
- str
Necessário se o blob de destino tiver uma concessão infinita ativa.
acquire_blob_lease
Pede uma nova concessão. Se o blob não tiver uma concessão ativa, o serviço Blob cria uma concessão no blob e devolve um novo ID de concessão.
acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parâmetros
- lease_duration
- int
Especifica a duração da concessão, em segundos ou negativa (-1) para uma concessão que nunca expira. Uma concessão não infinita pode ser entre 15 e 60 segundos. Não é possível alterar a duração da concessão através da renovação ou alteração. A predefinição é -1 (concessão infinita).
- proposed_lease_id
- str
ID de concessão proposto, num formato de cadeia GUID. O serviço Blob devolve 400 (Pedido inválido) se o ID de concessão proposto não estiver no formato correto.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para executar a operação apenas se o recurso não existir e falhe a operação se existir.
Devoluções
str
acquire_container_lease
Pede uma nova concessão. Se o contentor não tiver uma concessão ativa, o serviço Blob cria uma concessão no contentor e devolve um novo ID de concessão.
acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parâmetros
- lease_duration
- int
Especifica a duração da concessão, em segundos ou negativa (-1) para uma concessão que nunca expira. Uma concessão não infinita pode ser entre 15 e 60 segundos. Não é possível alterar a duração da concessão através da renovação ou alteração. A predefinição é -1 (concessão infinita).
- proposed_lease_id
- str
ID de concessão proposto, num formato de cadeia GUID. O serviço Blob devolve 400 (Pedido inválido) se o ID de concessão proposto não estiver no formato correto.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
Devoluções
str
batch_delete_blobs
Envia um lote de vários pedidos de eliminação de blobs.
O método de eliminação de blobs elimina o blob ou instantâneo especificado. Tenha em atenção que eliminar um blob também elimina todos os respetivos instantâneos. Para mais informações, consulte https://docs.microsoft.com/rest/api/storageservices/delete-blob
batch_delete_blobs(batch_delete_sub_requests, timeout=None)Parâmetros
- batch_delete_sub_requests
- list(BatchDeleteSubRequest)
Os pedidos de eliminação de blobs para enviar como um lote.
Devoluções
resposta HTTP de eliminação de lote analisada
Tipo de retorno
break_blob_lease
Interrompe a concessão, se o blob tiver uma concessão ativa. Depois de uma concessão ser interrompida, não pode ser renovada. Qualquer pedido autorizado pode interromper a concessão; o pedido não é necessário para especificar um ID de concessão correspondente. Quando uma concessão é interrompida, o período de interrupção da concessão é permitido decorrido, período durante o qual nenhuma operação de concessão, exceto quebra e libertação, pode ser realizada no blob. Quando uma concessão é quebrada com êxito, a resposta indica o intervalo em segundos até que uma nova concessão possa ser adquirida.
Uma concessão que tenha sido interrompida também pode ser libertada, caso em que outro cliente pode adquirir imediatamente a concessão no blob.
break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parâmetros
- lease_break_period
- int
Para uma operação de interrupção, esta é a duração proposta de segundos que a concessão deve continuar antes de ser interrompida, entre 0 e 60 segundos. Este período de interrupção só é utilizado se for mais curto do que o tempo restante na concessão. Se for mais longo, é utilizado o tempo restante na concessão. Uma nova concessão não estará disponível antes de o período de interrupção expirar, mas a concessão pode ser mantida por mais tempo do que o período de interrupção. Se este cabeçalho não for apresentado com uma operação de interrupção, uma concessão de duração fixa é interrompida após o período de concessão restante terminar e uma concessão infinita é interrompida imediatamente.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para executar a operação apenas se o recurso não existir e falhe a operação se existir.
Devoluções
int
break_container_lease
Quebre a concessão, se o contentor tiver uma concessão ativa. Depois de uma concessão ser interrompida, não pode ser renovada. Qualquer pedido autorizado pode interromper a concessão; o pedido não é necessário para especificar um ID de concessão correspondente. Quando uma concessão é interrompida, o período de interrupção da concessão é permitido decorrido, período durante o qual nenhuma operação de concessão, exceto quebra e libertação, pode ser realizada no contentor. Quando uma concessão é quebrada com êxito, a resposta indica o intervalo em segundos até que uma nova concessão possa ser adquirida.
break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parâmetros
- lease_break_period
- int
Esta é a duração proposta de segundos que a concessão deve continuar antes de ser quebrada, entre 0 e 60 segundos. Este período de interrupção só é utilizado se for mais curto do que o tempo restante na concessão. Se for mais longo, é utilizado o tempo restante na concessão. Uma nova concessão não estará disponível antes de o período de interrupção expirar, mas a concessão pode ser mantida por mais tempo do que o período de interrupção. Se este cabeçalho não for apresentado com uma operação de interrupção, uma concessão de duração fixa é interrompida após o período de concessão restante terminar e uma concessão infinita é interrompida imediatamente.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
Devoluções
int
change_blob_lease
Altera o ID de concessão de uma concessão ativa. Uma alteração tem de incluir o ID de concessão atual e um novo ID de concessão.
change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parâmetros
- proposed_lease_id
- str
ID de concessão proposto, num formato de cadeia GUID. O serviço Blob devolve 400 (Pedido inválido) se o ID de concessão proposto não estiver no formato correto.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para executar a operação apenas se o recurso não existir e falhe a operação se existir.
change_container_lease
Altere o ID de concessão de uma concessão ativa. Uma alteração tem de incluir o ID de concessão atual e um novo ID de concessão.
change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parâmetros
- proposed_lease_id
- str
ID de concessão proposto, num formato de cadeia GUID. O serviço Blob devolve 400 (Pedido inválido) se o ID de concessão proposto não estiver no formato correto.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
copy_blob
Copia um blob de forma assíncrona. Esta operação devolve um objeto de propriedades da operação de cópia, incluindo um ID de cópia que pode utilizar para verificar ou abortar a operação de cópia. O serviço Blob copia os blobs com base no melhor esforço.
O blob de origem para uma operação de cópia pode ser um blob de blocos, um blob de acréscimo ou um blob de páginas. Se o blob de destino já existir, tem de ser do mesmo tipo de blob que o blob de origem. Qualquer blob de destino existente será substituído. Não é possível modificar o blob de destino enquanto estiver em curso uma operação de cópia.
Ao copiar de um blob de páginas, o serviço Blob cria um blob de página de destino do comprimento do blob de origem, inicialmente contendo todos os zeros. Em seguida, os intervalos de páginas de origem são enumerados e os intervalos não vazios são copiados.
Para um blob de blocos ou um blob de acréscimo, o serviço Blob cria um blob consolidado de comprimento zero antes de regressar desta operação. Ao copiar de um blob de blocos, todos os blocos consolidados e os respetivos IDs de bloco são copiados. Os blocos não consolidados não são copiados. No final da operação de cópia, o blob de destino terá a mesma contagem de blocos consolidada que a origem.
Ao copiar de um blob de acréscimo, todos os blocos consolidados são copiados. No final da operação de cópia, o blob de destino terá a mesma contagem de blocos consolidada que a origem.
Para todos os tipos de blobs, pode chamar get_blob_properties no blob de destino para verificar o estado da operação de cópia. O blob final será consolidado quando a cópia for concluída.
copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None)Parâmetros
- blob_name
- str
Nome do blob de destino. Se o blob de destino existir, será substituído. Caso contrário, será criado.
- copy_source
- str
Um URL com até 2 KB de comprimento que especifica um ficheiro ou blob do Azure. O valor deve ser codificado com URL, tal como apareceria num URI de pedido. Se a origem estiver noutra conta, a origem tem de ser pública ou ter de ser autenticada através de uma assinatura de acesso partilhado. Se a origem for pública, não é necessária autenticação. Exemplos: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
Pares nome-valor associados ao blob como metadados. Se não forem especificados pares nome-valor, a operação copiará os metadados do blob ou ficheiro de origem para o blob de destino. Se forem especificados um ou mais pares nome-valor, o blob de destino é criado com os metadados especificados e os metadados não são copiados do blob ou ficheiro de origem.
- source_if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho condicional para copiar o blob apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho condicional para copiar o blob apenas se o blob de origem não tiver sido modificado desde a data/hora especificada.
- source_if_match
- <xref:ETag>
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho condicional para copiar o blob de origem apenas se a ETag corresponder ao valor especificado. Se os valores de ETag não corresponderem, o serviço Blob devolve o código de estado 412 (Falha na Pré-condição). Não é possível especificar este cabeçalho se a origem for um Ficheiro do Azure.
- source_if_none_match
- <xref:ETag>
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho condicional para copiar o blob apenas se a ETag não corresponder ao valor especificado. Se os valores forem idênticos, o serviço Blob devolve o código de estado 412 (Falha na Pré-condição). Não é possível especificar este cabeçalho se a origem for um Ficheiro do Azure.
- destination_if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho condicional para copiar o blob apenas 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 devolve o código de estado 412 (Falha na Pré-condição).
- destination_if_unmodified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho condicional para copiar o blob apenas 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 devolve o código de estado 412 (Falha na Pré-condição).
- destination_if_match
- <xref:ETag>
Um valor ETag ou o caráter universal (*). Especifique um valor ETag para este cabeçalho condicional para copiar o blob apenas se o valor ETag especificado corresponder ao valor ETag de um blob de destino existente. Se a ETag para o blob de destino não corresponder à ETag especificada para If-Match, o serviço Blob devolve o código de estado 412 (Falha na Pré-condição).
- destination_if_none_match
- <xref:ETag>
Um valor ETag ou o caráter universal (). Especifique um valor ETag para este cabeçalho condicional para copiar o blob apenas se o valor ETag especificado não corresponder ao valor ETag do blob de destino. Especifique o caráter universal () para executar a operação apenas se o blob de destino não existir. Se a condição especificada não for cumprida, o serviço Blob devolve o código de estado 412 (Falha na Pré-condição).
- destination_lease_id
- str
O ID de concessão especificado para este cabeçalho tem de corresponder ao ID de concessão do blob de destino. Se o pedido não incluir o ID de concessão ou não for válido, a operação falhará com o código de estado 412 (Falha na Pré-condição).
- source_lease_id
- str
Especifique esta opção para executar a operação Copiar Blob apenas se o ID de concessão fornecido corresponder ao ID de concessão ativo do blob de origem.
Devoluções
Copie as propriedades da operação, como o estado, a origem e o ID.
Tipo de retorno
create_container
Cria um novo contentor na conta especificada. Se o contentor com o mesmo nome já existir, a operação falhará se fail_on_exist for Verdadeiro.
create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)Parâmetros
- container_name
- str
Nome do contentor a criar. O nome do contentor só pode conter letras minúsculas, números e hífenes e tem de começar com uma letra ou um número. Cada hífen tem de ser precedido e seguido de um caráter que não seja um hífen. O nome também tem de ter entre 3 e 63 carateres.
Um ditado com pares name_value para associar ao contentor como metadados. Exemplo:{'Category':'test'}
- fail_on_exist
- bool
Especifique se pretende gerar uma exceção quando o contentor existe.
Devoluções
Verdadeiro se o contentor for criado, Falso se o contentor já existir.
Tipo de retorno
delete_blob
Marca o blob ou instantâneo especificado para eliminação. O blob é posteriormente eliminado durante a libertação da memória.
Tenha em atenção que, para eliminar um blob, tem de eliminar todos os respetivos instantâneos. Pode eliminar ambos ao mesmo tempo com a operação Eliminar Blob.
Se uma política de retenção de eliminação estiver ativada para o serviço, esta operação elimina de forma recuperável o blob ou instantâneo e mantém o blob ou instantâneo durante um número especificado de dias. Após o número especificado de dias, os dados do blob são removidos do serviço durante a libertação da memória. O blob ou instantâneo eliminado de forma recuperável está acessível através da API de Blobs de Lista que especifica a opção include=Include.Deleted. O blob ou instantâneo eliminado de forma recuperável pode ser restaurado com a API Undelete.
delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parâmetros
- snapshot
- str
O parâmetro de instantâneo é um valor dateTime opaco que, quando presente, especifica o instantâneo de blob a eliminar.
- delete_snapshots
- DeleteSnapshot
Necessário se o blob tiver instantâneos associados.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para executar a operação apenas se o recurso não existir e falhe a operação se existir.
delete_container
Marca o contentor especificado para eliminação. O contentor e quaisquer blobs contidos no mesmo são posteriormente eliminados durante a recolha de lixo.
delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parâmetros
- fail_not_exist
- bool
Especifique se pretende lançar uma exceção quando o contentor não existir.
- lease_id
- str
Se especificado, delete_container só é bem-sucedido se a concessão do contentor estiver ativa e corresponder a este ID. Necessário se o contentor tiver uma concessão ativa.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
Devoluções
Verdadeiro se o contentor for eliminado, o contentor False não existe.
Tipo de retorno
exists
Devolve um valor booleano que indica se o contentor existe (se blob_name for Nenhum) ou um valor booleano que indica se o blob existe.
exists(container_name, blob_name=None, snapshot=None, timeout=None)Parâmetros
- blob_name
- str
Nome de um blob. Se Nenhum, o contentor será verificado quanto à existência.
- snapshot
- str
O parâmetro instantâneo é um valor dateTime opaco que, quando presente, especifica o instantâneo.
Devoluções
Um valor booleano que indica se o recurso existe.
Tipo de retorno
extract_date_and_request_id
static extract_date_and_request_id(retry_context)Parâmetros
- retry_context
generate_account_shared_access_signature
Gera uma assinatura de acesso partilhado para o serviço de blobs. Utilize a assinatura devolvida com o parâmetro sas_token de qualquer BlobService.
generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)Parâmetros
- resource_types
- <xref:ResourceTypes>
Especifica os tipos de recursos que estão acessíveis com a SAS da conta.
- permission
- <xref:AccountPermissions>
As permissões associadas à assinatura de acesso partilhado. O utilizador está restrito a operações permitidas pelas permissões. Necessário, a menos que seja fornecido um ID que referencia uma política de acesso armazenado que contém este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada.
O momento em que a assinatura de acesso partilhado se torna inválida. Necessário, a menos que seja fornecido um ID que referencia uma política de acesso armazenado que contém este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada. O Azure irá sempre converter valores em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC.
O momento em que a assinatura de acesso partilhado se torna válida. Se omitido, assume-se que a hora de início desta chamada é a hora em que o serviço de armazenamento recebe o pedido. O Azure irá sempre converter valores em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC.
- ip
- str
Especifica um endereço IP ou um intervalo de endereços IP a partir dos quais aceitar pedidos. Se o endereço IP a partir do qual o pedido é originado não corresponder ao endereço IP ou intervalo de endereços especificado no token de SAS, o pedido não é autenticado. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 no SAS restringe o pedido a esses endereços IP.
- protocol
- str
Especifica o protocolo permitido para um pedido feito. O valor predefinido é https,http. Veja Protocol os valores possíveis.
Devoluções
Um token de Assinatura de Acesso Partilhado (sas).
Tipo de retorno
generate_blob_shared_access_signature
Gera uma assinatura de acesso partilhado para o blob ou um dos respetivos instantâneos. Utilize a assinatura devolvida com o parâmetro sas_token de qualquer BlobService.
generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)Parâmetros
- snapshot
- str
O parâmetro instantâneo é um valor dateTime opaco que, quando presente, especifica o instantâneo do blob para conceder permissão.
- permission
- BlobPermissions
As permissões associadas à assinatura de acesso partilhado. O utilizador está restrito a operações permitidas pelas permissões. As permissões têm de ser ordenadas de leitura, escrita, eliminação, lista. Necessário, a menos que seja fornecido um ID que referencia uma política de acesso armazenado que contém este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada.
O momento em que a assinatura de acesso partilhado se torna inválida. Necessário, a menos que seja fornecido um ID que referencia uma política de acesso armazenado que contém este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada. O Azure irá sempre converter valores em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC.
O momento em que a assinatura de acesso partilhado se torna válida. Se omitido, assume-se que a hora de início desta chamada é a hora em que o serviço de armazenamento recebe o pedido. O Azure irá sempre converter valores em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC.
- id
- str
Um valor exclusivo com até 64 carateres de comprimento que se correlaciona com uma política de acesso armazenada. Para criar uma política de acesso armazenada, utilize set_container_acl.
- ip
- str
Especifica um endereço IP ou um intervalo de endereços IP a partir dos quais aceitar pedidos. Se o endereço IP a partir do qual o pedido é originado não corresponder ao endereço IP ou intervalo de endereços especificado no token de SAS, o pedido não é autenticado. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 no SAS restringe o pedido a esses endereços IP.
- protocol
- str
Especifica o protocolo permitido para um pedido feito. O valor predefinido é https,http. Veja Protocol os valores possíveis.
- cache_control
- str
Valor do cabeçalho de resposta para Cache-Control quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_disposition
- str
Valor do cabeçalho de resposta para Content-Disposition quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_encoding
- str
Valor do cabeçalho de resposta para Codificação de Conteúdo quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_language
- str
Valor do cabeçalho de resposta para Content-Language quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_type
- str
Valor do cabeçalho de resposta para Tipo de Conteúdo quando o recurso é acedido com esta assinatura de acesso partilhado.
- user_delegation_key
- UserDelegationKey
Em vez de uma chave de conta, o utilizador pode transmitir uma chave de delegação de utilizador. Uma chave de delegação de utilizador pode ser obtida a partir do serviço através da autenticação com uma identidade do AAD; isto pode ser feito ao chamar get_user_delegation_key. Quando estiver presente, a SAS é assinada com a chave de delegação de utilizador.
Devoluções
Um token de Assinatura de Acesso Partilhado (sas).
Tipo de retorno
generate_container_shared_access_signature
Gera uma assinatura de acesso partilhado para o contentor. Utilize a assinatura devolvida com o parâmetro sas_token de qualquer BlobService.
generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)Parâmetros
- permission
- ContainerPermissions
As permissões associadas à assinatura de acesso partilhado. O utilizador está restrito a operações permitidas pelas permissões. As permissões têm de ser ordenadas de leitura, escrita, eliminação, lista. Necessário, a menos que seja fornecido um ID que referencia uma política de acesso armazenado que contém este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada.
O momento em que a assinatura de acesso partilhado se torna inválida. Necessário, a menos que seja fornecido um ID que referencia uma política de acesso armazenado que contém este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada. O Azure irá sempre converter valores em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC.
O momento em que a assinatura de acesso partilhado se torna válida. Se omitido, assume-se que a hora de início desta chamada é a hora em que o serviço de armazenamento recebe o pedido. O Azure irá sempre converter valores em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC.
- id
- str
Um valor exclusivo com até 64 carateres de comprimento que se correlaciona com uma política de acesso armazenada. Para criar uma política de acesso armazenada, utilize set_blob_service_properties.
- ip
- str
Especifica um endereço IP ou um intervalo de endereços IP a partir dos quais aceitar pedidos. Se o endereço IP a partir do qual o pedido é originado não corresponder ao endereço IP ou intervalo de endereços especificado no token de SAS, o pedido não é autenticado. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 no SAS restringe o pedido a esses endereços IP.
- protocol
- str
Especifica o protocolo permitido para um pedido feito. O valor predefinido é https,http. Veja Protocol os valores possíveis.
- cache_control
- str
Valor do cabeçalho de resposta para Cache-Control quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_disposition
- str
Valor do cabeçalho de resposta para Content-Disposition quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_encoding
- str
Valor do cabeçalho de resposta para Codificação de Conteúdo quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_language
- str
Valor do cabeçalho de resposta para Content-Language quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_type
- str
Valor do cabeçalho de resposta para Tipo de Conteúdo quando o recurso é acedido com esta assinatura de acesso partilhado.
- user_delegation_key
- UserDelegationKey
Em vez de uma chave de conta, o utilizador pode transmitir uma chave de delegação de utilizador. Uma chave de delegação de utilizador pode ser obtida a partir do serviço através da autenticação com uma identidade do AAD; isto pode ser feito ao chamar get_user_delegation_key. Quando estiver presente, a SAS é assinada com a chave de delegação de utilizador.
Devoluções
Um token de Assinatura de Acesso Partilhado (sas).
Tipo de retorno
get_blob_account_information
Obtém informações relacionadas com a conta de armazenamento. As informações também podem ser obtidas se o utilizador tiver uma SAS para um contentor ou blob.
get_blob_account_information(container_name=None, blob_name=None, timeout=None)Parâmetros
- container_name
- str
Nome do contentor existente. Opcional, a menos que utilize um token SAS para um contentor ou blob específico, caso em que é necessário.
- blob_name
- str
Nome do blob existente. Opcional, a menos que utilize um token de SAS para um blob específico, caso em que é necessário.
Devoluções
O campo AccountInformation.
get_blob_metadata
Devolve todos os metadados definidos pelo utilizador para o blob ou instantâneo especificado.
get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parâmetros
- snapshot
- str
O parâmetro instantâneo é um valor opaco que, quando presente, especifica o instantâneo do blob a obter.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para efetuar a operação apenas se o recurso não existir e falhar a operação se existir.
Desencripta os dados do lado do serviço com a chave especificada. A utilização de chaves fornecidas pelo cliente tem de ser efetuada através de HTTPS. Como a própria chave de encriptação é fornecida no pedido, tem de ser estabelecida uma ligação segura para transferir a chave.
Devoluções
Um dicionário que representa o nome dos metadados do blob, pares de valores.
Tipo de retorno
get_blob_properties
Devolve todos os metadados definidos pelo utilizador, propriedades HTTP padrão e propriedades do sistema para o blob. Não devolve o conteúdo do blob. Devolve Blob com BlobProperties e um ditado de metadados.
get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parâmetros
- snapshot
- str
O parâmetro instantâneo é um valor dateTime opaco que, quando presente, especifica o instantâneo do blob a obter.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para efetuar a operação apenas se o recurso não existir e falhar a operação se existir.
Desencripta os dados do lado do serviço com a chave especificada. A utilização de chaves fornecidas pelo cliente tem de ser efetuada através de HTTPS. Como a própria chave de encriptação é fornecida no pedido, tem de ser estabelecida uma ligação segura para transferir a chave.
Devoluções
um objeto de blob, incluindo propriedades e metadados.
Tipo de retorno
get_blob_service_properties
Obtém as propriedades do serviço Blob de uma conta de armazenamento, incluindo o Azure Análise de Armazenamento.
get_blob_service_properties(timeout=None)Parâmetros
Devoluções
O blob ServiceProperties com uma propriedade de target_version anexada.
get_blob_service_stats
Obtém estatísticas relacionadas com a replicação do serviço Blob. Só está disponível quando a replicação georredundante de acesso de leitura está ativada para a conta de armazenamento.
Com a replicação georredundante, o Armazenamento do Azure mantém os seus dados duráveis em duas localizações. Em ambas as localizações, o Armazenamento do Azure mantém constantemente múltiplas réplicas em bom estado de funcionamento dos seus dados. A localização onde lê, cria, atualiza ou elimina dados é a localização da conta de armazenamento principal. A localização primária existe na região que escolher no momento em que cria uma conta através do portal clássico do Azure Management do Azure, por exemplo, E.U.A. Centro-Norte. A localização para a qual os seus dados são replicados é a localização secundária. A localização secundária é determinada automaticamente com base na localização da localização primária; é num segundo datacenter que reside na mesma região que a localização primária. O acesso só de leitura está disponível a partir da localização secundária, se a replicação georredundante de acesso de leitura estiver ativada para a sua conta de armazenamento.
get_blob_service_stats(timeout=None)Parâmetros
Devoluções
As estatísticas do serviço blob.
Tipo de retorno
get_blob_to_bytes
Transfere um blob como uma matriz de bytes, com segmentações automáticas e notificações de progresso. Devolve uma instância com Blob propriedades, metadados e conteúdo.
get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parâmetros
- snapshot
- str
O parâmetro instantâneo é um valor dateTime opaco que, quando presente, especifica o instantâneo do blob a obter.
- start_range
- int
Início do intervalo de bytes a utilizar para transferir uma secção do blob. Se não for dada nenhuma end_range, todos os bytes após o start_range serão transferidos. Os parâmetros start_range e end_range são inclusivos. Por exemplo: start_range=0, end_range=511 transferirá os primeiros 512 bytes de blob.
- end_range
- int
Fim do intervalo de bytes a utilizar para transferir uma secção do blob. Se end_range for dada, start_range têm de ser fornecidas. Os parâmetros start_range e end_range são inclusivos. Por exemplo: start_range=0, end_range=511 transferirá os primeiros 512 bytes de blob.
- validate_content
- bool
Se for definido como verdadeiro, valida um hash MD5 para cada parte recuperada do blob. Isto é essencialmente importante para detetar bitflips no fio se utilizar http em vez de https como https (a predefinição) já irá validar. Tenha em atenção que o serviço só devolverá MD5s transacionais para segmentos de 4 MB ou menos, pelo que o primeiro pedido get será de tamanho próprio. MAX_CHUNK_GET_SIZE em vez de si mesmo. MAX_SINGLE_GET_SIZE. Se eu mesmo. MAX_CHUNK_GET_SIZE foi definido como superior a 4 MB, será emitido um erro. Uma vez que a computação do MD5 demora o processamento e mais pedidos terão de ser feitos devido ao tamanho reduzido do segmento, poderá haver algum aumento na latência.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Chamada de retorno para o progresso com a função de assinatura (atual, total) em que atual é o número de bytes transferidos até agora e o total é o tamanho do blob, se conhecido.
- max_connections
- int
Se estiver definido como 2 ou superior, será feita uma obtenção inicial para o primeiro eu. MAX_SINGLE_GET_SIZE bytes do blob. Se este for todo o blob, o método será devolvido neste momento. Se não for, transferirá os restantes dados paralelos com o número de threads iguais a max_connections. Cada segmento terá um tamanho próprio. MAX_CHUNK_GET_SIZE. Se estiver definido como 1, será feito um único pedido get grande. Geralmente, isto não é recomendado, mas está disponível se forem utilizados muito poucos threads, os pedidos de rede são muito caros ou um fluxo não procurado impede a transferência paralela. Isto também pode ser útil se se esperar que muitos blobs estejam vazios, uma vez que é necessário um pedido adicional para blobs vazios se max_connections for superior a 1.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para efetuar a operação apenas se o recurso não existir e falhar a operação se existir.
Desencripta os dados do lado do serviço com a chave especificada. A utilização de chaves fornecidas pelo cliente tem de ser efetuada através de HTTPS. Como a própria chave de encriptação é fornecida no pedido, tem de ser estabelecida uma ligação segura para transferir a chave.
- timeout
- int
O parâmetro de tempo limite é expresso em segundos. Este método pode fazer várias chamadas para o serviço do Azure e o tempo limite será aplicado a cada chamada individualmente.
Devoluções
Um Blob com propriedades e metadados. Se max_connections for superior a 1, o content_md5 (se definido no blob) não será devolvido. Se precisar deste valor, utilize get_blob_properties ou defina max_connections como 1.
Tipo de retorno
get_blob_to_path
Transfere um blob para um caminho de ficheiro, com segmentação automática e notificações de progresso. Devolve uma instância de Blob com propriedades e metadados.
get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parâmetros
- open_mode
- str
Modo a utilizar ao abrir o ficheiro. Tenha em atenção que especificar acrescentar apenas open_mode impede a transferência paralela. Assim, max_connections tem de ser definido como 1 se este open_mode for utilizado.
- snapshot
- str
O parâmetro instantâneo é um valor dateTime opaco que, quando presente, especifica o instantâneo do blob a obter.
- start_range
- int
Início do intervalo de bytes a utilizar para transferir uma secção do blob. Se não for dada nenhuma end_range, todos os bytes após o start_range serão transferidos. Os parâmetros start_range e end_range são inclusivos. Por exemplo: start_range=0, end_range=511 transferirá os primeiros 512 bytes de blob.
- end_range
- int
Fim do intervalo de bytes a utilizar para transferir uma secção do blob. Se end_range for dada, start_range têm de ser fornecidas. Os parâmetros start_range e end_range são inclusivos. Por exemplo: start_range=0, end_range=511 transferirá os primeiros 512 bytes de blob.
- validate_content
- bool
Se for definido como verdadeiro, valida um hash MD5 para cada parte recuperada do blob. Isto é essencialmente importante para detetar bitflips no fio se utilizar http em vez de https como https (a predefinição) já irá validar. Tenha em atenção que o serviço só devolverá MD5s transacionais para segmentos de 4 MB ou menos, pelo que o primeiro pedido get será de tamanho próprio. MAX_CHUNK_GET_SIZE em vez de si mesmo. MAX_SINGLE_GET_SIZE. Se eu mesmo. MAX_CHUNK_GET_SIZE foi definido como superior a 4 MB, será emitido um erro. Uma vez que a computação do MD5 demora o processamento e mais pedidos terão de ser feitos devido ao tamanho reduzido do segmento, poderá haver algum aumento na latência.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Chamada de retorno para o progresso com a função de assinatura (atual, total) em que atual é o número de bytes transferidos até agora e o total é o tamanho do blob, se conhecido.
- max_connections
- int
Se estiver definido como 2 ou superior, será feita uma obtenção inicial para o primeiro eu. MAX_SINGLE_GET_SIZE bytes do blob. Se este for todo o blob, o método será devolvido neste momento. Se não for, transferirá os restantes dados paralelos com o número de threads iguais a max_connections. Cada segmento terá um tamanho próprio. MAX_CHUNK_GET_SIZE. Se estiver definido como 1, será feito um único pedido get grande. Geralmente, isto não é recomendado, mas está disponível se forem utilizados muito poucos threads, os pedidos de rede são muito caros ou um fluxo não procurado impede a transferência paralela. Isto também pode ser útil se se esperar que muitos blobs estejam vazios, uma vez que é necessário um pedido adicional para blobs vazios se max_connections for superior a 1.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para efetuar a operação apenas se o recurso não existir e falhar a operação se existir.
Desencripta os dados do lado do serviço com a chave especificada. A utilização de chaves fornecidas pelo cliente tem de ser efetuada através de HTTPS. Como a própria chave de encriptação é fornecida no pedido, tem de ser estabelecida uma ligação segura para transferir a chave.
- timeout
- int
O parâmetro de tempo limite é expresso em segundos. Este método pode fazer várias chamadas para o serviço do Azure e o tempo limite será aplicado a cada chamada individualmente.
Devoluções
Um Blob com propriedades e metadados. Se max_connections for superior a 1, o content_md5 (se definido no blob) não será devolvido. Se precisar deste valor, utilize get_blob_properties ou defina max_connections como 1.
Tipo de retorno
get_blob_to_stream
Transfere um blob para um fluxo, com segmentação automática e notificações de progresso. Devolve uma instância de Blob com propriedades e metadados.
get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parâmetros
- snapshot
- str
O parâmetro instantâneo é um valor dateTime opaco que, quando presente, especifica o instantâneo do blob a obter.
- start_range
- int
Início do intervalo de bytes a utilizar para transferir uma secção do blob. Se não for dada nenhuma end_range, todos os bytes após o start_range serão transferidos. Os parâmetros start_range e end_range são inclusivos. Por exemplo: start_range=0, end_range=511 transferirá os primeiros 512 bytes de blob.
- end_range
- int
Fim do intervalo de bytes a utilizar para transferir uma secção do blob. Se end_range for dada, start_range têm de ser fornecidas. Os parâmetros start_range e end_range são inclusivos. Por exemplo: start_range=0, end_range=511 transferirá os primeiros 512 bytes de blob.
- validate_content
- bool
Se for definido como verdadeiro, valida um hash MD5 para cada parte recuperada do blob. Isto é importante para detetar bitflips no fio se a utilização de http em vez de https como https (a predefinição) já for validada. Tenha em atenção que o serviço só devolverá MD5s transacionais para segmentos de 4 MB ou menos, pelo que o primeiro pedido get será de tamanho próprio. MAX_CHUNK_GET_SIZE em vez de si mesmo. MAX_SINGLE_GET_SIZE. Se eu mesmo. MAX_CHUNK_GET_SIZE foi definido como superior a 4 MB, será gerado um erro. Uma vez que a computação do MD5 demora tempo de processamento e mais pedidos terão de ser feitos devido ao tamanho reduzido dos segmentos, poderá haver algum aumento na latência.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Chamada de retorno para o progresso com a função signature (atual, total) em que atual é o número de bytes transferidos até agora e o total é o tamanho do blob, se conhecido.
- max_connections
- int
Se estiver definido como 2 ou superior, será feita uma obtenção inicial para o primeiro self. MAX_SINGLE_GET_SIZE bytes do blob. Se este for o blob inteiro, o método será devolvido neste momento. Se não estiver, transferirá os dados restantes paralelos com o número de threads iguais a max_connections. Cada segmento terá um tamanho próprio. MAX_CHUNK_GET_SIZE. Se estiver definido como 1, será feito um único pedido get grande. Geralmente, isto não é recomendado, mas está disponível se forem utilizados muito poucos threads, os pedidos de rede são muito dispendiosos ou um fluxo não pesquisável impede a transferência paralela. Isto também pode ser útil se se esperar que muitos blobs estejam vazios, uma vez que é necessário um pedido adicional para blobs vazios se max_connections for superior a 1.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para executar a operação apenas se o recurso não existir e falhe a operação se existir.
Desencripta os dados no lado do serviço com a chave especificada. A utilização de chaves fornecidas pelo cliente tem de ser feita através de HTTPS. Como a própria chave de encriptação é fornecida no pedido, tem de ser estabelecida uma ligação segura para transferir a chave.
- timeout
- int
O parâmetro de tempo limite é expresso em segundos. Este método pode fazer várias chamadas para o serviço do Azure e o tempo limite será aplicado a cada chamada individualmente.
Devoluções
Um Blob com propriedades e metadados. Se max_connections for superior a 1, o content_md5 (se definido no blob) não será devolvido. Se precisar deste valor, utilize get_blob_properties ou defina max_connections como 1.
Tipo de retorno
get_blob_to_text
Transfere um blob como texto unicode, com segmentação automática e notificações de progresso. Devolve uma instância de Blob com propriedades, metadados e conteúdo.
get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parâmetros
- encoding
- str
Codificação python a utilizar ao descodificar os dados de blobs.
- snapshot
- str
O parâmetro de instantâneo é um valor dateTime opaco que, quando presente, especifica o instantâneo de blob a obter.
- start_range
- int
Início do intervalo de bytes a utilizar para transferir uma secção do blob. Se não for dada nenhuma end_range, todos os bytes após a start_range serão transferidos. Os parâmetros start_range e end_range são inclusivos. Por exemplo: start_range=0, end_range=511 transferirá os primeiros 512 bytes de blob.
- end_range
- int
Fim do intervalo de bytes a utilizar para transferir uma secção do blob. Se end_range for dada, start_range tem de ser fornecido. Os parâmetros start_range e end_range são inclusivos. Por exemplo: start_range=0, end_range=511 transferirá os primeiros 512 bytes de blob.
- validate_content
- bool
Se for definido como verdadeiro, valida um hash MD5 para cada parte recuperada do blob. Isto é importante para detetar bitflips no fio se a utilização de http em vez de https como https (a predefinição) já for validada. Tenha em atenção que o serviço só devolverá MD5s transacionais para segmentos de 4 MB ou menos, pelo que o primeiro pedido get será de tamanho próprio. MAX_CHUNK_GET_SIZE em vez de si mesmo. MAX_SINGLE_GET_SIZE. Se eu mesmo. MAX_CHUNK_GET_SIZE foi definido como superior a 4 MB, será gerado um erro. Uma vez que a computação do MD5 demora tempo de processamento e mais pedidos terão de ser feitos devido ao tamanho reduzido dos segmentos, poderá haver algum aumento na latência.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Chamada de retorno para o progresso com a função signature (atual, total) em que atual é o número de bytes transferidos até agora e o total é o tamanho do blob, se conhecido.
- max_connections
- int
Se estiver definido como 2 ou superior, será feita uma obtenção inicial para o primeiro self. MAX_SINGLE_GET_SIZE bytes do blob. Se este for o blob inteiro, o método será devolvido neste momento. Se não estiver, transferirá os dados restantes paralelos com o número de threads iguais a max_connections. Cada segmento terá um tamanho próprio. MAX_CHUNK_GET_SIZE. Se estiver definido como 1, será feito um único pedido get grande. Geralmente, isto não é recomendado, mas está disponível se forem utilizados muito poucos threads, os pedidos de rede são muito dispendiosos ou um fluxo não pesquisável impede a transferência paralela. Isto também pode ser útil se se esperar que muitos blobs estejam vazios, uma vez que é necessário um pedido adicional para blobs vazios se max_connections for superior a 1.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para executar a operação apenas se o recurso não existir e falhe a operação se existir.
Desencripta os dados no lado do serviço com a chave especificada. A utilização de chaves fornecidas pelo cliente tem de ser feita através de HTTPS. Como a própria chave de encriptação é fornecida no pedido, tem de ser estabelecida uma ligação segura para transferir a chave.
- timeout
- int
O parâmetro de tempo limite é expresso em segundos. Este método pode fazer várias chamadas para o serviço do Azure e o tempo limite será aplicado a cada chamada individualmente.
Devoluções
Um Blob com propriedades e metadados. Se max_connections for superior a 1, o content_md5 (se definido no blob) não será devolvido. Se precisar deste valor, utilize get_blob_properties ou defina max_connections como 1.
Tipo de retorno
get_container_acl
Obtém as permissões para o contentor especificado. As permissões indicam se os dados de contentor podem ser acedidos publicamente.
get_container_acl(container_name, lease_id=None, timeout=None)Parâmetros
- lease_id
Se especificado, get_container_acl só será bem-sucedido se a concessão do contentor estiver ativa e corresponder a este ID.
Devoluções
Um dicionário de políticas de acesso associadas ao contentor. dict of str to and a AccessPolicy public_access property if public access is turned on
get_container_metadata
Devolve todos os metadados definidos pelo utilizador para o contentor especificado.
get_container_metadata(container_name, lease_id=None, timeout=None)Parâmetros
- lease_id
- str
Se especificado, get_container_metadata só será bem-sucedido se a concessão do contentor estiver ativa e corresponder a este ID.
Devoluções
Um dicionário que representa o nome dos metadados do contentor, pares de valores.
Tipo de retorno
get_container_properties
Devolve todos os metadados definidos pelo utilizador e as propriedades do sistema para o contentor especificado. Os dados devolvidos não incluem a lista de blobs do contentor.
get_container_properties(container_name, lease_id=None, timeout=None)Parâmetros
- lease_id
- str
Se especificado, get_container_properties só será bem-sucedido se a concessão do contentor estiver ativa e corresponder a este ID.
Devoluções
propriedades do contentor especificado num objeto de contentor.
Tipo de retorno
get_user_delegation_key
Obtenha uma chave de delegação de utilizador para fins de assinatura de tokens SAS. Tem de estar presente uma credencial de token no objeto de serviço para que este pedido seja bem-sucedido.
get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)Parâmetros
Devoluções
A chave de delegação do utilizador.
Tipo de retorno
list_blob_names
Devolve um gerador para listar os nomes dos blobs no contentor especificado. O gerador seguirá preguiçosamente os tokens de continuação devolvidos pelo serviço e parará quando todos os blobs tiverem sido devolvidos ou num_results for atingido.
Se num_results for especificado e a conta tiver mais do que esse número de blobs, o gerador terá um campo de next_marker preenchido assim que terminar. Este marcador pode ser utilizado para criar um novo gerador se forem desejados mais resultados.
list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parâmetros
- prefix
- str
Filtra os resultados para devolver apenas blobs cujos nomes começam com o prefixo especificado.
- num_results
- int
Especifica o número máximo de blobs a devolver, incluindo todos os <xref:azure.storage.blob.baseblobservice.BlobPrefix> elementos. Se o pedido não especificar num_results ou especificar um valor superior a 5000, o servidor devolverá até 5000 itens. Definir num_results para um valor menor ou igual a zero resulta no código de resposta de erro 400 (Pedido Incorreto).
- include
- Include
Especifica um ou mais conjuntos de dados adicionais a incluir na resposta.
- delimiter
- str
Quando o pedido inclui este parâmetro, a operação devolve um BlobPrefix elemento na lista de resultados que atua como um marcador de posição para todos os blobs cujos nomes começam com a mesma subcadeia até ao aspeto do caráter delimitador. O delimitador pode ser um único caráter ou uma cadeia.
- marker
- str
Um token de continuação opaco. Este valor pode ser obtido a partir do campo next_marker de um objeto gerador anterior se num_results tiver sido especificado e esse gerador tiver concluído a enumeração de resultados. Se for especificado, este gerador começará a devolver resultados do ponto em que o gerador anterior parou.
list_blobs
Devolve um gerador para listar os blobs no contentor especificado. O gerador seguirá preguiçosamente os tokens de continuação devolvidos pelo serviço e parará quando todos os blobs tiverem sido devolvidos ou num_results for atingido.
Se num_results for especificado e a conta tiver mais do que esse número de blobs, o gerador terá um campo de next_marker preenchido assim que terminar. Este marcador pode ser utilizado para criar um novo gerador se forem desejados mais resultados.
list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parâmetros
- prefix
- str
Filtra os resultados para devolver apenas blobs cujos nomes começam com o prefixo especificado.
- num_results
- int
Especifica o número máximo de blobs a devolver, incluindo todos os <xref:azure.storage.blob.baseblobservice.BlobPrefix> elementos. Se o pedido não especificar num_results ou especificar um valor superior a 5000, o servidor devolverá até 5000 itens. Definir num_results para um valor menor ou igual a zero resulta no código de resposta de erro 400 (Pedido Incorreto).
- include
- Include
Especifica um ou mais conjuntos de dados adicionais a incluir na resposta.
- delimiter
- str
Quando o pedido inclui este parâmetro, a operação devolve um BlobPrefix elemento na lista de resultados que atua como um marcador de posição para todos os blobs cujos nomes começam com a mesma subcadeia até ao aspeto do caráter delimitador. O delimitador pode ser um único caráter ou uma cadeia.
- marker
- str
Um token de continuação opaco. Este valor pode ser obtido a partir do campo next_marker de um objeto gerador anterior se num_results tiver sido especificado e esse gerador tiver concluído a enumeração de resultados. Se for especificado, este gerador começará a devolver resultados do ponto em que o gerador anterior parou.
list_containers
Devolve um gerador para listar os contentores na conta especificada. O gerador seguirá preguiçosamente os tokens de continuação devolvidos pelo serviço e parará quando todos os contentores tiverem sido devolvidos ou num_results for atingido.
Se num_results for especificado e a conta tiver mais do que esse número de contentores, o gerador terá um campo de next_marker preenchido assim que terminar. Este marcador pode ser utilizado para criar um novo gerador se forem desejados mais resultados.
list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)Parâmetros
- prefix
- str
Filtra os resultados para devolver apenas os contentores cujos nomes começam com o prefixo especificado.
- num_results
- int
Especifica o número máximo de contentores a devolver. Um pedido de lista única pode devolver até 1000 contianers e, potencialmente, um token de continuação que deve ser seguido para obter reencaminhamentos adicionais.
- include_metadata
- bool
Especifica que os metadados do contentor são devolvidos na resposta.
- marker
- str
Um token de continuação opaco. Este valor pode ser obtido a partir do campo next_marker de um objeto gerador anterior se num_results tiver sido especificado e esse gerador tiver concluído a enumeração de resultados. Se for especificado, este gerador começará a devolver resultados do ponto em que o gerador anterior parou.
make_blob_url
Cria o URL para aceder a um blob.
make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)Parâmetros
- protocol
- str
Protocolo a utilizar: "http" ou "https". Se não for especificado, utiliza o protocolo especificado quando BaseBlobService foi inicializado.
- sas_token
- str
Token de assinatura de acesso partilhado criado com generate_shared_access_signature.
- snapshot
- str
Um valor de cadeia que identifica exclusivamente o instantâneo. O valor deste parâmetro de consulta indica a versão do instantâneo.
Devoluções
URL de acesso a blobs.
Tipo de retorno
make_container_url
Cria o URL para aceder a um contentor.
make_container_url(container_name, protocol=None, sas_token=None)Parâmetros
- protocol
- str
Protocolo a utilizar: "http" ou "https". Se não for especificado, utiliza o protocolo especificado quando BaseBlobService foi inicializado.
- sas_token
- str
Token de assinatura de acesso partilhado criado com generate_shared_access_signature.
Devoluções
URL de acesso ao contentor.
Tipo de retorno
release_blob_lease
Liberta a concessão. A concessão poderá ser libertada se o ID de concessão especificado no pedido corresponder ao associado ao blob. Libertar a concessão permite que outro cliente adquira imediatamente a concessão do blob assim que a versão estiver concluída.
release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parâmetros
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para executar a operação apenas se o recurso não existir e falhe a operação se existir.
release_container_lease
Liberte a concessão. A concessão poderá ser lançada se o lease_id especificado corresponder ao associado ao contentor. A libertação da concessão permite que outro cliente adquira imediatamente a concessão do contentor assim que a versão estiver concluída.
release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parâmetros
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
renew_blob_lease
Renova a concessão. A concessão pode ser renovada se o ID de concessão especificado no pedido corresponder ao associado ao blob. Tenha em atenção que a concessão pode ser renovada mesmo que tenha expirado desde que o blob não tenha sido modificado ou arrendado novamente desde a expiração dessa concessão. Quando renova uma concessão, o relógio de duração da concessão é reposto.
renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parâmetros
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para efetuar a operação apenas se o recurso não existir e falhar a operação se existir.
Devoluções
str
renew_container_lease
Renova a concessão. A concessão pode ser renovada se o ID de concessão especificado corresponder ao associado ao contentor. Tenha em atenção que a concessão pode ser renovada mesmo que tenha expirado desde que o contentor não tenha sido arrendado novamente desde a expiração dessa concessão. Quando renova uma concessão, o relógio de duração da concessão é reposto.
renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parâmetros
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
Devoluções
str
set_blob_metadata
Define metadados definidos pelo utilizador para o blob especificado como um ou mais pares nome-valor.
set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parâmetros
Dict contendo pares de nomes e valores. Cada chamada para esta operação substitui todos os metadados existentes anexados ao blob. Para remover todos os metadados do blob, chame esta operação sem cabeçalhos de metadados.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para efetuar a operação apenas se o recurso não existir e falhar a operação se existir.
Encripta os dados do lado do serviço com a chave especificada. A utilização de chaves fornecidas pelo cliente tem de ser efetuada através de HTTPS. Como a própria chave de encriptação é fornecida no pedido, tem de ser estabelecida uma ligação segura para transferir a chave.
Devoluções
ETag e propriedades modificadas pela última vez para o Blob atualizado
Tipo de retorno
set_blob_properties
Define as propriedades do sistema no blob. Se uma propriedade estiver definida para o content_settings, todas as propriedades serão substituídas.
set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parâmetros
- content_settings
- ContentSettings
Objeto ContentSettings utilizado para definir propriedades de blobs.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para efetuar a operação apenas se o recurso não existir e falhar a operação se existir.
Encripta os dados do lado do serviço com a chave especificada. A utilização de chaves fornecidas pelo cliente tem de ser efetuada através de HTTPS. Como a própria chave de encriptação é fornecida no pedido, tem de ser estabelecida uma ligação segura para transferir a chave.
Devoluções
ETag e propriedades modificadas pela última vez para o Blob atualizado
Tipo de retorno
set_blob_service_properties
Define as propriedades do serviço Blob de uma conta de armazenamento, incluindo o Azure Análise de Armazenamento. Se um elemento (ex Registo) for deixado como Nenhum, as definições existentes no serviço para essa funcionalidade serão preservadas.
set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)Parâmetros
- hour_metrics
- Metrics
As definições de métricas de hora fornecem um resumo das estatísticas de pedido agrupadas pela API em agregados por hora para blobs.
- minute_metrics
- Metrics
As definições de métricas de minutos fornecem estatísticas de pedidos para cada minuto para blobs.
- cors
- list(CorsRule)
Pode incluir até cinco elementos CorsRule na lista. Se for especificada uma lista vazia, todas as regras CORS serão eliminadas e o CORS será desativado para o serviço.
- target_version
- str
Indica a versão predefinida a utilizar para pedidos se a versão de um pedido de entrada não for especificada.
- delete_retention_policy
- DeleteRetentionPolicy
A política de retenção eliminar especifica se pretende reter blobs eliminados. Também especifica o número de dias e versões do blob a manter.
- static_website
- StaticWebsite
Especifica se a funcionalidade de site estático estático está ativada e, se sim, indica o documento de índice e o documento de erro 404 a utilizar.
set_container_acl
Define as permissões para o contentor especificado ou políticas de acesso armazenado que podem ser utilizadas com Assinaturas de Acesso Partilhado. As permissões indicam se os blobs num contentor podem ser acedidos publicamente.
set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parâmetros
- signed_identifiers
- dict(str, AccessPolicy)
Um dicionário de políticas de acesso a associar ao contentor. O dicionário pode conter até 5 elementos. Um dicionário vazio limpará as políticas de acesso definidas no serviço.
- lease_id
- str
Se especificado, set_container_acl só é bem-sucedido se a concessão do contentor estiver ativa e corresponder a este ID.
- if_modified_since
- datetime
Um valor datetime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso tiver sido modificado desde a data/hora especificada.
- if_unmodified_since
- datetime
Um valor datetime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
Devoluções
ETag e propriedades modificadas pela última vez para o Contentor atualizado
Tipo de retorno
set_container_metadata
Define um ou mais pares nome-valor definidos pelo utilizador para o contentor especificado. Cada chamada para esta operação substitui todos os metadados existentes anexados ao contentor. Para remover todos os metadados do contentor, chame esta operação sem dict de metadados.
set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)Parâmetros
Um ditado que contém pares nome-valor para associar ao contentor como metadados. Exemplo: {'category':'test'}
- lease_id
- str
Se especificado, set_container_metadata só é bem-sucedido se a concessão do contentor estiver ativa e corresponder a este ID.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso tiver sido modificado desde a hora especificada.
Devoluções
ETag e propriedades modificadas pela última vez para o Contentor atualizado
Tipo de retorno
set_proxy
Define o anfitrião e a porta do servidor proxy para o Túnel HTTP CONNECT.
set_proxy(host, port, user=None, password=None)Parâmetros
snapshot_blob
Cria um instantâneo só de leitura de um blob.
snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)Parâmetros
Especifica um par nome-valor definido pelo utilizador associado ao blob. Se não forem especificados pares nome-valor, a operação copiará os metadados do blob base para o instantâneo. Se forem especificados um ou mais pares name-value, o instantâneo é criado com os metadados especificados e os metadados não são copiados do blob base.
- if_modified_since
- datetime
Um valor DateTime. O Azure espera que o valor de data transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas 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 transmitido seja UTC. Se o fuso horário estiver incluído, quaisquer datetimes não UTC serão convertidos em UTC. Se uma data for transmitida sem informações de fuso horário, assume-se que é UTC. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data/hora especificada.
- if_match
- str
Um valor ETag ou o caráter universal (*). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso corresponder ao valor especificado.
- if_none_match
- str
Um valor ETag ou o caráter universal (). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso não corresponder ao valor especificado. Especifique o caráter universal () para efetuar a operação apenas se o recurso não existir e falhar a operação se existir.
Encripta os dados do lado do serviço com a chave especificada. A utilização de chaves fornecidas pelo cliente tem de ser efetuada através de HTTPS. Como a própria chave de encriptação é fornecida no pedido, tem de ser estabelecida uma ligação segura para transferir a chave.
Devoluções
propriedades do instantâneo
Tipo de retorno
undelete_blob
A operação anular a eliminação de Blobs restaura os conteúdos e metadados do blob ou instantâneo eliminado de forma recuperável. Tentar anular a eliminação de um blob ou instantâneo que não seja eliminado de forma recuperável será bem-sucedido sem quaisquer alterações.
undelete_blob(container_name, blob_name, timeout=None)Parâmetros
Atributos
protocol
request_session
socket_timeout
MAX_CHUNK_GET_SIZE
MAX_CHUNK_GET_SIZE = 4194304MAX_SINGLE_GET_SIZE
MAX_SINGLE_GET_SIZE = 33554432
Azure SDK for Python