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.
# Schwärzung oder Identifizierung persönlich identifizierbarer Informationen
Die Schwärzung wird verwendet, um sensible Inhalte in Form von persönlich identifizierbaren Informationen (PII) in Ihren Transkripten zu maskieren oder daraus zu entfernen. Die Arten von personenbezogenen Daten, die redigiert Amazon Transcribe werden können, variieren zwischen Batch- und Streaming-Transkriptionen. Die PII-Liste für jede Transkriptionsmethode finden Sie unter [Schwärzen von PII in Ihrem Batch-Job](pii-redaction-batch.md) und [Schwärzen oder Identifizieren von PII in einem Echtzeit-Datenstrom](pii-redaction-stream.md). Bei Streaming-Transkriptionen haben Sie auch die Möglichkeit, PII zu kennzeichnen, ohne sie zu schwärzen; ein Beispiel für die Ausgabe finden Sie unter [Beispiel für die Ausgabe der PII-Identifikation](pii-redaction-output.md#pii-redaction-output-id) .
Wenn die Schwärzung aktiviert ist, haben Sie die Möglichkeit, nur ein geschwärztes Transkript oder sowohl ein geschwärztes als auch ein ungeschwärztes Transkript zu erstellen. Wenn Sie sich dafür entscheiden, nur ein geschwärztes Transkript zu erstellen, beachten Sie, dass Ihr Datenträger der einzige Ort ist, an dem das vollständige Gespräch gespeichert wird. Wenn Sie Ihre Originaldatenträger löschen, gibt es keine Aufzeichnungen über die ungeschwärzten PII. Aus diesem Grund kann es sinnvoll sein, zusätzlich zu einem geschwärzten Transkript auch ein ungeschwärztes Transkript zu erstellen.
Weitere Informationen über die Schwärzung von PII bei Batch-Transkriptionen finden Sie unter: [Schwärzen von PII in Ihrem Batch-Job](pii-redaction-batch.md).
Weitere Informationen zur Schwärzung oder Identifizierung von personenbezogenen Daten bei Streaming-Transkriptionen finden Sie unter: [Schwärzen oder Identifizieren von PII in einem Echtzeit-Datenstrom](pii-redaction-stream.md).
**Wichtig**
Die SchwärzungsFeature dient dazu, sensible Daten zu identifizieren und zu entfernen. Aufgrund des prädiktiven Charakters des maschinellen Lernens können jedoch Amazon Transcribe möglicherweise nicht alle Fälle sensibler Daten in Ihrem Transkript identifiziert und entfernt werden. Wir empfehlen Ihnen dringend, alle geschwärzten Ausgaben zu überprüfen, um sicherzustellen, dass sie Ihren Anforderungen entsprechen.
Die SchwärzungsFeature erfüllt nicht die Anforderungen an die De-Identifizierung gemäß den Gesetzen zum Schutz der Privatsphäre in der Medizin, wie dem U.S. Health Insurance Portability and Accountability Act von 1996 (HIPAA).
Ein Video über die Schwärzung und Identifizierung von PII finden Sie hier:
[](http://www.youtube.com/watch?v=https://www.youtube.com/embed/4H8dQoeLkyM)
# Schwärzen von PII in Ihrem Batch-Job
Wenn Sie während eines Batch-Transkriptionsvorgangs personenbezogene Daten (PII) aus einem Transkript redigieren, wird jede identifizierte Instanz von PII durch den Haupttext Ihres `[PII]` Transkripts Amazon Transcribe ersetzt. In dem Teil der Transkriptionsausgabe können Sie sich auch die Art der personenbezogenen Daten ansehen, die geschwärzt wurden. word-for-word Ein Beispiel für die Ausgabe finden Sie unter [Beispiel für eine geschwärzte Ausgabe (Batch)](pii-redaction-output.md#pii-redaction-output-batch).
Die Schwärzung mit Batch-Transkriptionen ist in US-Englisch (`en-US`) und US-Spanisch () verfügbar. `es-US` Die Schwärzung ist nicht mit der [Sprachidentifikation](lang-id-batch.md)kompatibel.
Sowohl geschwärzte als auch unredigierte Transkripte werden im selben Ausgabe-Bucket gespeichert. Amazon S3 Amazon Transcribe speichert sie in einem von Ihnen angegebenen Bucket oder in dem vom Service verwalteten Amazon S3 Standard-Bucket.
**Arten von personenbezogenen Daten, die bei Amazon Transcribe Batch-Transkriptionen erkannt werden können**
| PII-Typ | Description |
| --- | --- |
| ADDRESS | Eine physische Adresse, z. B. *100 Main Street, Anytown, USA* oder *Suite \$112, Gebäude 123*. Eine Adresse kann eine Straße, ein Gebäude, einen Ort, eine Stadt, ein Bundesland, ein Land, eine Grafschaft, eine Postleitzahl, einen Bezirk, ein Stadtviertel und mehr enthalten. |
| ALL | Schwärzen oder identifizieren Sie alle in dieser Tabelle aufgeführten PII-Typen. |
| BANK\$1ACCOUNT\$1NUMBER | Eine US-Bankkontonummer. Diese sind in der Regel zwischen 10 und 12 Ziffern lang, aber Amazon Transcribe erkennt auch Bankkontonummern, bei denen nur die letzten 4 Ziffern vorhanden sind. |
| BANK\$1ROUTING | Eine US-Bankleitzahl. Diese sind in der Regel 9 Ziffern lang, aber Amazon Transcribe erkennt auch Routing-Nummern, bei denen nur die letzten 4 Ziffern vorhanden sind. |
| CREDIT\$1DEBIT\$1CVV | Ein dreistelliger Kartenbestätigungscode (CVV), der auf Kredit- und Debitkarten von VISA und Discover vorhanden ist. MasterCard Bei American Express-Kredit- oder Debitkarten handelt es sich um einen 4-stelligen Zahlencode. |
| CREDIT\$1DEBIT\$1EXPIRY | Das Ablaufdatum einer Kredit- oder Debitkarte. Diese Nummer ist normalerweise vierstellig und als month/year MM/YY formatiert. Amazon Transcribe *Kann beispielsweise Ablaufdaten wie *01/21, 01/2021* *und Jan 2021* erkennen.* |
| CREDIT\$1DEBIT\$1NUMBER | Die Nummer einer Kredit- oder Debitkarte. Diese Zahlen können zwischen 13 und 16 Ziffern lang sein, erkennen aber Amazon Transcribe auch Kredit- oder Debitkartennummern, wenn nur die letzten 4 Ziffern vorhanden sind. |
| EMAIL | Eine E-Mail-Adresse, z. B. *efua.owusu@email.com.* |
| NAME | Der Name einer Person. Dieser Entitätstyp umfasst keine Titel wie Herr, Frau, Fräulein oder Dr.. Er wendet diesen Entitätstyp Amazon Transcribe nicht auf Namen an, die Teil von Organisationen oder Adressen sind. Amazon Transcribe Erkennt beispielsweise die *John Doe Organization* als Organisation und *Jane Doe Street* als Adresse. |
| PHONE | Eine Telefonnummer. Dieser Entitätstyp umfasst auch Fax- und Pager-Nummern. |
| PIN | Eine 4-stellige persönliche Identifikationsnummer (PIN), mit der jemand Zugang zu seinen Kontodaten erhält. |
| SSN | Eine Sozialversicherungsnummer (SSN) ist eine 9-stellige Nummer, die an US-Bürger, Personen mit ständigem Wohnsitz und Personen mit vorübergehender Erwerbstätigkeit vergeben wird. Amazon Transcribe erkennt auch Sozialversicherungsnummern, wenn nur die letzten 4 Ziffern vorhanden sind. |
Sie können einen Batch-Transkriptionsauftrag mit dem AWS SDK AWS-Managementkonsole AWS CLI, oder starten.
## 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). Daraufhin wird die Seite **Auftragsdetails angeben** geöffnet.
1. Nachdem Sie die gewünschten Felder auf der Seite **Auftragsdetails angeben** ausgefüllt haben, wählen Sie **Weiter**, um zur Seite **Auftrag konfigurieren – *optional*** zu gelangen. Hier finden Sie den Bereich **zum Entfernen von Inhalten** mit dem Schalter für die **Schwärzung von PII** .
![\[Amazon Transcribe Konsolen-Screenshot: Der Bereich zum Entfernen von Inhalten auf der Seite „Job konfigurieren“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/content-redact.png)
1. Sobald Sie die **Schwärzung von PII** ausgewählt haben, haben Sie die Möglichkeit, alle PII-Typen auszuwählen, die Sie schwärzen möchten. Sie können auch festlegen, dass ein ungeschwärztes Transkript angezeigt wird, wenn Sie **Ungeschwärztes Transkript in das Auftragsausgabefeld einschließen** auswählen.
![\[Amazon Transcribe Konsolen-Screenshot: Der Bereich „Inhalte entfernen“ mit PII-Optionen.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/content-redact-select.png)
1. Wählen Sie **Auftrag erstellen**, um Ihren Transkriptionsauftrag auszuführen.
## AWS CLI
In diesem Beispiel werden der Befehl und der [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)Parameter verwendet. `content-redaction` 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_ContentRedaction.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ContentRedaction.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 \
--content-redaction RedactionType=PII,RedactionOutput=redacted,PiiEntityTypes=NAME,ADDRESS,BANK_ACCOUNT_NUMBER
```
Hier ist ein weiteres Beispiel, in dem die [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)Methode verwendet wird, und der Anfragetext redigiert die PII für diesen Job.
```
aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://filepath/my-first-redaction-job.json
```
Die Datei *my-first-redaction-job.json* enthält den folgenden Anfragetext.
```
{
"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",
"ContentRedaction": {
"RedactionOutput":"redacted",
"RedactionType":"PII",
"PiiEntityTypes": [
"NAME",
"ADDRESS",
"BANK_ACCOUNT_NUMBER"
]
}
}
```
## AWS SDK für Python (Boto3)
In diesem Beispiel wird der verwendet AWS SDK für Python (Boto3) , um den Inhalt mithilfe des `ContentRedaction` Arguments für die Methode [start\$1transcription\$1job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) zu redigieren. 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_ContentRedaction.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ContentRedaction.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',
ContentRedaction = {
'RedactionOutput':'redacted',
'RedactionType':'PII',
'PiiEntityTypes': [
'NAME','ADDRESS','BANK_ACCOUNT_NUMBER'
]
}
)
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)
```
**Anmerkung**
Die Bearbeitung personenbezogener Daten für Batch-Jobs wird nur in folgenden Ländern unterstützt AWS-Regionen: Asien-Pazifik (Hongkong), Asien-Pazifik (Mumbai), Asien-Pazifik (Seoul), Asien-Pazifik (Singapur), Asien-Pazifik (Sydney), Asien-Pazifik GovCloud (Tokio), (US-West), Kanada (Zentral), EU (Frankfurt), EU (Irland), EU (London), EU (Paris), Naher Osten (Bahrain), Südamerika (Sao Paulo), USA Ost (Nord-Virginia), USA Ost (Ohio), USA West (Oregon) und USA West (Nordkalifornien).
# Schwärzen oder Identifizieren von PII in einem Echtzeit-Datenstrom
Amazon Transcribe Ersetzt bei der Schwärzung von persönlich identifizierbaren Informationen (PII) aus einer Streaming-Transkription jede identifizierte Instanz von PII durch `[PII]` in Ihrem Transkript.
Eine zusätzliche Option für Streaming-Transkriptionen ist die *Identifizierung von personenbezogenen Daten*. Wenn Sie PII Identification aktivieren, Amazon Transcribe kennzeichnet die PII in Ihren Transkriptionsergebnissen unter einem Objekt. `Entities` Ein Beispiel für die Ausgabe finden Sie unter [Beispiel für eine geschwärzte Streaming-Ausgaben](pii-redaction-output.md#pii-redaction-output-stream) und [Beispiel für die Ausgabe der PII-Identifikation](pii-redaction-output.md#pii-redaction-output-id).
Die Bearbeitung und Identifizierung personenbezogener Daten mit Streaming-Transkriptionen ist in den folgenden englischen Dialekten möglich: Schottisch (`en-AB`), Australien (`en-AU`), Kanada (`en-CA`), Britisch (`en-GB`), Irland (`en-IE`), Indien (`en-IN`), Neuseeland (), Vereinigte Staaten (`en-NZ`), Wales (`en-US`) und Südafrika (`en-WL`); spanische Dialekte: USA (`en-ZA`), Spanien (); Französische Dialekte: Französisch (`es-US``es-ES`), Kanada (); Portugiesische Dialekte: Portugal (`fr-FR``fr-CA`), Brasilien (); italienischer Dialekt: Italien `pt-PT` `pt-BR` (`it-IT`); und deutsche Dialekte: Deutschland (`de-DE`), Schweizerisch (`de-CH`).
Die Identifizierung und Schwärzung von personenbezogenen Daten bei Streaming-Aufträgen erfolgt erst nach vollständiger Transkription der Audiosegmente.
**Arten von personenbezogenen Daten, die bei Amazon Transcribe Streaming-Transkriptionen erkannt werden können**
| PII-Typ | Description |
| --- | --- |
| ADDRESS | Eine physische Adresse, z. B. *100 Main Street, Anytown, USA* oder *Suite \$112, Gebäude 123*. Eine Adresse kann eine Straße, ein Gebäude, einen Ort, eine Stadt, ein Bundesland, ein Land, eine Grafschaft, eine Postleitzahl, einen Bezirk, ein Stadtviertel und mehr enthalten. |
| ALL | Schwärzen oder identifizieren Sie alle in dieser Tabelle aufgeführten PII-Typen. |
| BANK\$1ACCOUNT\$1NUMBER | Eine US-Bankkontonummer. Diese sind in der Regel zwischen 10 und 12 Ziffern lang, aber Amazon Transcribe erkennt auch Bankkontonummern, bei denen nur die letzten 4 Ziffern vorhanden sind. |
| BANK\$1ROUTING | Eine US-Bankleitzahl. Diese sind in der Regel 9 Ziffern lang, aber Amazon Transcribe erkennt auch Routing-Nummern, bei denen nur die letzten 4 Ziffern vorhanden sind. |
| CREDIT\$1DEBIT\$1CVV | Ein dreistelliger Kartenbestätigungscode (CVV), der auf Kredit- und Debitkarten von VISA und Discover vorhanden ist. MasterCard Bei American Express-Kredit- oder Debitkarten handelt es sich um einen 4-stelligen Zahlencode. |
| CREDIT\$1DEBIT\$1EXPIRY | Das Ablaufdatum einer Kredit- oder Debitkarte. Diese Nummer ist normalerweise vierstellig und als month/year MM/YY formatiert. Amazon Transcribe *Kann beispielsweise Ablaufdaten wie *01/21, 01/2021* *und Jan 2021* erkennen.* |
| CREDIT\$1DEBIT\$1NUMBER | Die Nummer einer Kredit- oder Debitkarte. Diese Zahlen können zwischen 13 und 16 Ziffern lang sein, erkennen aber Amazon Transcribe auch Kredit- oder Debitkartennummern, wenn nur die letzten 4 Ziffern vorhanden sind. |
| EMAIL | Eine E-Mail-Adresse, z. B. *efua.owusu@email.com.* |
| NAME | Der Name einer Person. Dieser Entitätstyp umfasst keine Titel wie Herr, Frau, Fräulein oder Dr.. Er wendet diesen Entitätstyp Amazon Transcribe nicht auf Namen an, die Teil von Organisationen oder Adressen sind. Amazon Transcribe Erkennt beispielsweise die *John Doe Organization* als Organisation und *Jane Doe Street* als Adresse. |
| PHONE | Eine Telefonnummer. Dieser Entitätstyp umfasst auch Fax- und Pager-Nummern. |
| PIN | Eine 4-stellige persönliche Identifikationsnummer (PIN), mit der jemand Zugang zu seinen Kontodaten erhält. |
| SSN | Eine Sozialversicherungsnummer (SSN) ist eine 9-stellige Nummer, die an US-Bürger, Personen mit ständigem Wohnsitz und Personen mit vorübergehender Erwerbstätigkeit vergeben wird. Amazon Transcribe erkennt auch Sozialversicherungsnummern, wenn nur die letzten 4 Ziffern vorhanden sind. |
| AGE | Das Alter einer Person, einschließlich Menge und Zeiteinheit. In der Phrase „Ich bin 40 Jahre alt“ wird beispielsweise „40 Jahre“ als Alter Amazon Transcribe erkannt. |
| DATE\$1TIME | Ein Datum kann ein Jahr, einen Monat, einen Tag, einen Wochentag oder eine Tageszeit enthalten. Amazon Transcribe Erkennt beispielsweise „19. Januar 2020“ oder „11 Uhr“ als Datum. Amazon Transcribe erkennt Teildaten, Datumsbereiche und Datumsintervalle. Es wird auch Jahrzehnte wie „die 1990er“ berücksichtigen. |
| LICENSE\$1PLATE | Ein Nummernschild für ein Fahrzeug wird von dem Staat oder Land ausgestellt, in dem das Fahrzeug registriert ist. Das Format für Personenkraftwagen besteht in der Regel aus fünf bis acht Zeichen, mit Großbuchstaben gefolgt von Ziffern. Das Format variiert je nach Standort des ausstellenden Staates oder Landes. |
| PASSPORT\$1NUMBER | Eine eindeutige Kennung, die dem Reisepass einer Person zugewiesen wird. Das Format umfasst in der Regel eine Kombination aus Buchstaben und Zahlen und ist je nach Land unterschiedlich. |
| PASSWORD | Eine alphanumerische Zeichenfolge, die als Passwort verwendet wird, z. B. „\$1very20special\$1pass\$1“. |
| USERNAME | Ein Benutzername, der ein Konto identifiziert, wie etwa ein Login-Name, Bildschirmname, Spitzname oder Handle. |
| VEHICLE\$1IDENTIFICATION\$1NUMBER | Eine Fahrgestellnummern (VIN) identifiziert ein Fahrzeug eindeutig. Inhalt und Format der Fahrgestellnummer sind in der Spezifikation ISO 3779 definiert. Jedes Land hat spezifische Codes und Formate für VINs. |
Sie können eine Streaming-Transkription mit AWS-Managementkonsole WebSocket, oder HTTP/2 starten.
## AWS-Managementkonsole
1. Melden Sie sich beim [AWS-Managementkonsole](https://console.aws.amazon.com/transcribe/) an.
1. Wählen Sie im Navigationsbereich **Echtzeit-Streaming** aus. Scrollen Sie nach unten zu **Einstellungen für das Entfernen von Inhalten** und erweitern Sie dieses Feld, falls es minimiert ist.
![\[Amazon Transcribe Konsolen-Screenshot: Die Seite „Transkription in Echtzeit“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/redaction-stream1.png)
1. Umschalten auf **PII-Identifizierung und Schwärzung**.
![\[Amazon Transcribe Konsolen-Screenshot: Das erweiterte Fenster mit den Einstellungen für das Entfernen von Inhalten.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/redaction-stream2.png)
1. Wählen Sie **Nur Identifizierung** oder **Identifizierung und Schwärzung** und wählen Sie dann die Arten von personenbezogenen Daten, die Sie in Ihrem Transkript identifizieren oder schwärzen möchten.
![\[Amazon Transcribe Konsolen-Screenshot: Liste der PII-Typen, die ausgewählt werden können.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/redaction-stream3.png)
1. Jetzt können Sie Ihren Stream transkribieren. Wählen Sie **Streaming starten** und beginnen Sie zu sprechen. Um Ihr Diktat zu beenden, wählen Sie **Streaming beenden**.
## WebSocket streamen
In diesem Beispiel wird eine vorsignierte URL erstellt, die PII-Schwärzung (oder PII-Identifizierung) in einem Stream verwendet. WebSocket Für eine bessere Lesbarkeit werden Zeilenumbrüche hinzugefügt. Weitere Informationen zur Verwendung von WebSocket Streams mit finden Sie unter. Amazon Transcribe[Einen WebSocket Stream einrichten](streaming-setting-up.md#streaming-websocket) Weitere Einzelheiten zu den Parametern finden Sie unter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html).
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=string
&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date
&language-code=en-US
&media-encoding=flac
&sample-rate=16000
&pii-entity-types=NAME,ADDRESS
&content-redaction-type=PII (or &content-identification-type=PII)
```
Sie können nicht sowohl `content-identification-type` als auch `content-redaction-type` in derselben Anfrage verwenden.
Parameterdefinitionen finden Sie in der [API-Referenz.](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html) Parameter, die allen AWS API-Vorgängen gemeinsam sind, sind im Abschnitt [Allgemeine Parameter](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html) aufgeführt.
## HTTP/2-Stream
In diesem Beispiel wird eine HTTP/2-Anfrage mit aktivierter PII-Identifizierung oder PII-Redaktion erstellt. Weitere Informationen zur Verwendung von HTTP/2-Streaming mit finden Sie Amazon Transcribe unter[Einrichten eines HTTP/2-Streams](streaming-setting-up.md#streaming-http2). Weitere Informationen zu spezifischen Parametern und Headern finden Sie Amazon Transcribe unter. [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html)
```
POST /stream-transcription HTTP/2
host: transcribestreaming.us-west-2.amazonaws.com
X-Amz-Target: com.amazonaws.transcribe.Transcribe.StartStreamTranscription
Content-Type: application/vnd.amazon.eventstream
X-Amz-Content-Sha256: string
X-Amz-Date: 20220208T235959Z
Authorization: AWS4-HMAC-SHA256 Credential=access-key/20220208/us-west-2/transcribe/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date;x-amz-target;x-amz-security-token, Signature=string
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000
x-amzn-transcribe-content-identification-type: PII (or x-amzn-transcribe-content-redaction-type: PII)
x-amzn-transcribe-pii-entity-types: NAME,ADDRESS
transfer-encoding: chunked
```
Sie können nicht sowohl `content-identification-type` als auch `content-redaction-type` in derselben Anfrage verwenden.
Parameterdefinitionen finden Sie in der [API-Referenz.](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html) Parameter, die allen AWS API-Vorgängen gemeinsam sind, sind im Abschnitt [Allgemeine Parameter](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html) aufgeführt.
**Anmerkung**
Die Bearbeitung personenbezogener Daten für das Streaming wird nur in folgenden Ländern unterstützt AWS-Regionen: Asien-Pazifik (Seoul), Asien-Pazifik (Sydney), Asien-Pazifik (Tokio), Kanada (Zentral), EU (Frankfurt), EU (Irland), EU (London), USA Ost (Nord-Virginia), USA Ost (Ohio) und USA West (Oregon).
# Beispiel für die Schwärzung und Identifizierung von PII
Die folgenden Beispiele zeigen geschwärzte Transkripte von Batch- und Streaming-Aufträgen sowie die PII-Identifizierung bei einem Streaming-Auftrag.
Transkriptionsaufträge, die die Inhaltsschwärzung verwenden, erzeugen zwei Arten von `confidence`-Werten. Bei der automatischen Spracherkennungszuverlässigkeit (Automatic Speech Recognition, ASR) werden die Elemente angegeben, die den `type` der `pronunciation` aufweisen oder bei denen die `punctuation` eine bestimmte Äußerung ist. In der folgenden Transkriptausgabe hat das Wort `Good` einen `confidence` von `1.0`. Dieser Konfidenzwert gibt an, dass zu 100 Prozent sicher Amazon Transcribe ist, dass das in diesem Protokoll gesprochene Wort „Gut“ ist. Der `confidence`-Wert für ein `[PII]`-Tag stellt die Zuverlässigkeit dar, dass es sich bei dem Gesprochenen, das von Amazon Transcribe zur Schwärzung gekennzeichnet wurde, wirklich um personenbezogene Daten handelt. In der folgenden Transkriptausgabe `0.9999` bedeutet der Wert `confidence` von, dass zu 99,99 Prozent sicher Amazon Transcribe ist, dass es sich bei der Entität, die im Protokoll redigiert wurde, um personenbezogene Daten handelt.
## Beispiel für eine geschwärzte Ausgabe (Batch)
```
{
"jobName": "my-first-transcription-job",
"accountId": "111122223333",
"isRedacted": true,
"results": {
"transcripts": [
{
"transcript": "Good morning, everybody. My name is [PII], and today I feel like
sharing a whole lot of personal information with you. Let's start with my Social
Security number [PII]. My credit card number is [PII] and my C V V code is [PII].
I hope that Amazon Transcribe is doing a good job at redacting that personal
information away. Let's check."
}
],
"items": [
{
"id": 0,
"start_time": "2.86",
"end_time": "3.35",
"alternatives": [
{
"confidence": "1.0",
"content": "Good"
}
],
"type": "pronunciation"
},
Items removed for brevity
{
"id": 8,
"start_time": "5.56",
"end_time": "6.25",
"alternatives": [
{
"content": "[PII]",
"redactions": [
{
"confidence": "0.9999",
"type": "NAME",
"category": "PII"
}
]
}
],
"type": "pronunciation"
},
Items removed for brevity
],
},
"status": "COMPLETED"
}
```
Hier ist das ungekürzte Transkript zum Vergleich:
```
{
"jobName": "job id",
"accountId": "111122223333",
"isRedacted": false,
"results": {
"transcripts": [
{
"transcript": "Good morning, everybody. My name is Mike, and today I feel like
sharing a whole lot of personal information with you. Let's start with my Social
Security number 000000000. My credit card number is 5555555555555555
and my C V V code is 000. I hope that Amazon Transcribe is doing a good job
at redacting that personal information away. Let's check."
}
],
"items": [
{
"id": 0,
"start_time": "2.86",
"end_time": "3.35",
"alternatives": [
{
"confidence": "1.0",
"content": "Good"
}
],
"type": "pronunciation"
},
Items removed for brevity
{
"id": 8,
"start_time": "5.56",
"end_time": "6.25",
"alternatives": [
{
"confidence": "0.9999",
"content": "Mike",
{
],
"type": "pronunciation"
},
Items removed for brevity
],
},
"status": "COMPLETED"
}
```
## Beispiel für eine geschwärzte Streaming-Ausgaben
```
{
"TranscriptResultStream": {
"TranscriptEvent": {
"Transcript": {
"Results": [
{
"Alternatives": [
{
"Transcript": "my name is [NAME]",
"Items": [
{
"Content": "my",
"EndTime": 0.3799375,
"StartTime": 0.0299375,
"Type": "pronunciation"
},
{
"Content": "name",
"EndTime": 0.5899375,
"StartTime": 0.3899375,
"Type": "pronunciation"
},
{
"Content": "is",
"EndTime": 0.7899375,
"StartTime": 0.5999375,
"Type": "pronunciation"
},
{
"Content": "[NAME]",
"EndTime": 1.0199375,
"StartTime": 0.7999375,
"Type": "pronunciation"
}
],
"Entities": [
{
"Content": "[NAME]",
"Category": "PII",
"Type": "NAME",
"StartTime" : 0.7999375,
"EndTime" : 1.0199375,
"Confidence": 0.9989
}
]
}
],
"EndTime": 1.02,
"IsPartial": false,
"ResultId": "12345a67-8bc9-0de1-2f34-a5b678c90d12",
"StartTime": 0.0199375
}
]
}
}
}
}
```
## Beispiel für die Ausgabe der PII-Identifikation
Die PII-Identifikation ist eine zusätzliche Feature, die Sie bei Ihrem Streaming-Transkriptionsauftrag nutzen können. Die identifizierten PII sind im `Entities`-Abschnitt des jeweiligen Segments aufgeführt.
```
{
"TranscriptResultStream": {
"TranscriptEvent": {
"Transcript": {
"Results": [
{
"Alternatives": [
{
"Transcript": "my name is mike",
"Items": [
{
"Content": "my",
"EndTime": 0.3799375,
"StartTime": 0.0299375,
"Type": "pronunciation"
},
{
"Content": "name",
"EndTime": 0.5899375,
"StartTime": 0.3899375,
"Type": "pronunciation"
},
{
"Content": "is",
"EndTime": 0.7899375,
"StartTime": 0.5999375,
"Type": "pronunciation"
},
{
"Content": "mike",
"EndTime": 0.9199375,
"StartTime": 0.7999375,
"Type": "pronunciation"
}
],
"Entities": [
{
"Content": "mike",
"Category": "PII",
"Type": "NAME",
"StartTime" : 0.7999375,
"EndTime" : 1.0199375,
"Confidence": 0.9989
}
]
}
],
"EndTime": 1.02,
"IsPartial": false,
"ResultId": "12345a67-8bc9-0de1-2f34-a5b678c90d12",
"StartTime": 0.0199375
}
]
}
}
}
}
```