Menggunakan ExpirationSettings pesan Amazon Chime SDK

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

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

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.

Mengkonfigurasi ExpirationSettings

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

Melakukan konfigurasi ExpirationSettings saat Anda membuat sumber daya

Anda dapat mengonfigurasi ExpirationSettings saat menjalankan CreateAppInstanceUser atau CreateChannel APIs. Jika Anda mengatur ExpirationSettings parameter, Anda harus memberikan izin IAM berikut:

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

Anda juga dapat menggunakan PutAppInstanceUserExpirationSettings dan PutChannelExpirationSettings APIs 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"
}