Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Markieren von Amazon-ECS-Ressourcen
Um sich die Verwaltung Ihrer Amazon-ECS-Ressourcen zu erleichtern, können Sie optional jeder Ressource mithilfe von *Tags* Ihre eigenen Metadaten zuweisen. Jedes *Tag* besteht aus einem *Schlüssel* und einem optionalen *Wert*.
Mit Tags können Sie Ihre Amazon-ECS-Ressourcen auf unterschiedliche Weise kategorisieren (z. B. nach Zweck, Eigentümer oder Umgebung). Dies ist nützlich, wenn Sie viele Ressourcen desselben Typs haben. Sie können eine bestimmte Ressource anhand der ihr zugewiesenen Tags schnell identifizieren. Sie können zum Beispiel eine Reihe von Tags für die Amazon-ECS-Container-Instances Ihres Kontos definieren. Auf diese Weise können Sie den Eigentümer und die Stack-Ebene der einzelnen Instances nachverfolgen.
Sie können Tags für Ihre Kosten- und Nutzungsberichte verwenden. Sie können diese Berichte verwenden, um die Kosten und Nutzung Ihrer Amazon-ECS-Ressourcen analysieren. Weitere Informationen finden Sie unter [Amazon-ECS-Nutzungsberichte](usage-reports.md).
**Warnung**
Es gibt viele APIs , die Tag-Schlüssel und ihre Werte zurückgeben. Das Verweigern des Zugriffs auf verweigert `DescribeTags` nicht automatisch den Zugriff auf Tags, die von anderen APIs zurückgegeben wurden. Als bewährte Vorgehensweise empfehlen wir Ihnen, keine sensiblen Daten in Ihre Tags (Markierungen) aufzunehmen.
Wir empfehlen die Verwendung von Tag (Markierung)-Schlüsseln, die die Anforderungen der jeweiligen Ressourcentypen erfüllen. Eine Anzahl einheitlicher Tagschlüssel vereinfacht das Verwalten Ihrer Ressourcen. Sie können die Ressourcen auf Grundlage der hinzugefügten Tags (Markierungen) filtern und danach suchen.
Tags (Markierungen) haben keine semantische Bedeutung für Amazon ECS und werden ausschließlich als Zeichenfolgen interpretiert. Sie können Tag (Markierung)-Schlüssel und -Werte bearbeiten und Tags (Markierungen) jederzeit von einer Ressource entfernen. Sie können den Wert eines Tags (Markierung) zwar auf eine leere Zeichenfolge, jedoch nicht null festlegen. Wenn Sie ein Tag (Markierung) mit demselben Schlüssel wie ein vorhandener Tag (Markierung) für die Ressource hinzufügen, wird der alte Wert mit dem neuen überschrieben. Wenn Sie eine Ressource löschen, werden alle Tags der Ressource ebenfalls gelöscht.
Wenn Sie AWS Identity and Access Management (IAM) verwenden, können Sie steuern, welche Benutzer in Ihrem AWS Konto berechtigt sind, Tags zu verwalten.
## So werden Ressourcen markiert
Es gibt mehrere Möglichkeiten, Amazon-ECS-Aufgaben, -Services, -Aufgabendefinitionen und -Cluster zu markieren:
+ Ein Benutzer markiert eine Ressource manuell mithilfe der AWS-Managementkonsole Amazon ECS-API AWS CLI, des oder eines AWS SDK.
+ Ein Benutzer erstellt einen Service oder führt eine eigenständige Aufgabe aus und wählt die Option Amazon ECS Managed Tags aus.
Amazon ECS markiert automatisch alle neu gestarteten Aufgaben. Weitere Informationen finden Sie unter [Amazon ECS Managed Tags](#managed-tags).
+ Ein Benutzer erstellt mithilfe der Konsole eine Ressource. Die Konsole markiert die Ressourcen automatisch.
Diese Tags werden in den AWS CLI und AWS SDK-Antworten zurückgegeben und in der Konsole angezeigt. Sie können diese Tags nicht ändern oder löschen.
Informationen zu den hinzugefügten Tags finden Sie in der Spalte **Tags, die automatisch von der Konsole hinzugefügt wurden** in der Tabelle **Tagging-Unterstützung für Amazon-ECS-Ressourcen**.
Wenn Sie bei der Erstellung einer Ressource Tags angeben und die Tags nicht angewendet werden können, macht Amazon ECS den Erstellungsprozess rückgängig. Auf diese Weise werden Ressourcen entweder mit Tags (Markierungen) oder überhaupt nicht erstellt und keine Ressourcen verbleiben ohne Tags (Markierungen). Indem Sie Ressourcen zum Erstellungszeitpunkt markieren, müssen Sie anschließend keine benutzerdefinierten Markierungs-Skripts ausführen.
Die folgende Tabelle beschreibt die Amazon-ECS-Ressourcen, die Tagging unterstützen.
| Ressource | Unterstützt Tags (Markierungen) | Unterstützt Tag-Propagierung | Von der Konsole automatisch hinzugefügte Tags |
| --- | --- | --- | --- |
| Amazon-ECS-Aufgaben | Ja | Ja, von der Aufgabendefinition. | Schlüssel: aws:ecs:clusterName *Value (Wert)*: `cluster-name` |
| Amazon-ECS-Services | Ja | Ja, von der Aufgabendefinition oder dem Service zu den Aufgaben im Service. | Schlüssel: ecs:service:stackId *Wert* `arn:aws:cloudformation:arn` |
| Amazon-ECS-Aufgabensätze | Ja | Nein | – |
| Amazon-ECS-Aufgabendefinitionen | Ja | Nein | Schlüssel: ecs:taskDefinition:createdFrom *Value (Wert)*: `ecs-console-v2` |
| Amazon-ECS-Cluster | Ja | Nein | Schlüssel: aws:cloudformation:logical-id *Value (Wert)*: `ECSCluster` Schlüssel: aws:cloudformation:stack-id*Value (Wert)*: `arn:aws:cloudformation:arn`*Schlüssel*: `aws:cloudformation:stack-name`*Value (Wert)*: `ECS-Console-V2-Cluster-EXAMPLE` |
| Amazon-ECS-Container-Instances | Ja | Ja, von der Amazon-EC2-Instance. Weitere Informationen finden Sie unter [Hinzufügen von Tags zu einer Amazon-EC2-Container-Instance für Amazon ECS](instance-details-tags.md). | – |
| Externe Amazon-ECS-Instances | Ja | Nein | – |
| Amazon-ECS-Kapazitätsanbieter | Ja. Vordefinierte `FARGATE`- und `FARGATE_SPOT`-Kapazitätsanbieter können nicht markiert werden. | Ja, nur von Kapazitätsanbietern für Amazon ECS Managed Instances. Sie können Tags vom Kapazitätsanbieter für Amazon ECS Managed Instances an alle vom Anbieter verwalteten Ressourcen weitergeben, z. B. Amazon-EC2-Instances, Startvorlagen, Elastic-Network-Schnittstellen und Volumes. | – |
## Markieren von Ressourcen bei der Erstellung
Die folgenden Ressourcen unterstützen das Tagging bei der Erstellung mithilfe der Amazon ECS-API oder des AWS SDK: AWS CLI
+ Amazon-ECS-Aufgaben
+ Amazon-ECS-Dienstleistungen
+ Amazon ECS-Aufgabendefinition
+ Amazon-ECS-Aufgabensätze
+ Amazon-ECS-Cluster
+ Amazon-ECS-Container-Instances
+ Amazon-ECS-Kapazitätsanbieter
Amazon ECS bietet die Möglichkeit, die Tagging-Autorisierung für die Erstellung von Ressourcen zu verwenden. Wenn das AWS-Konto für die Autorisierung durch Tags konfiguriert ist, müssen Benutzer über Berechtigungen für Aktionen verfügen, die die Ressource erstellen, wie z. B. `ecsCreateCluster`. Wenn Sie bei der Aktion zur Erstellung von Ressourcen Tags angeben, AWS führt eine zusätzliche Autorisierung durch, um zu überprüfen, ob Benutzer oder Rollen berechtigt sind, Tags zu erstellen. Daher müssen Sie explizite Berechtigungen für die Verwendung der Aktion `ecs:TagResource` gewähren. Weitere Informationen finden Sie unter [Berechtigung zum Markieren von Ressourcen bei der Erstellung gewähren](supported-iam-actions-tagging.md). Weitere Informationen zum Konfigurieren der Option finden Sie unter [Tagging-Autorisierung](ecs-account-settings.md#tag-resources-setting).
## Einschränkungen
Für Tags gelten die folgenden Einschränkungen:
+ Maximal 50 Tags können einer Ressource zugeordnet werden.
+ Tag-Schlüssel können nicht für eine Ressource wiederholt werden. Jeder Tag-Schlüssel muss eindeutig sein, und jeder Schlüssel darf nur einen Wert besitzen.
+ Schlüssel können aus bis zu 128 Zeichen im UTF-8-Format bestehen.
+ Werte können aus bis zu 256 Zeichen im UTF-8-Format bestehen.
+ Wenn mehrere AWS-Services Ressourcen Ihr Tagging-Schema verwenden, schränken Sie die verwendeten Zeichentypen ein. Einige Services haben möglicherweise Einschränkungen für zulässige Zeichen. Allgemein erlaubte Zeichen sind: Buchstaben, Zahlen, Leerzeichen und die folgenden Sonderzeichen: `+` `-` `=` `.` `_` `:` `/` `@`.
+ Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.
+ Verwenden Sie weder `aws:` noch `AWS:` oder Kombinationen aus Groß- und Kleinbuchstaben von diesen als Präfix für Schlüssel oder Werte, da sie für die -Verwendung reserviert sind. Diese sind nur für die AWS Verwendung reserviert. Sie können keine Tag-Schlüssel oder -Werte mit diesem Präfix bearbeiten oder löschen. Tags mit diesem Präfix werden nicht auf dein tags-per-resource Limit angerechnet.
## Amazon ECS Managed Tags
Wenn Sie Amazon ECS Managed Tags verwenden, markiert Amazon ECS automatisch alle neu gestarteten Aufgaben sowie alle Amazon-EBS-Volumes, die der Aufgabe angehängt sind, mit den Cluster-Informationen und entweder den vom Benutzer hinzugefügten Aufgabendefinitions-Tags oder den Service-Tags. Im Folgenden werden die hinzugefügten Tags beschrieben:
+ Eigenständige Aufgaben – ein Tag mit einem *Schlüssel* als `aws:ecs:clusterName` und einem *Wert*, der dem Clusternamen zugewiesen ist. Alle Aufgabendefinitions-Tags, die von Benutzern hinzugefügt wurden. Ein Amazon-EBS-Volume, das an eine eigenständige Aufgabe angehängt ist, erhält das Tag mit einem *Schlüssel* als `aws:ecs:clusterName` und einem *Wert*, der auf den Cluster-Namen gesetzt ist. Weitere Informationen zum Markieren von Amazon-EBS-Volumes finden Sie unter [Markieren von Amazon-EBS-Volumes](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging).
+ Aufgaben, die Teil eines Services sind – ein Tag mit einem *Schlüssel* als `aws:ecs:clusterName` und einem *Wert*, der dem Clusternamen zugewiesen ist. Ein Tag mit einem *Schlüssel* als `aws:ecs:serviceName` und einem *Wert*, der auf den Servicenamen gesetzt ist. Tags aus einer der folgenden Ressourcen:
+ Aufgabendefinitionen – Alle Aufgabendefinitions-Tags, die von Benutzern hinzugefügt wurden.
+ Services – Alle Service-Tags, die von Benutzern hinzugefügt wurden.
Ein Amazon-EBS-Volume, das an eine Aufgabe angehängt ist, die Teil eines Service ist, erhält ein Tag mit einem *Schlüssel* als `aws:ecs:clusterName` und einem *Wert*, der auf den Cluster-Namen festgelegt ist, sowie ein Tag mit einem *Schlüssel* als `aws:ecs:serviceName` und einem *Wert*, der auf den Service-Namen gesetzt ist. Weitere Informationen zum Markieren von Amazon-EBS-Volumes finden Sie unter [Markieren von Amazon-EBS-Volumes](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging).
Die folgenden Optionen sind für dieses Feature erforderlich:
+ Sie müssen sich für die neuen Formate Amazon Ressourcenname (ARN) und Ressourcen-Identifier (ID) anmelden (Opt-in). Weitere Informationen finden Sie unter [Amazon-Ressourcennamen (ARNs) und IDs](ecs-account-settings.md#ecs-resource-ids).
+ Wenn Sie den verwenden APIs , um einen Dienst zu erstellen oder eine Aufgabe auszuführen, müssen Sie `true` für `run-task` und festlegen `enableECSManagedTags``create-service`. Weitere Informationen finden Sie unter [create-service](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) und [run-task](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) unter *AWS Command Line Interface -API-Referenz*.
+ Amazon ECS verwendet verwaltete Tags, um zu bestimmen, wann einige Features aktiviert sind, z. B. Cluster-Auto-Scaling. Wir empfehlen, Tags nicht manuell zu ändern, damit Amazon ECS die Features effektiv verwalten kann.
## Verwenden von Tags für die Fakturierung
AWS bietet ein Berichtstool namens Cost Explorer, mit dem Sie die Kosten und die Nutzung Ihrer Amazon ECS-Ressourcen analysieren können.
Verwenden Sie Cost Explorer, um Diagramme Ihrer Nutzung und Kosten anzuzeigen. Sie können die Daten der letzten 13 Monate anzeigen und prognostizieren, wie viel Sie wahrscheinlich für die nächsten drei Monate ausgeben werden. Sie können den Cost Explorer verwenden, um Muster zu sehen, wie viel Sie für AWS -Ressourcen im Zeitablauf ausgeben. Sie können es zum Beispiel verwenden, um Bereiche zu identifizieren, die eine genauere Untersuchung erfordern, sowie um Trends auszumachen, die Ihnen helfen, Ihre Kosten zu verstehen. Sie können auch Zeitbereiche für die Daten angeben und die Daten nach Tagen oder Monate anzeigen lassen.
Sie können von Amazon ECS Managed Tags oder von Benutzern hinzugefügte Tags für Ihren Kosten- und Nutzungsbericht verwenden. Weitere Informationen finden Sie unter [Amazon-ECS-Nutzungsberichte](usage-reports.md).
Um die Kosten kombinierter Ressourcen anzuzeigen, können Sie Ihre Fakturierungsinformationen nach Ressourcen mit gleichen Tag (Markierung)-Schlüsselwerten strukturieren. Beispielsweise können Sie mehrere Ressourcen mit einem bestimmten Anwendungsnamen markieren und dann Ihre Fakturierungsinformationen so organisieren, dass Sie die Gesamtkosten dieser Anwendung über mehrere Services hinweg sehen können. Weitere Informationen zum Einrichten eines Kostenzuordnungsberichts mit Markierungen finden Sie unter [Monatlicher Kostenzuordnungsbericht](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) im *Benutzerhandbuch für AWS Billing *.
Außerdem können Sie die Option *Split Cost Allocation Data* aktivieren, um in Ihren Kosten- und Nutzungsberichten Daten zur CPU- und Speichernutzung auf Aufgabenebene zu erhalten. Weitere Informationen finden Sie unter [Kosten- und Nutzungsberichte auf Aufgabenebene](usage-reports.md#task-cur).
**Anmerkung**
Wenn Sie die Berichterstellung aktiviert haben, kann es bis zu 24 Stunden dauern, bis die Daten für den aktuellen Monat zur Ansicht verfügbar sind.
# Hinzufügen von Tags zu Amazon-ECS-Ressourcen
Sie können neue oder bestehende Aufgaben, Services, Aufgabendefinitionen und Cluster markieren. Informationen zum Taggen Ihrer Container-Instances finden Sie unter[Hinzufügen von Tags zu einer Amazon-EC2-Container-Instance für Amazon ECS](instance-details-tags.md).
**Warnung**
Fügen Sie keine personenbezogenen Daten (Personally Identifiable Information, PII) oder andere vertrauliche Informationen in Tags hinzu. Tags sind für viele AWS Dienste zugänglich, auch für die Abrechnung. Tags sind nicht für private oder sensible Daten gedacht.
Sie können die folgenden Ressourcen verwenden, um Tags anzugeben, wenn Sie die Ressource erstellen.
| Aufgabe | Konsole | AWS CLI | API-Aktion |
| --- | --- | --- | --- |
| Führen Sie eine oder mehrere Aufgaben aus. | [Ausführen einer Anwendung als Amazon-ECS-Aufgabe](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) |
| Erstellen Sie einen Service. | [Erstellung einer Amazon-ECS-Bereitstellung mit fortlaufender Aktualisierung](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) |
| Einen Aufgabensatz erstellen. | [Amazon-ECS-Services mithilfe eines Drittanbieter-Controllers bereitstellen](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) |
| Eine Aufgabendefinition registrieren. | [Erstellen einer Amazon-ECS-Aufgabendefinition mit der Konsole](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) |
| Erstellen Sie einen Cluster. | [Erstellen eines Amazon-ECS-Clusters für Fargate-Workloads](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) |
| Eine oder mehrere Container-Instances ausführen. | [Starten einer Amazon ECS Linux-Container-Instance](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) |
| Erstellen Sie einen Kapazitätsanbieter für Amazon ECS Managed Instances. | [Erstellen eines Kapazitätsanbieters für Amazon ECS Managed Instances](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) |
## Hinzufügen von Tags zu vorhandenen Ressourcen (Amazon-ECS-Konsole)
Sie können Sie Tags, die Ihren Clustern, Services, Aufgaben und Aufgabendefinitionen zugeordnet sind, direkt von der Seite der Ressource aus hinzufügen oder löschen.
**So ändern Sie ein Tag für eine einzelne Ressource**
1. Öffnen Sie die Konsole auf [https://console.aws.amazon.com/ecs/Version](https://console.aws.amazon.com/ecs/v2) 2.
1. Wählen Sie in der Navigationsleiste die aus, die Sie verwenden AWS-Region möchten.
1. Wählen Sie im Navigationsbereich einen Ressourcentyp aus (z. B. **Clusters (Cluster)**).
1. Wählen Sie die Ressource aus der Ressourcenliste aus, wählen Sie die Registerkarte **Tags** und dann **Manage tags** (Tags verwalten) aus.
1. Konfigurieren Sie Ihre Tags.
[Ein Tag hinzufügen] Wählen Sie **Add tag** (Tag hinzufügen) und führen Sie dann das Folgende aus:
+ Geben Sie bei **Key (Schlüssel)** den Schlüsselnamen ein.
+ Geben Sie bei **Value (Wert)** den Wert des Schlüssels ein.
1. Wählen Sie **Speichern**.
## Hinzufügen von Tags zu vorhandenen Ressourcen (AWS CLI)
Sie können ein oder mehrere Tags hinzufügen oder überschreiben, indem Sie die AWS CLI oder eine API verwenden.
**Anmerkung**
Sie können Dual-Stack-Service-Endpunkte verwenden, um mit Amazon ECS über die AWS CLI SDKs, und die Amazon ECS-API sowohl über als auch IPv4 zu interagieren. IPv6 Weitere Informationen finden Sie unter [Verwenden von Dual-Stack-Endpunkten in Amazon ECS](dual-stack-endpoint.md).
+ AWS CLI [- Tag-Ressource](https://docs.aws.amazon.com/cli/latest/reference/ecs/tag-resource.html)
+ API-Aktion - [TagResource](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html)
# Tags für Amazon ECS Managed Instances
Amazon ECS Managed Instances unterstützen eine Kombination aus benutzerdefinierten und hinzugefügten Tags AWS , die zur Kostenoptimierung verwendet werden können. Weitere Informationen zur Verwendung von Tags zur Fakturierung finden Sie unter [Verwenden von Tags für die Fakturierung](ecs-using-tags.md#tag-resources-for-billing).
## Von hinzugefügte Tags AWS
AWS fügt jeder vom Kapazitätsanbieter erstellten Amazon ECS Managed Instance die folgenden Tags hinzu:
+ Amazon ECS fügt automatisch die reservierten Tags `AmazonECSCreated` und `AmazonECSManaged` zu Amazon ECS Managed Instances hinzu.
+ Amazon ECS fügt jeder Instance die folgenden System-Tags hinzu:
+ Ein Tag mit einem *Schlüssel* als `aws:ecs:clusterName` und einem *Wert*, der auf den Cluster-Namen gesetzt ist.
+ Ein Tag mit einem *Schlüssel* als `aws:ecs:capacityProviderName` und einem *Wert*, der auf den Namen des Kapazitätsanbieters gesetzt ist.
+ Ein Tag mit einem *Schlüssel* als `aws:ecs:containerInstanceId` und einem *Wert* als Container-Instance-ID für die von Amazon ECS Managed Instance.
+ Amazon EC2 fügt das System-Tag `aws:ec2:managed-launch` mit dem Wert `ecs-managed-instances` hinzu. Darüber hinaus fügt Amazon EC2 System-Tags hinzu, die die Startvorlage angeben, die zur Erstellung der verwalteten Instance verwendet wurde, und die Amazon-EC2-Flotte, zu der die verwaltete Instance gehört.
## Benutzerdefinierte Tags
Sie können zusätzliche benutzerdefinierte Tags zu Amazon ECS Managed Instances hinzufügen, indem Sie Tags zum Kapazitätsanbieter hinzufügen und die Tag-Weitergabe mithilfe der `propagateTags`-Eigenschaft aktivieren. Tags auf dem Kapazitätsanbieter werden an die verwalteten Instances weitergegeben, die der Kapazitätsanbieter startet
Die folgende Beispieldefinition eines Kapazitätsanbieters zeigt, wie Tags beim Erstellen des Kapazitätsanbieters mit dem `CAPACITY_PROVIDER`-Wert für `propagateTags` angegeben und vom Kapazitätsanbieter weitergegeben werden können.
```
{
"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"
]
}
}
}
}
```
**Anmerkung**
Wenn Sie einem Kapazitätsanbieter neue Tags hinzufügen, werden die neu hinzugefügten Tags nicht an bestehende Instances weitergegeben, sondern an alle neu erstellten Instances weitergegeben.
Kunden dürfen Tags direkt zu den EC2-Instances hinzufügen, aber diese Tags werden nicht zurück an den Kapazitätsanbieter weitergegeben
Sie können den Kapazitätsanbieter auch mit oder kennzeichnen oder die Markierung aufheben [Hinzufügen von Tags zu vorhandenen Ressourcen (AWS CLI)](tag-resources-console.md#tag-resources-api-sdk) [Hinzufügen von Tags zu vorhandenen Ressourcen (Amazon-ECS-Konsole)](tag-resources-console.md#adding-or-deleting-tags)
Weitere Informationen über Kapazitätsanbieter von Amazon ECS Managed Instances finden Sie unter [Kapazitätsanbieter von Amazon ECS Managed Instances](managed-instances-capacity-providers-concept.md).
# Hinzufügen von Tags zu einer Amazon-EC2-Container-Instance für Amazon ECS
Sie können Ihren Amazon-EC2-Container-Instances für Amazon ECS mit einer der folgenden Methoden Tags zuordnen:
+ Methode 1: Beim Erstellen der Container-Instance geben Sie mit der Amazon EC2-API, -CLI oder -Konsole die Tags an, indem Sie Benutzerdaten mit dem Konfigurationsparameter `ECS_CONTAINER_INSTANCE_TAGS` an die Instance übergeben. Dadurch werden Tags erstellt, die nur der Container-Instance in Amazon ECS zugeordnet sind. Sie können nicht mithilfe der Amazon EC2-API angeboten werden. Weitere Informationen finden Sie unter [Bootstrapping von Amazon-ECS-Linux-Container-Instances zur Weitergabe von Daten](bootstrap_container_instance.md).
**Wichtig**
Wenn Sie Ihre Container-Instances mit einer Amazon EC2 Auto Scaling-Gruppe starten, sollten Sie den Agent-Konfigurationsparameter ECS\$1CONTAINER\$1INSTANCE\$1TAGS verwenden, um Tags hinzuzufügen. Dies liegt an der Art und Weise, in der Amazon-EC2-Instances Tags hinzugefügt werden, die mit Auto-Scaling-Gruppen gestartet werden.
Nachfolgend ist ein Beispiel für ein Benutzerdatenskript angeführt, das Tags mit Ihrer Container-Instance verknüpft:
```
#!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
EOF
```
+ Methode 2: Beim Erstellen Ihrer Container-Instance geben Sie mit der Amazon-EC2-API, -CLI oder -Konsole die Tags zunächst mit dem Parameter `TagSpecification.N` an. Übergeben Sie dann Benutzerdaten mithilfe des Container-Agent-Konfigurationsparameters `ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM` an die Instance. Dadurch werden sie von Amazon EC2 an Amazon ECS weitergegeben.
Nachfolgend finden Sie ein Beispiel für ein Benutzerdaten-Skript, das die mit einer Amazon-EC2-Instance verknüpften Tags propagiert und die Instance mit einem Cluster namens `MyCluster` registriert:
```
#!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance
EOF
```
Um den Zugriff zu gewähren, damit Container-Instance-Tags von Amazon EC2 zu Amazon ECS propagieren werden können, fügen Sie manuell der IAM-Rolle der Amazon-ECS-Container-Instance die folgenden Berechtigungen als Inline-Richtlinie hinzu. Weitere Informationen finden Sie unter [Hinzufügen und Entfernen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html).
+ `ec2:DescribeTags`
Das folgende ist ein Beispiel einer Richtlinie mit der diese Berechtigungen hinzugefügt werden.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ec2:DescribeTags"
],
"Resource": "*"
}
]
}
```
------
# Hinzufügen von Tags zu externen Container-Instances für Amazon ECS
Sie können Ihren externen Container-Instances für Amazon ECS mit einer der folgenden Methoden Tags zuweisen:
+ Methode 1: Bevor Sie das Installationsskript ausführen, um Ihre externe Instance bei Ihrem Cluster zu registrieren, erstellen oder bearbeiten Sie die Konfigurationsdatei für den Amazon-ECS-Container Agent unter `/etc/ecs/ecs.config` und fügen Sie den `ECS_CONTAINER_INSTANCE_TAGS`-Konfigurationsparameter hinzu. Dadurch werden Tags erstellt, die der externen Instance zugeordnet sind.
Es folgt ein Beispiel für die Syntax.
```
ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
```
+ Methode 2 — Nachdem Ihre externe Instance in Ihrem Cluster registriert wurde, können Sie die verwenden, AWS-Managementkonsole um Tags hinzuzufügen. Weitere Informationen finden Sie unter [Hinzufügen von Tags zu vorhandenen Ressourcen (Amazon-ECS-Konsole)](tag-resources-console.md#adding-or-deleting-tags).
# Amazon-ECS-Nutzungsberichte
AWS bietet ein Berichtstool namens Cost Explorer, mit dem Sie die Kosten und die Nutzung Ihrer Amazon ECS-Ressourcen analysieren können.
Verwenden Sie Cost Explorer, um Diagramme Ihrer Nutzung und Kosten anzuzeigen. Sie können die Daten der letzten 13 Monate anzeigen und prognostizieren, wie viel Sie wahrscheinlich für die nächsten drei Monate ausgeben werden. Sie können den Cost Explorer verwenden, um Muster zu sehen, wie viel Sie für AWS -Ressourcen im Zeitablauf ausgeben. Sie können es zum Beispiel verwenden, um Bereiche zu identifizieren, die eine genauere Untersuchung erfordern, sowie um Trends auszumachen, die Ihnen helfen, Ihre Kosten zu verstehen. Sie können auch Zeitbereiche für die Daten angeben und die Daten nach Tagen oder Monate anzeigen lassen.
Die Messdaten in Ihrem Kosten- und Nutzungsbericht zeigen die Nutzung für alle Ihre Amazon-ECS-Aufgaben an. Die Messdaten umfassen die CPU-Auslastung als `vCPU-Hours` und die Speicherauslastung als `GB-Hours` für jede ausgeführte Aufgabe. Wie die Daten vorgelegt werden, hängt von der Rechenoption der Aufgabe ab.
Bei Aufgaben, die Fargate verwenden, zeigt die `lineItem/Operation`-Spalte `FargateTask` an und Sie sehen die mit jeder Aufgabe verbundenen Kosten.
Bei Aufgaben, die EC2 verwenden, zeigt die `lineItem/Operation`-Spalte `ECSTask-EC2` an und die Aufgaben sind keinen direkten Kosten zugeordnet. Die im Bericht angezeigten Messdaten, z. B. die Speichernutzung, stellen die Gesamtressourcen dar, die die Aufgabe in dem von Ihnen angegebenen Abrechnungszeitraum reserviert hat. Sie können diese Daten verwenden, um die Kosten Ihres zugrunde liegenden Clusters von Amazon-EC2-Instances zu ermitteln. Die Kosten- und Nutzungsdaten für Ihre Amazon-EC2-Instances werden separat unter dem Amazon-EC2-Service aufgeführt.
Sie können auch die von Amazon ECS Managed Tags verwenden, um den Service oder Cluster zu identifizieren, zu dem die einzelnen Aufgaben gehören. Weitere Informationen finden Sie unter [Verwenden von Tags für die Fakturierung](ecs-using-tags.md#tag-resources-for-billing).
**Wichtig**
Die Messdaten sind nur für Aufgaben sichtbar, die am oder nach dem 16. November 2018 gestartet wurden. Aufgaben, die vor diesem Datum gestartet wurden, zeigen keine Messdaten an.
Nachfolgend finden Sie ein Beispiel, wie Sie die Daten in einigen Feldern für die Kostenzuordnung mit Cost Explorer sortieren können:
+ Clustername
+ Service-Name
+ Ressourcen-Tags
+ Starttyp
+ AWS-Region
+ Verwendungstyp
Weitere Informationen zur Erstellung eines AWS Kosten- und Nutzungsberichts finden Sie unter [AWS Kosten- und Nutzungsbericht](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-reports-costusage.html) im *AWS Billing Benutzerhandbuch*.
## Kosten- und Nutzungsberichte auf Aufgabenebene
AWS Cost Management kann CPU- und Speichernutzungsdaten AWS Cost and Usage Report für jede Aufgabe auf Amazon ECS bereitstellen, einschließlich Aufgaben auf Fargate und Aufgaben auf EC2. Diese Daten werden als *Split Cost Allocation Data* bezeichnet. Sie können diese Daten verwenden, um Kosten und Nutzung für Anwendungen zu analysieren. Außerdem können Sie die Kosten mit Hilfe von Kostenzuordnungs-Tags und Kostenkategorien auf einzelne Geschäftseinheiten und Teams aufteilen und zuordnen. Weitere Informationen zu *geteilten Kostenzuordnungsdaten* finden Sie unter [Grundlegendes zu geteilten Kostenzuordnungsdaten](https://docs.aws.amazon.com/cur/latest/userguide/split-cost-allocation-data.html) im AWS Cost and Usage Report Benutzerhandbuch.
Sie können sich für *Split Cost Allocation Data* auf Aufgabenebene für das Konto in AWS Cost Management Console entscheiden. Wenn Sie über ein Verwaltungskonto (Zahler) verfügen, können Sie sich vom Zahlerkonto aus dafür entscheiden, diese Konfiguration auf jedes verknüpfte Konto anzuwenden.
Nachdem Sie die *Daten zur geteilten Kostenzuweisung* eingerichtet haben, werden unter der **splitLineItem**Überschrift des Berichts weitere Spalten angezeigt. Weitere Informationen finden Sie im AWS Cost and Usage Report Benutzerhandbuch unter [Details zu Einzelposten aufteilen](https://docs.aws.amazon.com/cur/latest/userguide/split-line-item-columns.html)
Bei Aufgaben auf EC2 teilen diese Daten die Kosten der EC2-Instance auf der Grundlage der Ressourcennutzung oder -Reservierungen und der verbleibenden Ressourcen auf der Instance auf.
Nachfolgend sind Voraussetzungen aufgeführt:
+ Stellen Sie den Konfigurationsparameter `ECS_DISABLE_METRICS` des Amazon-ECS-Agenten auf `false` ein.
Wenn diese Einstellung aktiviert ist`false`, sendet der Amazon ECS-Agent Metriken an Amazon CloudWatch. Unter Linux ist diese Einstellung `false` standardmäßig und Metriken werden an gesendet CloudWatch. Unter Windows ist diese Einstellung `true` standardmäßig, Sie müssen also die Einstellung ändern, `false` um die Metriken CloudWatch zur Verwendung an AWS Cost Management zu senden. Weitere Informationen zur ECS-Agentenkonfiguration finden Sie unter [Konfiguration des Amazon-ECS-Container-Agenten](ecs-agent-config.md).
+ Die Mindestversion von Docker für zuverlässige Metriken ist die Docker-Version v20.10.13 und neuer, die im Amazon-ECS-optimierten AMI 20220607 und neuer enthalten ist.
Um *Split Cost Allocation Data* verwenden zu können, müssen Sie einen Bericht erstellen und die Option **Split Cost Allocation Data** auswählen. Weitere Informationen finden Sie im Benutzerhandbuch unter [Erstellen von Kosten- und Nutzungsberichten](https://docs.aws.amazon.com/cur/latest/userguide/cur-create.html). AWS Cost and Usage Report
AWS Cost Management berechnet die *Daten zur geteilten Kostenzuweisung* anhand der CPU- und Speicherauslastung der Aufgabe. AWS Cost Management kann anstelle der Nutzung die CPU- und Speicherreservierung für die Aufgabe verwenden, wenn die Nutzung nicht verfügbar ist. Wenn Sie sehen, dass die CUR die Reservierungen verwendet, überprüfen Sie, ob Ihre Container-Instances die Voraussetzungen erfüllen und dass die Messwerte zur Nutzung der Task-Ressourcen unter angezeigt werden. CloudWatch