azure.storage.filedatalake.DataLakeDirectoryClient class

Pede uma nova concessão. Se o ficheiro ou diretório não tiver uma concessão ativa, o serviço DataLake cria uma concessão no ficheiro/diretório e devolve um novo ID de concessão.

acquire_lease(lease_duration: int | None = -1, lease_id: str | None = None, **kwargs) -> DataLakeLeaseClient

Parâmetros

lease_duration: int

Necessário

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 ter entre 15 e 60 segundos. Não é possível alterar a duração da concessão com renovação ou alteração. A predefinição é -1 (concessão infinita).

lease_id: str

Necessário

ID de concessão proposto, num formato de cadeia GUID. O serviço DataLake 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 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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

Um objeto DataLakeLeaseClient, que pode ser executado num gestor de contexto.

Tipo de retorno

DataLakeLeaseClient

Este método consiste em fechar os sockets abertos pelo cliente. Não é necessário utilizá-lo ao utilizar com um gestor de contexto.

close() -> None

Criar um novo diretório.

create_directory(metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]

Parâmetros

metadata: dict(str, str)

Necessário

Pares nome-valor associados ao ficheiro como metadados.

content_settings: ContentSettings

Objeto ContentSettings utilizado para definir propriedades de caminho.

lease: DataLakeLeaseClient ou str

Necessário se o ficheiro tiver uma concessão ativa. O valor pode ser um objeto DataLakeLeaseClient ou o ID de concessão como uma cadeia.

umask: str

Opcional e apenas válido se o Espaço de Nomes Hierárquico estiver ativado para a conta. Ao criar um ficheiro ou diretório e a pasta principal não tiver uma ACL predefinida, a umask restringe as permissões do ficheiro ou diretório a criar. A permissão resultante é dada por p & ^u, em que p é a permissão e o utilizador é a umask. Por exemplo, se p for 0777 e for 0057, a permissão resultante é 0720. A permissão predefinida é 0777 para um diretório e 0666 para um ficheiro. A umask predefinida é 0027. A umask tem de ser especificada na notação octal de 4 dígitos (por exemplo, 0766).

owner: str

O proprietário do ficheiro ou diretório.

group: str

O grupo proprietário do ficheiro ou diretório.

acl: str

Define os direitos de controlo de acesso POSIX em ficheiros e diretórios. O valor é uma lista separada por vírgulas de entradas de controlo de acesso. Cada entrada de controlo de acesso (ACE) consiste num âmbito, um tipo, um identificador de utilizador ou grupo e permissões no formato "[âmbito:][tipo]:[id]:[permissões]".

lease_id: str

ID de concessão proposto, num formato de cadeia GUID. O serviço DataLake devolve 400 (pedido inválido) se o ID de concessão proposto não estiver no formato correto.

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 ter entre 15 e 60 segundos. Não é possível alterar a duração da concessão com renovação ou alteração.

permissions: str

Opcional e apenas válido se o Espaço de Nomes Hierárquico estiver ativado para a conta. Define as permissões de acesso POSIX para o proprietário do ficheiro, o grupo proprietário do ficheiro e outros. A cada classe pode ser concedida permissão de leitura, escrita ou execução. A bit autocolante também é suportada. Ambos os símbolos (rwxrw-rw-) e notação octal de 4 dígitos (por exemplo, 0766) são suportados.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

cpk: CustomerProvidedEncryptionKey

Encripta 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.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é controlado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

Um dicionário de cabeçalhos de resposta.

Tipo de retorno

Dict[str, Union[str, datetime]]

Exemplos

Criar diretório.


   directory_client.create_directory()

Crie um novo ficheiro e devolva o cliente de ficheiros com o qual pretende interagir.

create_file(file: FileProperties | str, **kwargs) -> DataLakeFileClient

Parâmetros

file: str ou FileProperties

Necessário

O ficheiro com o qual interagir. Pode ser o nome do ficheiro ou uma instância de FileProperties.

content_settings: ContentSettings

Objeto ContentSettings utilizado para definir propriedades do caminho.

metadata

Pares nome-valor associados ao ficheiro como metadados.

lease: DataLakeLeaseClient ou str

Necessário se o ficheiro tiver uma concessão ativa. O valor pode ser um objeto DataLakeLeaseClient ou o ID de concessão como uma cadeia.

umask: str

