Definir Propriedades do Diretório
A Set Directory Properties
operação define as propriedades do sistema para o diretório especificado. Esta API está disponível a partir da versão 2019-02-02.
Disponibilidade do protocolo
Protocolo de partilha de ficheiros ativado | Disponível |
---|---|
SMB | |
NFS |
Pedir
O Set Directory Properties
pedido pode ser construído da seguinte forma. Recomendamos que utilize HTTPS.
Método | URI do pedido | Versão HTTP |
---|---|---|
PUT | https://myaccount.file.core.windows.net/myshare/mydirectorypath/mydirectory?restype=directory&comp=properties |
HTTP/1.1 |
Substitua os componentes de caminho apresentados no URI do pedido pelo seu, da seguinte forma:
Componente caminho | Description |
---|---|
myaccount |
O nome da sua conta de armazenamento. |
myshare |
O nome da partilha de ficheiros. |
mydirectorypath |
Opcional. O caminho para o diretório principal. |
mydirectory |
O nome do ficheiro. |
Para obter informações sobre restrições de nomenclatura de caminhos, veja Partilhas de nomes e referências, diretórios, ficheiros e metadados.
Parâmetros do URI
Pode especificar os seguintes parâmetros adicionais no URI do pedido:
Parâmetro | Description |
---|---|
timeout |
Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, veja Definir tempos limite para operações do Serviço de ficheiros. |
Cabeçalhos do pedido
Os cabeçalhos de pedido obrigatórios e opcionais estão descritos na tabela seguinte:
Cabeçalho do pedido | Description |
---|---|
Authorization |
Obrigatório. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure. |
Date ou x-ms-date |
Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure. |
x-ms-version |
Necessário para todos os pedidos autorizados. Especifica a versão da operação a utilizar para este pedido. Para obter mais informações, veja Controlo de versões dos serviços de Armazenamento do Azure. |
x-ms-file-permission: { preserve ¦ <SDDL> } |
Nas versões 2019-02-02 a 2021-04-10, este cabeçalho é necessário se x-ms-file-permission-key não for especificado. A partir da versão 2021-06-08, ambos os cabeçalhos são opcionais. Esta permissão é o descritor de segurança do diretório especificado na Security Descriptor Definition Language (SDDL). Pode utilizar este cabeçalho se o tamanho das permissões for 8 kibibytes (KiB) ou menos. Caso contrário, pode utilizar x-ms-file-permission-key . Se for especificado, tem de ter uma lista de controlo de acesso discricionário (DACL) de proprietário, grupo e grupo. Para manter um valor existente inalterado, pode transmitir um valor de preserve .Nota: pode especificar ou x-ms-file-permission x-ms-file-permission-key . Se nenhum dos cabeçalhos for especificado, o valor predefinido de preserve é utilizado para o x-ms-file-permission cabeçalho. |
x-ms-file-permission-key: <PermissionKey> |
Nas versões 2019-02-02 a 2021-04-10, este cabeçalho é necessário se x-ms-file-permission não for especificado. A partir da versão 2021-06-08, ambos os cabeçalhos são opcionais. A chave da permissão a definir para o ficheiro. Isto pode ser criado com a Create-Permission API.Nota: pode especificar ou x-ms-file-permission x-ms-file-permission-key . Se nenhum dos cabeçalhos for especificado, o valor predefinido de preserve é utilizado para o x-ms-file-permission cabeçalho. |
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } |
Necessário para as versões 2019-02-02 a 2021-04-10. Opcional para a versão 2021-06-08 e posterior. Os atributos do sistema de ficheiros a definir no ficheiro. Veja a lista de atributos disponíveis. Um valor de preserve pode ser transmitido para manter um valor existente inalterado. O valor predefinido é preserve . |
x-ms-file-creation-time: { preserve ¦ <DateTime> } |
Necessário para as versões 2019-02-02 a 2021-04-10. Opcional para a versão 2021-06-08 e posterior. A propriedade hora de criação da Hora Universal Coordenada (UTC) para um diretório. Um valor de preserve pode ser transmitido para manter um valor existente inalterado. O valor predefinido é preserve . |
x-ms-file-last-write-time: { preserve ¦ <DateTime> } |
Necessário para as versões 2019-02-02 a 2021-04-10. Opcional para a versão 2021-06-08 e posterior. A última propriedade de escrita da Hora Universal Coordenada (UTC) para um diretório. Um valor de preserve pode ser transmitido para manter um valor existente inalterado. O valor predefinido é preserve . |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de carateres de 1 kibibyte (KiB) que é registado nos registos quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe. Para obter mais informações, veja Monitorizar Ficheiros do Azure. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Opcional. Versão 2021-06-08 e posterior. A propriedade Hora Universal Coordenada (UTC) altera a propriedade hora do diretório, formatada no formato ISO 8601. Pode utilizar um valor de now para indicar a hora do pedido. O valor predefinido é now . |
x-ms-file-request-intent |
Necessário se o Authorization cabeçalho especificar um token OAuth. O valor aceitável é backup . Este cabeçalho especifica que o Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action ou Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action deve ser concedido se estiver incluído na política RBAC atribuída à identidade autorizada com o Authorization cabeçalho. Disponível para a versão 2022-11-02 e posterior. |
x-ms-allow-trailing-dot: { <Boolean> } |
Opcional. Versão 2022-11-02 e posterior. O valor Booleano especifica se um ponto à direita presente no URL do pedido deve ser cortado ou não. Para obter mais informações, veja Naming and referencing shares, directories, files, and metadata (Atribuir nomes e referenciar partilhas, diretórios, ficheiros e metadados). |
Corpo do pedido
Nenhum.
Resposta
A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.
Código de estado
Uma operação bem-sucedida devolve o código de estado 200 (OK).
Para obter mais informações sobre códigos de estado, veja Códigos de estado e de erro.
Cabeçalhos de resposta
A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
Cabeçalho de resposta | Descrição |
---|---|
ETag |
Contém um valor que representa a versão do ficheiro. O valor está entre aspas. |
Last-Modified |
Devolve a data e hora em que o diretório foi modificado pela última vez. O formato de data segue RFC 1123. Para obter mais informações, veja Representar valores de data/hora em cabeçalhos. Qualquer operação que modifica o diretório ou as respetivas propriedades atualiza a hora da última modificação. As operações em ficheiros não afetam a hora da última modificação do diretório. |
x-ms-request-id |
Identifica exclusivamente o pedido que foi feito e pode ser utilizado para resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API. |
x-ms-version |
Indica a versão do Serviço de ficheiros que foi utilizada para executar o pedido. |
Date ou x-ms-date |
Um valor de data/hora UTC gerado pelo serviço, que indica a hora em que a resposta foi iniciada. |
x-ms-request-server-encrypted: true/false |
Versão 2017-04-17 e posterior. O valor deste cabeçalho é definido como true se os conteúdos do pedido forem encriptados com êxito através do algoritmo especificado. Caso contrário, o valor está definido como false . |
x-ms-file-permission-key |
Versão 2019-02-02 e posterior. A chave da permissão do diretório. |
x-ms-file-attributes |
Versão 2019-02-02 e posterior. Os atributos do sistema de ficheiros no diretório. Para obter mais informações, veja a lista de atributos disponíveis. |
x-ms-file-creation-time |
Versão 2019-02-02 e posterior. O valor de data/hora UTC que representa a propriedade de hora de criação do diretório. |
x-ms-file-last-write-time |
Versão 2019-02-02 e posterior. O valor de data/hora UTC que representa a última propriedade de hora de escrita do diretório. |
x-ms-file-change-time |
Versão 2019-02-02 e posterior. O valor de data/hora UTC que representa a propriedade de hora de alteração do diretório. |
x-ms-client-request-id |
Pode ser utilizado para resolver problemas de pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente no pedido e o valor não contiver mais de 1024 carateres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, não estará presente na resposta. |
Corpo da resposta
Nenhum.
Autorização
Apenas o proprietário da conta pode chamar esta operação.
Atributos do sistema de ficheiros
Atributo | Atributo de ficheiro Win32 | Definição |
---|---|---|
ReadOnly | FILE_ATTRIBUTE_READONLY | Um diretório só de leitura. |
Oculto | FILE_ATTRIBUTE_HIDDEN | O diretório está oculto. Não está incluído numa listagem de diretórios comum. |
Sistema | FILE_ATTRIBUTE_SYSTEM | Um diretório do qual o sistema operativo utiliza uma parte ou utiliza exclusivamente. |
Nenhuma | FILE_ATTRIBUTE_NORMAL | Um diretório que não tem outros atributos definidos. Este atributo só é válido quando é utilizado individualmente. |
Diretório | FILE_ATTRIBUTE_DIRECTORY | O identificador que identifica um diretório. |
Arquivo | FILE_ATTRIBUTE_ARCHIVE | Um diretório que é um diretório de arquivo. Normalmente, as aplicações utilizam este atributo para marcar ficheiros para cópia de segurança ou remoção. |
Offline | FILE_ATTRIBUTE_OFFLINE | Os dados de um diretório não estão disponíveis imediatamente. Este atributo do sistema de ficheiros é apresentado principalmente para fornecer compatibilidade com o Windows. Ficheiros do Azure não suporta opções de armazenamento offline. |
NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | O diretório não deve ser indexado pelo serviço de indexação de conteúdos. |
NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | O fluxo de dados do utilizador não deve ser lido pelo detetor de integridade de dados em segundo plano. Este atributo do sistema de ficheiros é apresentado principalmente para fornecer compatibilidade com o Windows. |
Observações
Set Directory Properties
não é suportado num instantâneo de partilha, que é uma cópia só de leitura de uma partilha. Uma tentativa de executar esta operação num instantâneo de partilha falha com 400 (InvalidQueryParameterValue).
As propriedades definidas num diretório com Set Directory Properties
não são propagadas para subdiretórios abaixo desse diretório. Tem de chamar Set Directory Properties
cada diretório para o qual pretende atualizar as propriedades.