Menggunakan ExpirationSettings

Saat Anda membuat AppInstanceUser atau aChannel, Anda dapat menggunakan ExpirationSettings untuk mengonfigurasi sumber daya tersebut untuk penghapusan otomatis. ExpirationSettingsmembantu 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.

UntukAppInstanceUser, Anda menentukan periode kedaluwarsa berdasarkan waktu pembuatan pengguna. UntukChannel, 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.

Mengkonfigurasi ExpirationSettings

Bagian berikut menjelaskan cara mengkonfigurasi ExpirationSettings dari sebuah AppInstanceUser atau aChannel.

Mengkonfigurasi ExpirationSettings saat Anda membuat sumber daya

Anda dapat mengonfigurasi ExpirationSettings saat menjalankan CreateChannelAPI CreateAppInstanceUseratau. Jika Anda mengatur ExpirationSettings parameter, Anda harus memberikan izin IAM berikut:

• chime:PutAppInstanceUserExpirationSettingssaat membuat AppInstanceUser

• chime:PutChannelExpirationSettingssaat membuatChannel.

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 API untuk mengkonfigurasi ExpirationSettings

Anda juga dapat menggunakan PutChannelExpirationSettingsAPI PutAppInstanceUserExpirationSettingsdan untuk membuat, memperbarui, dan menghapusExpirationSettings.

Contoh berikut menunjukkan Anda untuk menggunakan AWS CLI untuk memperbarui anAppInstanceUser. 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

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"
}