前缀列表

创建前缀列表

1. 前往专有网络控制台VPC前缀列表页面。先在顶部菜单栏左上处选择目标地域，再单击创建VPC前缀列表。

2. 在创建VPC前缀列表面板中：

   1. 选择IP版本（IPv4/IPv6）。

   2. 设置最大条目数：该数值会占用VPC路由表和安全组的配额，创建后可修改。

      例如，即使前缀列表实际只包含20个条目，但只要最大条目数设置为50，在VPC路由表或安全组中引用时，仍会占用50条路由或50条安全组规则的配额。

      配额参考：单个VPC路由表支持的自定义路由条目数默认为200，单个安全组支持的规则数默认为200。

   3. 配置前缀列表条目，支持逐条输入、批量输入、从其他前缀列表克隆（支持跨地域克隆，但不支持从来自共享的前缀列表或系统前缀列表进行克隆）。

增加或删除条目

在目标前缀列表的基本信息的条目页签下：

• 增加条目：单击创建VPC前缀列表条目。

• 删除条目：在目标条目的操作列单击删除，或多选后单击批量删除。

查看引用前缀列表的资源

在目标前缀列表的基本信息页面，单击关联页签查看。

删除前缀列表

在目标前缀列表的操作列或详情页单击删除。

删除前，请确保前缀列表未被其他资源引用，且未被共享。

开启共享

此处仅介绍将前缀列表共享给任意账户的方式。针对资源目录方式，请参考仅在资源目录内共享资源。

1. 登录前缀列表所有者的账号，前往资源管理控制台的资源共享-我的共享页面。先在顶部菜单栏左上处，选择共享资源所在的地域，再单击创建共享单元，在打开的页面中：

   1. 第一步：输入共享单元名称，在资源面板的下拉列表中选择VPC前缀列表，然后选中需要共享的前缀列表。

   2. 第二步：系统会默认选择AliyunRSDefaultPermissionPrefixList权限。

   3. 第三步：使用者范围选择允许共享给任意账号，添加方式选择手动添加，使用者ID输入前缀列表使用者的阿里云账号ID，并点击添加。

   4. 第四步：检查无误后，在页面底部单击确定。

2. 登录前缀列表使用者的账号，接受共享邀请：

   1. 前往资源管理控制台的资源共享-共享给我页面。

   2. 在顶部菜单栏左上处，选择共享资源所在的地域，再单击目标共享单元状态列的接受。

   3. 接受后，使用者就可以访问共享的前缀列表，且后续该共享单元新增的共享资源将默认接受共享邀请。

   4. 前往专有网络控制台VPC前缀列表页面，在顶部菜单栏选择共享前缀列表所在的地域后，您可以看到收到的前缀列表（拥有者列被标记为来自共享）。

      

   5. 接下来您可以参考引用前缀列表，在VPC路由表、TR路由表、ECS安全组中进行引用。

管理共享前缀列表和使用者

前缀列表所有者可参考如下步骤，查看或增删共享前缀列表及其使用者。

1. 登录前缀列表所有者的账号，前往资源管理控制台的资源共享-我的共享页面。在顶部菜单栏左上处，选择已共享的前缀列表所在的地域。

2. 在我的共享页面，您可以：

   • 查看已共享的前缀列表：单击共享的资源页签进行查看。

   • 查看共享前缀列表的使用者：单击资源使用者页签进行查看。

3. 单击共享单元页签，找到目标共享单元，单击共享单元ID。

4. 您可以点击资源或资源使用者页签，分别查看此共享单元内的共享前缀列表和使用者。

   如果资源和资源使用者页签的共享状态显示为已关联时，表示共享的资源和资源使用者添加成功：

   

   关联失败的常见原因

   如果资源和资源使用者区域的共享状态显示为关联失败，则表示共享失败。共享失败的可能原因如下，请您排查后再添加要共享的前缀列表：

   • 要共享的前缀列表使用者的账号与前缀列表所有者的账号相同，即前缀列表所有者不能将自己的前缀列表共享给自己。

   • 单个前缀列表支持共享给资源使用者的个数超过了配额（默认为10个）。

   • 单个前缀列表使用者接收的共享前缀列表的个数超过了配额（默认为100个）。

5. 在目标共享单元页面，单击右上方编辑共享单元，您可以在此共享单元内：

   • 增加或删除共享前缀列表：在第一步，勾选或取消勾选前缀列表。

   • 增加或删除共享前缀列表的使用者：在第三步，添加或删除账号UID。

6. 检查无误后，在编辑共享单元页面的第四步，单击确定。

开启共享

• 方式一：共享给任意账户

  1. 使用前缀列表所有者的身份凭证，调用CreateResourceShare创建共享单元，并确保将AllowExternalTargets参数设为True。

  2. 使用前缀列表使用者的身份凭证，先调用ListResourceShareInvitations查询收到的资源邀请信息，再调用AcceptResourceShareInvitation接受资源共享邀请。

• 方式二：仅在资源目录内共享

  操作前，请确保前缀列表所有者和使用者已加入同一个资源目录。

  1. 使用资源目录管理账号的身份凭证，调用EnableSharingWithResourceDirectory启用资源目录组织共享。

  2. 使用前缀列表所有者的身份凭证，调用CreateResourceShare创建共享单元，并确保将AllowExternalTargets参数设为False。

管理共享前缀列表和使用者

前缀列表所有者，查看已被共享的共享前缀列表及使用者：

• 调用ListSharedResources查看共享前缀列表。

• 调用ListSharedTargets查看共享前缀列表的使用者列表。

前缀列表所有者，在共享单元内管理共享前缀列表及使用者：

• 调用ListResourceShareAssociations查看共享单元内的前缀列表或使用者。

• 调用AssociateResourceShare在共享单元内增加共享前缀列表或使用者。

• 调用DisassociateResourceShare在共享单元内删除共享前缀列表或使用者。

当前Terraform不支持将前缀列表共享给任意账户，仅支持在资源目录内共享，请您在操作前确保资源目录管理账号已启用资源目录组织共享。

Resources: alicloud_resource_manager_resource_share、alicloud_resource_manager_shared_resource、alicloud_resource_manager_shared_target

使用前缀列表所有者的身份凭证，开启共享：

# 指定地域
provider "alicloud" {
  region = "cn-hangzhou"
}

# 指定共享单元名称
resource "alicloud_resource_manager_resource_share" "example_unit" {
  resource_share_name = "example_unit_name"
}

# 指定共享前缀列表
resource "alicloud_resource_manager_shared_resource" "example_vsw" {
  resource_share_id = alicloud_resource_manager_resource_share.example_unit.id
  resource_id       = "pl-bp18t4lsc3e4yd6xxxxx" # 要共享的前缀列表ID
  resource_type     = "PrefixList"               # 资源类型为前缀列表 
}

# 指定共享前缀列表的使用者
resource "alicloud_resource_manager_shared_target" "example_target" {
  resource_share_id = alicloud_resource_manager_resource_share.example_unit.id
  target_id         = "101xxxxxxxxxxxxxxx" # 前缀列表使用者的UID
}