Opcional e válido apenas se o Espaço de Nomes Hierárquico estiver ativado para a conta. Ao criar um ficheiro ou diretório e a pasta principal não tiver uma ACL predefinida, a umask restringe as permissões do ficheiro ou diretório a criar. A permissão resultante é dada por p & ^u, em que p é a permissão e o utilizador é a umask. Por exemplo, se p for 0777 e for 0057, a permissão resultante será 0720. A permissão predefinida é 0777 para um diretório e 0666 para um ficheiro. A umask predefinida é 0027. A umask tem de ser especificada em notação octal de 4 dígitos (por exemplo, 0766).

owner: str

O proprietário do ficheiro ou diretório.

group: str

O grupo proprietário do ficheiro ou diretório.

acl: str

Define direitos de controlo de acesso POSIX em ficheiros e diretórios. O valor é uma lista separada por vírgulas de entradas de controlo de acesso. Cada entrada de controlo de acesso (ACE) consiste num âmbito, um tipo, um identificador de utilizador ou grupo e permissões no formato "[scope:][type]:[id]:[permissions]".

lease_id: str

ID de concessão proposto, num formato de cadeia GUID. O serviço DataLake devolve 400 (Pedido inválido) se o ID de concessão proposto não estiver no formato correto.

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.

expires_on: datetime ou int

A hora de definir o ficheiro para expirar. Se o tipo de expires_on for um int, o tempo de expiração será definido como o número de milissegundos decorridos da hora de criação. Se o tipo de expires_on for datetime, a hora de expiração será definida como absoluta para a hora fornecida. Se não forem fornecidas informações de fuso horário, isto será interpretado como UTC.

permissions: str

Opcional e válido apenas se o Espaço de Nomes Hierárquico estiver ativado para a conta. Define permissões de acesso POSIX para o proprietário do ficheiro, o grupo proprietário do ficheiro e outros. Pode ser concedida permissão de leitura, escrita ou execução a cada classe. O sticky bit também é suportado. Tanto a notação octal simbólica (rwxrw-rw-) como a notação octal de 4 dígitos (por exemplo, 0766) são suportadas.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

cpk: CustomerProvidedEncryptionKey

Encripta 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.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é controlado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

DataLakeFileClient

Crie um subdiretório e devolva o cliente subdiretório com o qual pretende interagir.

create_sub_directory(sub_directory: DirectoryProperties | str, metadata: Dict[str, str] | None = None, **kwargs) -> DataLakeDirectoryClient

Parâmetros

sub_directory: str ou DirectoryProperties

Necessário

O diretório com o qual interagir. Pode ser o nome do diretório ou uma instância de DirectoryProperties.

metadata: dict(str, str)

Necessário

Pares nome-valor associados ao ficheiro como metadados.

content_settings: ContentSettings

Objeto ContentSettings utilizado para definir propriedades do caminho.

lease: DataLakeLeaseClient ou str

Necessário se o ficheiro tiver uma concessão ativa. O valor pode ser um objeto DataLakeLeaseClient ou o ID de concessão como uma cadeia.

umask: str

Opcional e válido apenas se o Espaço de Nomes Hierárquico estiver ativado para a conta. Ao criar um ficheiro ou diretório e a pasta principal não tiver uma ACL predefinida, a umask restringe as permissões do ficheiro ou diretório a criar. A permissão resultante é dada por p & ^u, em que p é a permissão e o utilizador é a umask. Por exemplo, se p for 0777 e for 0057, a permissão resultante será 0720. A permissão predefinida é 0777 para um diretório e 0666 para um ficheiro. A umask predefinida é 0027. A umask tem de ser especificada em notação octal de 4 dígitos (por exemplo, 0766).

owner: str

O proprietário do ficheiro ou diretório.

group: str

O grupo proprietário do ficheiro ou diretório.

acl: str

Define direitos de controlo de acesso POSIX em ficheiros e diretórios. O valor é uma lista separada por vírgulas de entradas de controlo de acesso. Cada entrada de controlo de acesso (ACE) consiste num âmbito, um tipo, um identificador de utilizador ou grupo e permissões no formato "[scope:][type]:[id]:[permissions]".

lease_id: str

ID de concessão proposto, num formato de cadeia GUID. O serviço DataLake devolve 400 (Pedido inválido) se o ID de concessão proposto não estiver no formato correto.

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.

permissions: str

