本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 標記 Amazon Managed Grafana 工作區
<a name="Tagging_workspaces"></a>

使用本節中的程序來處理 Amazon Managed Grafana 工作區的標籤。

**Topics**

# 將標籤新增至工作區
<a name="Add-tag-to-workspace"></a>

將標籤 （鍵/值對） 新增至 Amazon Managed Grafana 工作區可協助您識別和組織 AWS 資源。首先，您可以將一或多個標籤新增至工作區，然後您可以建立 IAM 政策來根據這些標籤管理工作區的存取權。您可以使用 主控台或 AWS CLI 將標籤新增至 Amazon Managed Grafana 工作區。

**重要**  
將標籤新增至工作區可能會影響對該工作區的存取權。將標籤新增至工作區之前，務必檢閱任何可能會使用標籤控制資源存取權的 IAM 政策。

如需有關在建立標籤時將標籤新增至 Amazon Managed Grafana 工作區的詳細資訊，請參閱《Amazon Managed Grafana 使用者指南》[建立 Amazon Managed Grafana 工作區](AMG-create-workspace.md)中的 。

------
#### [  Console  ]

您可以使用 主控台，將一或多個標籤新增至 Amazon Managed Grafana 工作區。

1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/) 的 Amazon Managed Grafana 主控台。

1. 在左側導覽窗格中，選擇選單圖示。

1. 選擇**所有工作區**。

1. 選擇您要管理工作區的工作區 ID。

1. 選擇 **Tags** (標籤) 索引標籤。

1.  選擇**管理標籤**。

1. 在**金鑰**欄位中，輸入標籤的名稱。您可以在值欄位中新增標籤的選用**值**。

1. （選用） 若要新增另一個標籤，請選擇**新增標籤**。

1. 當您完成新增標籤時，請選擇**儲存變更**。

------
#### [  CLI  ]

請依照下列步驟，使用 AWS CLI 將一或多個標籤新增至 Amazon Managed Grafana 工作區：
+ 在終端機或命令列，執行 `tag-resource`命令，指定您要新增標籤之工作區的 Amazon Resource Name (ARN)，以及您要新增之標籤的索引鍵和值。您可以將多個標籤新增至工作區。例如，若要使用名為 *Name* 的標籤索引鍵標記 Grafana 工作區 *My-Workspace***，請執行下列命令：

  ```
  aws grafana tag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/My-Workspace --tags "Name=my_key_value"
  ```

------

# 檢視工作區的標籤
<a name="view-tags-for-workspace"></a>

您可以檢視與 Amazon Managed Grafana 工作區相關聯的標籤。如需標記策略的詳細資訊，請參閱《 AWS 一般參考》中的[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。

------
#### [  Console  ]

您可以使用 主控台來檢視與 Amazon Managed Grafana 工作區相關聯的標籤。

1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/) 的 Amazon Managed Grafana 主控台。

1.  在左側導覽窗格中，選擇選單圖示。

1.  選擇**所有工作區**。

1.  選擇您要管理工作區的工作區 ID。

1.  選擇 **Tags** (標籤) 索引標籤。

------
#### [  CLI  ]

請依照下列步驟使用 AWS CLI 來檢視 Amazon Managed Grafana 工作區的 AWS 標籤。若未新增標籤，傳回的清單空白。

在終端機或命令列，執行 **list-tags-for-resource** 命令。例如，若要檢視工作區的標籤索引鍵和標籤值清單，請執行下列命令：

```
aws grafana list-tags-for-resource --resoure-arn arn:aws:grafana:us-west-2:/workspace/workspace-IDstring
```

若成功，此命令會傳回類似如下的資訊：

```
{
    "tags": {
        "Status": "Secret",
        "Team": "My-Team"
    }
}
```

------

# 編輯工作區的標籤
<a name="edit-tags-for-workspace"></a>

您可以使用 `TagResource` API 在單一呼叫中變更與工作區相關聯的標籤值。若要更新現有標籤的金鑰，您必須結合 `UntagResource`和 `TagResource` APIs。

