Path - Update

  • Referência
Serviço:
Storage Services
Versão da API:
2023-08-03

Acrescentar Dados | Remover Dados | Definir Propriedades | Definir Controlo de Acesso
Carrega dados a acrescentar a um ficheiro, remove (escreve) dados carregados anteriormente para um ficheiro, define as propriedades de um ficheiro ou diretório ou define o controlo de acesso de um ficheiro ou diretório. Os dados só podem ser anexados a um ficheiro. As escritas simultâneas no mesmo ficheiro com vários clientes não são suportadas. Esta operação suporta pedidos HTTP condicionais. Para obter mais informações, veja Especificar Cabeçalhos Condicionais para Operações do Serviço Blob.

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}
Com parâmetros opcionais: 
PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&flush={flush}&timeout={timeout}

Parâmetros do URI

Name Em Necessário Tipo Description
accountName
 path True

string

O nome da conta de Armazenamento do Azure.
dnsSuffix
 path True

string

O sufixo DNS para o ponto final Azure Data Lake Storage.
filesystem
 path True

string

O identificador do sistema de ficheiros.

Padrão Regex: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path
 path True

string

O caminho do ficheiro ou diretório.
action
 query True

PathUpdateAction

A ação tem de ser "anexar" para carregar dados para serem anexados a um ficheiro, "flush" para remover dados carregados anteriormente para um ficheiro, "setProperties" para definir as propriedades de um ficheiro ou diretório ou "setAccessControl" para definir o proprietário, grupo, permissões ou lista de controlo de acesso para um ficheiro ou diretório ou "setAccessControlRecursive" para definir a lista de controlo de acesso de um diretório de forma recursiva. Tenha em atenção que o Espaço de Nomes Hierárquico tem de estar ativado para a conta para poder utilizar o controlo de acesso. Tenha também em atenção que a Lista de Controlo de Acesso (ACL) inclui permissões para o proprietário, o grupo proprietário e outros, pelo que os cabeçalhos de pedido x-ms-permissions e x-ms-acl são mutuamente exclusivos.
close
 query

boolean

Os Eventos de Armazenamento do Azure permitem que as aplicações recebam notificações quando os ficheiros são alterados. Quando os Eventos de Armazenamento do Azure estão ativados, é gerado um evento de alteração de ficheiro. Este evento tem uma propriedade que indica se esta é a alteração final para distinguir a diferença entre uma descarga intermédia para um fluxo de ficheiros e o fecho final de um fluxo de ficheiros. O parâmetro fechar consulta só é válido quando a ação é "flush" e as notificações de alteração estão ativadas. Se o valor de fechar for "verdadeiro" e a operação de remoção da cache for concluída com êxito, o serviço emitirá uma notificação de alteração de ficheiro com uma propriedade que indica que esta é a atualização final (o fluxo de ficheiros foi fechado). Se for apresentada uma notificação de alteração a indicar que o ficheiro foi alterado, será apresentada uma notificação de alteração. A predefinição é false. Este parâmetro de consulta está definido como verdadeiro pelo controlador do Hadoop ABFS para indicar que o fluxo de ficheiros foi fechado."
continuation
 query

string

Opcional e válido apenas para a operação "setAccessControlRecursive". O número de caminhos processados com cada invocação é limitado. Se o número de caminhos a processar exceder este limite, é devolvido um token de continuação no cabeçalho de resposta x-ms-continuation. Quando um token de continuação é devolvido na resposta, tem de ser codificado por percentagem e especificado numa invocação subsequente de setAccessControlRecursive operation.
flush
 query

boolean

Válido apenas para chamadas de acréscimo. Este parâmetro permite que o autor da chamada seja descarregado durante uma chamada de acréscimo. O valor predefinido é "false", se "verdadeiro" os dados forem descarregados com a chamada de acréscimo. Tenha em atenção que ao utilizar flush=true, os seguintes cabeçalhos não são suportados – "x-ms-cache-control", "x-ms-content-encoding", "x-ms-content-type", "x-ms-content-language", "x-ms-content-md5", "x-ms-content-disposition". Para definir estes cabeçalhos durante a descarga, utilize action=flush
forceFlag
 query

boolean

