Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwendung von ExpirationSettings Nachrichten im Amazon Chime SDK
Wenn du eine `AppInstanceUser` oder eine erstellst`Channel`, kannst du sie verwenden, `ExpirationSettings` um diese Ressourcen für das automatische Löschen zu konfigurieren. `ExpirationSettings`trä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**
`ExpirationSettings`Startet 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.
**Topics**
+ [Konfiguration ExpirationSettings](#create-expiration)
+ [AWS CloudTrail Ereignisse für das Löschen abgelaufener Ressourcen](#ct-events)
## Konfiguration ExpirationSettings
In den folgenden Abschnitten wird erklärt, wie Sie den `ExpirationSettings` von an `AppInstanceUser` oder a konfigurieren`Channel`.
### Konfiguration ExpirationSettings beim Erstellen einer Ressource
Sie können konfigurieren`ExpirationSettings`, wann Sie das [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)oder ausführen [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. Wenn Sie den `ExpirationSettings` Parameter festlegen, müssen Sie die folgenden IAM-Berechtigungen gewähren:
+ `chime:PutAppInstanceUserExpirationSettings`beim Erstellen eines `AppInstanceUser`
+ `chime:PutChannelExpirationSettings`beim Erstellen eines`Channel`.
Das folgende Beispiel verwendet die AWS CLI, um eine zu erstellen`AppInstanceUser`, 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 erstellen`Channel`, 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 Sie Put APIs zur Konfiguration ExpirationSettings
Sie können das [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_PutAppInstanceUserExpirationSettings.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_PutAppInstanceUserExpirationSettings.html)und auch [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 zum Erstellen, Aktualisieren und Löschen verwenden`ExpirationSettings`.
Das folgende Beispiel zeigt, wie Sie die AWS CLI verwenden, um eine `AppInstanceUser` zu aktualisieren`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"
}'
```
Das folgende Beispiel zeigt, wie Sie die AWS CLI verwenden, um einen Kanal zu löschen`ExpirationSettings`.
```
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"
}
```