本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用更新事件数据存储 Amazon CLI
<a name="lake-cli-update-eds"></a>

本节提供的示例说明如何通过运行 Amazon CLI `update-event-data-store`命令来更新事件数据存储的设置。

**Topics**
+ [使用更新计费模式 Amazon CLI](#lake-cli-update-billing-mode)
+ [更新保留模式，启用终止保护，然后 Amazon KMS key 使用指定 Amazon CLI](#lake-cli-update-retention)
+ [使用禁用终止保护 Amazon CLI](#lake-cli-update-disable-termination)

## 使用更新计费模式 Amazon CLI
<a name="lake-cli-update-billing-mode"></a>

事件数据存储的 `--billing-mode` 决定了摄取和存储事件的成本，以及事件数据存储的默认和最长保留期。如果事件数据存储的 `--billing-mode` 设置为 `FIXED_RETENTION_PRICING`，则可以将该值更改为 `EXTENDABLE_RETENTION_PRICING`。如果您的事件数据存储每月摄取的事件数据少于 25TB，并且您希望采用最多 3653 天的灵活保留期，则通常建议使用 `EXTENDABLE_RETENTION_PRICING`。有关定价的信息，请参阅 [Amazon CloudTrail 定价](https://www.amazonaws.cn/cloudtrail/pricing/)和[管理 CloudTrail 湖泊成本](cloudtrail-lake-manage-costs.md)。

**注意**  
您不能将 `--billing-mode` 值从 `EXTENDABLE_RETENTION_PRICING` 更改为 `FIXED_RETENTION_PRICING`。如果事件数据存储的计费模式设置为 `EXTENDABLE_RETENTION_PRICING`，且您想改用 `FIXED_RETENTION_PRICING`，则可以[停止对事件数据存储的摄取](lake-cli-manage-eds.md#lake-cli-stop-ingestion-eds)，并创建一个使用 `FIXED_RETENTION_PRICING` 的新事件数据存储。

以下示例 Amazon CLI **update-event-data-store**命令将事件数据存储`--billing-mode`的命令从更改`FIXED_RETENTION_PRICING`为`EXTENDABLE_RETENTION_PRICING`。必要的 `--event-data-store` 参数值是 ARN（或 ARN 的 ID 后缀），且是必填项；其它参数是可选项。

```
aws cloudtrail update-event-data-store \
--region us-east-1 \
--event-data-store arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE \
--billing-mode EXTENDABLE_RETENTION_PRICING
```

以下为响应示例。

```
{
    "EventDataStoreArn": "event-data-store arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE",
    "Name": "management-events-eds",
    "Status": "ENABLED",
    "AdvancedEventSelectors": [
        {
            "Name": "Default management events",
            "FieldSelectors": [
                {
                    "Field": "eventCategory",
                    "Equals": [
                        "Management"
                    ]
                }
            ]
        }
    ],
    "MultiRegionEnabled": true,
    "OrganizationEnabled": false,
    "BillingMode": "EXTENDABLE_RETENTION_PRICING",
    "RetentionPeriod": 2557,
    "TerminationProtectionEnabled": true,
    "CreatedTimestamp": "2023-10-27T10:55:55.384000-04:00",
    "UpdatedTimestamp": "2023-10-27T10:57:05.549000-04:00"
}
```

## 更新保留模式，启用终止保护，然后 Amazon KMS key 使用指定 Amazon CLI
<a name="lake-cli-update-retention"></a>

以下示例 Amazon CLI **update-event-data-store**命令更新事件数据存储以将其保留期更改为 100 天，并启用终止保护。必要的 `--event-data-store` 参数值是 ARN（或 ARN 的 ID 后缀），且是必填项；其它参数是可选项。在此示例中，添加了 `--retention-period` 参数，以将保留期限更改为 100 天。或者，您可以选择启用 Amazon Key Management Service 加密并 Amazon KMS key 通过在命令中添加并`--kms-key-id`指定 KMS 密钥 ARN 作为值来指定。 `--termination-protection-enabled`添加是为了在未启用终止保护的事件数据存储上启用终止保护。

 Amazon 无法更新记录外部事件的事件数据存储以记录 Amazon 事件。同样，记录 Amazon 事件的事件数据存储不能更新为从外部记录事件 Amazon。

**注意**  
如果您缩短了事件数据存储的保留期，则 CloudTrail 会删除所有保留期`eventTime`早于新保留期的事件。例如，如果之前的保留期为 365 天，而您将其缩短为 100 天，则 CloudTrail 会移除`eventTime`超过 100 天的事件。

```
aws cloudtrail update-event-data-store \
--event-data-store arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE \
--retention-period 100 \
--kms-key-id "arn:aws:kms:us-east-1:0123456789:alias/{{KMS_key_alias}}" \
--termination-protection-enabled
```

以下为响应示例。

```
{
    "EventDataStoreArn": "arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLE-ee54-4813-92d5-999aeEXAMPLE",
    "Name": "my-event-data-store",
    "Status": "ENABLED",
    "AdvancedEventSelectors": [
        {
            "Name": "Select all S3 data events",
            "FieldSelectors": [
                {
                    "Field": "eventCategory",
                    "Equals": [
                        "Data"
                    ]
                },
                {
                    "Field": "resources.type",
                    "Equals": [
                        "AWS::S3::Object"
                    ]
                },
                {
                    "Field": "resources.ARN",
                    "StartsWith": [
                        "arn:aws:s3"
                    ]
                }
            ]
        }
    ],
    "MultiRegionEnabled": true,
    "OrganizationEnabled": false,
    "BillingMode": "EXTENDABLE_RETENTION_PRICING",
    "RetentionPeriod": 100,
    "KmsKeyId": "arn:aws:kms:us-east-1:0123456789:alias/{{KMS_key_alias}}",
    "TerminationProtectionEnabled": true,
    "CreatedTimestamp": "2023-10-27T10:55:55.384000-04:00",
    "UpdatedTimestamp": "2023-10-27T10:57:05.549000-04:00"
}
```

## 使用禁用终止保护 Amazon CLI
<a name="lake-cli-update-disable-termination"></a>

默认情况下，事件数据存储已启用终止保护，以防止事件数据存储被意外删除。当终止保护启用时，您无法删除事件数据存储。如果要删除事件数据存储，您必须先禁用终止保护。

以下示例 Amazon CLI **update-event-data-store**命令通过传递`--no-termination-protection-enabled`参数来禁用终止保护。

```
aws cloudtrail update-event-data-store \
--region us-east-1 \
--no-termination-protection-enabled \
--event-data-store arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE
```

以下为响应示例。

```
{
    "EventDataStoreArn": "arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE",
    "Name": "management-events-eds",
    "Status": "ENABLED",
    "AdvancedEventSelectors": [
        {
            "Name": "Default management events",
            "FieldSelectors": [
                {
                    "Field": "eventCategory",
                    "Equals": [
                        "Management"
                    ]
                }
            ]
        }
    ],
    "MultiRegionEnabled": true,
    "OrganizationEnabled": false,
    "BillingMode": "EXTENDABLE_RETENTION_PRICING",
    "RetentionPeriod": 366,
    "TerminationProtectionEnabled": false,
    "CreatedTimestamp": "2023-10-27T10:55:55.384000-04:00",
    "UpdatedTimestamp": "2023-10-27T10:57:05.549000-04:00"
}
```