標記 Amazon Neptune 資源

您可以使用 Neptune 標籤，將中繼資料新增至您的 Neptune 資源。此外，您可以搭配 AWS Identity and Access Management (IAM) 政策使用標籤來管理 Neptune 資源的存取，並控制可套用至這些資源的動作。最後，您可以使用標籤將類似的標記資源分類為群組以追蹤成本。

所有 Neptune 管理資源都可以加上標籤，包括下列項目：

• 資料庫執行個體

• 資料庫叢集

• 僅供讀取複本

• 資料庫快照

• 資料庫叢集快照

• 事件訂閱

• 資料庫參數群組

• 資料庫叢集參數群組

• 資料庫子網路群組

Neptune 資源標籤概觀

Amazon Neptune 標籤是您定義並將其與 Neptune 資源建立關聯的名稱值組。此名稱叫做金鑰。為金鑰提供值是選用的。您可以使用標籤，將任意資訊指派給 Neptune 資源。例如，您可以使用標籤金鑰來定義類別，此標籤值可以是該類別中的項目。例如，您可以定義標籤金鑰 “project”及標籤值 “Salix”，以指示 Neptune 資源指派給 Salix 專案。您也可以使用金鑰 (例如 environment=test 或 environment=production)，以使用標籤來指定用於測試或生產的 Neptune 資源。我們建議您使用一組一致的標籤金鑰，讓您更輕鬆地追蹤與 Neptune 資源相關聯的中繼資料。

使用標籤來組織帳 AWS 單，以反映您自己的成本結構。要做到這一點，註冊以獲取包含標籤鍵值的 AWS 帳戶 帳單。接著，若要查看合併資源的成本，請根據具有相同標籤鍵值的資源來整理您的帳單資訊。例如，您可以使用特定應用程式名稱來標記數個資源，然後整理帳單資訊以查看該應用程式跨數項服務的總成本。如需詳細資訊，請參閱《AWS Billing 》使用者指南中的使用成本分配標籤。

每個 Neptune 資源皆有標籤集，其中包含指派給該 Neptune 資源的所有標籤。標籤集最多可以包含 10 個標籤，也可以是空的。如果您將標籤新增至 Neptune 資源，而它有與資源上的現有標籤相同的金鑰，則新值會覆寫舊值。

AWS 不會將任何語義意義應用於您的標籤; 標籤嚴格解釋為字符串。Neptune 可在資料庫執行個體或其他 Neptune 資源上設定標籤，這取決於您建立資源時所使用的設定。例如，Neptune 可能新增標籤以表示資料庫執行個體用於生產或測試。