Opcional e válido apenas para a operação "setAccessControlRecursive". Se esta operação for "falsa", a operação terminará rapidamente ao deparar-se com erros de utilizador (4XX). Se for "verdadeiro", a aPI ignorará os erros do utilizador e prosseguirá com a operação noutras sub entidades do diretório. O estado detalhado dos erros do utilizador será devolvido na resposta para qualquer um dos cenários. O token de continuação só será devolvido quando forceFlag for "verdadeiro" em caso de erros do utilizador. O valor predefinido para forceFlag é falso.
maxRecords
 query

integer

int32

Opcional e válido apenas para a operação "setAccessControlRecursive". Especifica o número máximo de ficheiros ou diretórios nos quais a alteração da acl será aplicada. Se for omitido ou superior a 2000, o pedido processará até 2000 itens
mode
 query

string

Opcional. Válido e necessário para a operação "setAccessControlRecursive". O modo "definir" define os direitos de controlo de acesso POSIX em ficheiros e diretórios, "modificar" modifica um ou mais direitos de controlo de acesso POSIX que existem anteriormente em ficheiros e diretórios, "remover" remove um ou mais direitos de controlo de acesso POSIX que estavam presentes anteriormente em ficheiros e diretórios
position
 query

integer

int64

Este parâmetro permite que o autor da chamada carregue dados em paralelo e controle a ordem pela qual são anexados ao ficheiro. É necessário ao carregar dados para serem anexados ao ficheiro e ao remover dados carregados anteriormente para o ficheiro. O valor tem de ser a posição onde os dados devem ser acrescentados. Os dados carregados não são imediatamente descarregados ou escritos no ficheiro. Para remover a cache, os dados carregados anteriormente têm de ser contíguos, o parâmetro de posição tem de ser especificado e igual ao comprimento do ficheiro depois de todos os dados terem sido escritos e não pode haver um corpo de entidade de pedido incluído no pedido.
retainUncommittedData
 query

boolean

Válido apenas para operações de descarregamento. Se for "verdadeiro", os dados não consolidados serão retidos após a conclusão da operação de remoção de cache; caso contrário, os dados não comprometidos são eliminados após a operação de remoção da cache. A predefinição é false. Os dados em deslocamentos inferiores à posição especificada são escritos no ficheiro quando a remoção é concluída com êxito, mas este parâmetro opcional permite que os dados após a posição de remoção da cache sejam mantidos para uma operação de remoção futura.
timeout
 query

integer

int32

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

Cabeçalho do Pedido

Media Types: "application/octet-stream", "text/plain"

Name Necessário Tipo Description
Content-Length

integer

int64

Necessário para "Acrescentar Dados" e "Remover Dados". Tem de ser 0 para "Flush Data". Tem de ter a duração do conteúdo do pedido em bytes para "Acrescentar Dados".
Content-MD5

string

Opcional. Um hash MD5 do conteúdo do pedido. Este cabeçalho é válido nas operações "Acrescentar" e "Remover". Este hash é utilizado para verificar a integridade do conteúdo do pedido durante o transporte. Quando este cabeçalho é especificado, o serviço de armazenamento compara o hash do conteúdo que chegou com este valor do cabeçalho. Se os dois hashes não corresponderem, a operação falhará com o código de erro 400 (Pedido Incorreto). Tenha em atenção que este hash MD5 não é armazenado com o ficheiro. Este cabeçalho está associado ao conteúdo do pedido e não ao conteúdo armazenado do próprio ficheiro.
x-ms-lease-id

string

O ID de concessão tem de ser especificado se existir uma concessão ativa. Inválido para operações "setAccessControlRecursive".

Padrão Regex: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-cache-control

string

Opcional e apenas válido para operações de descarregamento e definição de propriedades. O serviço armazena este valor e inclui-o no cabeçalho de resposta "Cache-Control" para operações "Ler Ficheiro".
x-ms-content-type

string

Opcional e apenas válido para operações de descarregamento e definição de propriedades. O serviço armazena este valor e inclui-o no cabeçalho de resposta "Tipo de Conteúdo" para as operações "Ler Ficheiro".
x-ms-content-disposition

string

