Partilhar via


File Shares - Delete

Exclui o compartilhamento especificado em sua conta.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2025-06-01
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2025-06-01&$include={$include}

Parâmetros URI

Nome Em Necessário Tipo Descrição
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes das contas de armazenamento devem ter entre 3 e 24 caracteres e usar apenas números e letras minúsculas.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

shareName
path True

string

minLength: 3
maxLength: 63

O nome do compartilhamento de arquivos na conta de armazenamento especificada. Os nomes de compartilhamento de arquivos devem ter entre 3 e 63 caracteres e usar números, letras minúsculas e traço (-) apenas. Cada caractere de traço (-) deve ser imediatamente precedido e seguido por uma letra ou número.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

$include
query

string

Opcional. Os valores válidos são: snapshots, leased-snapshots, none. O valor padrão é snapshots. Para 'instantâneos', o compartilhamento de arquivos é excluído, incluindo todos os seus instantâneos de compartilhamento de arquivos. Se o compartilhamento de arquivos contiver instantâneos concedidos, a exclusão falhará. Para 'snapshots concedidos', o compartilhamento de arquivos é excluído incluindo todos os seus instantâneos de compartilhamento de arquivos (alugados/não alugados). Para 'nenhum', o compartilhamento de arquivos é excluído se não tiver instantâneos de compartilhamento. Se o compartilhamento de arquivos contiver instantâneos (alugados ou não concedidos), a exclusão falhará.

Cabeçalho de Pedido

Nome Necessário Tipo Descrição
x-ms-snapshot

string

Opcional, usado para excluir um instantâneo.

Respostas

Nome Tipo Descrição
200 OK

Recurso excluído com êxito.

204 No Content

O recurso não existe.

Other Status Codes

CloudError

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

DeleteShares

Pedido de exemplo

DELETE https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4079/providers/Microsoft.Storage/storageAccounts/sto4506/fileServices/default/shares/share9689?api-version=2025-06-01

Resposta de exemplo

Definições

Nome Descrição
CloudError

Uma resposta de erro do serviço de armazenamento.

CloudErrorBody

Uma resposta de erro do serviço de armazenamento.

CloudError

Uma resposta de erro do serviço de armazenamento.

Nome Tipo Descrição
error

CloudErrorBody

Uma resposta de erro do serviço de armazenamento.

CloudErrorBody

Uma resposta de erro do serviço de armazenamento.

Nome Tipo Descrição
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.

target

string

O alvo do erro específico. Por exemplo, o nome da propriedade em erro.