Benutzen ExpirationSettings

Wenn du eine AppInstanceUser oder eine erstellstChannel, kannst du sie verwenden, ExpirationSettings um diese Ressourcen für das automatische Löschen zu konfigurieren. ExpirationSettingsträgt dazu bei, die Speicherkosten zu senken und resource-limit-exceeded Probleme zu vermeiden. Sie können beispielsweise ungenutzte Kanäle nach 7 Tagen löschen oder Kanäle löschen, AppInstanceUser die nur zu Testzwecken aufgerufen wurden.

Für eine AppInstanceUser geben Sie den Ablaufzeitraum auf der Grundlage der Benutzererstellungszeit an. Für a Channel geben Sie den Ablaufzeitraum auf der Grundlage der Erstellungszeit des Kanals oder der Zeit der letzten Nachricht an. Letzteres ermöglicht es Ihnen, Nachrichtenaktivitäten zu verwenden, um das automatische Löschen anzupassen.

Wichtig

ExpirationSettingsStartet kurz nach Ablauf einer Ressource einen Hintergrundprozess zum Löschen dieser Ressource. Der Vorgang dauert normalerweise 6 Stunden, diese Zeit kann jedoch variieren.

Abgelaufen AppInstanceUsers und Channels noch nicht gelöschte Dateien werden weiterhin als gültig und aktiv angezeigt. Sie können ihre Ablaufeinstellungen aktualisieren oder entfernen, und das System berücksichtigt Ihre Änderungen.

Konfiguration ExpirationSettings

In den folgenden Abschnitten wird erklärt, wie Sie den ExpirationSettings von an AppInstanceUser oder a konfigurierenChannel.

KonfigurationExpirationSettings, wenn Sie eine Ressource erstellen

Sie können konfigurierenExpirationSettings, wann Sie die CreateChannelAPIs CreateAppInstanceUseroder ausführen. Wenn Sie den ExpirationSettings Parameter festlegen, müssen Sie die folgenden IAM-Berechtigungen gewähren:

• chime:PutAppInstanceUserExpirationSettingsbeim Erstellen eines AppInstanceUser

• chime:PutChannelExpirationSettingsbeim Erstellen einesChannel.

Das folgende Beispiel verwendet die AWS CLI, um eine zu erstellenAppInstanceUser, die nach einem Tag abläuft.

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

Das folgende Beispiel verwendet die AWS CLI, um eine zu erstellenChannel, die nach einem Tag nach dem letzten Empfang einer Nachricht abläuft.

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

Verwenden von Put-APIs zur Konfiguration ExpirationSettings

Sie können die PutChannelExpirationSettingsAPIs PutAppInstanceUserExpirationSettingsund auch zum Erstellen, Aktualisieren und Löschen verwendenExpirationSettings.

Das folgende Beispiel zeigt, wie Sie die AWS CLI verwenden, um eine AppInstanceUser zu aktualisierenExpirationSettings.

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

Das folgende Beispiel zeigt, wie Sie die AWS CLI verwenden, um einen Kanal zu löschenExpirationSettings.

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

AWS CloudTrail Ereignisse für das Löschen abgelaufener Ressourcen

Nachdem das System eine abgelaufene Ressource gelöscht hat, sendet es ein ExpireAppInstanceUser ExpireChannel OR-Ereignis an AWS CloudTrail. Die Art des Ereignisses hängt von der Art des gelöschten Elements ab.

Das folgende Beispiel zeigt ein AppInstanceUser Ereignis.

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