

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

# 標記 Amazon ECS 資源
<a name="ecs-using-tags"></a>

為協助您管理 Amazon ECS 資源，您可以使用*標籤*選擇性地將您自己的中繼資料指派給每個資源。每個*標籤*皆包含*索引鍵*與選用*值*。

您可以使用標籤以不同方式將 Amazon ECS 資源分類，例如依用途、擁有者或環境。這在您擁有許多相同類型的資源時很有用。您可以根據您指派給資源的標籤快速識別特定資源。例如，您可以為帳戶的 Amazon ECS 容器執行個體定義一組標籤，這可以協助您追蹤每個執行個體的擁有者和堆疊層級。

您可以將標籤用於成本和用量報告。您可以使用這些報告分析 Amazon ECS 資源的成本和用量。如需詳細資訊，請參閱[Amazon ECS 用量報告](usage-reports.md)。

**警告**  
有許多 API 會傳回標籤鍵及其值。拒絕存取 `DescribeTags` 不會自動拒絕存取其他 API 傳回的標籤。根據最佳實務，建議您不要在標籤中包含敏感資料。

我們建議您為每種資源類型建立符合您需求的標籤金鑰。您可以使用一致的標籤索引鍵組，讓您更輕鬆的管理您的資源。您可以根據您新增的標籤搜尋和篩選資源。

標籤對 Amazon ECS 來說不具有任何語意意義，並會嚴格解譯為字元字串。您可以編輯標籤索引鍵和值，也可以隨時從資源中移除標籤。您可以將標籤的值設為空白字串，但您無法將標籤的值設為 Null。若您將與現有標籤具有相同鍵的標籤新增到該資源，則新值會覆寫早前的值。如果您刪除資源，也會刪除該資源的任何標籤。

如果您使用 AWS Identity and Access Management (IAM)，您可以控制 AWS 帳戶中哪些使用者具有管理標籤的許可。

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