Opcional e apenas válido para operações de descarregamento e definição de propriedades. O serviço armazena este valor e inclui-o no cabeçalho de resposta "Content-Disposition" para operações "Ler Ficheiro".
x-ms-content-encoding

string

Opcional e apenas válido para operações de descarregamento e definição de propriedades. O serviço armazena este valor e inclui-o no cabeçalho de resposta "Codificação de Conteúdo" para operações "Ler Ficheiro".
x-ms-content-language

string

Opcional e apenas válido para operações de descarregamento e definição de propriedades. O serviço armazena este valor e inclui-o no cabeçalho de resposta "Content-Language" para operações "Ler Ficheiro".
x-ms-content-md5

string

Opcional e apenas válido para operações de "Propriedades de Descarregamento e Definir". O serviço armazena este valor e inclui-o no cabeçalho de resposta "Content-Md5" para as operações "Ler e Obter Propriedades". Se esta propriedade não for especificada no pedido, a propriedade será desmarcada para o ficheiro. As chamadas subsequentes para "Propriedades de Leitura e Obtenção" não devolverão esta propriedade, a menos que seja definida explicitamente nesse ficheiro novamente.
x-ms-properties

string

Opcional. Propriedades definidas pelo utilizador a serem armazenadas com o ficheiro ou diretório, no formato de uma lista separada por vírgulas de pares de nome e valor "n1=v1, n2=v2, ...", em que cada valor é uma cadeia codificada base64. Tenha em atenção que a cadeia só pode conter carateres ASCII no conjunto de carateres ISO-8859-1. Válido apenas para a operação setProperties. Se o ficheiro ou diretório existir, quaisquer propriedades não incluídas na lista serão removidas. Todas as propriedades serão removidas se o cabeçalho for omitido. Para intercalar propriedades novas e existentes, obtenha primeiro todas as propriedades existentes e a Etiqueta E atual e, em seguida, faça um pedido condicional com a Etiqueta E e inclua valores para todas as propriedades.
x-ms-owner

string

Opcional e válido apenas para a operação setAccessControl. Define o proprietário do ficheiro ou diretório.
x-ms-group

string

Opcional e válido apenas para a operação setAccessControl. Define o grupo proprietário do ficheiro ou diretório.
x-ms-permissions

string

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 (4), escrita (2) ou execução (1) a cada classe. Tanto a notação octal simbólica (rwxrw-rw-) como a notação octal de 4 dígitos (por exemplo, 0766) são suportadas. O sticky bit também é suportado e, em notação simbólica, é representado pela letra t ou T no local do caráter final, consoante o bit de execução para a categoria outras esteja definido ou desativado, respetivamente (por exemplo, rwxrw-rw- com sticky bit é representado como rwxrw-rwT. Um rwxrw-rwx com sticky bit é representado como rwxrw-rwt), a ausência de t ou T indica que sticky bit não está definido. Na notação octal de 4 dígitos, é representada por 1º dígito (por exemplo, 1766 representa rwxrw-rw- com sticky bit e 0766 representa rwxrw-rw- sem sticky bit). Inválido em conjunto com x-ms-acl.
x-ms-acl

string

