翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# を使用した Managed Integrations API コールのログ記録 AWS CloudTrail
マネージド統合は、ユーザー[AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)、ロール、または によって実行されたアクションを記録するサービスである と統合されています AWS のサービス。CloudTrail は、マネージド統合のすべての API コールをイベントとしてキャプチャします。キャプチャされた呼び出しには、マネージド統合コンソールからの呼び出しと、マネージド統合 API オペレーションへのコード呼び出しが含まれます。CloudTrail で収集された情報を使用して、マネージド統合に対するリクエスト、リクエスト元の IP アドレス、リクエスト日時などの詳細を確認できます。
各イベントまたはログエントリには、誰がリクエストを生成したかという情報が含まれます。アイデンティティ情報は、以下を判別するのに役立ちます。
+ ルートユーザーまたはユーザー認証情報のどちらを使用してリクエストが送信されたか。
+ リクエストが IAM Identity Center ユーザーに代わって行われたかどうか。
+ リクエストがロールまたはフェデレーションユーザーのテンポラリなセキュリティ認証情報を使用して行われたかどうか。
+ リクエストが、別の AWS のサービスによって送信されたかどうか。
CloudTrail は、アカウントを作成する AWS アカウント と でアクティブになり、CloudTrail **イベント履歴**に自動的にアクセスできます。CloudTrail の **[イベント履歴]** では、 AWS リージョンで過去 90 日間に記録された 管理イベントの表示、検索、およびダウンロードが可能で、変更不可能な記録を確認できます。詳細については、「*AWS CloudTrail ユーザーガイド*」の「[CloudTrail イベント履歴の使用](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)」を参照してください。**[イベント履歴]** の閲覧には CloudTrail の料金はかかりません。
AWS アカウント 過去 90 日間のイベントの継続的な記録については、証跡または [CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) イベントデータストアを作成します。
**CloudTrail 証跡**
*証跡*により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。を使用して作成されたすべての証跡 AWS マネジメントコンソール はマルチリージョンです。 AWS CLIを使用する際は、単一リージョンまたは複数リージョンの証跡を作成できます。アカウント AWS リージョン 内のすべての でアクティビティをキャプチャするため、マルチリージョン証跡を作成することをお勧めします。単一リージョンの証跡を作成する場合、証跡の AWS リージョンに記録されたイベントのみを表示できます。証跡の詳細については、「*AWS CloudTrail ユーザーガイド*」の「[AWS アカウントの証跡の作成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)」および「[組織の証跡の作成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-trail-organization.html)」を参照してください。
証跡を作成すると、進行中の管理イベントのコピーを 1 つ無料で CloudTrail から Amazon S3 バケットに配信できますが、Amazon S3 ストレージには料金がかかります。CloudTrail の料金の詳細については、「[AWS CloudTrail の料金](https://aws.amazon.com/cloudtrail/pricing/)」を参照してください。Amazon S3 の料金に関する詳細については、「[Amazon S3 の料金](https://aws.amazon.com/s3/pricing/)」を参照してください。
**CloudTrail Lake イベントデータストア**
*[CloudTrail Lake]* を使用すると、イベントに対して SQL ベースのクエリを実行できます。CloudTrail Lake は、行ベースの JSON 形式の既存のイベントを [Apache ORC](https://orc.apache.org/) 形式に変換します。ORC は、データを高速に取得するために最適化された単票ストレージ形式です。イベントは、*イベントデータストア*に集約されます。イベントデータストアは、[高度なイベントセレクタ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors)を適用することによって選択する条件に基づいた、イベントのイミュータブルなコレクションです。どのイベントが存続し、クエリに使用できるかは、イベントデータストアに適用するセレクタが制御します。CloudTrail Lake の詳細については、 *AWS CloudTrail ユーザーガイド*の[AWS CloudTrail 「Lake の使用](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html)」を参照してください。
CloudTrail Lake のイベントデータストアとクエリにはコストがかかります。イベントデータストアを作成する際に、イベントデータストアに使用する[料金オプション](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option)を選択します。料金オプションによって、イベントの取り込みと保存にかかる料金、および、そのイベントデータストアのデフォルトと最長の保持期間が決まります。CloudTrail の料金の詳細については、「[AWS CloudTrail の料金](https://aws.amazon.com/cloudtrail/pricing/)」を参照してください。
## CloudTrail でイベントを管理する
[管理イベント](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)は、 のリソースで実行される管理オペレーションに関する情報を提供します AWS アカウント。これらのイベントは、コントロールプレーンオペレーションとも呼ばれます。CloudTrail は、デフォルトで管理イベントをログ記録します。
マネージド統合は、以下のマネージド統合コントロールプレーンオペレーション*を管理イベント*として CloudTrail に記録します。
+ `CreateCloudConnector`
+ `UpdateCloudConnector`
+ `GetCloudConnector`
+ `DeleteCloudConnector`
+ `ListCloudConnectors`
+ `CreateConnectorDestination`
+ `UpdateConnectorDestination`
+ `GetConnectorDestination`
+ `DeleteConnectorDestination`
+ `ListConnectorDestinations`
+ `CreateAccountAssociation`
+ `UpdateAccountAssociation`
+ `GetAccountAssociation`
+ `DeleteAccountAssociation`
+ `ListAccountAssociations`
+ `StartAccountAssociationRefresh`
+ `ListManagedThingAccountAssociations`
+ `RegisterAccountAssociation`
+ `DeregisterAccountAssociation`
+ `SendConnectorEvent`
+ `ListDeviceDiscoveries`
+ `ListDiscoveredDevices`
## イベント例
各イベントは任意の送信元からの単一のリクエストを表し、リクエストされた API オペレーション、オペレーションの日時、リクエストパラメータなどに関する情報を含みます。CloudTrail ログファイルは、パブリック API コールの順序付けられたスタックトレースではないため、イベントは特定の順序で表示されません。
次の例は、正常な `CreateCloudConnector` API オペレーションを示す CloudTrail イベントを示しています。
**`CreateCloudConnector` API オペレーションで成功した CloudTrail イベント。**
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EXAMPLE",
"arn": "arn:aws:sts::111122223333:assumed-role/Admin/EXAMPLE",
"accountId": "111122223333",
"accessKeyId": "EXAMPLEKYSBQSCGRIC",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AROAZOZQFKYSFZVB2J2GN",
"arn": "arn:aws:iam::111122223333:role/Admin",
"accountId": "111122223333",
"userName": "Admin"
},
"attributes": {
"creationDate": "2025-06-05T18:26:16Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2025-06-05T18:30:40Z",
"eventSource": "iotmanagedintegrations.amazonaws.com",
"eventName": "CreateCloudConnector",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "PostmanRuntime/7.44.0",
"requestParameters": {
"EndpointType": "LAMBDA",
"Description": "Manual testing for C2C CT Validation",
"ClientToken": "abc7460",
"EndpointConfig": {
"lambda": {
"arn": "arn:aws:lambda:us-east-1:111122223333:function:LightweightMockConnector7460"
}
},
"Name": "EdenManualTestCloudConnector"
},
"responseElements": {
"X-Frame-Options": "DENY",
"Access-Control-Expose-Headers": "Content-Length,Content-Type,X-Amzn-Errortype,X-Amzn-Requestid",
"Strict-Transport-Security": "max-age:47304000; includeSubDomains",
"Cache-Control": "no-store, no-cache",
"X-Content-Type-Options": "nosniff",
"Content-Security-Policy": "upgrade-insecure-requests; default-src 'none'; object-src 'none'; frame-ancestors 'none'; base-uri 'none'",
"Pragma": "no-cache",
"Id": "f7e633e719404c4a933596b4d0cc276e",
"Arn": "arn:aws:iotmanagedintegrations:us-east-1:111122223333:cloud-connector/EXAMPLE404c4a933596b4d0cc276e"
},
"requestID": "c0071fd1-b8e0-400a-bcc0-EXAMPLE9e4",
"eventID": "95b318ea-2f63-4183-9c22-EXAMPLE3e",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "111122223333",
"eventCategory": "Management"
}
```
次の例は、正常な `ListDiscoveredDevices` API オペレーションを示す CloudTrail イベントを示しています。
**`ListDiscoveredDevices` API オペレーションで成功した CloudTrail イベント。**
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EZAMPLE",
"arn": "arn:aws:sts::444455556666:assumed-role/Admin/EXAMPLE",
"accountId": "444455556666",
"accessKeyId": "EXAMPLERJ26PYMH",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "EXAMPLE",
"arn": "arn:aws:iam::444455556666:role/Admin",
"accountId": "444455556666",
"userName": "Admin"
},
"attributes": {
"creationDate": "2025-06-10T23:37:31Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2025-06-10T23:38:07Z",
"eventSource": "iotmanagedintegrations.amazonaws.com",
"eventName": "ListDiscoveredDevices",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "EXAMPLE-runtime/2.4.0",
"requestParameters": {
"Identifier": "EXAMPLE4f268483a17d8060f014"
},
"responseElements": null,
"requestID": "27ae1f61-e2e6-43e4-bf17-EXAMPLEa568",
"eventID": "34734e81-76a8-49a4-9641-EXAMPLE28ed",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "444455556666",
"eventCategory": "Management"
}
```
CloudTrail レコードの内容については、「*AWS CloudTrail ユーザーガイド*」の「[CloudTrail record contents](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html)」を参照してください。