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

# 標記您的 AWS Cloud Map 資源
<a name="using-tags"></a>

標籤是您指派給 AWS 資源的標籤。每個標籤皆包含由您定義的一個*金鑰*與一個選用*值*。

標籤可讓您依用途、擁有者或環境等方式將 AWS 資源分類。當您有許多相同類型的資源時，您可以依據先前指派的標籤，快速識別特定的資源。例如，您可以為您的 AWS Cloud Map 服務定義一組標籤，以協助您追蹤每個服務的擁有者和堆疊層級。建議您為每個資源類型設計一組一致的標籤金鑰。

標籤不會自動指派給您的資源。新增標籤後，您可以隨時編輯標籤索引鍵和值，或從資源移除標籤。如果您刪除資源，也會刪除任何該資源的標籤。

標籤對 沒有任何語意意義， AWS Cloud Map 並嚴格解譯為字元字串。您可以將標籤的值設為空白字串，但您無法將標籤的值設為 Null。若您將與現有標籤具有相同鍵的標籤新增到該資源，則新值會覆寫舊值。

您可以使用 AWS 管理主控台、 AWS CLI和 AWS Cloud Map API 來使用標籤。

如果您使用的是 AWS Identity and Access Management (IAM)，您可以控制 AWS 帳戶中哪些使用者具有建立、編輯或刪除標籤的許可。

## 如何標記資源
<a name="tag-resources"></a>

您可以標記新的或現有的 AWS Cloud Map 命名空間和服務。

如果您使用的是 AWS Cloud Map 主控台，您可以隨時使用相關資源頁面上的標籤索引標籤，將**標籤**套用至新資源或現有資源。

如果您使用的是 AWS Cloud Map API AWS CLI、 或 AWS SDK，您可以使用相關 API 動作上的 `tags` 參數將標籤套用至新資源，或使用 [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html) API 動作將標籤套用至現有資源。如需詳細資訊，請參閱 [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html)。

有些資源建立動作可讓您在建立資源時指定資源的標籤。如果無法在資源建立時套用標籤，則資源建立程序會失敗。這可確保您要在建立時標記的資源是以指定的標籤建立，不然就根本不會建立。如果您在建立時標記資源，則不需要在建立資源之後執行自訂標記指令碼。

下表說明可標記 AWS Cloud Map 的資源，以及在建立時可標記的資源。


**資源的標記支援 AWS Cloud Map**  

| 資源 | 支援標籤 | 支援標籤傳播 | 支援建立時標記 (AWS Cloud Map API、 AWS CLI AWS SDK) | 
| --- | --- | --- | --- | 
|  AWS Cloud Map 命名空間  |  是  | 否。命名空間標籤不會傳播到與命名空間相關聯的任何其他資源。 |  是  | 
|  AWS Cloud Map 服務  |  是  | 否。服務標籤不會傳播到與服務相關聯的任何其他資源。 |  是  | 

## 限制
<a name="tag-restrictions"></a>

以下基本限制適用於標籤：
+ 每個資源的標籤數量上限 – 50
+ 對於每一個資源，每個標籤金鑰必須是唯一的，且每個標籤金鑰只能有一個值。
+ 索引鍵長度上限 - 128 個 UTF-8 Unicode 字元
+ 值的長度上限 - 256 個 UTF-8 Unicode 字元
+ 如果您的標記結構描述用於多個 AWS 服務和資源，請記住，其他 服務可能有允許的字元限制。通常允許的字元包括：可用 UTF-8 表示的英文字母、數字和空格，還有以下字元：\$1 - = . \$1 : / @。
+ 標籤鍵與值皆區分大小寫。
+ 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的組合，例如索引鍵或值的字首，因為其保留供 AWS 使用。您不可編輯或刪除具此字首的標籤金鑰或值。具此字首的標籤不算在每一資源的標籤數限制內。

# 更新 AWS Cloud Map 資源的標籤
<a name="tag-resources-api-sdk"></a>

使用以下 AWS CLI 命令或 AWS Cloud Map API 操作來新增、更新、列出和刪除資源的標籤。


**資源的標記支援 AWS Cloud Map**  

| 任務 | API 動作 | AWS CLI | AWS Tools for Windows PowerShell | 
| --- | --- | --- | --- | 
|  新增或覆寫一或多個標籤。  |  [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html)  |  [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/tag-resource.html)  |  [Add-SDResourceTag](https://docs.aws.amazon.com/powershell/v4/reference/items/Add-SDResourceTag.html)  | 
|  刪除一或多個標籤。  |  [UntagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_UntagResource.html)  |  [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/untag-resource.html)  |  [Remove-SDResourceTag](https://docs.aws.amazon.com/powershell/v4/reference/items/Remove-SDResourceTag.html)  | 
| 列出資源的標籤 |  [ListTagsForResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListTagsForResource.html)  |  [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-tags-for-resource.html)  |  [Get-SDResourceTag](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-SDResourceTag.html)  | 

下列範例示範如何使用 AWS CLI來標記或取消標記資源。

**範例 1：標記現有資源**  
以下命令會標記現有的資源。

```
aws servicediscovery tag-resource --resource-arn resource_ARN --tags team=devs
```

**範例 2：取消標記現有的資源**  
以下命令會從現有的資源刪除標籤。

```
aws servicediscovery untag-resource --resource-arn resource_ARN --tag-keys tag_key
```

**範例 3：列出資源的標籤**  
以下命令列出與現有資源相關聯的標籤。

```
aws servicediscovery list-tags-for-resource --resource-arn resource_ARN
```

有些資源建立動作可讓您在建立資源時指定標籤。下列動作支援在建立時新增標籤。


| 任務 | API 動作 | AWS CLI | AWS Tools for Windows PowerShell | 
| --- | --- | --- | --- | 
| 建立 HTTP 命名空間 | [CreateHttpNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateHttpNamespace.html) | [create-http-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-http-namespace.html) | [New-SDHttpNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDHttpNamespace.html) | 
| 根據 DNS 建立私有命名空間 | [CreatePrivateDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePrivateDnsNamespace.html) | [create-private-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-private-dns-namespace.html) | [New-SDPrivateDnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPrivateDnsNamespace.html) | 
| 根據 DNS 建立公用命名空間 | [CreatePublicDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePublicDnsNamespace.html) | [create-public-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-public-dns-namespace.html) | [New-SDPublicDnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPublicDnsNamespace.html) | 
| 建立服務 | [CreateService](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html) | [create-service](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-service.html) | [New-SDService](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDService.html) |