Opcional e válido apenas se o Espaço de Nomes Hierárquico estiver ativado para a conta. Define permissões de acesso POSIX para o proprietário do ficheiro, o grupo proprietário do ficheiro e outros. Pode ser concedida permissão de leitura, escrita ou execução a cada classe. O sticky bit também é suportado. Tanto a notação octal simbólica (rwxrw-rw-) como a notação octal de 4 dígitos (por exemplo, 0766) são suportadas.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

cpk: CustomerProvidedEncryptionKey

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.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

DataLakeDirectoryClient para o subdiretório.

Marca o diretório especificado para eliminação.

delete_directory(**kwargs) -> None

Parâmetros

lease: DataLakeLeaseClient ou str

Necessário se o ficheiro tiver uma concessão ativa. O valor pode ser um objeto LeaseClient ou o ID de concessão como uma cadeia.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

Nenhuma

Exemplos

Eliminar diretório.


   new_directory.delete_directory()

Marca o subdiretório especificado para eliminação.

delete_sub_directory(sub_directory: DirectoryProperties | str, **kwargs) -> DataLakeDirectoryClient

Parâmetros

sub_directory: str ou DirectoryProperties

Necessário

O diretório com o qual interagir. Este pode ser o nome do diretório ou uma instância de DirectoryProperties.

lease: DataLakeLeaseClient ou str

Necessário se o ficheiro tiver uma concessão ativa. O valor pode ser um objeto LeaseClient ou o ID de concessão como uma cadeia.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

DataLakeDirectoryClient para o subdiretório

Devolve Verdadeiro se existir um diretório e devolve Falso de outra forma.

exists(**kwargs: Any) -> bool

Parâmetros

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

Verdadeiro se existir um diretório, Falso caso contrário.

Tipo de retorno

bool

Crie DataLakeDirectoryClient a partir de uma Cadeia de Ligação.

