Forçar identificadores de fechamento
A operação Force Close Handles
fecha um identificador ou identificador aberto em um diretório ou arquivo. Ele dá suporte ao fechamento de um único identificador especificado pela ID do identificador em um arquivo ou diretório. Ele também dá suporte ao fechamento de todos os identificadores abertos nesse recurso. Opcionalmente, ele dá suporte ao fechamento recursivo de identificadores em sub-recursos quando o recurso é um diretório.
Use essa operação juntamente com de Identificadores de Lista para forçar o fechamento de identificadores que bloqueiam operações, como renomear um diretório. Os clientes SMB podem ter vazado ou perdido o controle desses identificadores. A operação tem um impacto do lado do cliente no identificador que você está fechando, incluindo erros visíveis do usuário devido a tentativas de leitura ou gravação de arquivos com falha. Esta operação não se destina como uma substituição ou alternativa para fechar uma sessão SMB.
Essa operação está disponível na versão 2018-11-09 e posterior.
Disponibilidade do protocolo
Protocolo de compartilhamento de arquivos habilitado | Disponível |
---|---|
SMB |
![]() |
NFS |
![]() |
Pedir
A solicitação Force Close Handles
é construída da seguinte maneira. Recomendamos que você use HTTPS.
Método | URI de solicitação | Versão HTTP |
---|---|---|
PÔR | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
HTTP/1.1 |
Substitua os componentes de caminho mostrados no URI da solicitação por seus próprios, da seguinte maneira:
Componente path | Descrição |
---|---|
myaccount |
O nome da sua conta de armazenamento. |
myshare |
O nome do compartilhamento de arquivos. |
mydirectorypath |
Opcional. O caminho para o diretório. |
myfileordirectory |
O nome do arquivo ou diretório. |
Para obter detalhes sobre restrições de nomenclatura de caminho, consulte Nomenclatura e referência a compartilhamentos, diretórios, arquivos e metadados.
Parâmetros de URI
Você pode especificar os seguintes parâmetros adicionais no URI:
Parâmetro | Descrição |
---|---|
timeout |
Opcional. Expresso em segundos. Para obter mais informações, consulte Definir tempos limite para operações de serviço de arquivo. |
marker |
Opcional. Um valor de cadeia de caracteres que identifica a posição dos identificadores que serão fechados com a próxima operação de Force Close Handles . A operação retornará um valor de marcador dentro do corpo da resposta se houver mais identificadores a serem fechados. Em seguida, o valor do marcador pode ser usado em uma chamada subsequente para fechar o próximo conjunto de identificadores.O valor do marcador é opaco para o cliente. |
sharesnapshot |
Opcional. Um valor opaco de data/hora. Quando estiver presente, ele especifica o instantâneo de compartilhamento para consultar a lista de identificadores. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais:
Cabeçalho de solicitação | Descrição |
---|---|
Authorization |
Necessário. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure. |
Date ou x-ms-date |
Necessário. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure. |
x-ms-version |
Necessário para todas as solicitações autorizadas, mas opcional para solicitações anônimas. Especifica a versão da operação a ser usada para essa solicitação. Para obter mais informações, consulte Controle de versão para os serviços de Armazenamento do Azure. |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres kib (1 kibibyte) que é registrado nos logs quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. |
x-ms-handle-id |
Necessário. Especifica a ID do identificador a ser fechada. Use um asterisco (*) como uma cadeia de caracteres curinga para especificar todos os identificadores. |
x-ms-recursive |
Opcional. Um valor booliano que especifica se a operação também deve se aplicar aos arquivos e subdiretórios do diretório especificado no URI. |
x-ms-file-request-intent |
Necessário se Authorization cabeçalho especificar um token OAuth. O valor aceitável é backup . Esse cabeçalho especifica que os Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action ou Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action devem ser concedidos se forem incluídos na política RBAC atribuída à identidade autorizada usando o cabeçalho Authorization . 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 booliano especifica se um ponto à direita presente na URL da solicitação deve ser cortado ou não. Para obter mais informações, consulte Nomenclatura e referência a compartilhamentos, diretórios, arquivos e metadados. |
Corpo da solicitação
Nenhum.
Resposta
A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta no formato XML.
Código de status
Uma operação bem-sucedida retorna o código de status 200 (OK). Para obter informações sobre códigos de status, consulte Status e códigos de erro.
Cabeçalhos de resposta
A resposta dessa operação inclui os cabeçalhos na tabela a seguir. 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 de protocolo HTTP/1.1 .
Cabeçalhos comuns
Cabeçalho de resposta | Descrição |
---|---|
x-ms-request-id |
Identifica exclusivamente a solicitação que foi feita. Você pode usá-la para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API. |
x-ms-version |
Indica a versão dos Arquivos do Azure usada para executar a solicitação. |
Date |
Um valor de data/hora UTC que indica a hora em que o serviço enviou a resposta. |
x-ms-marker |
Descreve o próximo identificador a ser fechado. Essa cadeia de caracteres é retornada quando mais identificadores precisam ser fechados para concluir a solicitação. A cadeia de caracteres é usada em solicitações subsequentes para forçar o fechamento de alças restantes. A ausência de x-ms-marker indica que todos os identificadores relevantes foram fechados. |
x-ms-number-of-handles-closed |
Indica o número de identificadores fechados. |
x-ms-number-of-handles-failed |
Indica o número de identificadores que não foram fechados. |
x-ms-client-request-id |
Pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho é igual ao valor do cabeçalho x-ms-client-request-id , se ele estiver presente na solicitação e o valor for no máximo 1.024 caracteres ASCII visíveis. Se o cabeçalho x-ms-client-request-id não estiver presente na solicitação, esse cabeçalho não estará presente na resposta. |
Corpo da resposta
Vazio.
Autorização
Somente o proprietário da conta pode chamar essa operação.
Observações
Se nenhum identificador for fechado durante o processamento de solicitações (por exemplo, o valor de x-ms-handle-id
fornecido especifica um identificador inválido ou nenhum identificador aberto foi encontrado no arquivo ou diretório fornecido) você obterá uma resposta de status 200 (OK) com x-ms-number-of-handles-closed=0
.
O cabeçalho x-ms-recursive
é válido apenas para diretórios. Se você especificá-lo para um arquivo, obterá uma resposta 400 (Solicitação Incorreta).
Forçar o fechamento de um identificador aberto com FILE_FLAG_DELETE_ON_CLOSE
pode não fazer com que o arquivo seja excluído.
de Identificadores de Lista retorna a ID do identificador do lado do serviço x-ms-handle-id
. Essa ID de identificador é diferente da alça do lado do cliente correspondente que o SMB ou um aplicativo mantém.
Consulte também
- operações de em arquivos
- operações de em diretórios