Forçar Alças de Fecho

Artigo
03/29/2023

A Force Close Handles operação fecha um identificador ou identificadores abertos num diretório ou num ficheiro. Suporta o fecho de um único identificador especificado pelo ID do identificador num ficheiro ou diretório. Também suporta fechar todos os identificadores abertos nesse recurso. Opcionalmente, suporta identificadores de fecho recursivo em sub-recursos quando o recurso é um diretório.

Utilize esta operação juntamente com Os Identificadores de Lista para forçar o fecho de identificadores que bloqueiam operações, como mudar o nome de um diretório. Os clientes SMB podem ter vazado ou perdido o registo destes identificadores. A operação tem um impacto no lado do cliente na alça que está a fechar, incluindo erros visíveis pelo utilizador devido a tentativas falhadas de leitura ou escrita de ficheiros. Esta operação não se destina a ser uma substituição ou alternativa para fechar uma sessão SMB.

Esta operação está disponível na versão 2018-11-09 e posterior.

Disponibilidade do protocolo

Protocolo de partilha de ficheiros ativado	Disponível
SMB
NFS

Pedir

Pode construir o pedido da Force Close Handles seguinte forma. Recomendamos HTTPS.

Método	URI do pedido	Versão HTTP
`PUT`	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles`	HTTP/1.1

Substitua os componentes de caminho mostrados 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.
`myfileordirectory`	O nome do ficheiro ou diretório.

Para obter detalhes sobre as restrições de nomenclatura de caminhos, veja Naming and referencing shares, directories, files, and metadata (Atribuir nomes e referenciar partilhas, diretórios, ficheiros e metadados).

Parâmetros do URI

Pode especificar os seguintes parâmetros adicionais no URI:

Parâmetro	Description
`timeout`	Opcional. Expresso em segundos. Para obter mais informações, veja Definir tempos limite para operações do serviço de ficheiros.
`marker`	Opcional. Um valor de cadeia que identifica a posição dos identificadores que serão fechados com a operação seguinte `Force Close Handles` . A operação devolve um valor de marcador no corpo da resposta se existirem mais alças para fechar. Em seguida, o valor do marcador pode ser utilizado numa chamada subsequente para fechar o próximo conjunto de identificadores. O valor do marcador é opaco para o cliente.
`sharesnapshot`	Opcional. Um valor de data/hora opaco. Quando estiver presente, especifica o instantâneo de partilha para consultar a lista de identificadores.

Cabeçalhos do pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais:

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, mas opcional para pedidos anónimos. 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-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.
`x-ms-handle-id`	Obrigatório. Especifica o ID do identificador a fechar. Utilize um asterisco (*) como uma cadeia de carateres universais para especificar todos os identificadores.
`x-ms-recursive`	Opcional. Um valor booleano que especifica se a operação também deve ser aplicada aos ficheiros e subdiretórios do diretório especificado no URI.
`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, um conjunto de cabeçalhos de resposta e um corpo de resposta no formato XML.

Código de estado

Uma operação bem-sucedida devolve o código de estado 200 (OK).

Para obter 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
`x-ms-request-id`	Identifica exclusivamente o pedido que foi feito. Pode utilizá-lo 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 Ficheiros do Azure utilizada para executar o pedido.
`Date`	Um valor de data/hora UTC que indica a hora em que o serviço enviou a resposta.
`x-ms-marker`	Descreve a próxima alça a ser fechada. Esta cadeia é devolvida quando é necessário fechar mais identificadores para concluir o pedido. A cadeia é utilizada em pedidos subsequentes para forçar o fecho das 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 alças fechadas.
`x-ms-number-of-handles-failed`	Indica o número de identificadores que não foram fechados.
`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 for, no máximo, 1024 carateres ASCII visíveis. Se o `x-ms-client-request-id` cabeçalho não estiver presente no pedido, este cabeçalho não estará presente na resposta.

Corpo da resposta

Vazio.

Autorização

Apenas o proprietário da conta pode chamar esta operação.

Observações

Se não forem fechadas alças durante o processamento de pedidos (por exemplo, o valor fornecido x-ms-handle-id especifica uma alça inválida ou não foram encontradas alças abertas no ficheiro ou diretório fornecido), obterá uma resposta de estado 200 (OK) com x-ms-number-of-handles-closed=0.

O x-ms-recursive cabeçalho é válido apenas para diretórios. Se o especificar para um ficheiro, receberá uma resposta 400 (Pedido Incorreto).

O fecho forçado de uma alça aberta pode não fazer com FILE_FLAG_DELETE_ON_CLOSE que o ficheiro seja eliminado.

As Alças de Lista devolvem o ID da alça do lado do x-ms-handle-id serviço. Este ID de identificador é diferente do identificador do lado do cliente correspondente que o SMB ou uma aplicação mantém.

Partilhar via