Opcional e válido apenas para as operações setAccessControl e setAccessControlRecursive. Necessário para a operação setAccessControlRecursive. 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 que substitui totalmente a lista de controlo de acesso (ACL) existente no caso do modo setAccessControl e "set" de setAccessControlRecursive. O modo "modificar" de setAccessControlRecursive atualiza a ACLS pré-existente. 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]". O âmbito tem de ser "predefinido" para indicar que o ACE pertence à ACL predefinida de um diretório; caso contrário, o âmbito é implícito e o ACE pertence à ACL de acesso. Existem quatro tipos ACE: "utilizador" concede direitos ao proprietário ou a um utilizador nomeado, "grupo" concede direitos ao grupo proprietário ou a um grupo nomeado, "mask" restringe os direitos concedidos aos utilizadores nomeados e aos membros dos grupos e "outro" concede direitos a todos os utilizadores que não se encontrem em nenhuma das outras entradas. O identificador de utilizador ou grupo é omitido para entradas do tipo "mask" e "other". O identificador de utilizador ou grupo também é omitido para o proprietário e o grupo proprietário. O campo de permissão é uma sequência de 3 carateres em que o primeiro caráter é "r" para conceder acesso de leitura, o segundo caráter é "w" para conceder acesso de escrita e o terceiro caráter é "x" para conceder permissão de execução. Se o acesso não for concedido, o caráter "-" é utilizado para indicar que a permissão é negada. Por exemplo, a seguinte ACL concede direitos de leitura, escrita e execução ao proprietário do ficheiro e john.doe@contoso, o direito de leitura ao grupo proprietário e nada para todos os outros utilizadores: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Inválido em conjunto com x-ms-permissions. O modo "remover" de setAccessControlRecursive remove as ACLs pré-existentes e não deve conter permissões na lista de controlo de acesso especificada: "user:john.doe@contoso:, mask:". O modo "set" de setAccessControlRecursive define as ACLs que substituem as ACLs pré-existentes do âmbito especificado e têm de conter as três - utilizador proprietário, grupo proprietário e outras informações se o âmbito de acesso estiver a ser definido ou se um dos utilizadores proprietário, grupo proprietário ou outro estiver a ser definido no âmbito predefinido. Os modos "set" e "modify" de setAccessControlRecursive têm de conter permissões como parte da lista de controlo de acesso.
If-Match

string

Opcional para Remover Dados, Definir Controlo de Acesso e Definir Propriedades, mas inválido para Acrescentar Dados e Definir Controlo de Acesso Recursivo. Um valor ETag. Especifique este cabeçalho para executar a operação apenas se a ETag do recurso corresponder ao valor especificado. A ETag tem de ser especificada entre aspas.
If-None-Match

string

Opcional para Remover Dados, Definir Controlo de Acesso e Definir Propriedades, mas inválido para Acrescentar Dados e Definir Controlo de Acesso Recursivo. Um valor ETag ou o valor de caráter universal especial ("*"). Especifique este cabeçalho para executar a operação apenas se a ETag do recurso não corresponder ao valor especificado. A ETag tem de ser especificada entre aspas.
If-Modified-Since

string

Opcional para Remover Dados e Definir Propriedades, mas inválido para Acrescentar Dados e Definir Controlo de Acesso Recursivo. Um valor de data e hora. Especifique este cabeçalho para executar a operação apenas se o recurso tiver sido modificado desde a data e hora especificadas.
If-Unmodified-Since

string

Opcional para Remover Dados e Definir Propriedades, mas inválido para Acrescentar Dados e Definir Controlo de Acesso Recursivo. Um valor de data e hora. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data e hora especificadas.
x-ms-encryption-key

string

Opcional. A chave de encriptação AES-256 codificada com Base64.
x-ms-encryption-key-sha256

string

Opcional. O hash SHA256 codificado com Base64 da chave de encriptação.
x-ms-encryption-algorithm: AES256

string

Opcional. Especifica o algoritmo a utilizar para encriptação. O valor deste cabeçalho tem de ser AES256.
x-ms-lease-action True

PathLeaseAction

A partir da versão 2020-08-04 em operações de acréscimo e descarga. O acréscimo suporta a ação "adquirir", "renovação automática" e "adquirir versão". Se "adquirir", adquirirá a concessão. Se "renovação automática", renovará a concessão. Se "acquire-release" adquirir & concluir a operação & libertar a concessão assim que a operação estiver concluída. A ação "Libertar" só é suportada na operação de remoção da cache. Se for "verdadeiro", libertará a concessão no ficheiro com as informações de ID de concessão do cabeçalho x-ms-lease-id.
x-ms-lease-duration

integer

int32

A duração da concessão é necessária para adquirir uma concessão e especifica a duração da concessão em segundos. A duração da concessão tem de estar entre 15 e 60 segundos ou -1 para concessão infinita.
x-ms-proposed-lease-id

string

Necessário quando "x-ms-lease-action" é "adquirir" ou "alterar". Uma concessão será adquirida com este ID de concessão se a operação for bem-sucedida.

Padrão Regex: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-client-request-id

string

Um UUID registado nos registos de análise para resolução de problemas e correlação.

Padrão Regex: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date

string

