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.
# Taggen von -Ressourcen
Ein Tag ist eine benutzerdefinierte Metadatenbeschriftung, die Sie einer Ressource hinzufügen können, um sie leichter identifizieren, organisieren und in einer Suche finden zu können. Tags bestehen aus zwei einzelnen Teilen: Einem Tag-Schlüssel und einem Tag-Wert. Dies wird als Schlüssel:Wert-Paar bezeichnet.
Ein Tag-Schlüssel steht in der Regel für eine größere Kategorie, während ein Tag-Wert eine Teilmenge dieser Kategorie darstellt. Sie könnten zum Beispiel *tag key=Color* und *tag value=Blue*haben, was das Schlüssel:Wert-Paar `Color:Blue`ergeben würde. Beachten Sie, dass Sie den Wert eines Tags auf eine leere Zeichenkette setzen können, nicht aber den Wert eines Tags auf null. Ein nicht angegebener Tag-Wert entspricht einer leeren Zeichenfolge.
**Tipp**
AWS Fakturierung und Kostenmanagement kann Tags verwenden, um Ihre Rechnungen in dynamische Kategorien zu unterteilen. Wenn Sie zum Beispiel Tags hinzufügen, die verschiedene Abteilungen in Ihrem Unternehmen repräsentieren, wie `Department:Sales` oder `Department:Legal`, kann AWS Ihnen Ihre Kostenverteilung pro Abteilung anzeigen.
In Amazon Transcribe können Sie die folgenden Ressourcen taggen:
+ Transkriptionsaufträge
+ Medical-Transkriptionsaufträge
+ Rufen Sie Analyseaufträge nach dem Anruf zur Transkription auf
+ Benutzerdefinierte Vokabulare
+ Kundenspezifische medizinische Vokabulare
+ Benutzerdefinierte Vokalbularfilter
+ Rufen Sie Analyse-Kategorien auf
+ Benutzerdefinierte Sprachmodelle
Tag-Schlüssel können bis zu 128 Zeichen lang sein und Tag-Werte können bis zu 256 Zeichen lang sein. In beiden Fällen wird zwischen Groß- und Kleinschreibung unterschieden. Amazon Transcribe unterstützt bis zu 50 Tags pro Ressource. Für eine bestimmte Ressource muss jeder Tag-Schlüssel eindeutig sein und darf nur einen Wert haben. Beachten Sie, dass Ihre Tags nicht mit beginnen dürfen`aws:`, da dieses Präfix für vom System generierte Tags AWS reserviert ist. Sie können keine `aws:*` Tags hinzufügen, ändern oder löschen, und sie werden nicht auf Ihr tags-per-resource Limit angerechnet.
**Spezifische API-Vorgänge für die Kennzeichnung von Ressourcen**
[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListTagsForResource.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TagResource.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TagResource.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UntagResource.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UntagResource.html)
Um das Tagging verwenden zu können APIs, müssen Sie Ihrer Anfrage einen Amazon-Ressourcennamen (ARN) beifügen. ARNs habe das Format`arn:partition:service:region:account-id:resource-type/resource-id`. Der ARN für einen Transkriptionsauftrag kann zum Beispiel so aussehen: `arn:{{aws}}:transcribe:{{us-west-2}}:{{111122223333}}:transcription-job/{{my-transcription-job-name}}`.
Weitere Informationen über Tagging, einschließlich bewährter Methoden, finden Sie unter [Tagging-Ressourcen AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).
## Tag-basierte Zugriffskontrolle
Sie können Tags verwenden, um den Zugriff innerhalb Ihres zu kontrollieren. AWS-Konten Bei der tagbasierten Zugriffskontrolle geben Sie Taginformationen im Bedingungselement einer IAM Richtlinie an. Sie können dann Tags und den zugehörigen Tag-Bedingungsschlüssel verwenden, um den Zugriff auf Folgendes zu steuern:
+ **Ressourcen:** Steuern Sie den Zugriff auf Ihre Amazon Transcribe Ressourcen anhand der Tags, die Sie diesen Ressourcen zugewiesen haben.
+ Verwenden Sie den `aws:ResourceTag/{{key-name}}`-Bedingungsschlüssel, um anzugeben, welches Tag-Schlüssel:Wert-Paar an die Ressource angehängt werden muss.
+ **Abfragen:** Steuern Sie, welche Tags in einer Anfrage übergeben werden können.
+ Verwenden Sie den `aws:RequestTag/{{key-name}}` Bedingungsschlüssel, um anzugeben, welche Tags einem IAM Benutzer oder einer Rolle hinzugefügt, geändert oder daraus entfernt werden können.
+ **Autorisierungsprozesse:** Steuern Sie den Tag-basierten Zugriff für jeden Teil Ihres Autorisierungsprozesses.
+ Verwenden Sie den `aws:TagKeys/`-Bedingungsschlüssel, um zu steuern, ob bestimmte Tag-Schlüssel auf einer Ressource, in einer Anfrage oder von einem Auftraggeber verwendet werden können. In diesem Fall spielt der Schlüsselwert keine Rolle.
Ein Beispiel für eine Tag-basierte Zugriffskontrollrichtlinie finden Sie unter [Anzeigen von Transkriptionsaufträgen basierend auf Tags](security_iam_id-based-policy-examples.md#tagging-transcription-policy).
Ausführlichere Informationen zur Tag-basierten Zugriffskontrolle finden Sie unter [Steuerung des Zugriffs auf AWS -Ressourcen mithilfe von Tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
## Hinzufügen von Tags zu Ihren Amazon Transcribe Ressourcen
Sie können Tags vor oder nach der Ausführung Ihres Amazon Transcribe Jobs hinzufügen. Mithilfe der vorhandenen Optionen **Create\*** und **Start\*** APIs können Sie Ihrer Transkriptionsanfrage zusätzliche Tags hinzufügen.
Sie können Tags mit den Tasten, oder hinzufügen **AWS-Managementkonsole**AWS CLI****, ändern oder **AWS SDKs**löschen. Beispiele finden Sie im Folgenden:
### AWS-Managementkonsole
1. Melden Sie sich an der [AWS-Managementkonsole](https://console.aws.amazon.com/transcribe/) an.
1. Wählen Sie im Navigationsbereich **Transkriptionsaufträge** und dann **Auftrag erstellen** (oben rechts). Dies öffnet die Seite **Auftragsdetails angeben**.
1. Scrollen Sie auf der Seite **Auftragsdetails angeben** bis zum Ende, um das Feld **Tags – *optional*** zu finden, und wählen Sie **Neues Tag hinzufügen**.
1. Geben Sie Informationen für das Feld **Schlüssel** und, optional, für das Feld **Wert** ein.
1. Füllen Sie alle anderen Felder aus, die Sie auf der Seite **Auftragsdetails angeben** möchten, und wählen Sie dann **Weiter**. Hier gelangen Sie zur **Seite Auftrag konfigurieren – *optional* **.
Wählen Sie **Auftrag erstellen**, um Ihren Transkriptionsauftrag auszuführen.
1. Sie können die mit einem Transkriptionsauftrag verbundenen Tags anzeigen, indem Sie zur Seite **Transkriptionsaufträge** navigieren, einen Transkriptionsauftrag auswählen und auf der Informationsseite dieses Auftrags bis zum Ende scrollen. Wenn Sie Ihre Tags bearbeiten möchten, können Sie dies tun, indem Sie **Tags verwalten** wählen.
### AWS CLI
In diesem Beispiel werden der [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)Befehl und der `Tags` Parameter verwendet. Weitere Informationen erhalten Sie unter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) und [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html).
```
aws transcribe start-transcription-job \
--region {{us-west-2}} \
--transcription-job-name {{my-first-transcription-job}} \
--media MediaFileUri=s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}} \
--output-bucket-name {{amzn-s3-demo-bucket}} \
--output-key {{my-output-files}}/ \
--language-code {{en-US}} \
--tags Key={{color}},Value={{blue}} Key={{shape}},Value={{square}}
```
Hier ist ein weiteres Beispiel, in dem der [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)Befehl und ein Anforderungstext verwendet werden, der diesem Job Tags hinzufügt.
```
aws transcribe start-transcription-job \
--region {{us-west-2}} \
--cli-input-json file://{{filepath}}/{{my-first-tagging-job.json}}
```
Die Datei *my-first-tagging-job.json* enthält den folgenden Anforderungstext.
```
{
"TranscriptionJobName": "{{my-first-transcription-job}}",
"Media": {
"MediaFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
},
"OutputBucketName": "{{amzn-s3-demo-bucket}}",
"OutputKey": "{{my-output-files}}/",
"LanguageCode": "{{en-US}}",
"Tags": [
{
"Key": "{{color}}",
"Value": "{{blue}}"
},
{
"Key": "{{shape}}",
"Value": "{{square}}"
}
]
}
```
### AWS SDK für Python (Boto3)
Im folgenden Beispiel wird mithilfe des AWS SDK für Python (Boto3) `Tags` Arguments für die Methode [start\_transcription\_job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) ein Tag hinzugefügt. Weitere Informationen erhalten Sie unter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) und [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html).
Weitere Beispiele für die Verwendung der AWS SDKs, einschließlich funktionsspezifischer, szenarienspezifischer und serviceübergreifender Beispiele, finden Sie im Kapitel. [Codebeispiele für Amazon Transcribe mit AWS SDKs](service_code_examples.md)
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', '{{us-west-2}}')
job_name = "{{my-first-transcription-job}}"
job_uri = "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
transcribe.start_transcription_job(
TranscriptionJobName = job_name,
Media = {
'MediaFileUri': job_uri
},
OutputBucketName = '{{amzn-s3-demo-bucket}}',
OutputKey = '{{my-output-files}}/',
LanguageCode = '{{en-US}}',
Tags = [
{
'Key':'{{color}}',
'Value':'{{blue}}'
}
]
)
while True:
status = transcribe.get_transcription_job(TranscriptionJobName = job_name)
if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```