Share via


Filesystem - List

Listar sistemas de arquivos e suas propriedades em determinada conta.

GET https://{accountName}.{dnsSuffix}/?resource=account
GET https://{accountName}.{dnsSuffix}/?resource=account&prefix={prefix}&continuation={continuation}&maxResults={maxResults}&timeout={timeout}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
accountName
path True

string

O nome da conta do Armazenamento do Azure.

dnsSuffix
path True

string

O sufixo DNS para o ponto de extremidade Azure Data Lake Storage.

resource
query True

AccountResourceType

O valor deve ser "account" para todas as operações de conta.

continuation
query

string

O número de sistemas de arquivos retornados com cada invocação é limitado. Se o número de sistemas de arquivos a serem retornados exceder esse limite, um token de continuação será retornado no cabeçalho de resposta x-ms-continuation. Quando um token de continuação é retornado na resposta, ele deve ser especificado em uma invocação subsequente da operação de lista para continuar listando os sistemas de arquivos.

maxResults
query

integer

int32

Um valor opcional que especifica o número máximo de itens a serem retornados. Se for omitido ou maior que 5.000, a resposta incluirá até 5.000 itens.

prefix
query

string

Filtra os resultados para sistemas de arquivos dentro do prefixo especificado.

timeout
query

integer

int32

Um valor de tempo limite de operação opcional em segundos. O período começa quando a solicitação é recebida pelo serviço. Se o valor do tempo limite passar antes da conclusão da operação, a operação falhará.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
x-ms-client-request-id

string

Uma UUID registrada nos logs de análise para solução de problemas e correlação.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-date

string

Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Isso é necessário ao usar a autorização de chave compartilhada.

x-ms-version

string

Especifica a versão do protocolo REST usada para processar a solicitação. Isso é necessário ao usar a autorização de chave compartilhada.

Respostas

Nome Tipo Description
200 OK

FilesystemList

OK

Headers

  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
  • Content-Type: string
  • x-ms-default-encryption-scope: string
  • x-ms-deny-encryption-scope-override: boolean
Other Status Codes

DataLakeStorageError

