

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.

# Verschlagworten Sie Ihre Ressourcen AWS Cloud Map
<a name="using-tags"></a>

Ein Tag ist eine Bezeichnung, die Sie einer AWS Ressource zuweisen. Jeder Tag (Markierung) besteht aus einem *Schlüssel* und einem optionalen *Wert*, beides können Sie bestimmen.

Mithilfe von Tags können Sie Ihre AWS Ressourcen beispielsweise nach Zweck, Eigentümer oder Umgebung kategorisieren. Wenn Sie viele Ressourcen desselben Typs haben, können Sie bestimmte Ressourcen basierend auf den zugewiesenen Tags schnell bestimmen. Sie können beispielsweise eine Reihe von Tags für Ihre AWS Cloud Map Services definieren, um Ihnen zu helfen, den Besitzer und die Stack-Ebene der einzelnen Services nachzuverfolgen. Sie sollten für jeden Ressourcentyp einen konsistenten Satz von Tag-Schlüsseln entwickeln.

Tags werden nicht automatisch Ihren Ressourcen zugewiesen. Nachdem Sie ein Tag hinzugefügt haben, können Sie jederzeit Tag-Schlüssel und -Werte bearbeiten oder Tags aus einer Ressource entfernen. Wenn Sie eine Ressource löschen, werden alle Tags (Markierungen) der Ressource ebenfalls gelöscht.

Tags haben keine semantische Bedeutung AWS Cloud Map und werden ausschließlich als Zeichenfolge interpretiert. 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.

Sie können mit Tags arbeiten, indem Sie die AWS-Managementkonsole AWS CLI, und die AWS Cloud Map API verwenden.

Wenn Sie AWS Identity and Access Management (IAM) verwenden, können Sie steuern, welche Benutzer in Ihrem AWS Konto berechtigt sind, Tags zu erstellen, zu bearbeiten oder zu löschen.

## So werden Ressourcen markiert
<a name="tag-resources"></a>

Sie können neue oder bestehende AWS Cloud Map Namespaces und Dienste taggen.

Wenn Sie die AWS Cloud Map Konsole verwenden, können Sie Tags auf neue Ressourcen anwenden, wenn diese erstellt werden, oder jederzeit auf bestehende Ressourcen, indem Sie die Registerkarte „**Tags**“ auf der entsprechenden Ressourcenseite verwenden.

Wenn Sie die AWS Cloud Map API, das AWS CLI oder ein AWS SDK verwenden, können Sie mithilfe des `tags` Parameters der entsprechenden API-Aktion Tags auf neue Ressourcen oder mithilfe der [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html)API-Aktion auf vorhandene Ressourcen anwenden. Weitere Informationen finden Sie unter [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html).

Bei einigen Aktionen zur Ressourcenerstellung können Sie Tags für eine Ressource angeben, wenn die Ressource erstellt wird. Wenn Tags während der Ressourcenerstellung nicht angewendet werden können, schlägt die Ressourcenerstellung fehl. Auf diese Weise wird sichergestellt, dass Ressourcen, die Sie bei der Erstellung markieren möchten, entweder mit angegebenen Tags oder gar nicht erstellt werden. Wenn Sie Ressourcen zum Zeitpunkt der Erstellung markieren, müssen Sie nach der Ressourcenerstellung keine benutzerdefinierten Tagging-Skripts ausführen.

In der folgenden Tabelle werden die AWS Cloud Map Ressourcen beschrieben, die markiert werden können, und die Ressourcen, die bei der Erstellung markiert werden können.


**Unterstützung für AWS Cloud Map das Markieren von Ressourcen**  

| Ressource | Unterstützt Tags (Markierungen) | Unterstützt Tag-Propagierung | Unterstützt das Taggen bei der Erstellung (AWS Cloud Map API AWS CLI, AWS SDK) | 
| --- | --- | --- | --- | 
|  AWS Cloud Map Namespaces  |  Ja  | Nein. Namespace-Tags werden nicht auf andere Ressourcen übertragen, die dem Namespace zugeordnet sind. |  Ja  | 
|  AWS Cloud Map Dienste  |  Ja  | Nein. Service-Tags werden nicht auf andere Ressourcen übertragen, die mit dem Service verknüpft sind. |  Ja  | 

