你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
File Shares - Delete
删除其帐户下的指定共享。
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01&$include={$include}
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
account
|
path | True |
string |
指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符,并且只能使用数字和小写字母。 Regex pattern: |
resource
|
path | True |
string |
用户订阅中的资源组的名称。 此名称不区分大小写。 Regex pattern: |
share
|
path | True |
string |
指定存储帐户中的文件共享的名称。 文件共享名称的长度必须介于 3 到 63 个字符之间,并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线(-)字符的前后必须紧跟字母或数字。 |
subscription
|
path | True |
string |
目标订阅的 ID。 |
api-version
|
query | True |
string |
要用于此操作的 API 版本。 |
$include
|
query |
string |
可选。 有效值为:快照、租用快照、无。 默认值为快照。 对于“快照”,将删除文件共享,包括其所有文件共享快照。 如果文件共享包含租用快照,则删除会失败。 对于“租用快照”,将删除文件共享,包括其所有文件共享快照 (租用/未发布的) 。 对于“none”,如果文件共享没有共享快照,则会将其删除。 如果文件共享包含 (租用或未发布的) 的任何快照,则删除将失败。 |
请求头
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
x-ms-snapshot |
string |
可选,用于删除快照。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 -- 删除共享操作已成功完成。 |
|
204 No Content |
无内容 - 共享不存在。 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
DeleteShares
Sample Request
DELETE https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4079/providers/Microsoft.Storage/storageAccounts/sto4506/fileServices/default/shares/share9689?api-version=2023-01-01
Sample Response
定义
名称 | 说明 |
---|---|
Cloud |
存储服务的错误响应。 |
Cloud |
存储服务的错误响应。 |
CloudError
存储服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
存储服务的错误响应。 |
CloudErrorBody
存储服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
details |
有关错误的其他详细信息的列表。 |
|
message |
string |
描述错误的消息,该消息适用于在用户界面中显示。 |
target |
string |
特定错误的目标。 例如,属性的名称出错。 |