更新后端存储属性 - UpdateObsTargetAttributes
功能介绍
更新后端存储属性。
接口约束
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
PUT /v1/{project_id}/sfs-turbo/shares/{share_id}/targets/{target_id}/attributes
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于标识资源所属的IAM项目空间,实现项目级资源隔离与权限管控。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| share_id | 是 | String | 参数解释: 文件系统ID,用于唯一标识SFS Turbo文件系统实例。 获取方法请参见查询文件系统列表接口。 约束限制: 文件系统状态必须为可用状态,不能处于创建中、扩容中、删除中等任务执行中的中间状态,否则接口将拒绝该请求。调用前可通过查询文件系统详情接口确认文件系统状态。 取值范围: 不涉及。 默认取值: 不涉及。 |
| target_id | 是 | String | 参数解释: 绑定关系ID,用于唯一标识后端存储与文件系统之间的绑定关系。 约束限制: 绑定关系必须处于可用状态(AVAILABLE),不可处于创建中或删除中状态。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,用于鉴权认证。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| Content-Type | 是 | String | 参数解释: 请求消息体MIME类型,用于标识请求正文的数据格式。 约束限制: 不涉及。 取值范围: application/json 默认取值: application/json |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| attributes | 是 | ObsTargetAttributes object | 参数解释: 后端存储属性配置对象,用于配置从OBS桶导入到文件系统的文件和目录的权限及属主信息。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| file_mode | 否 | Integer | 参数解释: 导入的文件权限,使用八进制数字表示。第一位表示文件所有者的权限,取值范围是0到7;第二位表示文件所属用户组的权限,取值范围是0到7;第三位表示其他用户的权限,取值范围是0到7。文件所有者由uid指定,文件所属用户组由gid指定,不是文件所有者且不在文件所属用户组的用户为其他用户。 数字4、2、1分别表示读、写、执行权限,这些数字相加,即可得到所需的权限组合。例如:750中第一位7代表该文件所有者对该文件具有读、写、执行权限;第二位5代表该文件所属用户组对该文件具有读、执行权限;第三位0代表其他用户对该文件无权限。 约束限制: 不涉及。 取值范围: 000到777的整数。 默认取值: 不涉及。 |
| dir_mode | 否 | Integer | 参数解释: 导入的目录权限,使用八进制数字表示。第一位表示目录所有者的权限,取值范围是0到7;第二位表示目录所属用户组的权限,取值范围是0到7;第三位表示其他用户的权限,取值范围是0到7。目录所有者由uid指定,目录所属用户组由gid指定,不是目录所有者且不在目录所属用户组的用户为其他用户。 数字4、2、1分别表示读、写、执行权限,这些数字相加,即可得到所需的权限组合。例如:750中第一位7代表该目录所有者对该目录具有读、写、执行权限;第二位5代表该目录所属用户组对该目录具有读、执行权限;第三位0代表其他用户对该目录无权限。 约束限制: 不涉及。 取值范围: 000到777的整数。 默认取值: 不涉及。 |
| uid | 否 | Integer | 参数解释: 导入对象所有者的用户ID。 约束限制: 不涉及。 取值范围: 0到4294967294(即2^32-2)的整数。 默认取值: 0 |
| gid | 否 | Integer | 参数解释: 导入对象所属用户组的ID。 约束限制: 不涉及。 取值范围: 0到4294967294(即2^32-2)的整数。 默认取值: 0 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| X-request-id | String | 参数解释: 请求ID,用于唯一标识和追踪本次请求。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| target_id | String | 参数解释: 绑定关系ID,用于唯一标识后端存储与文件系统之间的绑定关系。 取值范围: 不涉及。 |
| attributes | ObsTargetAttributes object | 参数解释: 后端存储属性配置对象,包含从OBS桶导入到文件系统的文件和目录的权限及属主信息。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| file_mode | Integer | 参数解释: 导入的文件权限,使用八进制数字表示。第一位表示文件所有者的权限,取值范围是0到7;第二位表示文件所属用户组的权限,取值范围是0到7;第三位表示其他用户的权限,取值范围是0到7。文件所有者由uid指定,文件所属用户组由gid指定,不是文件所有者且不在文件所属用户组的用户为其他用户。 数字4、2、1分别表示读、写、执行权限,这些数字相加,即可得到所需的权限组合。例如:750中第一位7代表该文件所有者对该文件具有读、写、执行权限;第二位5代表该文件所属用户组对该文件具有读、执行权限;第三位0代表其他用户对该文件无权限。 取值范围: 000到777的整数。 |
| dir_mode | Integer | 参数解释: 导入的目录权限,使用八进制数字表示。第一位表示目录所有者的权限,取值范围是0到7;第二位表示目录所属用户组的权限,取值范围是0到7;第三位表示其他用户的权限,取值范围是0到7。目录所有者由uid指定,目录所属用户组由gid指定,不是目录所有者且不在目录所属用户组的用户为其他用户。 数字4、2、1分别表示读、写、执行权限,这些数字相加,即可得到所需的权限组合。例如:750中第一位7代表该目录所有者对该目录具有读、写、执行权限;第二位5代表该目录所属用户组对该目录具有读、执行权限;第三位0代表其他用户对该目录无权限。 取值范围: 000到777的整数。 |
| uid | Integer | 参数解释: 导入对象所有者的用户ID。 取值范围: 0到4294967294(即2^32-2)的整数。 |
| gid | Integer | 参数解释: 导入对象所属用户组的ID。 取值范围: 0到4294967294(即2^32-2)的整数。 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errCode | String | 参数解释: 错误码,用于标识请求失败的原因。详细错误码请参见错误码。 取值范围: 不涉及。 |
| errMsg | String | 参数解释: 错误描述,用于描述请求失败的具体原因,便于排查问题。请参见错误码。 取值范围: 不涉及。 |
状态码:500
请求示例
文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde",后端target_id为"11abef67-7ac4-0f46-644d-1d5cfc2424a4",更新后端存储属性
PUT HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/targets/11abef67-7ac4-0f46-644d-1d5cfc2424a4/attributes
{
"attributes" : {
"file_mode" : 750,
"dir_mode" : 640,
"uid" : 0,
"gid" : 0
}
} 响应示例
状态码:200
{
"target_id" : "00000334-xxxx-402d-a5d4-bxxxxx87b939",
"attributes" : {
"file_mode" : 750,
"dir_mode" : 640,
"uid" : 0,
"gid" : 0
}
} 状态码:404
{
"errCode" : "SFS.TURBO.0126",
"errMsg" : "target not found, not bound yet"
} 状态码:500
{
"errCode" : "SFS.TURBO.0005",
"errMsg" : "internal server error"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 成功 |
| 404 | 错误响应 |
| 500 | 错误响应 |
错误码
请参见错误码。