Virtual Private Cloud：首碼列表

建立首碼列表

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
}