Especifica a Hora Universal Coordenada (UTC) do pedido. Isto é necessário ao utilizar a autorização de chave partilhada.
x-ms-version

string

Especifica a versão do protocolo REST utilizada para processar o pedido. Isto é necessário ao utilizar a autorização de chave partilhada.

Corpo do Pedido

Media Types: "application/octet-stream", "text/plain"

Name Tipo Description
requestBody

object

Válido apenas para operações de acréscimo. Os dados a carregar e anexar ao ficheiro.

Respostas

Name Tipo Description
200 OK

SetAccessControlRecursiveResponse

Os dados foram descarregados (escritos) para o ficheiro ou as propriedades foram definidas com êxito. O corpo da resposta é opcional e é válido apenas para "SetAccessControlRecursive"

Cabeçalhos

  • Date: string
  • ETag: string
  • Last-Modified: string
  • Accept-Ranges: string
  • Cache-Control: string
  • Content-Disposition: string
  • Content-Encoding: string
  • Content-Language: string
  • Content-Length: integer
  • Content-Range: string
  • Content-Type: string
  • Content-MD5: string
  • x-ms-properties: string
  • x-ms-continuation: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-request-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-scope: string
  • x-ms-lease-renewed: boolean
202 Accepted

Os dados carregados foram aceites.

Cabeçalhos

  • Content-MD5: string
  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-lease-renewed: boolean
Other Status Codes

