**Hinweis zum Ende des Supports:** Am 30. Oktober 2026 AWS wird der Support für Amazon Pinpoint eingestellt. Nach dem 30. Oktober 2026 können Sie nicht mehr auf die Amazon-Pinpoint-Konsole oder die Amazon-Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analytik) zugreifen. Weitere Informationen finden Sie unter [Ende des Amazon-Pinpoint-Supports](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Hinweis:** APIs In Bezug auf SMS sind Sprach-, mobile Push-, OTP- und Telefonnummernvalidierung von dieser Änderung nicht betroffen und werden von AWS End User Messaging unterstützt. 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. # Amazon Pinpoint Pinpoint-Ressourcen-Tags verwalten Ein *Tag* ist eine Bezeichnung, die Sie optional definieren und mit AWS Ressourcen verknüpfen können, einschließlich bestimmter Arten von Amazon Pinpoint Pinpoint-Ressourcen. Tags können Ihnen dabei helfen, Ressourcen auf verschiedene Arten zu kategorisieren und zu verwalten (z. B. nach Zweck, Besitzer, Umgebung oder anderen Kriterien). Sie können Tags zum Beispiel verwenden, um Richtlinien oder eine Automatisierung anzuwenden oder um Ressourcen zu identifizieren, für die bestimmte Compliance-Anforderungen erfüllt werden müssen. Sie können den folgenden Amazon-Pinpoint-Ressourcentypen Tags hinzufügen: + Kampagnen + Nachrichtenvorlagen + Projekte (Anwendungen) + Segmente Eine Ressource kann bis zu 50 Tags enthalten. Jedes Tag besteht aus einem *Schlüssel* und einem optionalen *Wert*. Beides können Sie definieren. Ein *Tag-Schlüssel* ist eine allgemeine Markierung, die wie eine Kategorie für spezifischere Tag-Werte fungiert. Ein *Tag-Wert* dient als Bezeichnung für einen Tag-Schlüssel. Ein Tag-Schlüssel kann bis zu 128 Zeichen enthalten. Ein Tag-Wert kann bis zu 256 Zeichen enthalten. Die Zeichen können Unicode-Buchstaben, Zahlen, Leerzeichen oder eines der folgenden Symbole sein: \$1 . : / = \$1 -. Für Tags gelten die folgenden zusätzlichen Einschränkungen: + Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden. + Für jede zugeordnete Ressource muss jeder Tag-Schlüssel eindeutig sein und darf nur einen Wert haben. + Das `aws:` Präfix ist für die Verwendung durch reserviert AWS. Sie können es nicht in Tag-Schlüsseln oder -Werten verwenden, die Sie definieren. Sie können auch keine Tag-Schlüssel oder -Werte mit diesem Präfix bearbeiten oder entfernen. Tags mit diesem Präfix werden beim Kontingent von 50 Tags pro Ressource nicht eingerechnet. + Es ist nicht möglich, eine Ressource nur anhand ihrer Tags zu aktualisieren oder zu löschen. Darüber hinaus müssen Sie den Amazon-Ressourcennamen (ARN) oder die Ressourcen-ID angeben – je nach Operation, die Sie verwenden. + Sie können Tags öffentlichen oder freigegebenen Ressourcen zuordnen. Die Tags sind jedoch nur für Ihr AWS Konto verfügbar, nicht für andere Konten, die die Ressource gemeinsam nutzen. Darüber hinaus sind die Tags nur für Ressourcen verfügbar, die sich in der für Ihr AWS Konto angegebenen AWS Region befinden. Um Tag-Schlüssel und Werte aus Amazon Pinpoint Pinpoint-Ressourcen hinzuzufügen, anzuzeigen, zu aktualisieren und zu entfernen, können Sie die AWS Command Line Interface (AWS CLI), die Amazon Pinpoint Pinpoint-API, die AWS -Ressourcengruppen Tagging-API oder ein SDK verwenden. AWS Verwenden Sie die [AWS -Ressourcengruppen Tagging-API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html), um Tag-Schlüssel und -Werte für alle AWS Ressourcen zu verwalten, die sich in einer bestimmten AWS Region für Ihr AWS Konto befinden (einschließlich Amazon Pinpoint Pinpoint-Ressourcen). Weitere Informationen zu den CLI-Befehlen, die Sie für die Verwaltung von Amazon-Pinpoint-Ressourcen verwenden können, finden Sie im Amazon-Pinpoint-Abschnitt der [AWS CLI -Befehlsreferenz](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Weitere Informationen zu den Ressourcen in der Amazon-Pinpoint-API, einschließlich unterstützter HTTP(S)-Methoden, Parameter und Schemata, finden Sie in der [Amazon-Pinpoint-API-Referenz](https://docs.aws.amazon.com/pinpoint/latest/apireference/). # Verwenden Sie Amazon Pinpoint Pinpoint-Tags in IAM-Richtlinien und API-Vorgängen Nachdem Sie mit der Implementierung von Tags begonnen haben, können Sie tagbasierte Berechtigungen auf Ressourcenebene auf AWS Identity and Access Management (IAM-) Richtlinien und API-Operationen anwenden. Dies umfasst Vorgänge, die das Hinzufügen von Tags zu Ressourcen beim Erstellen von Ressourcen unterstützen. Durch die Verwendung von Tags auf diese Weise können Sie detailliert steuern, welche Gruppen und Benutzer in Ihrem AWS Konto berechtigt sind, Ressourcen zu erstellen und zu taggen, und welche Gruppen und Benutzer generell berechtigt sind, Tags zu erstellen, zu aktualisieren und zu entfernen. Beispielsweise können Sie eine Richtlinie erstellen, die es einem Benutzer ermöglicht, vollen Zugriff auf alle Amazon-Pinpoint-Ressourcen zu haben, deren Name ein Wert im `Owner`-Tag für die Ressource ist: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ModifyResourceIfOwner", "Effect": "Allow", "Action": "mobiletargeting:*", "Resource": "*", "Condition": { "StringEqualsIgnoreCase": { "aws:ResourceTag/Owner": "${aws:username}" } } } ] } ``` ------ Wenn Sie Tag-basierte Berechtigungen auf Ressourcenebene definieren, werden die Berechtigungen sofort wirksam. Dies bedeutet, dass Ihre Ressourcen besser geschützt sind, sobald sie erstellt wurden, und Sie schnell damit beginnen können, die Verwendung von Tags für neue Ressourcen zu erzwingen. Mithilfe von Berechtigungen auf Ressourcenebene können Sie auch steuern, welche Tag-Schlüssel und -Werte können mit neuen und vorhandenen Ressourcen verknüpft werden können. Weitere Informationen finden Sie unter [Zugriffssteuerung mit Tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) im *AWS -IAM-Benutzerhandbuch*. # Programmgesteuertes Hinzufügen von Tags zu Amazon Pinpoint Pinpoint-Ressourcen In den folgenden Beispielen wird gezeigt, wie Sie einer Amazon-Pinpoint-Ressource mithilfe der [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) und der [Amazon-Pinpoint-REST-API](https://docs.aws.amazon.com/pinpoint/latest/apireference/) ein Tag hinzufügen. Sie können auch jedes unterstützte AWS SDK verwenden, um einer Ressource ein Tag hinzuzufügen. Um mehreren Amazon Pinpoint Pinpoint-Ressourcen in einem einzigen Vorgang ein Tag hinzuzufügen, verwenden Sie die Tagging-Operationen für Ressourcengruppen der AWS CLI oder der [AWS -Ressourcengruppen Tagging-API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html). ## Fügen Sie mithilfe der API Tags hinzu Um eine neue Ressource zu erstellen und ihr mithilfe der Amazon-Pinpoint-REST-API ein Tag hinzuzufügen, senden Sie eine POST-Anforderung an den entsprechenden Ressourcen-URI. Geben Sie im Text der Anforderung den `tags`-Parameter und die Werte an. Das folgende Beispiel zeigt, wie Sie ein Tag angeben, wenn Sie ein neues Projekt erstellen. ``` POST /v1/apps HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/x-www-form-urlencoded Accept: application/json Cache-Control: no-cache { "Name":"MyProject", "tags":{ "key1":"value1" } } ``` Um einer vorhandenen Ressource ein Tag hinzuzufügen, senden Sie eine POST-Anforderung an den [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/tags-resource-arn.html)-URI. Fügen Sie den Amazon-Ressourcennamen (ARN) der Ressource in den URI ein. Der ARN sollte URL-codiert sein. Geben Sie im Anforderungstext den `tags`-Parameter und die Werte an, wie im folgenden Beispiel gezeigt. ``` POST /v1/tags/resource-arn HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache { "tags":{ "key1":"value1" } } ``` ## Fügen Sie Tags hinzu, indem Sie den AWS CLI Um eine neue Ressource zu erstellen und ihr mithilfe von ein Tag hinzuzufügen AWS CLI, verwenden Sie den entsprechenden `create` Befehl für die Ressource. Fügen Sie die `tags`-Parameter und -Werte hinzu. Das folgende Beispiel zeigt, wie Sie Tags angeben, wenn Sie ein neues Projekt erstellen. ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint create-app \ --create-application-request '{ "Name":"MyProject", "tags": { "key1":"value1", "key2":"value2" } }' ``` ------ #### [ Windows Command prompt ] ``` C:\> aws pinpoint create-app ^ --create-application-request Name=MyProject,tags={key1=value1,key2=value2} ``` ------ Gehen Sie im vorhergehenden Beispiel wie folgt vor: + *MyProject*Ersetzen Sie es durch den Namen, den Sie dem Projekt geben möchten. + Ersetzen Sie *key1* und *key2* durch die Schlüssel der Tags, die Sie der Ressource hinzufügen möchten. + Ersetzen Sie *value1* und *value2* durch die Werte der Tags, die Sie für die jeweiligen Schlüssel hinzufügen möchten. Weitere Informationen zu den Befehlen, die Sie zum Erstellen einer Amazon-Pinpoint-Ressource verwenden können, finden Sie in der [AWS CLI -Befehl-Referenz](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/). Um einer vorhandenen Ressource ein Tag hinzuzufügen, verwenden Sie den `tag-resource`-Befehl, und geben Sie die entsprechenden Werte für die erforderlichen Parameter an: ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint tag-resource \ --resource-arn resource-arn \ --tags-model '{ "tags": { "key1":"value1", "key2":"value2" } }' ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws pinpoint tag-resource ^ --resource-arn resource-arn ^ --tags-model tags={key1=value1,key2=value2} ``` ------ Gehen Sie im vorhergehenden Beispiel wie folgt vor: + *resource-arn*Ersetzen Sie es durch den Amazon-Ressourcennamen (ARN) der Ressource, der Sie ein Tag hinzufügen möchten. + Ersetzen Sie *key1* und *key2* durch die Schlüssel der Tags, die Sie der Ressource hinzufügen möchten. + Ersetzen Sie *value1* und *value2* durch die Werte der Tags, die Sie für die jeweiligen Schlüssel hinzufügen möchten. # Programmgesteuertes Anzeigen von Tags für Amazon Pinpoint Pinpoint-Ressourcen In den folgenden Beispielen wird gezeigt, wie die [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) und die [Amazon-Pinpoint-REST-API](https://docs.aws.amazon.com/pinpoint/latest/apireference/) verwendet wird, um eine Liste aller Tags (Schlüssel und Werte) anzuzeigen, die einer Amazon-Pinpoint-Ressource zugeordnet sind. Sie können auch jedes unterstützte AWS SDK verwenden, um die mit einer Ressource verknüpften Tags anzuzeigen. ## Zeigen Sie Tags mithilfe der API an Um mit der Amazon-Pinpoint-REST-API alle Tags anzuzeigen, die einer bestimmten Ressource zugeordnet sind, senden Sie eine GET-Anforderung an den [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html)-URI, einschließlich des Amazon-Ressourcennamens (ARN) der Ressource. Der ARN sollte URL-codiert sein. Mit der folgenden Anfrage werden beispielsweise alle Tags abgerufen, die einer bestimmten Kampagne (*resource-arn*) zugeordnet sind: ``` GET /v1/tags/resource-arn HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache ``` Die JSON-Antwort auf die Anforderung enthält ein `tags`-Objekt. Das `tags`-Objekt listet alle Tag-Schlüssel und -Werte auf, die der Kampagne zugeordnet sind. Um alle Tags anzuzeigen, die mehr als einer Ressource desselben Typs zugeordnet sind, senden Sie eine GET-Anforderung an den entsprechenden Ressourcen-URI. Mit der folgenden Anfrage werden beispielsweise Informationen zu allen Kampagnen im angegebenen Projekt () *application-id* abgerufen: ``` GET /v1/apps/application-id/campaigns HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache ``` In der JSON-Antwort auf die Anforderung sind alle Kampagnen im Projekt aufgeführt. Das `tags`-Objekt der einzelnen Kampagnen listet alle Tag-Schlüssel und -Werte auf, die mit der Kampagne verknüpft sind. ## Zeigen Sie Tags an, indem Sie AWS CLI Um eine Liste der AWS CLI Tags anzuzeigen, die einer bestimmten Ressource zugeordnet sind, führen Sie den `list-tags-for-resource` Befehl aus und geben Sie den Amazon-Ressourcennamen (ARN) der Ressource für den `resource-arn` Parameter an, wie im folgenden Beispiel gezeigt. ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint list-tags-for-resource \ --resource-arn resource-arn ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws pinpoint list-tags-for-resource ^ --resource-arn resource-arn ``` ------ Verwenden Sie den Befehl [get-resources der AWS -Ressourcengruppen Tagging-API, um eine Liste aller Amazon Pinpoint Pinpoint-Ressourcen mit Tags und aller Tags anzuzeigen, die mit jeder dieser Ressourcen](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html) verknüpft sind. Legen Sie den `resource-type-filters`-Parameter wie im folgenden Beispiel gezeigt fest. ------ #### [ Linux, macOS, or Unix ] ``` $ aws resourcegroupstaggingapi get-resources \ --resource-type-filters "mobiletargeting" ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws resourcegroupstaggingapi get-resources ^ --resource-type-filters "mobiletargeting" ``` ------ Die Ausgabe des Befehls ist eine Liste aller ARNs Amazon Pinpoint Pinpoint-Ressourcen, die über Tags verfügen. Die Liste enthält alle Tag-Schlüssel und -Werte, die den einzelnen Ressourcen zugeordnet sind. # Programmgesteuertes Aktualisieren oder Überschreiben von Tags für Amazon Pinpoint Pinpoint-Ressourcen Zum Aktualisieren (Überschreiben) eines Tags für eine Amazon-Pinpoint-Ressource haben Sie mehrere Möglichkeiten. Welche die zum Aktualisieren eines Tags beste Methode ist, hängt von folgenden Faktoren ab: + Dem Typ der Ressource, für die Sie Tags aktualisieren möchten + Ob Sie ein Tag für eine Ressource oder mehrere Ressourcen gleichzeitig aktualisieren möchten + Ob Sie einen Tag-Schlüssel, einen Tag-Wert oder beides aktualisieren möchten Um ein Tag für ein Amazon Pinpoint Pinpoint-Projekt oder für mehrere Ressourcen gleichzeitig zu aktualisieren, verwenden Sie die Tagging-Operationen für Ressourcengruppen der AWS CLI oder der [AWS -Ressourcengruppen Tagging-API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html). Die Amazon-Pinpoint-API bietet derzeit keine direkte Unterstützung für eine dieser Aufgaben. Um einen Tag für eine Ressource zu aktualisieren, [entfernen Sie das aktuelle Tag](tags-remove.md) und [fügen Sie ein neues Tag hinzu](tags-add.md), indem Sie die Amazon-Pinpoint-API verwenden. # Programmgesteuertes Entfernen von Tags aus Amazon Pinpoint Pinpoint-Ressourcen In den folgenden Beispielen wird gezeigt, wie ein Tag (sowohl der Schlüssel als auch der Wert) aus einer Amazon-Pinpoint-Ressource mithilfe der [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) und der [Amazon-Pinpoint-REST-API](https://docs.aws.amazon.com/pinpoint/latest/apireference/) entfernt wird. Sie können auch jedes unterstützte AWS SDK verwenden, um ein Tag aus einer Ressource zu entfernen. Um ein Tag in einem einzigen Vorgang aus mehreren Amazon Pinpoint Pinpoint-Ressourcen zu entfernen, verwenden Sie die Tagging-Operationen für Ressourcengruppen der AWS CLI oder der [AWS -Ressourcengruppen Tagging-API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html). Um nur einen bestimmten Tag-Wert, also nicht den Tag-Schlüssel, von einer Ressource zu entfernen, können Sie das [Tag für die Ressource aktualisieren](tags-update.md). ## Entfernen Sie Tags mithilfe der API Um ein Tag aus einer Ressource mithilfe der Amazon-Pinpoint-REST-API zu entfernen, senden Sie eine DELETE-Anforderung an den [Tags](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html)-URI. Fügen Sie im URI eine Abfragezeichenfolge an, die den Amazon-Ressourcennamen (ARN) der Ressource enthält, von der Sie ein Tag entfernen möchten, gefolgt vom `tagKeys`-Parameter und dem zu entfernenden Tag. Beispiel: ``` https://endpoint/v1/tags/resource-arn?tagKeys=key ``` Wobei Folgendes gilt: + *endpoint*ist der Amazon Pinpoint-Endpunkt für die AWS Region, die die Ressource hostet. + *resource-arn*ist der ARN der Ressource, von der Sie ein Tag entfernen möchten. + *key*ist das Tag, das Sie aus der Ressource entfernen möchten. Alle Parameter sollten URL-codiert sein. Um mehrere Tag-Schlüssel als auch die zugehörigen Werte von einer Ressource zu entfernen, fügen Sie den `tagKeys`-Parameter und das Argument für jedes zusätzliche zu entfernende Tag an, getrennt durch ein kaufmännisches Und-Zeichen (&). Beispiel: ``` https://endpoint/v1/tags/resource-arn?tagKeys=key1&tagKeys=key2 ``` Alle Parameter sollten URL-codiert sein. ## Entfernen Sie Tags mit dem AWS CLI Um ein Tag mit dem aus einer Ressource zu entfernen AWS CLI, führen Sie den `untag-resource` Befehl aus. Geben Sie den `tag-keys`-Parameter und das -Argument an, wie im folgenden Beispiel gezeigt. ------ #### [ Linux, macOS, or Unix ] ``` $ aws pinpoint untag-resource \ --resource-arn resource-arn \ --tag-keys key1 key2 ``` ------ #### [ Windows Command Prompt ] ``` C:\> aws pinpoint untag-resource ^ --resource-arn resource-arn ^ --tag-keys key1 key2 ``` ------ Nehmen Sie im vorherigen Beispiel Sie die folgenden Änderungen vor: + *resource-arn*Ersetzen Sie es durch den ARN der Ressource, aus der Sie Tags entfernen möchten. + Ersetzen Sie *key1* und *key2* durch die Schlüssel der Tags, die Sie aus der Ressource entfernen möchten.