使用DeleteGatewayFileShares删除指定文件网关中的文件共享-云存储网关-阿里云

接口说明

警告

删除共享会导致您的业务和数据同步中断，请谨慎操作。
当删除 NFS 共享时，建议您先在客户端执行卸载操作。若客户端未先执行卸载操作，而直接删除共享或网关，会导致挂载点无法正常卸载。此后对挂载目录的任何操作均会出现卡住或长时间无响应的情况。
删除共享并不会终止网关计费，如果您无需使用网关，可以通过调用 DeleteGateway 接口删除网关以避免持续产生费用。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

hcs-sgw:DeleteGatewayFileShares

delete

*全部资源

*

无

名称	类型	必填	描述	示例值
GatewayId	string	是	网关 ID。	gw-000eg44nmxbsfwbv****
IndexId	string	是	文件共享在网关内部的 ID。可以通过 DescribeGatewayFileShares 接口获得。	NFSalex***
Force	boolean	否	是否强制删除。可能值： true：强制删除同步未完成的文件共享，请谨慎操作。 false（默认）：不删除同步未完成的文件共享。	false

正常返回示例

JSON格式

{
  "TaskId": "t-000c6hshwukkcfn****",
  "Message": "successful",
  "RequestId": "t-000czaedx5koz578vk**",
  "Code": "200",
  "Success": true
}

HTTP status code	错误码	错误信息	描述
400	EmptyShareIndexId	You must enter a valid file sharing ID.	文件共享ID不能为空，请输入一个有效值。
400	GatewayNotExist	The specified gateway does not exist. You must specify a valid parameter.	网关不存在，请确认输入参数是否正确。
400	GatewayInOperation	The gateway is processing requests . Try again later.	网关正在进行操作中，请稍后再试。
500	InternalError	Unexpected error. Try again later. If the error persists after several tries, we recommend that you submit a ticket.	内部错误，请重试。如果多次尝试失败，请提交工单。

访问错误中心查看更多错误码。

更多信息，参考变更详情。