修改文件系统绑定的安全组 - ChangeSecurityGroup
功能介绍
修改SFS Turbo文件系统绑定的安全组。修改安全组为异步任务,可以通过“查询文件系统详细信息”返回的子状态字段“sub_status”来判断是否修改安全组状态,子状态为“232”即为修改安全组成功。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/sfs-turbo/shares/{share_id}/action
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于标识资源所属的IAM项目空间,实现项目级资源隔离与权限管控。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| share_id | 是 | String | 参数解释: 文件系统ID,用于唯一标识SFS Turbo文件系统实例。获取方法请参见1.4 获取文件系统列表 - ListShares。 约束限制: 文件系统需处于可用状态,不可处于任务执行中状态。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,用于鉴权认证。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| Content-Type | 是 | String | 参数解释: 请求消息体MIME类型,用于标识请求正文的数据格式。 约束限制: 不涉及。 取值范围: application/json 默认取值: application/json |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| change_security_group | 是 | ChangeSecurityGroup object | 参数解释: 修改安全组的配置信息,包含目标安全组ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| auto_create_security_group_rules | 否 | String | 参数解释: 是否自动创建安全组规则。 约束限制: 不涉及。 取值范围: 默认取值: true |
响应参数
状态码:202
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: SFS Turbo文件系统的ID。 取值范围: 不涉及。 |
请求示例
修改文件系统绑定的安全组,需要修改的目标安全组ID为“26f6b565-240e-43c3-8867-03f0bd975433”。
{
"change_security_group" : {
"security_group_id" : "26f6b565-240e-43c3-8867-03f0bd975433"
}
} 响应示例
状态码:202
{
"id" : "67d4bd5e-7b2f-4c24-9a0b-c0038940c6f8"
} 状态码
| 状态码 | 描述 |
|---|---|
| 202 | 修改安全组请求下发成功返回body。 |
错误码
请参见错误码。