管理和取消管理共享¶
“管理”共享意味着管理员而非共享驱动程序管理存储生命周期。当管理员已经拥有具有大小、共享文件系统协议和导出路径的自定义非 Manila 共享时，并且管理员希望将其注册到共享文件系统服务中，这种方法是合适的。
“取消管理”共享意味着从共享文件系统服务中注销指定的共享。管理员可以根据需要将取消管理的共享恢复为管理状态。
取消管理共享¶
注意
在共享文件系统 API 版本 2.49 (Stein/Manila 8.0.0 版本) 之前，对于基于共享服务器和使用共享网络创建的共享，不支持 取消管理 操作。
重要提示
除非已删除或取消管理快照，并且已删除共享副本，否则具有依赖快照或共享副本的共享无法从共享文件系统服务中删除。
取消管理共享会将其从共享文件系统服务的管理中移除，而不会删除共享。这是一个非破坏性操作，现有客户端不会断开连接，该功能旨在帮助基础设施操作和维护工作流程。要取消管理共享，请运行 openstack share abandon 命令。然后尝试打印有关共享的信息。返回的结果应指示共享文件系统服务找不到该共享
$ openstack share abandon share_for_docs
$ openstack share show share_for_docs
ERROR: No share with a name or ID of 'share_for_docs' exists.
管理共享¶
注意
在共享文件系统 API 版本 2.49 (Stein/Manila 8.0.0 版本) 之前，对于通过共享网络在共享服务器上导出的共享，不支持 管理 操作。
注意
从 API 版本 2.53 开始，如果请求者指定包含 replication_type 附加规格的共享类型，同时管理共享，Manila 配额系统将为两个额外的配额预留和消耗资源：share_replicas 和 replica_gigabytes。从 API 版本 2.62 开始，Manila 配额系统将根据 per_share_gigabytes 配额验证共享的大小。
要将非管理共享注册到文件系统服务，请运行 openstack share adopt 命令
openstack share adopt [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--name <name>]
[--description <description>]
[--share-type <share-type>]
[--driver-options [<key=value> ...]]
[--public]
[--share-server-id <share-server-id>]
[--wait]
<service-host> <protocol> <export-path>
位置参数是
service_host。在
host@backend#POOL格式中的 manage-share 服务主机，包括后端的主机名、后端的名称以及后端的池名称。protocol。要管理的共享的共享文件系统协议。有效值包括 NFS、CIFS、GlusterFS、HDFS 或 MAPRFS。
export_path。适用于该协议的格式的共享导出路径
NFS 协议。10.0.0.1:/foo_path。
CIFS 协议。\\10.0.0.1\foo_name_of_cifs_share。
HDFS 协议。hdfs://10.0.0.1:foo_port/foo_share_name。
GlusterFS。10.0.0.1:/foo_volume。
MAPRFS。maprfs:///share-0 -C -Z -N foo。
可选参数是
name。正在管理的共享的名称。
share_type。正在管理的共享的共享类型。如果未指定，该服务将尝试使用配置的默认共享类型来管理该共享。
share_server_id。必须提供才能管理使用共享网络的共享。此参数只能与文件系统 API 版本
2.49(Stein/Manila 8.0.0 版本) 及更高版本一起使用。driver_options。一组可选的键值对，用于描述驱动程序选项。因此，在示例中使用了名为
for_managing的特殊共享类型。
要管理共享，请运行
$ openstack share adopt \
manila@saopaulo#shares \
nfs \
10.0.0.10:/shares/share_e113729a_8da4_45f3_bbbf_0014f_350380c_c4b06060_9c56_459e_9219_b86a0777054b \
--name share_for_docs \
--description "We manage share." \
--share-type default
+-------------------------------------+--------------------------------------+
| Field | Value |
+-------------------------------------+--------------------------------------+
| id | 8b3aa39d-e07f-4255-82ac-f6f56565a725 |
| size | None |
| availability_zone | None |
| created_at | 2025-04-03T10:57:19.230793 |
| status | manage_starting |
| name | share_for_docs |
| description | We manage share. |
| project_id | c0bc204890ad428796f364b677a8516b |
| snapshot_id | None |
| share_network_id | None |
| share_proto | NFS |
| metadata | {} |
| share_type | 807e5cd7-a0e7-4912-8f7d-352512ce51c3 |
| volume_type | default |
| is_public | False |
| snapshot_support | True |
| task_state | None |
| share_type_name | default |
| access_rules_status | active |
| replication_type | None |
| has_replicas | False |
| user_id | c5d0c19aae6e4484a41e241f0d8b04fb |
| create_share_from_snapshot_support | True |
| revert_to_snapshot_support | True |
| share_group_id | None |
| source_share_group_snapshot_member_ | None |
| id | |
| mount_snapshot_support | True |
| progress | None |
| is_soft_deleted | False |
| scheduled_to_be_deleted_at | None |
| source_backup_id | None |
| share_server_id | None |
| host | manila@saopaulo#shares |
+-------------------------------------+--------------------------------------+
检查共享是否可用
$ openstack share show share_for_docs
+-------------------------------------+--------------------------------------+
| Field | Value |
+-------------------------------------+--------------------------------------+
| id | 8b3aa39d-e07f-4255-82ac-f6f56565a725 |
| size | 1 |
| availability_zone | manila-zone-1 |
| created_at | 2025-04-03T10:57:19.230793 |
| status | available |
| name | share_for_docs |
| description | We manage share. |
| project_id | c0bc204890ad428796f364b677a8516b |
| snapshot_id | None |
| share_network_id | None |
| share_proto | NFS |
| share_type | 807e5cd7-a0e7-4912-8f7d-352512ce51c3 |
| volume_type | default |
| is_public | False |
| snapshot_support | True |
| task_state | None |
| share_type_name | default |
| access_rules_status | active |
| replication_type | None |
| has_replicas | False |
| user_id | c5d0c19aae6e4484a41e241f0d8b04fb |
| create_share_from_snapshot_support | True |
| revert_to_snapshot_support | True |
| share_group_id | None |
| source_share_group_snapshot_member_ | None |
| id | |
| mount_snapshot_support | True |
| progress | 100% |
| is_soft_deleted | False |
| scheduled_to_be_deleted_at | None |
| source_backup_id | None |
| share_server_id | None |
| host | manila@saopaulo#shares |
| export_locations | |
| | id = |
| | ba4ad0cd-6d25-422f-97f6-a1bc383ae49d |
| | path = 11.0.0.11:/shares/share_e1137 |
| | 29a_8da4_45f3_bbbf_0014f350380c_c4b0 |
| | 6060_9c56_459e_9219_b86a0777054b |
| | preferred = False |
| | metadata = {} |
| | share_instance_id = |
| | c4b06060-9c56-459e-9219-b86a0777054b |
| | is_admin_only = True |
| | id = |
| | c525a3aa-b52a-4565-acf3-aacaca1167ec |
| | path = 10.0.0.10:/shares/share_e1137 |
| | 29a_8da4_45f3_bbbf_0014f350380c_c4b0 |
| | 6060_9c56_459e_9219_b86a0777054b |
| | preferred = True |
| | metadata = {} |
| | share_instance_id = |
| | c4b06060-9c56-459e-9219-b86a0777054b |
| | is_admin_only = False |
| | id = |
| | b5c26041-eba0-415d-8bda-f46ca67a55b9 |
| | path = 10.0.0.20:/shares/share_e1137 |
| | 29a_8da4_45f3_bbbf_0014f350380c_c4b0 |
| | 6060_9c56_459e_9219_b86a0777054b |
| | preferred = False |
| | metadata = {} |
| | share_instance_id = |
| | c4b06060-9c56-459e-9219-b86a0777054b |
| | is_admin_only = False |
| properties | |
+-------------------------------------+--------------------------------------+