**重要**  
編輯 Amazon Managed Grafana 工作區的標籤可能會影響對該工作區的存取。在編輯工作區的標籤之前，請務必檢閱任何可能使用標籤金鑰或值來控制儲存庫等資源存取的 IAM 政策。

------
#### [  Console  ]

您可以使用 主控台來編輯與 Amazon Managed Grafana 工作區相關聯的標籤。

1. 在 Grafana 主控台開啟 Amazon Managed [Grafana 主控台](https://console.aws.amazon.com/grafana/)。

1.  在左側導覽窗格中，選擇選單圖示。

1.  選擇**所有工作區**。

1.  選擇您要管理工作區的工作區 ID。

1.  選擇 **Tags** (標籤) 索引標籤。

1.  選擇**管理標籤**。

1.  在**金鑰**欄位中，輸入標籤的名稱。您可以在值欄位中新增標籤的選用**值**。

1. 完成編輯標籤後，請選擇**儲存變更**。

------
#### [  CLI  ]

請依照下列步驟使用 AWS CLI 來更新工作區的標籤。您可以變更現有金鑰的值，或新增另一個金鑰。

在終端機或命令列，執行 **tag-resource** 命令，指定您要更新標籤的 Amazon Managed Grafana 工作區的 Amazon Resource Name (ARN)，並指定標籤索引鍵和標籤值。

例如，若要使用新值 *Key\$1value\$1new* 變更標籤的值，請執行下列命令。

```
aws grafana tag-resource \
    --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring \
    --tags "Name=Key_value_new"
```

 若要使用新名稱 *Name\$1new* 變更標籤的金鑰，請執行下列命令：

```
aws grafana untag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring --tag-keys Items=Name
aws grafana tag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring --tags "Name_new=Key_value_old"
```

------

# 將標籤從工作區移除
<a name="remove-tag-from-workspace"></a>

您可以移除一或多個與工作區相關聯的標籤。移除標籤不會從與該標籤相關聯的其他 AWS 資源中刪除標籤。

**重要**  
從 Amazon Managed Grafana 工作區移除標籤可能會影響對該工作區的存取。從工作區移除標籤之前，請務必檢閱任何可能使用標籤金鑰或值來控制對工作區等資源的存取的 IAM 政策。

------
#### [  Console  ]

您可以使用主控台移除標籤和工作區之間的關聯。

1. 在 Grafana 主控台開啟 Amazon Managed [Grafana 主控台](https://console.aws.amazon.com/grafana/)。

1.  在左側導覽窗格中，選擇選單圖示。

1.  選擇**所有工作區**。

1.  選擇您要管理工作區的工作區 ID。

1.  選擇 **Tags** (標籤) 索引標籤。

1.  選擇**管理標籤**。

1.  尋找您要刪除的標籤，然後選擇**移除**。

1.  完成移除標籤後，請選擇**儲存變更**。

------
#### [  CLI  ]

請依照下列步驟，使用 從工作區 AWS CLI 移除標籤。移除標籤不會從其他資源刪除標籤，但只會移除標籤與工作區之間的關聯。

**注意**  
如果您刪除 Amazon Managed Grafana 工作區，所有標籤關聯都會從已刪除的工作區中移除。您不需要在刪除工作區之前移除標籤。

在終端機或命令列，執行 **untag-resource** 命令，指定您要移除標籤之工作區的 Amazon Resource Name (ARN)，以及您要移除之標籤的標籤索引鍵。例如，若要使用標籤索引鍵*名稱*移除工作區上名為 *workspace-IDstring* 的標籤，請執行下列命令：

```
aws grafana untag-resource --resoure-arn arn:aws:grafana:us-west-2:/workspaces/workspace-IDstring --tag-keys Items=Name
```

如果成功，此命令會傳回空的回應。若要確認已移除與工作區相關聯的標籤，請執行 **list-tags-for-resource** 命令。

------