翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用した Amazon Translate API コールのログ記録AWS CloudTrail
Amazon Translate はAWS CloudTrail、Amazon Translate の IAM エンティティまたはサービスによって実行されたアクションを記録するAWSサービスである Amazon Translate と統合されています。CloudTrail は、Amazon Translate へのすべての API コールをイベントとしてキャプチャします。これには、Amazon Translate コンソールからのコールと、Amazon Translate API オペレーションへのコードコールが含まれます。CloudTrail 追跡を作成すると、Amazon Simple Storage Service (Amazon S3) バケットへの Amazon Translate イベントなど、CloudTrail のイベントの継続的な配信が可能になります。証跡を設定しない場合でも、CloudTrail コンソールの [イベント履歴] で最新のイベントを表示できます。CloudTrail で収集された情報を使用して、Amazon Translate に対するリクエスト、リクエスト元の IP アドレス、リクエストの実行者、リクエスト日時などの詳細を把握できます。
CloudTrail の詳細については、「AWS CloudTrailユーザーガイド」を参照してください。
CloudTrail における Amazon Translate の情報
CloudTrail は、AWSアカウントの作成時にアカウントで有効になります。Amazon Translate でアクティビティが発生すると、そのアクティビティはイベント履歴の他のAWSサービスイベントとともに CloudTrail イベントに記録されます。AWSアカウントで最近のイベントを表示、検索、ダウンロードできます。詳細については、CloudTrail イベント履歴でのイベントの表示を参照してください。
Amazon Translate のイベントなど、AWSアカウントのイベントの継続的な記録については、証跡を作成します。証跡により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。デフォルトでは、コンソールで作成した証跡がすべての AWS リージョンに適用されます。証跡では、AWSパーティションのすべてのリージョンからのイベントがログに記録され、指定した S3 バケットにログファイルが配信されます。CloudTrail ログで収集されたイベントデータをさらに分析して処理するように、他のAWSサービスを設定できます。詳細については、次を参照してください:
Amazon Translate のすべてのアクションは CloudTrail によってログとして記録され、API リファレンスセクションに記載されます。例えば、DeleteTerminology、ImportTerminology、TranslateText の各アクションを呼び出すと、CloudTrail ログファイルにエントリが生成されます。
各イベントまたはログエントリには、リクエストの生成者に関する情報が含まれます。この情報は以下のことを確認するのに役立ちます:
-
リクエストが、ルートユーザーの認証情報で行われたかどうか
-
リクエストの送信に使用された一時的なセキュリティ認証情報に、ロールとフェデレーテッドユーザーのどちらが使用されたか
-
リクエストが別のAWSサービスによって行われたかどうか
詳細については、「CloudTrail userIdentity エレメント」を参照してください。
Amazon Translate ログファイルエントリの概要
「トレイル」は、指定した Simple Storage Service (Amazon S3) バケットにイベントをログファイルとして配信するように設定できます。CloudTrail のログファイルは、単一か複数のログエントリを含みます。イベントは、任意の出典からの単一のリクエストを表し、リクエストされたアクション、アクションの日時、リクエストパラメータなどに関する情報が含まれます。CloudTrail ログファイルは、パブリック API コールの順序付けられたスタックトレースではないため、特定の順序では表示されません。
以下の例は、TranslateText アクションを示す CloudTrail ログエントリです。
{ "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/Administrator", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "Administrator" }, "eventTime": "2019-09-03T20:32:50Z", "eventSource": "translate.amazonaws.com", "eventName": "TranslateText", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "aws-cli/1.16.207 Python/3.4.7 Linux/4.9.184-0.1.ac.235.83.329.metal1.x86_64 botocore/1.12.197", "requestParameters": { "text": "HIDDEN_DUE_TO_SECURITY_REASONS", "sourceLanguageCode": "en", "targetLanguageCode": "fr" }, "responseElements": { "translatedText": "HIDDEN_DUE_TO_SECURITY_REASONS", "sourceLanguageCode": "en", "targetLanguageCode": "fr" }, "requestID": "f56da956-284e-4983-b6fc-59befa20e2bf", "eventID": "1dc75278-84d7-4bb2-861a-493d08d67391", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" }