from_connection_string(conn_str: str, file_system_name: str, directory_name: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

Parâmetros

conn_str: str

Necessário

Uma cadeia de ligação a uma conta de Armazenamento do Azure.

file_system_name: str

Necessário

O nome do sistema de ficheiros com o qual interagir.

credential

valor predefinido: None

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

exceto no caso do AzureSasCredential, em que os tokens SAS em conflito gerarão um ValueError. Se utilizar uma instância do AzureNamedKeyCredential, "name" deve ser o nome da conta de armazenamento e "chave" deve ser a chave da conta de armazenamento.

directory_name: str

Necessário

O nome do diretório com o qual interagir. O diretório está no sistema de ficheiros.

credential

Necessário

As credenciais com as quais se autenticar. Isto é opcional se o URL da conta já tiver um token de SAS ou se a cadeia de ligação já tiver valores de chave de acesso partilhados. O valor pode ser uma cadeia de token de SAS, uma instância de uma AzureSasCredential ou AzureNamedKeyCredential a partir de azure.core.credentials, uma chave de acesso partilhada de conta ou uma instância de uma classe TokenCredentials a partir de azure.identity. As credenciais aqui fornecidas terão precedência sobre as da cadeia de ligação. Se utilizar uma instância do AzureNamedKeyCredential, "name" deve ser o nome da conta de armazenamento e "chave" deve ser a chave da conta de armazenamento.

Devoluções

a DataLakeDirectoryClient

Tipo de retorno

DataLakeDirectoryClient

get_access_control(upn: bool | None = None, **kwargs) -> Dict[str, Any]

Parâmetros

upn: bool

Necessário

Opcional. Válido apenas quando o Espaço de Nomes Hierárquico está ativado para a conta. Se "verdadeiro", os valores de identidade de utilizador devolvidos nos cabeçalhos de resposta x-ms-owner, x-ms-group e x-ms-acl serão transformados dos IDs de Objeto do Azure Active Directory para Nomes Principais de Utilizador. Se for "falso", os valores serão devolvidos como IDs de Objeto do Azure Active Directory. O valor predefinido é false. Tenha em atenção que os IDs de objeto de grupo e de aplicação não são traduzidos porque não têm nomes amigáveis exclusivos.

lease: DataLakeLeaseClient ou str

Necessário se o ficheiro/diretório tiver uma concessão ativa. O valor pode ser um objeto LeaseClient ou o ID de concessão como uma cadeia.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

response dict

dict de resposta.

Devolve todos os metadados definidos pelo utilizador, propriedades HTTP padrão e propriedades do sistema para o diretório. Não devolve o conteúdo do diretório.

get_directory_properties(**kwargs: Any) -> DirectoryProperties

Parâmetros

lease: DataLakeLeaseClient ou str

Necessário se o diretório ou ficheiro tiver uma concessão ativa. O valor pode ser um objeto DataLakeLeaseClient ou o ID de concessão como uma cadeia.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

cpk: CustomerProvidedEncryptionKey

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. Necessário se o diretório tiver sido criado com uma chave fornecida pelo cliente.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Tipo de retorno

DirectoryProperties

Exemplos

Obter as propriedades de um ficheiro/diretório.


   props = new_directory.get_directory_properties()

Faça com que um cliente interaja com o ficheiro especificado.

O ficheiro ainda não precisa de existir.

get_file_client(file: FileProperties | str) -> DataLakeFileClient

Parâmetros

file: str ou FileProperties

Necessário

O ficheiro com o qual interagir. Pode ser o nome do ficheiro ou uma instância de FileProperties. por exemplo, diretório/subdiretório/ficheiro

Devoluções

Um DataLakeFileClient.

Tipo de retorno

DataLakeFileClient

Faça com que um cliente interaja com o subdiretório especificado do diretório atual.

O subdiretório ainda não precisa de existir.

get_sub_directory_client(sub_directory: DirectoryProperties | str) -> DataLakeDirectoryClient

Parâmetros

sub_directory: str ou DirectoryProperties

Necessário

O diretório com o qual interagir. Este pode ser o nome do diretório ou uma instância de DirectoryProperties.

Devoluções

A DataLakeDirectoryClient.

Tipo de retorno

DataLakeDirectoryClient

Remove o Controlo de Acesso num caminho e sub-caminhos.

remove_access_control_recursive(acl: str, **kwargs: Any) -> AccessControlChangeResult

Parâmetros

acl: str

Necessário

Remove os direitos de controlo de acesso POSIX em ficheiros e diretórios. O valor é uma lista separada por vírgulas de entradas de controlo de acesso. Cada entrada de controlo de acesso (ACE) é constituída por um âmbito, um tipo e um identificador de utilizador ou grupo no formato "[âmbito:][tipo]:[id]".

progress_hook: <xref:func>(AccessControlChanges)

Chamada de retorno onde o autor da chamada pode controlar o progresso da operação, bem como recolher caminhos que não foram alterados Controlo de Acesso.

continuation_token: str

Token de continuação opcional que pode ser utilizado para retomar a operação parada anteriormente.

batch_size: int

Opcional. Se o tamanho do conjunto de dados exceder o tamanho do lote, a operação será dividida em vários pedidos para que o progresso possa ser monitorizado. O tamanho do lote deve estar entre 1 e 2000. A predefinição quando não especificada é 2000.

max_batches: int

Opcional. Define o número máximo de lotes que a única alteração Controlo de Acesso operação pode ser executada. Se o máximo for atingido antes de todos os sub-caminhos serem processados, o token de continuação pode ser utilizado para retomar a operação. O valor vazio indica que o número máximo de lotes não vinculados e a operação continua até ao fim.

continue_on_failure: bool

Se estiver definida como Falso, a operação terminará rapidamente ao deparar-se com erros de utilizador (4XX). Se For Verdadeiro, a operação ignorará os erros do utilizador e prosseguirá com a operação noutras sub entidades do diretório. O token de continuação só será devolvido quando continue_on_failure for Verdadeiro em caso de erros de utilizador. Se não definir o valor predefinido é Falso para isto.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

Um resumo das operações recursivas, incluindo a contagem de êxitos e falhas, bem como um token de continuação no caso de a operação ter sido terminada prematuramente.

Tipo de retorno

AccessControlChangeResult

Exceções

AzureError

O utilizador pode reiniciar a operação com continuation_token campo do AzureError se o token estiver disponível.

Mude o nome do diretório de origem.

rename_directory(new_name: str, **kwargs: Any) -> DataLakeDirectoryClient

Parâmetros

new_name: str

Necessário

o novo nome do diretório para o qual o utilizador quer mudar o nome. O valor tem de ter o seguinte formato: "{filesystem}/{directory}/{subdirectory}".

source_lease: DataLakeLeaseClient ou str

Um ID de concessão para o caminho de origem. Se especificado, o caminho de origem tem de ter uma concessão ativa e o ID de concessão tem de corresponder.

lease: DataLakeLeaseClient ou str

Necessário se o ficheiro/diretório tiver uma concessão ativa. O valor pode ser um objeto LeaseClient ou o ID de concessão como uma cadeia.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

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

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

source_etag: str

O valor ETag de origem ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

source_match_condition: MatchConditions

A condição de correspondência de origem a utilizar no etag.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

DataLakeDirectoryClient

Exemplos

Mude o nome do diretório de origem.


   new_dir_name = "testdir2"
   print("Renaming the directory named '{}' to '{}'.".format(dir_name, new_dir_name))
   new_directory = directory_client\
       .rename_directory(new_name=directory_client.file_system_name + '/' + new_dir_name)

Defina o proprietário, grupo, permissões ou lista de controlo de acesso para um caminho.

set_access_control(owner: str | None = None, group: str | None = None, permissions: str | None = None, acl: str | None = None, **kwargs) -> Dict[str, str | datetime]

Parâmetros

owner: str

Necessário

Opcional. O proprietário do ficheiro ou diretório.

group: str

Necessário

Opcional. O grupo proprietário do ficheiro ou diretório.

permissions: str

Necessário

Opcional e apenas válido se o Espaço de Nomes Hierárquico estiver ativado para a conta. Define as permissões de acesso POSIX para o proprietário do ficheiro, o grupo proprietário do ficheiro e outros. A cada classe pode ser concedida permissão de leitura, escrita ou execução. A bit autocolante também é suportada. Ambos os símbolos (rwxrw-rw-) e notação octal de 4 dígitos (por exemplo, 0766) são suportados. as permissões e acl são mutuamente exclusivas.

acl: str

Necessário

Define os direitos de controlo de acesso POSIX em ficheiros e diretórios. O valor é uma lista separada por vírgulas de entradas de controlo de acesso. Cada entrada de controlo de acesso (ACE) consiste num âmbito, um tipo, um identificador de utilizador ou grupo e permissões no formato "[âmbito:][tipo]:[id]:[permissões]". as permissões e acl são mutuamente exclusivas.

lease: DataLakeLeaseClient ou str

Necessário se o ficheiro/diretório tiver uma concessão ativa. O valor pode ser um objeto LeaseClient ou o ID de concessão como uma cadeia.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

response dict

dict de resposta (Etag e última modificação).

Define o Controlo de Acesso num caminho e sub-caminhos.

set_access_control_recursive(acl: str, **kwargs: Any) -> AccessControlChangeResult

Parâmetros

acl: str

Necessário

Define os direitos de controlo de acesso POSIX em ficheiros e diretórios. O valor é uma lista separada por vírgulas de entradas de controlo de acesso. Cada entrada de controlo de acesso (ACE) consiste num âmbito, um tipo, um identificador de utilizador ou grupo e permissões no formato "[âmbito:][tipo]:[id]:[permissões]".

progress_hook: <xref:func>(AccessControlChanges)

Chamada de retorno onde o autor da chamada pode controlar o progresso da operação, bem como recolher caminhos que não foram alterados Controlo de Acesso.

continuation_token: str

Token de continuação opcional que pode ser utilizado para retomar a operação parada anteriormente.

batch_size: int

Opcional. Se o tamanho do conjunto de dados exceder o tamanho do lote, a operação será dividida em vários pedidos para que o progresso possa ser monitorizado. O tamanho do lote deve estar entre 1 e 2000. A predefinição quando não especificada é 2000.

max_batches: int

Opcional. Define o número máximo de lotes que a única alteração Controlo de Acesso operação pode ser executada. Se o máximo for atingido antes de todos os sub-caminhos serem processados, o token de continuação pode ser utilizado para retomar a operação. O valor vazio indica que o número máximo de lotes não vinculados e a operação continua até ao fim.

continue_on_failure: bool

Se estiver definida como Falso, a operação terminará rapidamente ao deparar-se com erros de utilizador (4XX). Se For Verdadeiro, a operação ignorará os erros do utilizador e prosseguirá com a operação noutras sub entidades do diretório. O token de continuação só será devolvido quando continue_on_failure for Verdadeiro em caso de erros de utilizador. Se não definir o valor predefinido é Falso para isto.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

Um resumo das operações recursivas, incluindo a contagem de êxitos e falhas, bem como um token de continuação no caso de a operação ter sido terminada prematuramente.

Tipo de retorno

AccessControlChangeResult

Exceções

AzureError

O utilizador pode reiniciar a operação com continuation_token campo do AzureError se o token estiver disponível.

Define as propriedades do sistema no ficheiro ou diretório.

Se uma propriedade estiver definida para o content_settings, todas as propriedades serão substituídas.

set_http_headers(content_settings: ContentSettings | None = None, **kwargs) -> Dict[str, Any]

Parâmetros

content_settings: ContentSettings

Necessário

Objeto ContentSettings utilizado para definir propriedades de ficheiro/diretório.

lease: DataLakeLeaseClient ou str

Se especificado, set_file_system_metadata só é bem-sucedido se a concessão do sistema de ficheiros 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.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

file/directory-updated property dict (Etag and last modified)

Tipo de retorno

Dict[str, Any]

Define um ou mais pares nome-valor definidos pelo utilizador para o sistema de ficheiros especificado. Cada chamada para esta operação substitui todos os metadados existentes anexados ao sistema de ficheiros. Para remover todos os metadados do sistema de ficheiros, chame esta operação sem dict de metadados.

set_metadata(metadata: Dict[str, str], **kwargs) -> Dict[str, str | datetime]

Parâmetros

metadata: Dict[str, str]

Necessário

Um ditado que contém pares nome-valor para associar ao sistema de ficheiros como metadados. Exemplo: {'category':'test'}

lease: DataLakeLeaseClient ou str

Se especificado, set_file_system_metadata só é bem-sucedido se a concessão do sistema de ficheiros 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.

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.

etag: str

Um valor ETag ou o caráter universal (*). Utilizado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo parâmetro match_condition .

match_condition: MatchConditions

A condição de correspondência a utilizar no etag.

cpk: CustomerProvidedEncryptionKey

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.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

file system-updated property dict (Etag and last modified).

Modifica o Controlo de Acesso num caminho e sub-caminhos.

update_access_control_recursive(acl: str, **kwargs: Any) -> AccessControlChangeResult

Parâmetros

acl: str

Necessário

Modifica os direitos de controlo de acesso POSIX em ficheiros e diretórios. O valor é uma lista separada por vírgulas de entradas de controlo de acesso. Cada entrada de controlo de acesso (ACE) consiste num âmbito, um tipo, um identificador de utilizador ou grupo e permissões no formato "[âmbito:][tipo]:[id]:[permissões]".

progress_hook: <xref:func>(AccessControlChanges)

Chamada de retorno onde o autor da chamada pode controlar o progresso da operação, bem como recolher caminhos que não foram alterados Controlo de Acesso.

continuation_token: str

Token de continuação opcional que pode ser utilizado para retomar a operação parada anteriormente.

batch_size: int

Opcional. Se o tamanho do conjunto de dados exceder o tamanho do lote, a operação será dividida em vários pedidos para que o progresso possa ser monitorizado. O tamanho do lote deve estar entre 1 e 2000. A predefinição quando não especificada é 2000.

max_batches: int

Opcional. Define o número máximo de lotes que a única alteração Controlo de Acesso operação pode ser executada. Se o máximo for atingido antes de todos os sub-caminhos serem processados, o token de continuação pode ser utilizado para retomar a operação. O valor vazio indica que o número máximo de lotes não vinculados e a operação continua até ao fim.

continue_on_failure: bool

Se estiver definida como Falso, a operação terminará rapidamente ao deparar-se com erros de utilizador (4XX). Se For Verdadeiro, a operação ignorará os erros do utilizador e prosseguirá com a operação noutras sub entidades do diretório. O token de continuação só será devolvido quando continue_on_failure for Verdadeiro em caso de erros de utilizador. Se não definir o valor predefinido é Falso para isto.

timeout: int

Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais detalhes, veja https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Este valor não é monitorizado nem validado no cliente. Para configurar tempos limite de rede do lado do cliente, veja aqui.

Devoluções

Um resumo das operações recursivas, incluindo a contagem de êxitos e falhas, bem como um token de continuação no caso de a operação ter sido terminada prematuramente.

Tipo de retorno

AccessControlChangeResult

Exceções

AzureError

O utilizador pode reiniciar a operação com continuation_token campo do AzureError se o token estiver disponível.

A versão da API de Armazenamento utilizada para pedidos.

O modo de localização que o cliente está a utilizar atualmente.

Por predefinição, será "primário". As opções incluem "principal" e "secundário".

O URL do ponto final primário completo.

O nome do anfitrião do ponto final primário.

O URL completo do ponto final secundário, se configurado.

Se não estiver disponível, será gerado um ValueError. Para especificar explicitamente um nome de anfitrião secundário, utilize o argumento opcional secondary_hostname palavra-chave na instanciação.

Exceções

ValueError

O nome do anfitrião do ponto final secundário.

Se não estiver disponível, este será Nenhum. Para especificar explicitamente um nome de anfitrião secundário, utilize o argumento opcional secondary_hostname palavra-chave na instanciação.

O URL de ponto final completo para esta entidade, incluindo o token de SAS, se utilizado.

Este pode ser o ponto final principal ou o ponto final secundário, dependendo do atual location_mode. :returns: o URL de ponto final completo para esta entidade, incluindo o token SAS, se utilizado. :rtype: str

acquire_lease	Pede uma nova concessão. Se o ficheiro ou diretório não tiver uma concessão ativa, o serviço DataLake cria uma concessão no ficheiro/diretório e devolve um novo ID de concessão.
close	Este método consiste em fechar os sockets abertos pelo cliente. Não é necessário utilizá-lo ao utilizar com um gestor de contexto.
create_directory	Criar um novo diretório.
create_file	Crie um novo ficheiro e devolva o cliente de ficheiros com o qual pretende interagir.
create_sub_directory	Crie um subdiretório e devolva o cliente subdiretório com o qual pretende interagir.
delete_directory	Marca o diretório especificado para eliminação.
delete_sub_directory	Marca o subdiretório especificado para eliminação.
exists	Devolve Verdadeiro se existir um diretório e devolve Falso de outra forma.
from_connection_string	Crie DataLakeDirectoryClient a partir de uma Cadeia de Ligação.
get_access_control
get_directory_properties	Devolve todos os metadados definidos pelo utilizador, propriedades HTTP padrão e propriedades do sistema para o diretório. Não devolve o conteúdo do diretório.
get_file_client	Faça com que um cliente interaja com o ficheiro especificado. O ficheiro ainda não precisa de existir.
get_sub_directory_client	Faça com que um cliente interaja com o subdiretório especificado do diretório atual. O subdiretório ainda não precisa de existir.
remove_access_control_recursive	Remove o Controlo de Acesso num caminho e sub-caminhos.
rename_directory	Mude o nome do diretório de origem.
set_access_control	Defina o proprietário, grupo, permissões ou lista de controlo de acesso para um caminho.
set_access_control_recursive	Define o Controlo de Acesso num caminho e sub-caminhos.
set_http_headers	Define as propriedades do sistema no ficheiro ou diretório. Se uma propriedade estiver definida para o content_settings, todas as propriedades serão substituídas.
set_metadata	Define um ou mais pares nome-valor definidos pelo utilizador para o sistema de ficheiros especificado. Cada chamada para esta operação substitui todos os metadados existentes anexados ao sistema de ficheiros. Para remover todos os metadados do sistema de ficheiros, chame esta operação sem dict de metadados.
update_access_control_recursive	Modifica o Controlo de Acesso num caminho e sub-caminhos.

Partilhar via

DataLakeDirectoryClient Classe

Construtor

Parâmetros

Exemplos

Variáveis

Métodos

acquire_lease

Parâmetros

Devoluções

Tipo de retorno

close

create_directory

Parâmetros

Devoluções

Tipo de retorno

Exemplos

create_file

Parâmetros

Devoluções

create_sub_directory

Parâmetros

Devoluções

delete_directory

Parâmetros

Devoluções

Exemplos

delete_sub_directory

Parâmetros

Devoluções

exists

Parâmetros

Devoluções

Tipo de retorno

from_connection_string

Parâmetros

Devoluções

Tipo de retorno

get_access_control

Parâmetros

get_directory_properties

Parâmetros

Tipo de retorno

Exemplos

get_file_client

Parâmetros

Devoluções

Tipo de retorno

get_sub_directory_client

Parâmetros

Devoluções

Tipo de retorno

remove_access_control_recursive

Parâmetros

Devoluções

Tipo de retorno

Exceções

rename_directory

Parâmetros

Devoluções

Exemplos

set_access_control

Parâmetros

set_access_control_recursive

Parâmetros

Devoluções

Tipo de retorno

Exceções

set_http_headers

Parâmetros

Devoluções

Tipo de retorno

set_metadata

Parâmetros

Devoluções

update_access_control_recursive

Parâmetros

Devoluções

Tipo de retorno

Exceções