Ocorreu um erro. As possíveis cadeias de caracteres http status, código e mensagem estão listadas abaixo:

  • 400 Solicitação Inválida, ContentLengthMustBeZero, "O cabeçalho da solicitação Content-Length deve ser zero".
  • 400 Solicitação Inválida, InvalidAuthenticationInfo, "As informações de autenticação não são fornecidas no formato correto. Verifique o valor do cabeçalho De autorização."
  • 400 Solicitação Inválida, InvalidFlushPosition: "Os dados carregados não são contíguos ou o valor do parâmetro de consulta de posição não é igual ao comprimento do arquivo depois de acrescentar os dados carregados."
  • 400 Solicitação Inválida, InvalidHeaderValue: "O valor de um dos cabeçalhos HTTP não está no formato correto"
  • 400 Solicitação Inválida, InvalidHttpVerb, "O verbo HTTP especificado é inválido - ele não é reconhecido pelo servidor.".
  • 400 Solicitação Inválida, InvalidInput, "Uma das entradas de solicitação não é válida".
  • 400 Solicitação Inválida, InvalidPropertyName, "Um nome de propriedade não pode estar vazio".
  • 400 Solicitação Inválida, InvalidPropertyName, "O nome da propriedade contém caracteres inválidos".
  • 400 Solicitação Inválida, InvalidQueryParameterValue, "O valor de um dos parâmetros de consulta especificados no URI de solicitação é inválido".
  • 400 Solicitação Inválida, InvalidResourceName, "O nome do recurso especificado contém caracteres inválidos."
  • 400 Solicitação Inválida, InvalidSourceUri, "O URI de origem é inválido".
  • 400 Solicitação Inválida, InvalidUri, "O URI de solicitação é inválido".
  • 400 Solicitação Incorreta, MissingRequiredHeader, "Um cabeçalho HTTP obrigatório para essa solicitação não é especificado."
  • 400 Solicitação Inválida, MissingRequiredQueryParameter, "Um parâmetro de consulta obrigatório para essa solicitação não é especificado."
  • 400 Solicitação Incorreta, MultipleConditionHeadersNotSupported, "Não há suporte para vários cabeçalhos de condição".
  • 400 Solicitação Inválida, OutOfRangeInput, "Uma das entradas de solicitação está fora do intervalo".
  • 400 Solicitação Inválida, OutOfRangeQueryParameterValue, "Um dos parâmetros de consulta especificados no URI de solicitação está fora do intervalo permitido".
  • 400 Solicitação Inválida, Sem SuporteHeader, "Não há suporte para um dos cabeçalhos especificados na solicitação".
  • 400 Solicitação Inválida, UnsupportedQueryParameter, "Não há suporte para um dos parâmetros de consulta especificados no URI de solicitação".
  • 400 Solicitação Inválida, Sem SuporteRestVersion, "A versão rest especificada não tem suporte".
  • 403 Proibido, AccountIsDisabled, "A conta especificada está desabilitada".
  • 403 Proibido, AuthorizationFailure, "Esta solicitação não está autorizada a executar esta operação.".
  • 403 Proibido, InsufficientAccountPermissions: "A conta que está sendo acessada não tem permissões suficientes para executar esta operação.".
  • 404 Não Encontrado, FilesystemNotFound, "O sistema de arquivos especificado não existe".
  • 404 Não Encontrado, PathNotFound, "O caminho especificado não existe".
  • 404 Não Encontrado, RenameDestinationParentPathNotFound, "O diretório pai do caminho de destino não existe".
  • 404 Não Encontrado, ResourceNotFound, "O recurso especificado não existe".
  • 404 Não Encontrado, SourcePathNotFound, "O caminho de origem para uma operação de renomeação não existe".
  • Método 405 Não Permitido, Sem SuporteHttpVerb, "O recurso não dá suporte ao verbo HTTP especificado".
  • 409 Conflict, DestinationPathIsBeingDeleted, "O caminho de destino especificado está marcado para ser excluído".
  • 409 Conflict, DirectoryNotEmpty, "O valor do parâmetro de consulta recursiva deve ser true para excluir um diretório não vazio.".
  • 409 Conflict, FilesystemAlreadyExists, "O sistema de arquivos especificado já existe".
  • 409 Conflict, FilesystemBeingDeleted, "O sistema de arquivos especificado está sendo excluído".
  • 409 Conflict, InvalidDestinationPath, "O caminho especificado ou um elemento do caminho existe e seu tipo de recurso é inválido para esta operação." * 409 Conflict, InvalidFlushOperation, "O recurso foi criado ou modificado pela API do Serviço blob e não pode ser gravado pela API do Serviço Data Lake Storage".
  • 409 Conflict, InvalidRenameSourcePath, "O diretório de origem não pode ser o mesmo que o diretório de destino, nem o destino pode ser um subdiretório do diretório de origem."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "O tipo de recurso de origem e destino deve ser idêntico."
  • 409 Conflict, LeaseAlreadyPresent, "Já há uma concessão presente."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "A ID de concessão especificada não correspondeu à ID de concessão do recurso com a operação de concessão especificada.".
  • 409 Conflict, LeaseIsAlreadyBroken: "O aluguel já foi quebrado e não pode ser quebrado novamente."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired: "A ID de concessão correspondeu, mas a concessão está atualmente em estado de quebra e não pode ser adquirida até que seja quebrada."
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "A ID de concessão correspondeu, mas a concessão está atualmente em estado de quebra e não pode ser alterada."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "A ID de concessão correspondeu, mas a concessão foi interrompida explicitamente e não pode ser renovada."
  • 409 Conflict, LeaseNameMismatch, "O nome de concessão especificado não correspondeu ao nome de concessão existente.".
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "A ID de concessão não está presente com a operação de concessão especificada".
  • 409 Conflict, PathAlreadyExists, "O caminho especificado já existe.".
  • 409 Conflict, PathConflict, "O caminho especificado ou um elemento do caminho existe e seu tipo de recurso é inválido para esta operação."
  • Conflito 409, SourcePathIsBeingDeleted, "O caminho de origem especificado está marcado para ser excluído.".
  • 409 Conflict, ResourceTypeMismatch, "O tipo de recurso especificado na solicitação não corresponde ao tipo do recurso".
  • 412 Precondition Failed, ConditionNotMet, "A condição especificada usando cabeçalhos condicionais HTTP não é atendida."
  • 412 Precondition Failed, LeaseIdMismatch, "A ID de concessão especificada não correspondeu à ID de concessão do recurso.".
  • 412 Precondition Failed, LeaseIdMissing: "Atualmente, há uma concessão no recurso e nenhuma ID de concessão foi especificada na solicitação."
  • 412 Precondition Failed, LeaseNotPresent, "No momento, não há nenhuma concessão no recurso".
  • 412 Precondition Failed, LeaseLost, "Uma ID de concessão foi especificada, mas a concessão do recurso expirou."
  • 412 Precondition Failed, SourceConditionNotMet, "A condição de origem especificada usando cabeçalhos condicionais HTTP não é atendida."
  • 413 Entidade de Solicitação Muito Grande, RequestBodyTooLarge: "O corpo da solicitação é muito grande e excede o limite máximo permitido".
  • 416 Intervalo Solicitado Não Satisfiável, InvalidRange: "O intervalo especificado é inválido para o tamanho atual do recurso".
  • 500 Erro interno do servidor, InternalError, "O servidor encontrou um erro interno. Repita a solicitação."
  • 500 Erro interno do servidor, OperationTimedOut, "A operação não pôde ser concluída dentro do tempo permitido".
  • 503 Serviço Indisponível, ServerBusy, "A saída está acima do limite da conta".
  • 503 Serviço Indisponível, ServerBusy, "A entrada está acima do limite da conta".
  • 503 Serviço Indisponível, ServerBusy, "As operações por segundo estão acima do limite da conta".
  • 503 Serviço Indisponível, ServerBusy, "No momento, o servidor não pode receber solicitações. Tente novamente a sua solicitação.”

Headers

  • x-ms-request-id: string
  • x-ms-version: string

Definições

Nome Description
AccountResourceType

O valor deve ser "account" para todas as operações de conta.

DataLakeStorageError
Error

O objeto de resposta de erro de serviço.

Filesystem
FilesystemList

AccountResourceType

O valor deve ser "account" para todas as operações de conta.

Nome Tipo Description
account

string

DataLakeStorageError

Nome Tipo Description
error

Error

O objeto de resposta de erro de serviço.

Error

O objeto de resposta de erro de serviço.

Nome Tipo Description
code

string

O código de erro do serviço.

message

string

A mensagem de erro do serviço.

Filesystem

Nome Tipo Description
eTag

string

lastModified

string

name

string

FilesystemList

Nome Tipo Description
filesystems

Filesystem[]