修改共享updateShare
接口说明
修改共享的描述和名称信息。
约束说明
兼容V1接口
URL
PUT https://sfs.cn-south-2.myhuaweicloud.com/v2/{project_id}/shares/{share_id}
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
X-Openstack-Manila-Api-Version
|
float | header | 否 |
指定微版本号 |
|
project_id
|
string | path | 是 |
操作用户的项目ID。 |
|
share_id
|
string | path | 是 |
共享的UUID。 |
Body参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
share
|
share_update object | 是 |
share对象 |
返回参数
请求示例
示例 1
修改共享
"PUT https://{endpoint}/v2/{project_id}/shares/{share_id}"
{ "share": { "display_description": "test", "display_name": "testshare" } }
返回示例
返回码：200
OK
示例 1
{
"share": {
"access_rules_status": "active",
"availability_zone": "az1.dc1",
"create_share_from_snapshot_support": null,
"created_at": "2018-12-25T08:45:22.525899",
"description": "test",
"has_replicas": false,
"host": "DJ38@a4588256-3880-4136-b3c9-4c3aade8a84b#a4588256-3880-4136-b3c9-4c3aade8a84b",
"id": "f26d867f-9876-433d-8db2-25d210f29309",
"is_public": true,
"links": [
{
"href": "https://192.168.196.47:8796/v2/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
"rel": "self"
},
{
"href": "https://192.168.196.47:8796/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
"rel": "bookmark"
}
],
"metadata": {
"enterprise_project_id": "ttt",
"share_key": "test",
"share_used": "1"
},
"mount_snapshot_support": null,
"name": "manila share",
"project_id": "07412155bf474db9a2f697fd978593d7",
"replication_type": null,
"revert_to_snapshot_support": null,
"share_group_id": null,
"share_network_id": null,
"share_proto": "NFS",
"share_server_id": null,
"share_type": "8ae4e74e-83f4-4980-8ab8-e637f9294e0b",
"share_type_name": "sla",
"size": 1,
"snapshot_id": null,
"snapshot_support": true,
"source_share_group_snapshot_member_id": null,
"status": "available",
"task_state": null,
"user_id": "daa3f8f8d7254465841da769298a76f6",
"volume_type": "sla"
}
}
"share": {
"access_rules_status": "active",
"availability_zone": "az1.dc1",
"create_share_from_snapshot_support": null,
"created_at": "2018-12-25T08:45:22.525899",
"description": "test",
"has_replicas": false,
"host": "DJ38@a4588256-3880-4136-b3c9-4c3aade8a84b#a4588256-3880-4136-b3c9-4c3aade8a84b",
"id": "f26d867f-9876-433d-8db2-25d210f29309",
"is_public": true,
"links": [
{
"href": "https://192.168.196.47:8796/v2/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
"rel": "self"
},
{
"href": "https://192.168.196.47:8796/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
"rel": "bookmark"
}
],
"metadata": {
"enterprise_project_id": "ttt",
"share_key": "test",
"share_used": "1"
},
"mount_snapshot_support": null,
"name": "manila share",
"project_id": "07412155bf474db9a2f697fd978593d7",
"replication_type": null,
"revert_to_snapshot_support": null,
"share_group_id": null,
"share_network_id": null,
"share_proto": "NFS",
"share_server_id": null,
"share_type": "8ae4e74e-83f4-4980-8ab8-e637f9294e0b",
"share_type_name": "sla",
"size": 1,
"snapshot_id": null,
"snapshot_support": true,
"source_share_group_snapshot_member_id": null,
"status": "available",
"task_state": null,
"user_id": "daa3f8f8d7254465841da769298a76f6",
"volume_type": "sla"
}
}
错误码
请参考 错误码说明。
