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=2023-05-01
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-05-01&$include={$include}

Parâmetros do URI

Name Em Necessário Tipo Description
accountName
path True

string

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.

Padrão Regex: ^[a-z0-9]+$

resourceGroupName
path True

string

O nome do grupo de recursos dentro da assinatura do usuário. O nome não diferencia maiúsculas de minúsculas.

Padrão Regex: ^[-\w\._\(\)]+$

shareName
path True

string

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

A ID da assinatura de destino.

api-version
query True

string

A versão da API a ser usada 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 do Pedido

Name Necessário Tipo Description
x-ms-snapshot

string

Opcional, usado para excluir um instantâneo.

Respostas

Name Tipo Description
200 OK

OK -- Operação Delete Share concluída com êxito.

204 No Content

Sem conteúdo -- O compartilhamento não existe.

Other Status Codes

CloudError

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

DeleteShares

Pedido de amostra

DELETE https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4079/providers/Microsoft.Storage/storageAccounts/sto4506/fileServices/default/shares/share9689?api-version=2023-05-01

Resposta da amostra

Definições

Name Description
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.

Name Tipo Description
error

CloudErrorBody

Uma resposta de erro do serviço de armazenamento.

CloudErrorBody

Uma resposta de erro do serviço de armazenamento.

Name Tipo Description
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.