• 標籤金鑰是標籤必要的名稱。字串值長度可以是 1 到 128 個 Unicode 字元，不可在前面加上「aws:」或「rds:」。此字串只能包含一組 Unicode 字母、數字、空格、「_」、「.」、「/」、「=」、「+」、「–」(Java regex："^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。

• 標籤值即為選用的標籤字串值，字串值長度可以是 1 到 256 個 Unicode 字元，不可在前面加上「aws:」。此字串只能包含一組 Unicode 字母、數字、空格、「_」、「.」、「/」、「=」、「+」、「–」(Java regex："^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。

  標籤組中的值不必是唯一的，並且可以是 null。例如，您可以在 project/Trinity 和 cost-center/Trinity 標籤集中有一個鍵值對。

注意

您可以將標籤新增到快照。不過，您的帳單不會反映這個分組。

您可以使用 AWS Management Console AWS CLI、或 Neptune API 來新增、列出和刪除 Neptune 資源上的標籤。使用 AWS CLI 或 Neptune API 時，您必須為要使用的 Neptune 資源提供 Amazon 資源名稱 (ARN)。如需建構 ARN 的詳細資訊，請參閱 建構 Neptune 的 ARN。

標籤是快取用於授權之用。因此，新增和更新 Neptune 資源的標籤可能需要幾分鐘之後才可以使用。

複製 Neptune 中的標籤

當您建立或還原資料庫執行個體時，您可以指定標籤從資料庫執行個體複製到資料庫執行個體的快照。複製標籤可確保資料庫快照的中繼資料符合來源資料庫執行個體的中繼資料，以及資料庫快照的任何存取政策也符合來源資料庫執行個體的存取政策。根據預設，不會複製標籤。

您可以指定標籤複製到資料庫快照以用於下列動作：

• 建立資料庫執行個體。

• 還原資料庫執行個體。

• 建立僅供讀取複本。

• 複製資料庫快照。

注意

如果您包含建立-db-cluster-snapshot AWS CLI 命令的--tag-key參數值 (或為 CreateDBClusterSnapshot API 動作提供至少一個標籤)，Neptune 不會將標籤從來源資料庫執行個體複製到新的資料庫快照集。即使來源資料庫執行個體啟用 --copy-tags-to-snapshot (CopyTagsToSnapshot) 選項，也是如此。

這表示您可以從資料庫快照建立資料庫執行個體的複本，避免新增不適用於新資料庫執行個體的標籤。使用 AWS CLI create-db-cluster-snapshot命令 (或 CreateDBClusterSnapshot Neptune API 動作) 建立資料庫快照集之後，您就可以依本主題稍後所述新增標籤。

在 Neptune 中使用標記 AWS Management Console

設定 Amazon Neptune 資源標籤的程序類似為所有資源設定標籤的程序。下列程序說明如何設定 Neptune 資料庫執行個體標籤。

新增標籤至資料庫資訊個體

1. 登入 AWS 管理主控台，然後開啟 Amazon Neptune 主控台，網址為 https://console.aws.amazon.com/neptune/home。

2. 在導覽窗格中，選擇執行個體。

   注意

   若要過濾 Instances (執行個體) 窗格中的資料庫執行個體清單，請在 Filter instances (過濾執行個體) 方塊中輸入文字字串。只有包含此字串的資料庫執行個體會顯示出來。

3. 選擇您要設定標籤的資料庫執行個體。

4. 選擇 Instance actions (執行個體動作)，然後選擇 See details (請參閱詳細資訊)。

5. 在詳細內容區段，向下捲動至 Tags (標籤) 區段。

6. 選擇 Add (新增)。此時將會顯示 Add tags (新增標籤) 視窗。

7. 在 Tag key (標籤金鑰) 和 Value (值) 中輸入值。

8. 若要新增另一個標籤，您可以選擇 Add another Tag (新增另一個標籤)，然後在它的 Tag key (標籤金鑰) 和 Value (值) 中輸入值。

   視需要重複此步驟。

9. 選擇 Add (新增)。

從資料庫資訊個體刪除標籤

1. 登入 AWS 管理主控台，然後開啟 Amazon Neptune 主控台，網址為 https://console.aws.amazon.com/neptune/home。

2. 在導覽窗格中，選擇執行個體。

   注意

   若要過濾 Instances (執行個體) 窗格中的資料庫執行個體清單，請在 Filter instances (過濾執行個體) 方塊中輸入文字字串。只有包含此字串的資料庫執行個體會顯示出來。

3. 選擇您要設定標籤的資料庫執行個體。

4. 選擇 Instance actions (執行個體動作)，然後選擇 See details (請參閱詳細資訊)。

5. 在詳細內容區段，向下捲動至 Tags (標籤) 區段。

6. 選擇您要刪除的標籤。

7. 選擇 Remove (移除)，然後選擇 Remove tags (移除標籤) 視窗中的 Remove (移除)。

在 Neptune 中使用標記 AWS CLI

您可以使用 AWS CLI在 Neptune 中新增、列出或移除資料庫執行個體的標籤。

• 若要將一或多個標籤新增至 Neptune 資源，請使用 AWS CLI 命令add-tags-to-resource。

• 若要列出 Neptune 資源上的標籤，請使用 AWS CLI 命令list-tags-for-resource。

• 若要從 Neptune 資源中移除一或多個標籤，請使用 AWS CLI 命令remove-tags-from-resource。

若要進一步了解如何建構必要的 Amazon Resource Name (ARN)，請參閱建構 Neptune 的 ARN。

使用 API 在 Neptune 中進行標記

您可以使用 Neptune API，新增、列出或移除資料庫執行個體的標籤。

• 若要將標籤新增到 Neptune 資源，請使用 AddTagsToResource 操作。

• 若要列出指派給 Neptune 資源的標籤，請使用 ListTagsForResource。

• 若要從 Neptune 資源中移除標籤，請使用 RemoveTagsFromResource 操作。

若要進一步了解如何建構必要的 ARN，請參閱建構 Neptune 的 ARN。

搭配 XML 使用 Neptune API 時，標籤會使用以下結構描述：

<Tagging>
    <TagSet>
        <Tag>
            <Key>Project</Key>
            <Value>Trinity</Value>
        </Tag>
        <Tag>
            <Key>User</Key>
            <Value>Jones</Value>
        </Tag>
    </TagSet>
</Tagging> 

下表列出允許的 XML 標籤及其特性。Key 和 Value 的值區分大小寫。例如，project=Trinity 和 PROJECT=Trinity 是兩個不同的標籤。

標籤元素	描述
TagSet	標籤集是指派給 Neptune 資源之所有標籤的容器。每個資源只能有一個標籤集。您只能透過 Neptune API 使用 TagSet。
Tag	標籤是使用者定義的鍵值組。標籤集內可以有 1 到 50 個標籤。
Key	鍵是標籤的必要名稱。字串值長度可以是 1 到 128 個 Unicode 字元，不可在前面加上「rds:」或「aws:」。此字串只能包含一組 Unicode 字母、數字、空格、「_」、「.」、「/」、「=」、「+」、「–」(Java regex："^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。 鍵在標籤集內必須是唯一的。例如，標籤集內的鍵組不能有相同的鍵但使用不同的值，例如 project/Trinity 和 project/Xanadu。
Value	值是標籤的選用值。字串值長度可以是 1 到 256 個 Unicode 字元，不可在前面加上「rds:」或「aws:」。此字串只能包含一組 Unicode 字母、數字、空格、「_」、「.」、「/」、「=」、「+」、「–」(Java regex："^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。 標籤集內的值不必是唯一的，並且可以是 null。例如，您可以在 project/Trinity 和 cost-center/Trinity 標籤集中有一個鍵值對。