Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menggunakan ExpirationSettings pesan Amazon Chime SDK
<a name="expiration"></a>

Saat Anda membuat `AppInstanceUser` atau a`Channel`, Anda dapat menggunakan `ExpirationSettings` untuk mengonfigurasi sumber daya tersebut untuk penghapusan otomatis. `ExpirationSettings`membantu mengurangi biaya penyimpanan dan mencegah resource-limit-exceeded masalah. Misalnya, Anda dapat menghapus saluran yang tidak digunakan setelah 7 hari, atau menghapus saluran `AppInstanceUser` yang hanya dipanggil untuk tujuan pengujian.

Untuk`AppInstanceUser`, Anda menentukan periode kedaluwarsa berdasarkan waktu pembuatan pengguna. Untuk`Channel`, Anda menentukan periode kedaluwarsa berdasarkan waktu pembuatan saluran, atau waktu pesan terakhir. Yang terakhir memungkinkan Anda menggunakan aktivitas pesan untuk menyesuaikan penghapusan otomatis.

**penting**  
Tak lama setelah sumber daya kedaluwarsa, `ExpirationSettings` mulailah proses latar belakang untuk menghapus sumber daya tersebut. Prosesnya biasanya memakan waktu 6 jam, tetapi waktu itu dapat bervariasi.  
Kedaluwarsa `AppInstanceUsers` dan `Channels` yang belum dihapus masih tampak valid dan aktif. Anda dapat memperbarui atau menghapus pengaturan kedaluwarsa mereka, dan sistem menghormati perubahan Anda.

**Topics**
+ [Mengkonfigurasi ExpirationSettings](#create-expiration)
+ [AWS CloudTrail acara untuk penghapusan sumber daya yang kedaluwarsa](#ct-events)

## Mengkonfigurasi ExpirationSettings
<a name="create-expiration"></a>

Bagian berikut menjelaskan cara mengkonfigurasi `ExpirationSettings` dari sebuah `AppInstanceUser` atau a`Channel`. 

### Mengkonfigurasi ExpirationSettings saat Anda membuat sumber daya
<a name="configure-on-create"></a>

Anda dapat mengkonfigurasi `ExpirationSettings` ketika Anda menjalankan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateAppInstanceUser.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateAppInstanceUser.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html) APIs. Jika Anda mengatur `ExpirationSettings` parameter, Anda harus memberikan izin IAM berikut:
+ `chime:PutAppInstanceUserExpirationSettings`saat membuat `AppInstanceUser`
+ `chime:PutChannelExpirationSettings`saat membuat`Channel`.

Contoh berikut menggunakan AWS CLI untuk membuat `AppInstanceUser` yang kedaluwarsa setelah sehari.

```
aws chime-sdk-identity create-app-instance-user \
--app-instance-arn "app_instance_arn" \
--app-instance-user-id "backend-worker" \
--name "backend-worker" \
--expiration-settings '{
            "ExpirationDays": 1,
            "ExpirationCriterion": "CREATED_TIMESTAMP"
        }'
```

Contoh berikut menggunakan AWS CLI untuk membuat `Channel` yang kedaluwarsa setelah sehari setelah terakhir menerima pesan.

```
aws chime-sdk-messaging create-channel \
--chime-bearer "app_instance_user_arn" \
--app-instance-arn "app_instance_arn" \
--name "firstChannel" \
--expiration-settings '{
            "ExpirationDays": 1,
            "ExpirationCriterion": "LAST_MESSAGE_TIMESTAMP"
        }'
```

### Menggunakan Put APIs untuk mengkonfigurasi ExpirationSettings
<a name="configure-on-put"></a>

Anda juga dapat menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_PutAppInstanceUserExpirationSettings.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_PutAppInstanceUserExpirationSettings.html)dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutChannelExpirationSettings.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutChannelExpirationSettings.html) APIs untuk membuat, memperbarui, dan menghapus`ExpirationSettings`. 

Contoh berikut menunjukkan Anda untuk menggunakan AWS CLI untuk memperbarui an`AppInstanceUser`. `ExpirationSettings`

```
aws chime-sdk-identity put-app-instance-user-expiration-settings \
--app-instance-user-arn "app_instance_user_arn" \
--expiration-settings '{
            "ExpirationDays": 30,
            "ExpirationCriterion": "CREATED_TIMESTAMP"
        }'
```

Contoh berikut menunjukkan Anda untuk menggunakan AWS CLI untuk menghapus saluran. `ExpirationSettings`

```
aws chime-sdk-messaging put-channel-expiration-settings \
--chime-bearer "app_instance_user_arn" \
--channel-arn "channel_arn"
```

## AWS CloudTrail acara untuk penghapusan sumber daya yang kedaluwarsa
<a name="ct-events"></a>

Setelah sistem menghapus sumber daya yang kedaluwarsa, ia mengirimkan `ExpireChannel` acara `ExpireAppInstanceUser` atau ke. AWS CloudTrail Jenis acara tergantung pada jenis aset yang dihapus.

Contoh berikut menunjukkan suatu `AppInstanceUser` peristiwa.

```
{
    "eventVersion": "1.08",
    "userIdentity": {
        "accountId": "123456789012",
        "invokedBy": "chime.amazonaws.com"
    },
    "eventTime": "2023-03-15T00:00:00Z",
    "eventSource": "chime.amazonaws.com",
    "eventName": "ExpireAppInstanceUser",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "chime.amazonaws.com",
    "userAgent": "chime.amazonaws.com",
    "requestParameters": null,
    "responseElements": null,
    "eventID": "12345678-1234-1234-1234-123456789012",
    "readOnly": false,
    "resources": [
        {
            "accountId": "123456789012",
            "type": "AWS::Chime::AppInstanceUser",
            "ARN": "arn:aws:chime:us-east-1:123456789012:app-instance/app-instance-id/user/user-id"
        }
    ],
    "eventType": "AwsServiceEvent",
    "managementEvent": true,
    "recipientAccountId": "123456789012",
    "serviceEventDetails": {
        "reason": "AppInstanceUser deleted due to expiration settings."
    },
    "eventCategory": "Management"
}
```