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-Cognito-Ressourcen
Ein *Tag* ist ein Metadaten-Label, das Sie einer AWS Ressource AWS zuweisen oder zuweisen. Jedes Tag besteht aus einem *Schlüssel* und einem *Wert*. Für Tags, die Sie zuweisen, definieren Sie einen Schlüssel und einen Wert. So können Sie beispielsweise den Schlüssel als `stage` und den Wert für eine Ressource als `test` definieren.
Tags sind für folgende Aktivitäten nützlich:
+ Identifizieren und organisieren Sie Ihre AWS Ressourcen. Viele AWS Dienste unterstützen Tagging, sodass Sie Ressourcen aus verschiedenen Diensten dasselbe Tag zuweisen können. Dies hilft Ihnen, anzugeben, welche Ressourcen dazugehören. Sie können beispielsweise dasselbe Tag einem Amazon–Cognito-Benutzerpool und einer Amazon-DynamoDB-Tabelle zuweisen.
+ Verfolgen Sie Ihre AWS Kosten. Sie können diese Tags im AWS Fakturierung und Kostenmanagement Dashboard aktivieren. AWS verwendet Tags zur Kostenzuweisung, um Ihre Kosten zu kategorisieren und Ihnen einen monatlichen Kostenverteilungsbericht zu liefern. Weitere Informationen finden Sie unter [Use cost allocation tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) (Verwendung von Kostenzuordnungs-Tags) im *AWS Billing -Benutzerhandbuch*.
+ Steuern des Zugriffs auf Ihre Ressourcen basierend auf den ihnen zugeordneten Tags. Sie können den Zugriff steuern, indem Sie in den Bedingungen für eine AWS Identity and Access Management -IAM-Richtlinie Tag-Schlüssel und -Werte angeben. So könnten Sie beispielsweise einem Benutzer die Aktualisierung eines Benutzerpools nur gestatten, wenn der Benutzerpool ein `owner`-Tag enthält, dessen Wert dem Namen des Benutzers entspricht. Weitere Informationen finden Sie unter [Controlling access using tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) (Zugriffssteuerung mit Tags) im *IAM-Benutzerhandbuch*.
Sie können die AWS Command Line Interface oder die Amazon Cognito Cognito-API verwenden, um Tags für Benutzer- und Identitätspools hinzuzufügen, zu bearbeiten oder zu löschen. Für Benutzerpools können Sie die Tags zudem mit der Amazon-Cognito-Konsole verwalten.
Tipps zur Verwendung von Tags finden Sie unter [AWS Markierungsstrategien](https://aws.amazon.com/answers/account-management/aws-tagging-strategies/) im *AWS -Antworten-Blog*.
In den folgenden Abschnitten erhalten Sie weitere Informationen zu Tags für Amazon Cognito.
## Unterstützte Ressourcen in Amazon Cognito
Die folgenden Ressourcen in Amazon Cognito unterstützen die Markierung.
+ Benutzerpools
+ Identitäten-Pools
## Tag (Markierung)-Einschränkungen
Für Tags in Amazon-Cognito-Ressourcen gelten die folgenden Einschränkungen:
+ Die maximale Anzahl der Tags, die Sie einer Ressource zuweisen können – 50.
+ Maximale Schlüssellänge – 128 Unicode-Zeichen.
+ Maximale Wertlänge – 256 Unicode-Zeichen.
+ Gültige Zeichen für Schlüssel und Wert – a-z, A-Z, 0-9, Leerzeichen und die folgenden Zeichen: \$1 . : / = \$1 - @
+ Schlüssel und Werte unterscheiden zwischen Groß- und Kleinschreibung.
+ Verwenden Sie nicht `aws:` als Präfix für Schlüssel. Dieses Präfix ist für AWS reserviert.
## Verwalten von Tags über die Amazon-Cognito-Konsole
Mit der Amazon-Cognito-Konsole können Sie Tags verwalten, die Ihren eigenen Benutzerpools zugewiesen sind.
**So fügen Sie einem Benutzerpool Tags hinzu**
1. Navigieren Sie zur [Amazon-Cognito-Konsole](https://console.aws.amazon.com/cognito/home). Wenn Sie dazu aufgefordert werden, geben Sie Ihre AWS Anmeldeinformationen ein.
1. Wählen Sie **User Pools** (Benutzerpools) aus.
1. Wählen Sie einen vorhandenen Benutzerpool aus der Liste aus oder [erstellen Sie einen neuen Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pool-as-user-directory.html).
1. Wählen Sie das Menü **Einstellungen** und suchen Sie den Tab **Tags**.
1. Wählen Sie **Add tags** (Tags hinzufügen) aus und fügen Sie Ihr erstes Tag hinzu. Wenn Sie diesem Benutzerpool zuvor bereits Tags zugewiesen haben, wählen Sie unter **Manage tags** (Tags verwalten) **Add another** (Ein weiteres hinzufügen) aus.
1. Machen Sie Angaben unter **Tag Key (Tag-Schlüssel)** und **Tag Value (Tag-Wert)**.
1. Wählen Sie für jedes weitere Tag, das Sie hinzufügen möchten, **Add another** (Ein weiteres hinzufügen) aus.
1. Wenn Sie fertig mit dem Hinzufügen der Tags sind, klicken Sie auf **Save changes (Änderungen speichern)**.
Um einen Identitätspool zu taggen, navigieren Sie zum Menü **Identitätspools** und wählen Sie einen Identitätspool aus oder erstellen Sie einen. Suchen Sie auf der Registerkarte **Eigenschaften des Identitätspools** nach **Tags**. Wählen Sie **Add tag**.
## AWS CLI Beispiele
Das AWS CLI bietet Befehle, mit denen Sie die Tags verwalten können, die Sie Ihren Amazon Cognito Cognito-Benutzerpools und Identitätspools zuweisen.
### Zuweisen von Tags
Mit den folgenden Befehlen können Sie Ihren vorhandenen Benutzer- und Identitäten-Pools Tags zuweisen.
**Example `tag-resource`-Befehl für Benutzerpools**
Verwenden Sie [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/tag-resource.html) in folgenden `cognito-idp`-Befehlen, um einem Benutzerpool Tags zuzuweisen:
```
$ aws cognito-idp tag-resource \
> --resource-arn user-pool-arn \
> --tags Stage=Test
```
Dieser Befehl enthält die folgenden Parameter:
+ `resource-arn` – Der Amazon-Ressourcenname (ARN) des Benutzerpools, den Sie mit Tags versehen. Wählen Sie für die Suche des ARN den Benutzerpool in der Amazon-Cognito-Konsole aus; der Wert des **Pool-ARN** wird dann auf der Registerkarte **Allgemeine Einstellungen** angezeigt.
+ `tags` – Die Schlüssel-Wert-Paare der Tags im Format `key=value`.
Wenn Sie mehrere Tags auf einmal zuweisen möchten, geben Sie sie in eine durch Kommata getrennte Liste ein:
```
$ aws cognito-idp tag-resource \
> --resource-arn user-pool-arn \
> --tags Stage=Test,CostCenter=80432,Owner=SysEng
```
**Example `tag-resource`-Befehl für Identitäten-Pools**
Verwenden Sie [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/tag-resource.html) in folgenden `cognito-identity`-Befehlen, um einem Identitäten-Pool Tags zuzuweisen:
```
$ aws cognito-identity tag-resource \
> --resource-arn identity-pool-arn \
> --tags Stage=Test
```
Dieser Befehl enthält die folgenden Parameter:
+ `resource-arn` – Der Amazon-Ressourcenname (ARN) des Identitäten-Pools, den Sie mit Tags versehen. Wählen Sie für die Suche des ARN den Identitäten-Pool in der Amazon-Cognito-Konsole aus, und klicken Sie auf **Identitäten-Pool bearbeiten**. Klicken Sie dann unter **Identity pool ID (Identitäten-Pool-ID)** auf **Show ARN (ARN anzeigen)**.
+ `tags` – Die Schlüssel-Wert-Paare der Tags im Format `key=value`.
Wenn Sie mehrere Tags auf einmal zuweisen möchten, geben Sie sie in eine durch Kommata getrennte Liste ein:
```
$ aws cognito-identity tag-resource \
> --resource-arn identity-pool-arn \
> --tags Stage=Test,CostCenter=80432,Owner=SysEng
```
### Anzeigen von Tags
Mit den folgenden Befehlen können Sie die Tags anzeigen, die Sie Ihren Benutzer- und Identitäten-Pools zugewiesen haben.
**Example `list-tags-for-resource`-Befehl für Benutzerpools**
Verwenden Sie [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/list-tags-for-resource.html) in folgenden `cognito-idp`-Befehlen, um die einem Benutzerpool zugewiesenen Tags anzuzeigen:
```
$ aws cognito-idp list-tags-for-resource --resource-arn user-pool-arn
```
**Example `list-tags-for-resource`-Befehl für Identitäten-Pools**
Verwenden Sie [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/list-tags-for-resource.html) in folgenden `cognito-identity`-Befehlen, um die einem Identitäten-Pool zugewiesenen Tags anzuzeigen:
```
$ aws cognito-identity list-tags-for-resource --resource-arn identity-pool-arn
```
### Entfernen von Tags
Mit den folgenden Befehlen können Sie Tags aus Ihren Benutzer- und Identitäten-Pools entfernen.
**Example `untag-resource`-Befehl für Benutzerpools**
Verwenden Sie [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/untag-resource.html) in folgenden `cognito-idp`-Befehlen, um Tags aus einem Benutzerpool zu entfernen:
```
$ aws cognito-idp untag-resource \
> --resource-arn user-pool-arn \
> --tag-keys Stage CostCenter Owner
```
Geben Sie für den `--tag-keys`-Parameter mindestens einen Tag-Schlüssel an. Schließen Sie keine Tag-Werte ein. Separate Schlüssel mit Leerzeichen.
**Example `untag-resource`-Befehl für Identitäten-Pools**
Verwenden Sie [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/untag-resource.html) in folgenden `cognito-identity`-Befehlen, um Tags aus einem Identitäten-Pool zu entfernen:
```
$ aws cognito-identity untag-resource \
> --resource-arn identity-pool-arn \
> --tag-keys Stage CostCenter Owner
```
Geben Sie für den `--tag-keys`-Parameter mindestens einen Tag-Schlüssel an. Schließen Sie keine Tag-Werte ein.
**Wichtig**
Nachdem Sie einen Benutzer oder einen Identitäten-Pool gelöscht haben, können Tags, die sich auf den gelöschten Pool beziehen, noch bis zu 30 Tage nach dem Löschen in der Konsole oder in API-Aufrufen angezeigt werden.
### Anwenden von Tags beim Erstellen von Ressourcen
Mit den folgenden Befehlen können Sie Tags bei der Erstellung eines Benutzer- oder Identitäten-Pools zuweisen.
**Example `create-user-pool`-Befehl mit Tags**
Wenn Sie einen Benutzerpool mit dem [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/create-user-pool.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/create-user-pool.html)-Befehl erstellen, können Sie Tags mit dem `--user-pool-tags`-Parameter angeben:
```
$ aws cognito-idp create-user-pool \
> --pool-name user-pool-name \
> --user-pool-tags Stage=Test,CostCenter=80432,Owner=SysEng
```
Schlüssel-Wert-Paare für Tags müssen im Format `key=value` vorliegen. Wenn Sie mehrere Tags hinzufügen, geben Sie diese in einer durch Kommata getrennten Liste an.
**Example `create-identity-pool`-Befehl mit Tags**
Wenn Sie einen Identitäten-Pool mit dem [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/create-identity-pool.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/create-identity-pool.html)-Befehl erstellen, können Sie Tags mit dem `--identity-pool-tags`-Parameter angeben:
```
$ aws cognito-identity create-identity-pool \
> --identity-pool-name identity-pool-name \
> --allow-unauthenticated-identities \
> --identity-pool-tags Stage=Test,CostCenter=80432,Owner=SysEng
```
Schlüssel-Wert-Paare für Tags müssen im Format `key=value` vorliegen. Wenn Sie mehrere Tags hinzufügen, geben Sie diese in einer durch Kommata getrennten Liste an.
## Verwalten von Tags über die Amazon-Cognito-API
Mit den folgenden Aktionen können Sie in der Amazon-Cognito-API die Tags für Ihre Benutzer- und Identitäten-Pools verwalten.
### API-Aktionen für Tags für Benutzerpools
Mit den folgenden API-Aktionen können Sie Tags für Benutzerpools zuweisen, anzeigen und entfernen.
+ [TagResource](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_TagResource.html)
+ [ListTagsForResource](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ListTagsForResource.html)
+ [UntagResource](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UntagResource.html)
+ [CreateUserPool](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPool.html)
### API-Aktionen für Tags für Identitäten-Pools
Mit den folgenden API-Aktionen können Sie Tags für Identitäten-Pools zuweisen, anzeigen und entfernen.
+ [TagResource](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_TagResource.html)
+ [ListTagsForResource](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_ListTagsForResource.html)
+ [UntagResource](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_UntagResource.html)
+ [CreateIdentityPool](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_CreateIdentityPool.html)