DataLakeStorageError

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

  • 400 Pedido Incorreto, ContentLengthMustBeZero, "O cabeçalho do pedido Content-Length tem de ser zero".
  • 400 Pedido Incorreto, InvalidAuthenticationInfo, "As informações de autenticação não são fornecidas no formato correto. Verifique o valor do cabeçalho Autorização."
  • 400 Pedido Incorreto, 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 ficheiro depois de acrescentar os dados carregados."
  • 400 Pedido Incorreto, InvalidHeaderValue, "O valor de um dos cabeçalhos HTTP não está no formato correto."
  • 400 Pedido Inválido, InválidoHttpVerb, "O verbo HTTP especificado é inválido – não é reconhecido pelo servidor."
  • 400 Pedido Incorreto, InvalidInput, "Uma das entradas do pedido não é válida".
  • 400 Pedido Inválido, InvalidPropertyName, "Um nome de propriedade não pode estar vazio".
  • 400 Pedido Inválido, InvalidPropertyName, "O nome da propriedade contém carateres inválidos.".
  • 400 Pedido Inválido, InvalidQueryParameterValue, "O valor de um dos parâmetros de consulta especificados no URI do pedido é inválido."
  • 400 Pedido Inválido, InvalidResourceName, "O nome do recurso especificado contém carateres inválidos.".
  • 400 Pedido Incorreto, InvalidSourceUri, "O URI de origem é inválido".
  • 400 Pedido Incorreto, InvalidUri, "O URI do pedido é inválido".
  • 400 Pedido Incorreto, MissingRequiredHeader, "Não foi especificado um cabeçalho HTTP obrigatório para este pedido.".
  • 400 Pedido Incorreto, MissingRequiredQueryParameter, "Não foi especificado um parâmetro de consulta obrigatório para este pedido.".
  • 400 Pedido Incorreto, MultipleConditionHeadersNotSupported, "Vários cabeçalhos de condição não são suportados".
  • 400 Pedido Incorreto, OutOfRangeInput, "Uma das entradas do pedido está fora do intervalo".
  • 400 Pedido Incorreto, OutOfRangeQueryParameterValue, "Um dos parâmetros de consulta especificados no URI do pedido está fora do intervalo permitido."
  • 400 Pedido Incorreto, Não SuportadoHeader, "Um dos cabeçalhos especificados no pedido não é suportado."
  • 400 Pedido Incorreto, Não SuportadoQueryParameter, "Um dos parâmetros de consulta especificados no URI do pedido não é suportado."
  • 400 Pedido Incorreto, UnsupportedRestVersion, "A Versão Rest especificada não é suportada".
  • 403 Proibido, AccountIsDisabled, "A conta especificada está desativada".
  • 403 Proibido, AuthorizationFailure, "Este pedido não está autorizado a realizar esta operação."
  • 403 Proibido, InsufficientAccountPermissions, "A conta a ser acedida não tem permissões suficientes para executar esta operação."
  • 404 Não Encontrado, FilesystemNotFound, "O sistema de ficheiros especificado não existe".
  • 404 Não Encontrado, PathNotFound, "O caminho especificado não existe".
  • 404 Não Encontrado, RenameDestinationParentPathNotFound, "O diretório principal 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 mudança de nome não existe".
  • Método 405 Não Permitido, Não SuportadoHttpVerb, "O recurso não suporta o verbo HTTP especificado".
  • 409 Conflito, DestinationPathIsBeingDeleted, "O caminho de destino especificado está marcado para ser eliminado".
  • 409 Conflito, DirectoryNotEmpty, "O valor do parâmetro de consulta recursivo tem de ser verdadeiro para eliminar um diretório não vazio."
  • 409 Conflito, FilesystemAlreadyExists, "O sistema de ficheiros especificado já existe".
  • 409 Conflito, FilesystemBeingDeleted, "O sistema de ficheiros especificado está a ser eliminado".
  • 409 Conflito, InvalidDestinationPath, "O caminho especificado, ou um elemento do caminho, existe e o tipo de recurso é inválido para esta operação." * 409 Conflito, InvalidFlushOperation, "O recurso foi criado ou modificado pela API do Serviço Blob e não pode ser escrito pela API de Serviço Data Lake Storage.".
  • 409 Conflito, 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 Conflito, InvalidSourceOrDestinationResourceType, "O tipo de recurso de origem e destino tem de ser idêntico".
  • 409 Conflito, LeaseAlreadyPresent, "Já existe uma concessão presente."
  • 409 Conflito, LeaseIdMismatchWithLeaseOperation, "O ID de concessão especificado não correspondeu ao ID de concessão do recurso com a operação de concessão especificada."
  • 409 Conflito, LeaseIsAlreadyBroken, "A concessão já foi quebrada e não pode ser quebrada novamente."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "The lease ID matched, but the lease is currently in breaking state and cannot be acquired until it is broken."
  • 409 Conflito, LeaseIsBreakingAndCannotBeChanged, "O ID de concessão correspondeu, mas a concessão está atualmente em estado de interrupção e não pode ser alterada."
  • 409 Conflito, LeaseIsBrokenAndCannotBeRenewed, "O ID de concessão correspondeu, mas a concessão foi quebrada explicitamente e não pode ser renovada."
  • 409 Conflito, LeaseNameMismatch, "O nome da concessão especificado não corresponde ao nome da concessão existente."
  • 409 Conflito, LeaseNotPresentWithLeaseOperation, "O ID de concessão não está presente na operação de concessão especificada."
  • 409 Conflito, PathAlreadyExists, "O caminho especificado já existe".
  • 409 Conflito, PathConflict, "O caminho especificado, ou um elemento do caminho, existe e o tipo de recurso é inválido para esta operação."
  • 409 Conflito, SourcePathIsBeingDeleted, "O caminho de origem especificado está marcado para ser eliminado".
  • 409 Conflito, ResourceTypeMismatch, "O tipo de recurso especificado no pedido não corresponde ao tipo de recurso."
  • 412 Precondition Failed, ConditionNotMet, "The condition specified using HTTP conditional header(s) is not met."
  • 412 Precondition Failed, LeaseIdMismatch, "The lease ID specified not match the lease ID for the resource."
  • 412 Precondition Failed, LeaseIdMissing, "There is currently a lease on the resource and no lease ID was specified in the request."
  • 412 Precondition Failed, LeaseNotPresent, "Não existe atualmente nenhuma concessão no recurso.".
  • 412 Precondition Failed, LeaseLost, "A lease ID was specified, but the lease for the resource has expired."
  • 412 Precondition Failed, SourceConditionNotMet, "The source condition specified using HTTP conditional header(s) is not met."
  • 413 Request Entity Too Large, RequestBodyTooLarge, "The request body is too large and exceeds the maximum permissible limit."
  • 416 Intervalo Pedido Não Satisfiable, InvalidRange, "O intervalo especificado é inválido para o tamanho atual do recurso."
  • Erro interno do Servidor 500, InternalError, "O servidor encontrou um erro interno. Repita o pedido."
  • 500 Erro interno do Servidor, OperationTimedOut, "Não foi possível concluir a operação dentro do tempo permitido".
  • 503 Serviço Indisponível, ServerBusy, "A saída ultrapassou o 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".
  • Serviço 503 Indisponível, ServerBusy, "Atualmente, o servidor não consegue receber pedidos. Tente novamente o seu pedido."