## Einschränkungen
<a name="tag-restrictions"></a>

Die folgenden grundlegenden Einschränkungen gelten für Tags (Markierungen):
+ Maximale Anzahl von Tags für jede Ressource — 50
+ Jeder Tag (Markierung) muss für jede Ressource eindeutig sein. Jeder Tag (Markierung) kann nur einen Wert haben.
+ Maximale Schlüssellänge: 128 Unicode-Zeichen in UTF-8
+ Maximale Wertlänge: 256 Unicode-Zeichen in UTF-8
+ Wenn Ihr Tagging-Schema für mehrere AWS Dienste und Ressourcen verwendet wird, denken Sie daran, dass für andere Dienste möglicherweise Einschränkungen hinsichtlich der zulässigen Zeichen gelten. Allgemein erlaubte Zeichen sind Buchstaben, Zahlen, Leerzeichen, die in UTF-8 darstellbar sind, sowie die folgenden Zeichen: \$1 - = . \$1 : / @.
+ Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.
+ Verwenden `aws:` Sie weder für Schlüssel noch für Werte eine Kombination aus Groß- oder Kleinbuchstaben, z. B. ein Präfix, da es für AWS die Verwendung reserviert ist. `AWS:` 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 Ihr tags-per-resource Limit angerechnet.

# Tags für AWS Cloud Map Ressourcen werden aktualisiert
<a name="tag-resources-api-sdk"></a>

Verwenden Sie die folgenden AWS CLI Befehle oder AWS Cloud Map API-Operationen, um die Tags für Ihre Ressourcen hinzuzufügen, zu aktualisieren, aufzulisten und zu löschen.


**Tagging-Unterstützung für Ressourcen AWS Cloud Map**  

| Aufgabe | API-Aktion | AWS CLI | AWS Tools for Windows PowerShell | 
| --- | --- | --- | --- | 
|  Fügen Sie einen oder mehrere Tags hinzu oder überschreiben Sie sie.  |  [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)  |  [Hinzufügen — Tag SDResource](https://docs.aws.amazon.com/powershell/v4/reference/items/Add-SDResourceTag.html)  | 
|  Löschen Sie ein oder mehrere Tags.  |  [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)  |  [Entfernen — SDResource Tag](https://docs.aws.amazon.com/powershell/v4/reference/items/Remove-SDResourceTag.html)  | 
| Listet Tags für eine Ressource auf |  [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)  |  [Abrufen — SDResource Tag](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-SDResourceTag.html)  | 

Die folgenden Beispiele zeigen, wie man Tags an Ressourcen mithilfe der AWS CLI hinzufügt oder entfernt.

**Beispiel 1: Markieren einer vorhandenen Ressource**  
Der folgende Befehl markiert eine vorhandene Ressource.

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

**Beispiel 2: Entfernen der Markierung einer vorhandenen Ressource**  
Der folgende Befehl löscht ein Tag aus einer vorhandenen Ressource.

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

**Beispiel 3: Tags für eine Ressource auflisten**  
Der folgende Befehl listet die Tags auf, die einer vorhandenen Ressource zugeordnet sind.

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

Mit einigen Aktionen zur Ressourcenerstellung können Sie Tags beim Erstellen der Ressource angeben. Die folgenden Aktionen unterstützen das Markieren bei der Erstellung.


| Aufgabe | API-Aktion | AWS CLI | AWS Tools for Windows PowerShell | 
| --- | --- | --- | --- | 
| Erstellen eines HTTP-Namespace | [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) | [Neu — SDHttp Namespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDHttpNamespace.html) | 
| Erstellen eines privaten Namespace auf DNS-Basis | [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) | [Neu- SDPrivate DnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPrivateDnsNamespace.html) | 
| Erstellen eines öffentlichen Namespace auf DNS-Basis | [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) | [Neu- SDPublic DnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPublicDnsNamespace.html) | 
| Einen Service erstellen | [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) | [Neu- SDService](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDService.html) | 