Amazon ECS 任務、服務、任務定義和叢集有多種標記方式：
+ 使用者使用 AWS 管理主控台、Amazon ECS API AWS CLI、 或 AWS SDK 手動標記資源。
+ 使用者需要建立服務或執行獨立任務，然後選取 Amazon ECS 受管標籤選項。

  Amazon ECS 會自動標記所有新啟動的任務。如需詳細資訊，請參閱[Amazon ECS 受管標籤](#managed-tags)。
+ 使用者可使用主控台建立資源。主控台會自動標記資源。

  這些標籤會傳回 AWS CLI和 AWS SDK 回應，並顯示在 主控台中。您無法修改或刪除這些標籤。

  如需有關新增標籤的資訊，請參閱 **Amazon ECS 資源的標記支援**資料表中的**主控台自動新增的標籤**欄。

如果您在建立資源時指定標籤，但卻無法套用標籤，Amazon ECS 會復原建立程序。這可確保資源不是具有標籤建立，就是不會建立，因此無論何時都不會有不具有標籤的資源。藉由在建立時為資源建立標籤，您可以消除在資源建立後執行自訂標籤指令碼的必要。

下表說明支援標記的 Amazon ECS 資源。


|  資源  |  支援標籤  |  支援標籤傳播  | 主控台自動新增的標籤 | 
| --- | --- | --- | --- | 
|  Amazon ECS 任務  |  是  |  是，從任務定義。  | 索引鍵：aws:ecs:clusterName*Value (值)*：`cluster-name` | 
|  Amazon ECS 服務  |  是  |  是，從任務定義或服務到服務中的任務。  | 索引鍵：ecs:service:stackId*值*`arn:aws:cloudformation:arn` | 
|  Amazon ECS 任務集  |  是  |  否  | N/A | 
|  Amazon ECS 任務定義  |  是  |  否  | 索引鍵：ecs:taskDefinition:createdFrom*Value (值)*：`ecs-console-v2` | 
|  Amazon ECS 叢集  |  是  |  否  | 索引鍵：aws:cloudformation:logical-id*Value (值)*：`ECSCluster` 索引鍵：aws:cloudformation:stack-id*Value (值)*：`arn:aws:cloudformation:arn`*索引鍵*：`aws:cloudformation:stack-name`*Value (值)*：`ECS-Console-V2-Cluster-EXAMPLE` | 
|  Amazon ECS 容器執行個體。  |  是  |  是，來自 Amazon EC2 執行個體。如需詳細資訊，請參閱[將標籤新增至 Amazon ECS 的 Amazon EC2 容器執行個體](instance-details-tags.md)。  | N/A | 
|  Amazon ECS 外部執行個體  |  是  |  否  | N/A | 
| Amazon ECS 容量提供者 |  是。您無法標記預先定義的 `FARGATE` 和 `FARGATE_SPOT` 容量提供者。 | 是，僅可透過 Amazon ECS 受管執行個體的容量提供者實現。您可以將標籤從 Amazon ECS 受管執行個體的容量提供者傳播至提供者管理的所有資源，例如 Amazon EC2 執行個體、啟動範本、彈性網路介面與磁碟區。 | N/A | 

## 在建立期間標記資源
<a name="tags-on-creation"></a>

下列資源支援使用 Amazon ECS API AWS CLI或 AWS SDK 建立時標記：
+ Amazon ECS 任務
+ Amazon ECS 服務
+ Amazon ECS 任務定義
+ Amazon ECS 任務集
+ Amazon ECS 叢集
+ Amazon ECS 容器執行個體。
+ Amazon ECS 容量提供者

Amazon ECS 可選擇使用標記授權來建立資源。當 AWS 帳戶 設定為標記授權時，使用者必須具有建立資源之動作的許可，例如 `ecsCreateCluster`。如果您在資源建立動作中指定標籤， AWS 會執行額外的授權，以驗證使用者或角色是否具有建立標籤的許可。因此，您必須授予使用 `ecs:TagResource` 動作的明確許可。如需詳細資訊，請參閱[在建立時授予標記資源的許可](supported-iam-actions-tagging.md)。如需關於如何設定此選項的資訊，請參閱[標記授權](ecs-account-settings.md#tag-resources-setting)。

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

以下限制適用於標籤：
+ 資源最多可與 50 個標籤建立關聯。
+ 單一資源的標籤索引鍵不能重複。每個標籤索引鍵都必須是唯一的，而且只能有一個值。
+ 索引鍵的長度上限是 128 個 UTF-8 字元。
+ 索引鍵的長度上限是 256 個 UTF-8 字元。
+ 如果多個 AWS 服務 和 資源使用您的標記結構描述，請限制您使用的字元類型。某些服務可能對允許的字元設有限制。通常允許的字元為：字母、數字和空格，以及下列字元：`+` `-` `=` `.` `_` `:` `/` `@`。
+ 標籤鍵與值皆區分大小寫。
+ 您無法使用 `aws:`、`AWS:` 或任何大小寫組合作為索引鍵或值的字首。這些僅供保留 AWS 使用。您不可編輯或刪除具此字首的標籤金鑰或值。具此字首的標籤不算在每一資源的標籤數限制內。

## Amazon ECS 受管標籤
<a name="managed-tags"></a>

當您使用 Amazon ECS 受管標籤時，Amazon ECS 會自動標記包含叢集資訊的所有新啟動的任務以及任何連接到任務的 Amazon EBS 磁碟區，使用的標籤是使用者新增的任務定義標籤或服務標籤。以下說明新增的標籤：
+ 獨立任務 – *索引鍵*為 `aws:ecs:clusterName` 且*值*設定為叢集名稱的標籤。使用者新增的所有任務定義標籤。連接至獨立任務的 Amazon EBS 磁碟區會收到一個*鍵*為 `aws:ecs:clusterName` 且*值*設定為叢集名稱的標籤。如需有關 Amazon EBS 磁碟區標記的詳細資訊，請參閱[標記 Amazon EBS 磁碟區](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging)。
+ 屬於服務一部分的任務 – *索引鍵*為 `aws:ecs:clusterName` 且*值*設定為叢集名稱的標籤。*索引鍵*為 `aws:ecs:serviceName` 且*值*設定為服務名稱的標籤。來自下列其中一項資源的標籤：
  + 任務定義 – 使用者新增的所有任務定義標籤。
  + 服務 – 使用者新增的所有服務標籤。

    連接至屬於服務之任務的 Amazon EBS 磁碟區將會收到一個*鍵*為 `aws:ecs:clusterName` 且*值*設定為叢集名稱的標籤，以及一個*鍵*為 `aws:ecs:serviceName` 且*值*設定為服務名稱的標籤。如需有關 Amazon EBS 磁碟區標記的詳細資訊，請參閱[標記 Amazon EBS 磁碟區](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging)。

對此功能而言，下列選項為必要：
+ 您必須選擇加入新的 Amazon Resource Name (ARN) 和資源識別符 (ID) 格式。如需詳細資訊，請參閱[Amazon Resource Name (ARN) 和 ID](ecs-account-settings.md#ecs-resource-ids)。
+ 當您使用 API 建立服務或執行工作時，您必須為 `run-task` 和 `create-service` 將 `enableECSManagedTags` 設定至 `true`。如需詳細資訊，請參閱 [AWS Command Line Interface API 參考](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html)中的 [create-service](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) 和 *run-task*。
+ Amazon ECS 使用受管標籤來判斷何時啟用某些功能，例如叢集自動擴展。建議不要手動修改標籤，以便 Amazon ECS 能夠有效管理這些功能。

## 將標籤用於計費
<a name="tag-resources-for-billing"></a>

AWS 提供名為 Cost Explorer 的報告工具，可用來分析 Amazon ECS 資源的成本和用量。

您可以使用 Cost Explorer 來檢視用量和成本的圖表。您可以檢視過去 13 個月以來的資料，並預測未來三個月的可能花費。您可以使用 Cost Explorer 來查看在一段時間內的 AWS 資源支出模式。例如，您可以用它來找出需進一步調查的領域，以及查看您可用來了解成本的趨勢。您也可以指定資料的時間範圍，以及根據天或月檢視時間資料。

您可以將 Amazon ECS 受管標籤或使用者新增的標籤用於成本和用量報告。如需詳細資訊，請參閱[Amazon ECS 用量報告](usage-reports.md)。

若想要查看合併資源的成本，您可根據具有相同標籤金鑰值的資源來整理您的帳單資訊。例如，您可以使用特定應用程式名稱來標記數個資源，然後整理帳單資訊以查看該應用程式跨數項服務的總成本。如需有關使用標籤設定成本分配報告的詳細資訊，請參閱《AWS Billing 使用者指南》**中的[每月成本分配報告](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html)。

此外，您可以開啟*拆分成本分配資料*，在成本和用量報告中取得任務層級 CPU 和記憶體用量資料。如需詳細資訊，請參閱[任務層級成本和用量報告](usage-reports.md#task-cur)。

**注意**  
若您開啟報告，目前月份的資料會在 24 小時之後提供檢視。

# 將標籤新增至 Amazon ECS 資源
<a name="tag-resources-console"></a>

您可以標記新的或現有的任務、服務、任務定義和叢集。如需有關標記容器執行個體的資訊，請參閱[將標籤新增至 Amazon ECS 的 Amazon EC2 容器執行個體](instance-details-tags.md)。

**警告**  
請勿在標籤中加入個人身分識別資訊 (PII) 或其他機密或敏感資訊。許多 AWS 服務都可以存取標籤，包括帳單。標籤不適用於私有或敏感資料。

建立資源時，您可以使用以下資源來指定標籤。


|  任務  |  主控台  |  AWS CLI  |  API 動作  | 
| --- | --- | --- | --- | 
|  執行一或多個任務。  |  [將應用程式作為 Amazon ECS 任務執行](standalone-task-create.md)  |  [run-task](https://docs.aws.amazon.com/cli/latest/reference/ecs/run-task.html)  |  [RunTask](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html)  | 
|  建立服務。  |  [建立 Amazon ECS 滾動更新部署](create-service-console-v2.md)  |  [create-service](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-service.html)  |  [CreateService](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html)  | 
|  建立任務集。  |  [使用第三方控制器部署 Amazon ECS 服務](deployment-type-external.md)  |  [create-task-set](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-task-set.html)  |  [CreateTaskSet](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html)  | 
|  註冊任務定義。  | [使用主控台建立 Amazon ECS 任務定義](create-task-definition.md) |  [register-task-definition](https://docs.aws.amazon.com/cli/latest/reference/ecs/register-task-definition.html)  |  [RegisterTaskDefinition](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RegisterTaskDefinition.html)  | 
|  建立叢集。  |  [為 Fargate 工作負載建立 Amazon ECS 叢集](create-cluster-console-v2.md)   |  [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-cluster.html)  |  [CreateCluster](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCluster.html)  | 
|  執行一或多個容器執行個體。  |  [啟動 Amazon ECS Linux 容器執行個體](launch_container_instance.md)  |  [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html)  |  [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html)  | 
|  為 Amazon ECS 受管執行個體建立容量提供者。  |  [為 Amazon ECS 受管執行個體建立容量提供者](create-capacity-provider-managed-instances.md)  |  [create-capacity-provider](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-capacity-provider.html)  |  [CreateCapacityProvider](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html)  | 

## 將標籤新增至現有資源 (Amazon ECS 主控台)
<a name="adding-or-deleting-tags"></a>

您可直接從資源的頁面新增或刪除與叢集、服務、任務和任務定義相關聯的標籤。

**修改個別資源的標籤**

1. 開啟主控台，網址為 [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)。

1. 從導覽列中，選取要 AWS 區域 使用的 。

1. 在導覽窗格中，選取資源類型 (例如，**Clusters (叢集)**)。

1. 從資源清單選取資源，選擇 **Tags** (標籤) 索引標籤，然後選擇 **Manage tags** (管理標籤)。

1. 設定標籤。

   [新增標籤] 選擇**新增標籤**，然後執行下列操作︰
   + 在**索引鍵**中，輸入索引鍵名稱。
   + 在**值**欄位中，輸入金鑰值。

1. 選擇**儲存**。

## 將標籤新增至現有資源 (AWS CLI)
<a name="tag-resources-api-sdk"></a>

您可以使用 或 AWS CLI API 新增或覆寫一或多個標籤。

**注意**  
您可以使用雙堆疊服務端點，透過 IPv4 和 IPv6 AWS CLI從 、 SDKs 和 Amazon ECS API 與 Amazon ECS 互動。如需詳細資訊，請參閱[使用 Amazon ECS 雙堆疊端點](dual-stack-endpoint.md)。
+ AWS CLI - [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/ecs/tag-resource.html)
+ API 動作：[TagResource](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html)

# Amazon ECS 受管執行個體的標籤
<a name="instance-details-tags-managed-instances"></a>

Amazon ECS 受管執行個體支援由 新增的自訂標籤和標籤組合 AWS ，可用於成本最佳化。如需有關將標籤用於計費的詳細資訊，請參閱[將標籤用於計費](ecs-using-tags.md#tag-resources-for-billing)。

## 由 新增的標籤 AWS
<a name="instance-details-tags-managed-instances-system"></a>

 AWS 會將下列標籤新增至容量提供者建立的每個 Amazon ECS 受管執行個體：
+ Amazon ECS 會自動將預留標籤 `AmazonECSCreated` 與 `AmazonECSManaged` 新增至 Amazon ECS 受管執行個體。
+ Amazon ECS 會將如下系統標籤新增至每個執行個體：
  + *鍵*為 `aws:ecs:clusterName` 且*值*設定為叢集名稱的標籤。
  + *鍵*為 `aws:ecs:capacityProviderName` 且*值*設定為容量提供者名稱的標籤。
  + *鍵*為 `aws:ecs:containerInstanceId` 且*值*為 Amazon ECS 受管執行個體容器執行個體 ID 的標籤。
+ Amazon EC2 會新增值為 `ecs-managed-instances` 的系統標籤 `aws:ec2:managed-launch`。此外，Amazon EC2 會新增系統標籤，表示用來建立受管執行個體的啟動範本，以及受管執行個體所屬的 Amazon EC2 Fleet。

## 自訂標籤
<a name="instance-details-tags-managed-instances-custom"></a>

您可以透過將標籤新增至容量提供者，同時使用 `propagateTags` 屬性啟用標籤傳播，將額外的自訂標籤新增至 Amazon ECS 受管執行個體。容量提供者上的標籤會傳播到容量提供者啟動的受管執行個體

下列容量提供者定義範例示範如何在使用 `propagateTags` 的 `CAPACITY_PROVIDER` 值建立容量提供者時，透過容量提供者指定與傳播標籤。

```
{
    "name": "my-cluster-managed-instances-cp",
    "cluster": "my-cluster",
     "tags": [
                {
                "key":"tag_key",
                "value":"tag_value"
                }
            ],
    "managedInstancesProvider": {
        "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
        "propagateTags": "CAPACITY_PROVIDER",
        "instanceLaunchTemplate": {
            "ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile",
            "networkConfiguration": {
                "subnets": [
                    "subnet-abcdef01234567",
                    "subnet-bcdefa98765432"
                ],
                "securityGroups": [ 
                    "sg-0123456789abcdef"
                ]
            }
        }
    }
}
```

**注意**  
在將新標籤新增至容量提供者時，新增的標籤不會傳播至現有執行個體，但會傳播至任何新建立的執行個體。
客戶可以直接將標籤新增至 EC2 執行個體，但這些標籤不會傳播回容量提供者
您也可以使用 或 標記或取消標記容量提供者 [將標籤新增至現有資源 (AWS CLI)](tag-resources-console.md#tag-resources-api-sdk) [將標籤新增至現有資源 (Amazon ECS 主控台)](tag-resources-console.md#adding-or-deleting-tags)

如需有關 Amazon ECS 受管執行個體容量提供者的詳細資訊，請參閱 [Amazon ECS 受管執行個體容量提供者](managed-instances-capacity-providers-concept.md)。

# 將標籤新增至 Amazon ECS 的 Amazon EC2 容器執行個體
<a name="instance-details-tags"></a>

您可以使用以下其中一種方法，將標籤與 Amazon ECS Amazon EC2 容器執行個體建立關聯：
+ 方法 1：當您使用 Amazon EC2 API、CLI 或主控台建立容器執行個體時，使用容器代理程式組態參數 `ECS_CONTAINER_INSTANCE_TAGS` 將使用者資料傳遞到執行個體，以指定標籤。這樣會建立僅在 Amazon ECS 中與容器執行個體相關聯的標記，使用 Amazon EC2 API 無法將其列出在。如需詳細資訊，請參閱[引導 Amazon ECS Linux 容器執行個體傳遞資料](bootstrap_container_instance.md)。
**重要**  
如果您使用 Amazon EC2 Auto Scaling 群組啟動容器執行個體，則應使用 ECS\$1CONTAINER\$1INSTANCE\$1TAGS 代理程式組態參數來新增標籤。這是由於標籤新增到了使用 Auto Scaling 群組啟動的 Amazon EC2 執行個體。

  以下的使用者資料指令碼範例將標籤與您的容器執行個體建立關聯：

  ```
  #!/bin/bash
  cat <<'EOF' >> /etc/ecs/ecs.config
  ECS_CLUSTER=MyCluster
  ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
  EOF
  ```
+ 方法 2 – 當您使用 Amazon EC2 API、CLI 或主控台建立容器執行個體時，應先使用 `TagSpecification.N` 參數指定標籤。然後，使用容器代理程式組態參數 `ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM` 將使用者資料傳遞至執行個體。這樣做可以將它們從 Amazon EC2 傳播到 Amazon ECS。

  以下的使用者資料指令碼範例會傳播與 Amazon EC2 執行個體相關聯的標籤，並向名為 `MyCluster` 的叢集註冊該執行個體。

  ```
  #!/bin/bash
  cat <<'EOF' >> /etc/ecs/ecs.config
  ECS_CLUSTER=MyCluster
  ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance
  EOF
  ```

  若要提供存取，以允許容器執行個體標籤從 Amazon EC2 傳播到 Amazon ECS，請將以下許可當作內嵌政策，手動新增至 Amazon ECS 容器執行個體 IAM 角色。如需詳細資訊，請參閱[新增和移除 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。
  + `ec2:DescribeTags`

  以下為用來新增這些許可的政策範例。

------
#### [ JSON ]

****  

  ```
  {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
              	"ec2:DescribeTags"
              ],
              "Resource": "*"
          }
      ]
  }
  ```

------

# 將標籤新增至 Amazon ECS 的外部容器執行個體
<a name="instance-details-tags-external"></a>

您可以使用以下其中一種方法，將標籤與 Amazon ECS 的外部容器執行個體建立關聯。
+ 方法 1：在執行安裝指令碼以註冊您的外部執行個體到叢集之前，在 `/etc/ecs/ecs.config` 建立或編輯 Amazon ECS 容器代理程式組態檔案，並且新增 `ECS_CONTAINER_INSTANCE_TAGS` 容器代理程式組態參數。這將會建立與外部執行個體相關聯的標籤。

  以下為範例語法。

  ```
  ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
  ```
+ 方法 2 – 將外部執行個體註冊到您的叢集之後，您可以使用 AWS 管理主控台 來新增標籤。如需詳細資訊，請參閱[將標籤新增至現有資源 (Amazon ECS 主控台)](tag-resources-console.md#adding-or-deleting-tags)。

# Amazon ECS 用量報告
<a name="usage-reports"></a>

AWS 提供名為 Cost Explorer 的報告工具，可用來分析 Amazon ECS 資源的成本和用量。

您可以使用 Cost Explorer 來檢視用量和成本的圖表。您可以檢視過去 13 個月以來的資料，並預測未來三個月的可能花費。您可以使用 Cost Explorer 來查看在一段時間內的 AWS 資源支出模式。例如，您可以用它來找出需進一步調查的領域，以及查看您可用來了解成本的趨勢。您也可以指定資料的時間範圍，以及根據天或月檢視時間資料。

成本與用量報告中的計量資料會顯示所有 Amazon ECS 任務的用量。針對執行的每項任務，計量資料會包含做為 `vCPU-Hours` 的 CPU 用量以及做為 `GB-Hours` 記憶體用量。資料的呈現方式取決於任務的運算選項。

針對使用 Fargate 的任務，`lineItem/Operation` 欄會顯示 `FargateTask`，而且您會看到與每個任務相關聯的費用。

針對使用 EC2 的任務，`lineItem/Operation` 欄會顯示 `ECSTask-EC2`，而且任務不會有與其相關聯的直接費用。報告中顯示的計量資料，如記憶體用量，代表任務在指定計費期間預留的總資源。您可以使用這個資料來判斷 Amazon EC2 執行個體的基礎叢集費用。Amazon EC2 服務下會個別列出 Amazon EC2 執行個體的費用和用量資料。

您也可以使用 Amazon ECS 受管標籤來識別每項任務所屬的服務或叢集。如需詳細資訊，請參閱[將標籤用於計費](ecs-using-tags.md#tag-resources-for-billing)。

**重要**  
只有在 2018 年 11 月 16 日或之後啟動的任務，才有計量資料可供檢視。在此日期之前啟動的任務不會顯示計量資料。

以下是 Cost Explorer 中可以用來排序成本分配資料的一些欄位範例。
+ 叢集名稱
+ 服務名稱
+ 資源標籤
+ 啟動類型
+ AWS 區域
+ 用量類型

如需建立 AWS 成本和用量報告的詳細資訊，請參閱*AWS Billing 《 使用者指南*》中的[AWS 成本和用量報告](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-reports-costusage.html)。

## 任務層級成本和用量報告
<a name="task-cur"></a>

AWS Cost Management 可以在 中 AWS Cost and Usage Report 為 Amazon ECS 上的每個任務提供 CPU 和記憶體用量資料，包括 Fargate 上的任務和 EC2 上的任務。此資料稱為*拆分成本分配資料*。您可以使用此資料來分析應用程式的成本和用量。此外，您可以拆分成本並將成本分配給具有成本分配標籤和成本類別的個別業務單位和團隊。如需*分割成本分配資料*的詳細資訊，請參閱 AWS Cost and Usage Report 《 使用者指南》中的[了解分割成本分配資料](https://docs.aws.amazon.com/cur/latest/userguide/split-cost-allocation-data.html)。

您可以選擇加入 AWS Cost Management Console帳戶的任務層級*拆分成本分配資料*。如果您有一個管理 (付款人) 帳戶，您可以從付款人帳戶中選擇加入此組態，並將其套用至每個連結的帳戶。

設定*拆分成本分配資料*後，報表中的 **splitLineItem** 標頭下將會有額外資料欄。如需詳細資訊，請參閱 AWS Cost and Usage Report 《 使用者指南》中的[分割明細項目詳細資訊](https://docs.aws.amazon.com/cur/latest/userguide/split-line-item-columns.html) 

對於 EC2 上的任務，此資料會根據資源用量或保留以及執行個體上的剩餘資源來拆分 EC2 執行個體的成本。

先決條件如下：
+ 將 `ECS_DISABLE_METRICS` Amazon ECS 代理程式組態參數設定為 `false`。

  若此設定為 `false`，Amazon ECS 代理程式會將指標傳送至 Amazon CloudWatch。在 Linux 上，此設定預設為 `false`，並將指標傳送至 CloudWatch。在 Windows 上，此設定`true`預設為 ，因此您必須將設定變更為 `false`，才能將指標傳送至 CloudWatch， AWS Cost Management 以供 使用。如需 ECS 代理程式組態的詳細資訊，請參閱 [Amazon ECS 容器代理程式組態](ecs-agent-config.md)。
+ 可靠指標的最低 Docker 版本是 Docker 版本 v20.10.13 及更新版本，該版本隨附於 Amazon ECS 最佳化 AMI 20220607 及更新版本中。

若要使用*拆分成本分配資料*，您必須建立報表，然後選取 **Split cost allocation data** (拆分成本分配資料)。如需詳細資訊，請參閱 AWS Cost and Usage Report 《 使用者指南》中的[建立成本和用量報告](https://docs.aws.amazon.com/cur/latest/userguide/cur-create.html)。

AWS Cost Management 會使用任務 CPU 和記憶體用量計算*分割成本分配資料*。 AWS Cost Management 如果用量不可用， 可以使用任務 CPU 和記憶體保留，而不是用量。如果您看到 CUR 正在使用預留，請檢查您的容器執行個體是否符合先決條件，並在 CloudWatch 中顯示任務資源使用量指標。