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.
# Verwaltung von Schlüssel-Tags mit API-Operationen
Sie können die [AWS Payment Cryptography API](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/Welcome.html) verwenden, um Tags für die von Ihnen verwalteten Schlüssel hinzuzufügen, zu löschen und aufzulisten. Für diese Beispiele wird die [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/) verwendet. Sie können aber jede unterstützte Programmiersprache nutzen. Sie können nicht taggen Von AWS verwaltete Schlüssel.
Um Tags für einen Schlüssel hinzuzufügen, zu bearbeiten, anzuzeigen und zu löschen, benötigen Sie die erforderlichen Berechtigungen. Details hierzu finden Sie unter [Zugriffssteuerung mit Tags](tag-permissions.md).
**Topics**
+ [CreateKey: Fügen Sie einem neuen Schlüssel Tags hinzu](#tagging-keys-create-key)
+ [TagResource: Fügen Sie Tags für einen Schlüssel hinzu oder ändern Sie sie](#tagging-keys-tag-resource)
+ [ListResourceTags: Ruft die Tags für einen Schlüssel ab](#tagging-keys-list-resource-tags)
+ [UntagResource: Löscht Tags aus einem Schlüssel](#tagging-keys-untag-resource)
## CreateKey: Fügen Sie einem neuen Schlüssel Tags hinzu
Sie können Tags hinzufügen, wenn Sie einen Schlüssel erstellen. Verwenden Sie den `Tags` Parameter der [CreateKey](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html)Operation, um die Tags anzugeben.
Um beim Erstellen eines Schlüssels Tags hinzuzufügen, muss der Aufrufer über die entsprechenden `payment-cryptography:TagResource` Rechte in einer IAM-Richtlinie verfügen. Die Erlaubnis muss mindestens alle Schlüssel im Konto und in der Region abdecken. Details hierzu finden Sie unter [Zugriffssteuerung mit Tags](tag-permissions.md).
Der Wert des `Tags`-Parameters von `CreateKey` ist eine Sammlung von Tag-Schlüssel- und Tag-Wert-Paaren, unter Beachtung der Groß-/Kleinschreibung. Jedes Tag auf einem Schlüssel muss einen anderen Tagnamen haben. Der Tag-Wert kann auch eine leere (Null) Zeichenfolge sein.
Mit dem folgenden AWS CLI Befehl wird beispielsweise ein symmetrischer Verschlüsselungsschlüssel mit einem `Project:Alpha` Tag erstellt. Wenn Sie mehr als ein Schlüssel-Wert-Paar angeben, verwenden Sie ein Leerzeichen, um die einzelnen Paare zu trennen.
```
$ aws payment-cryptography create-key --exportable --key-attributes KeyAlgorithm=TDES_2KEY, \
KeyUsage=TR31_C0_CARD_VERIFICATION_KEY,KeyClass=SYMMETRIC_KEY, \
KeyModesOfUse='{Generate=true,Verify=true}' \
--tags '[{"Key":"Project","Value":"Alpha"},{"Key":"BIN","Value":"123456"}]'
```
Wenn dieser Befehl erfolgreich ist, gibt er ein `Key` Objekt mit Informationen über den neuen Schlüssel zurück. Die `Key` enthalten jedoch keine Tags. Verwenden Sie die [ListResourceTags](#tagging-keys-list-resource-tags)Operation, um die Tags abzurufen.
## TagResource: Fügen Sie Tags für einen Schlüssel hinzu oder ändern Sie sie
Die [TagResource](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_TagResource.html)Operation fügt einem Schlüssel ein oder mehrere Tags hinzu. Sie können diese Operation nicht verwenden, um Tags in einem anderen AWS-Konto hinzuzufügen oder zu bearbeiten.
Geben Sie zum Hinzufügen eines Tags einen neuen Tag-Schlüssel und einen Tag-Wert an. Um ein Tag zu bearbeiten, geben Sie einen vorhandenen Tag-Schlüssel und einen neuen Tag-Wert an. Jedes Tag auf einem Schlüssel muss einen anderen Tag-Schlüssel haben. Der Tag-Wert kann auch eine leere (Null) Zeichenfolge sein.
Der folgende Befehl fügt beispielsweise einem Beispielschlüssel **BIN** Tags hinzu **UseCase** und fügt ihm Tags hinzu.
```
$ aws payment-cryptography tag-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h --tags '[{"Key":"UseCase","Value":"Acquiring"},{"Key":"BIN","Value":"123456"}]'
```
Wenn der Befehl erfolgreich war, erfolgt keine Ausgabe. Verwenden Sie die [ListResourceTags](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListTagsForResource.html)Operation, um die Tags auf einem Schlüssel anzuzeigen.
Sie können auch **TagResource** verwenden, um den Tag-Wert für ein vorhandenes Tag zu ändern. Um einen Tag-Wert zu ersetzen, geben Sie den gleichen Tag-Schlüssel mit einem unterschiedlichen Wert an. Tags, die nicht in einem Änderungsbefehl aufgeführt sind, werden nicht geändert oder entfernt.
Beispielsweise ändert dieser Befehl den Wert des `Project`-Tag von `Alpha` auf `Noe`.
Der Befehl wird http/200 ohne Inhalt zurückgegeben. Um Ihre Änderungen zu sehen, verwenden Sie `ListTagsForResource`
```
$ aws payment-cryptography tag-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h \
--tags '[{"Key":"Project","Value":"Noe"}]'
```
## ListResourceTags: Ruft die Tags für einen Schlüssel ab
Die [ListResourceTags](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListTagsForResource.html)Operation ruft die Tags für einen Schlüssel ab. Der Parameter `ResourceArn` (KeyArn oder KeyAlias) ist erforderlich. Sie können diesen Vorgang nicht verwenden, um die Tags auf Schlüsseln in einem anderen Format anzuzeigen. AWS-Konto
Mit dem folgenden Befehl werden beispielsweise die Tags für einen Beispielschlüssel abgerufen.
```
$ aws payment-cryptography list-tags-for-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h
{
"Tags": [
{
"Key": "BIN",
"Value": "20151120"
},
{
"Key": "Project",
"Value": "Production"
}
]
}
```
## UntagResource: Löscht Tags aus einem Schlüssel
Die [UntagResource](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_UntagResource.html)Operation löscht Tags aus einem Schlüssel. Um die zu löschenden Tags zu identifizieren, geben Sie die Tag-Schlüssel an. Sie können diesen Vorgang nicht verwenden, um Tags aus einem anderen AWS-Konto Schlüssel zu löschen.
Wenn sie erfolgreich ist, gibt die `UntagResource`-Operation keine Ausgabe zurück. Wenn der angegebene Tag-Schlüssel auf dem Schlüssel nicht gefunden wird, wird auch keine Ausnahme ausgelöst und es wird keine Antwort zurückgegeben. Verwenden Sie den Vorgang, um zu überprüfen, ob der [ListResourceTags](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListTagsForResource.html)Vorgang funktioniert hat.
Dieser Befehl löscht beispielsweise das **Purpose** Tag und seinen Wert aus dem angegebenen Schlüssel.
```
$ aws payment-cryptography untag-resource \
--resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h --tag-keys Project
```