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=Bluehaben, was das Schlüssel:Wert-Paar Color:Blueergeben 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.

In Amazon Transcribe können Sie die folgenden Ressourcen taggen:

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ürfenaws:, 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.

Weitere Informationen über Tagging, einschließlich bewährter Methoden, finden Sie unter Tagging-Ressourcen AWS.

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:

Ein Beispiel für eine Tag-basierte Zugriffskontrollrichtlinie finden Sie unter Anzeigen von Transkriptionsaufträgen basierend auf Tags.

Ausführlichere Informationen zur Tag-basierten Zugriffskontrolle finden Sie unter Steuerung des Zugriffs auf AWS -Ressourcen mithilfe von Tags.

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 Management ConsoleAWS CLI, ändern oder AWS SDKslöschen. Beispiele finden Sie im Folgenden:

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

aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://filepath/my-first-tagging-job.json

{
  "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"
        }
  ]
}

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)