File Shares - Delete

删除其帐户下的指定共享。

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

URI 参数

名称 必需 类型 说明
accountName
path True

string

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

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

用户订阅中的资源组的名称。 此名称不区分大小写。

shareName
path True

string

minLength: 3
maxLength: 63

指定存储帐户中的文件共享的名称。 文件共享名称长度必须介于 3 到 63 个字符之间,并且只能使用数字、小写字母和短划线(-)。 每个短划线(-)字符必须紧跟在字母或数字前面,后跟一个字母或数字。

subscriptionId
path True

string

minLength: 1

目标订阅的 ID。

api-version
query True

string

minLength: 1

用于此操作的 API 版本。

$include
query

string

可选。 有效值为:快照、租用快照、无。 默认值为快照。 对于“snapshots”,文件共享将被删除,包括其所有文件共享快照。 如果文件共享包含租约快照,则删除会失败。 对于“leased-snapshots”,文件共享将包括其所有文件共享快照(租用/未发布)。 对于“none”,如果文件共享没有共享快照,则会删除文件共享。 如果文件共享包含任何快照(已租用或未发布),则删除将失败。

请求头

名称 必需 类型 说明
x-ms-snapshot

string

可选,用于删除快照。

响应

名称 类型 说明
200 OK

确定 - 删除共享作已成功完成。

204 No Content

无内容 - 共享不存在。

Other Status Codes

CloudError

描述作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

DeleteShares

示例请求

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

示例响应

定义

名称 说明
CloudError

存储服务的错误响应。

CloudErrorBody

存储服务的错误响应。

CloudError

存储服务的错误响应。

名称 类型 说明
error

CloudErrorBody

存储服务的错误响应。

CloudErrorBody

存储服务的错误响应。

名称 类型 说明
code

string

错误的标识符。 代码是固定的,旨在以编程方式使用。

details

CloudErrorBody[]

有关错误的其他详细信息的列表。

message

string

描述错误的消息,旨在适合在用户界面中显示。

target

string

特定错误的目标。 例如,错误属性的名称。