17.9. 共享类型访问控制

共享类型是一个由管理员定义的服务类型（type of service），它包括一个项目可见的描述信息，以及一个项目不可见的、称为额外规格（extra specifications）的键值对列表。manila-scheduler 使用额外的规格来做出调度决策，驱动程序则控制共享创建。

管理员可以创建和删除共享类型，也可以管理额外的规格，以便在 manila 内提供含义。项目可以列出共享类型，并可使用它们创建新的共享。共享类型可以被创建为 public 和 private。这是定义其他项目是否可以在共享类型列表中看到的共享类型的可见性级别，并使用它来创建新共享。

默认情况下，共享类型创建为 public。在创建共享类型时，请使用 --is_public 参数设置为 False 以使您的共享类型私有，这将阻止其他项目在共享类型列表中看到并创建新的共享。另一方面，云中的每个项目都可以使用 公共 共享类型。

Manila 允许管理员授予或拒绝对项目的 私有 共享类型的访问权限。您还可以获取有关指定私有共享类型访问的信息。

例如，admin 项目中的管理员可以创建名为 my_type 的专用共享类型，并在列表中看到它。在以下控制台示例中，省略了登录和注销，并提供了环境变量来显示当前登录的用户。

 $ env | grep OS_
 ...
 OS_USERNAME=admin
 OS_TENANT_NAME=admin
 ...
 $ manila type-list --all
 +----+--------+-----------+-----------+-----------------------------------+-----------------------+
 | ID | Name   | Visibility| is_default| required_extra_specs              | optional_extra_specs  |
 +----+--------+-----------+-----------+-----------------------------------+-----------------------+
 | 4..| my_type| private   | -         | driver_handles_share_servers:False| snapshot_support:True |
 | 5..| default| public    | YES       | driver_handles_share_servers:True | snapshot_support:True |
 +----+--------+-----------+-----------+-----------------------------------+-----------------------+

demo 项目中的 demo 用户可以列出类型，但名为 my_type 的私有共享类型对他不可见。

 $ env | grep OS_
 ...
 OS_USERNAME=demo
 OS_TENANT_NAME=demo
 ...
 $ manila type-list --all
 +----+--------+-----------+-----------+----------------------------------+----------------------+
 | ID | Name   | Visibility| is_default| required_extra_specs             | optional_extra_specs |
 +----+--------+-----------+-----------+----------------------------------+----------------------+
 | 5..| default| public    | YES       | driver_handles_share_servers:True| snapshot_support:True|
 +----+--------+-----------+-----------+----------------------------------+----------------------+

管理员可以授予 demo 项目的私有共享类型的访问权限，其 ID 等于 df29a37db5ae48d19b349fe947fada46:

 $ env | grep OS_
 ...
 OS_USERNAME=admin
 OS_TENANT_NAME=admin
 ...
 $ openstack project list
 +----------------------------------+--------------------+
 | ID                               | Name               |
 +----------------------------------+--------------------+
 | ...                              | ...                |
 | df29a37db5ae48d19b349fe947fada46 | demo               |
 +----------------------------------+--------------------+
 $ manila type-access-add my_type df29a37db5ae48d19b349fe947fada46

因此，demo 项目中的用户可以看到私有共享类型，并在创建共享时使用它：

 $ env | grep OS_
 ...
 OS_USERNAME=demo
 OS_TENANT_NAME=demo
 ...
 $ manila type-list --all
 +----+--------+-----------+-----------+-----------------------------------+-----------------------+
 | ID | Name   | Visibility| is_default| required_extra_specs              | optional_extra_specs  |
 +----+--------+-----------+-----------+-----------------------------------+-----------------------+
 | 4..| my_type| private   | -         | driver_handles_share_servers:False| snapshot_support:True |
 | 5..| default| public    | YES       | driver_handles_share_servers:True | snapshot_support:True |
 +----+--------+-----------+-----------+-----------------------------------+-----------------------+

要拒绝对指定项目的访问，请使用 manila type-access-remove <share_type> <project_id>。