Eliminar Partilha
A Delete Share operação elimina o instantâneo de partilha ou partilha especificado. Esta API é totalmente suportada, mas tenha em atenção que se trata de uma API de gestão legada.
Recomendamos que utilize Partilhas de Ficheiros – Eliminar . É fornecido pelo fornecedor de recursos de armazenamento (Microsoft.Storage). Para saber mais sobre a interação programática com recursos através FileShare do fornecedor de recursos de armazenamento, veja Operações em FileShares.
Disponibilidade do protocolo
| Protocolo de partilha de ficheiros ativado | Disponível |
|---|---|
| SMB |
|
| NFS |
|
Pedir
Pode construir o pedido da Delete Share seguinte forma. É recomendado HTTPS.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
DELETE |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
DELETE |
https://myaccount.file.core.windows.net/myshare?sharesnapshot=<DateTime>&restype=share |
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. |
Para obter detalhes sobre as restrições de nomenclatura de caminhos, veja Nomenclatura e referência de partilhas, diretórios, ficheiros e metadados.
Parâmetros URI
Pode especificar os seguintes parâmetros adicionais no URI do pedido.
| Parâmetro | Description |
|---|---|
sharesnapshot |
Opcional. Versão 2017-04-17 e posterior. O sharesnapshot parâmetro é um valor opaco DateTime que, quando presente, especifica o instantâneo de partilha a eliminar. |
timeout |
Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, veja Setting timeouts for Ficheiros do Azure operations (Definir tempos limite para operações de Ficheiros do Azure). |
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. 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-delete-snapshots: { include, include-leased } |
Opcional se a partilha tiver instantâneos associados. Especifique uma das seguintes opções:
|
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-lease-id: <ID> |
Necessário se a partilha de ficheiros de destino tiver uma concessão ativa. Disponível para a versão 2020-02-10 e posterior. Se o pedido não incluir o ID de concessão ou não for válido, a operação falhará com o código de estado 412 (Falha na Pré-condição). Se este cabeçalho for especificado e a partilha de ficheiros de destino não tiver atualmente uma concessão ativa, a operação também falha com o código de estado 412 (Falha na Pré-condição). |
Corpo do pedido
Nenhum.
Pedido de exemplo
DELETE https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ= TBD
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 202 (Aceite). 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 |
Este cabeçalho 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 Ficheiros do Azure utilizada para executar o pedido. |
Date ou x-ms-date |
Um valor de data/hora UTC que indica a hora em que a resposta foi iniciada. O serviço gera este valor. |
x-ms-client-request-id |
Pode utilizar este cabeçalho 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. O valor é, 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
Nenhum.
Autorização
Apenas o proprietário da conta pode chamar esta operação.
Observações
Quando elimina uma partilha, não pode criar uma partilha com o mesmo nome durante, pelo menos, 30 segundos. Enquanto a partilha está a ser eliminada, as tentativas de recriar uma partilha com o mesmo nome falharão com o código de estado 409 (Conflito). O serviço devolve informações de erro adicionais, que indicam que a partilha está a ser eliminada. Todas as outras operações, incluindo operações em quaisquer ficheiros na partilha, falharão com o código de estado 404 (Não Encontrado) enquanto a partilha está a ser eliminada.
Atualmente, a eliminação de uma partilha com instantâneos não é permitida. Os instantâneos de partilha podem ser eliminados individualmente ou podem ser eliminados juntamente com a partilha com o x-ms-delete-snapshots=include cabeçalho.
Só deve especificar x-ms-delete-snapshots um pedido relativamente ao recurso de partilha base. Se especificar este cabeçalho num pedido para eliminar um instantâneo individual, Ficheiros do Azure devolve o código de estado 400 (Valor do Parâmetro de Consulta Inválido). Se este cabeçalho não for especificado no pedido de eliminação e a partilha tiver instantâneos associados, o Ficheiros do Azure devolve o código de estado 409 (Partilhar Tem Instantâneos).