我们不再更新 Amazon Machine Learning 服务，也不再接受新用户使用该服务。本文档可供现有用户使用，但我们不会再对其进行更新。有关更多信息，请参阅[什么是 Amazon Machine Learning](https://docs.aws.amazon.com/machine-learning/latest/dg/what-is-amazon-machine-learning.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用记录亚马逊 ML API 调用 AWS CloudTrail
Amazon Mac AWS hine Learning (Amazon ML) AWS CloudTrail与一项服务集成，可记录用户、角色或服务在 Amazon ML 中执行的操作。 CloudTrail 将所有 Amazon ML 的 API 调用捕获为事件。捕获调用中包括通过 Amazon ML 控制台的调用和对 Amazon ML API 操作的代码调用。如果您创建了跟踪，则可以允许将 CloudTrail 事件持续传输到 Amazon S3 存储桶，包括 Amazon ML 的事件。如果您未配置跟踪，您仍然可以在 CloudTrail 控制台的 “事件**历史记录” 中查看最新的事件**。通过收集的信息 CloudTrail，您可以确定向 Amazon ML 发出的请求、发出请求的 IP 地址、谁提出了请求、何时提出请求以及其他详细信息。
要了解更多信息 CloudTrail，包括如何配置和启用它，请参阅《[AWS CloudTrail 用户指南》](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
## 中的亚马逊 ML 信息 CloudTrail
CloudTrail 在您创建 AWS 账户时已在您的账户上启用。当 Amazon ML 中出现支持的事件活动时，该活动会与其他 AWS 服务 CloudTrail 事件一起记录在**事件历史**记录中。您可以在自己的 AWS 账户中查看、搜索和下载最近发生的事件。有关更多信息，请参阅[使用事件历史记录查看 CloudTrail 事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。
要持续记录您的 AWS 账户中的事件，包括 Amazon ML 的事件，请创建跟踪。*跟踪*允许 CloudTrail 将日志文件传输到 Amazon S3 存储桶。默认情况下，在控制台中创建跟踪记录时，此跟踪记录应用于所有 AWS 区域。跟踪记录 AWS 分区中所有区域的事件，并将日志文件传送到您指定的 Amazon S3 存储桶。此外，您可以配置其他 AWS 服务，以进一步分析和处理 CloudTrail 日志中收集的事件数据。有关更多信息，请参阅下列内容：
+ [创建跟踪概述](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail 支持的服务和集成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [配置 Amazon SNS 通知 CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [接收来自多个区域的 CloudTrail 日志文件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)和[接收来自多个账户的 CloudTrail日志文件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Amazon ML 支持将以下操作作为事件记录在 CloudTrail 日志文件中：
+ [AddTags](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_AddTags.html)
+ [CreateBatchPrediction](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateBatchPrediction.html)
+ [CreateDataSourceFromRDS](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateDataSourceFromRDS.html)
+ [CreateDataSourceFromRedshift](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateDataSourceFromRedshift.html)
+ [CreateDataSourceFromS3](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateDataSourceFromS3.html)
+ [CreateEvaluation](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateEvaluation.html)
+ [创建MLModel](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateMLModel.html)
+ [CreateRealtimeEndpoint](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateRealtimeEndpoint.html)
+ [DeleteBatchPrediction](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DeleteBatchPrediction.html)
+ [DeleteDataSource](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DeleteDataSource.html)
+ [DeleteEvaluation](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DeleteEvaluation.html)
+ [删除MLModel](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DeleteMLModel.html)
+ [DeleteRealtimeEndpoint](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DeleteRealtimeEndpoint.html)
+ [DeleteTags](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DeleteTags.html)
+ [DescribeTags](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DescribeTags.html)
+ [UpdateBatchPrediction](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_UpdateBatchPrediction.html)
+ [UpdateDataSource](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_UpdateDataSource.html)
+ [UpdateEvaluation](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_UpdateEvaluation.html)
+ [更新MLModel](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_UpdateMLModel.html)
以下 Amazon ML 操作使用包含凭证的请求参数。在将这些请求发送到之前 CloudTrail，证书将替换为三个星号 (“\$1\$1\$1”)：
+ [CreateDataSourceFromRDS](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateDataSourceFromRDS.html)
+ [CreateDataSourceFromRedshift](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateDataSourceFromRedshift.html)
使用 Amazon ML 控制台执行以下 Amazon ML 操作时，`ComputeStatistics`该属性不包含在 CloudTrail 日志的`RequestParameters`组成部分中：
+ [CreateDataSourceFromRedshift](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateDataSourceFromRedshift.html)
+ [CreateDataSourceFromS3](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_CreateDataSourceFromS3.html)
每个事件或日志条目都包含有关生成请求的人员信息。身份信息有助于您确定以下内容：
+ 请求是使用根证书还是 AWS Identity and Access Management (IAM) 用户凭证发出。
+ 请求是使用角色还是联合用户的临时安全凭证发出的。
+ 请求是否由其他 AWS 服务发出。
有关更多信息，请参阅 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。
## 示例：Amazon ML 日志文件条目
跟踪是一种配置，允许将事件作为日志文件传输到您指定的 Amazon S3 存储桶。 CloudTrail 日志文件包含一个或多个日志条目。事件代表来自任何来源的单个请求，包括有关请求的操作、操作的日期和时间、请求参数等的信息。 CloudTrail 日志文件不是公共 API 调用的有序堆栈跟踪，因此它们不会按任何特定的顺序出现。
以下示例显示了演示该操作的 CloudTrail 日志条目。
```
{
"Records": [
{
"eventVersion": "1.03",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::012345678910:user/Alice",
"accountId": "012345678910",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2015-11-12T15:04:02Z",
"eventSource": "machinelearning.amazonaws.com",
"eventName": "CreateDataSourceFromS3",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "console.amazonaws.com",
"requestParameters": {
"data": {
"dataLocationS3": "s3://aml-sample-data/banking-batch.csv",
"dataSchema": "{\"version\":\"1.0\",\"rowId\":null,\"rowWeight\":null,
\"targetAttributeName\":null,\"dataFormat\":\"CSV\",
\"dataFileContainsHeader\":false,\"attributes\":[
{\"attributeName\":\"age\",\"attributeType\":\"NUMERIC\"},
{\"attributeName\":\"job\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"marital\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"education\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"default\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"housing\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"loan\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"contact\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"month\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"day_of_week\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"duration\",\"attributeType\":\"NUMERIC\"},
{\"attributeName\":\"campaign\",\"attributeType\":\"NUMERIC\"},
{\"attributeName\":\"pdays\",\"attributeType\":\"NUMERIC\"},
{\"attributeName\":\"previous\",\"attributeType\":\"NUMERIC\"},
{\"attributeName\":\"poutcome\",\"attributeType\":\"CATEGORICAL\"},
{\"attributeName\":\"emp_var_rate\",\"attributeType\":\"NUMERIC\"},
{\"attributeName\":\"cons_price_idx\",\"attributeType\":\"NUMERIC\"},
{\"attributeName\":\"cons_conf_idx\",\"attributeType\":\"NUMERIC\"},
{\"attributeName\":\"euribor3m\",\"attributeType\":\"NUMERIC\"},
{\"attributeName\":\"nr_employed\",\"attributeType\":\"NUMERIC\"}
],\"excludedAttributeNames\":[]}"
},
"dataSourceId": "exampleDataSourceId",
"dataSourceName": "Banking sample for batch prediction"
},
"responseElements": {
"dataSourceId": "exampleDataSourceId"
},
"requestID": "9b14bc94-894e-11e5-a84d-2d2deb28fdec",
"eventID": "f1d47f93-c708-495b-bff1-cb935a6064b2",
"eventType": "AwsApiCall",
"recipientAccountId": "012345678910"
},
{
"eventVersion": "1.03",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::012345678910:user/Alice",
"accountId": "012345678910",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2015-11-11T15:24:05Z",
"eventSource": "machinelearning.amazonaws.com",
"eventName": "CreateBatchPrediction",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "console.amazonaws.com",
"requestParameters": {
"batchPredictionName": "Batch prediction: ML model: Banking sample",
"batchPredictionId": "exampleBatchPredictionId",
"batchPredictionDataSourceId": "exampleDataSourceId",
"outputUri": "s3://EXAMPLE_BUCKET/BatchPredictionOutput/",
"mLModelId": "exampleModelId"
},
"responseElements": {
"batchPredictionId": "exampleBatchPredictionId"
},
"requestID": "3e18f252-8888-11e5-b6ca-c9da3c0f3955",
"eventID": "db27a771-7a2e-4e9d-bfa0-59deee9d936d",
"eventType": "AwsApiCall",
"recipientAccountId": "012345678910"
}
]
}
```