Cabeçalhos

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

Definições

Name Description
AclFailedEntryList
DataLakeStorageError
Error

O objeto de resposta de erro do serviço.
PathLeaseAction

A partir da versão 2020-08-04 em operações de acréscimo e descarga. O acréscimo suporta a ação "adquirir", "renovação automática" e "adquirir versão". Se "adquirir", adquirirá a concessão. Se "renovação automática", renovará a concessão. Se "acquire-release" adquirir & concluir a operação & libertar a concessão assim que a operação estiver concluída. A ação "Libertar" só é suportada na operação de remoção da cache. Se for "verdadeiro", libertará a concessão no ficheiro com as informações de ID de concessão do cabeçalho x-ms-lease-id.
PathUpdateAction

A ação tem de ser "anexar" para carregar dados para serem anexados a um ficheiro, "flush" para remover dados carregados anteriormente para um ficheiro, "setProperties" para definir as propriedades de um ficheiro ou diretório ou "setAccessControl" para definir o proprietário, grupo, permissões ou lista de controlo de acesso para um ficheiro ou diretório ou "setAccessControlRecursive" para definir a lista de controlo de acesso de um diretório de forma recursiva. Tenha em atenção que o Espaço de Nomes Hierárquico tem de estar ativado para a conta para poder utilizar o controlo de acesso. Tenha também em atenção que a Lista de Controlo de Acesso (ACL) inclui permissões para o proprietário, o grupo proprietário e outros, pelo que os cabeçalhos de pedido x-ms-permissions e x-ms-acl são mutuamente exclusivos.
SetAccessControlRecursiveResponse

AclFailedEntryList

Name Tipo Description
errorMessage

string

name

string

type

string

DataLakeStorageError

Name Tipo Description
error

Error

O objeto de resposta de erro do serviço.

Error

O objeto de resposta de erro do serviço.

Name Tipo Description
code

string

O código de erro do serviço.
message

string

A mensagem de erro do serviço.

PathLeaseAction

A partir da versão 2020-08-04 em operações de acréscimo e descarga. O acréscimo suporta a ação "adquirir", "renovação automática" e "adquirir versão". Se "adquirir", adquirirá a concessão. Se "renovação automática", renovará a concessão. Se "acquire-release" adquirir & concluir a operação & libertar a concessão assim que a operação estiver concluída. A ação "Libertar" só é suportada na operação de remoção da cache. Se for "verdadeiro", libertará a concessão no ficheiro com as informações de ID de concessão do cabeçalho x-ms-lease-id.

Name Tipo Description
acquire

string

acquire-release

string

auto-renew

string

release

string

PathUpdateAction

A ação tem de ser "anexar" para carregar dados para serem anexados a um ficheiro, "flush" para remover dados carregados anteriormente para um ficheiro, "setProperties" para definir as propriedades de um ficheiro ou diretório ou "setAccessControl" para definir o proprietário, grupo, permissões ou lista de controlo de acesso para um ficheiro ou diretório ou "setAccessControlRecursive" para definir a lista de controlo de acesso de um diretório de forma recursiva. Tenha em atenção que o Espaço de Nomes Hierárquico tem de estar ativado para a conta para poder utilizar o controlo de acesso. Tenha também em atenção que a Lista de Controlo de Acesso (ACL) inclui permissões para o proprietário, o grupo proprietário e outros, pelo que os cabeçalhos de pedido x-ms-permissions e x-ms-acl são mutuamente exclusivos.

Name Tipo Description
append

string

flush

string

setAccessControl

string

setAccessControlRecursive

string

setProperties

string

SetAccessControlRecursiveResponse

Name Tipo Description
directoriesSuccessful

integer

failedEntries

AclFailedEntryList[]

failureCount

integer

filesSuccessful

integer