Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo ExpirationSettings nella messaggistica SDK Amazon Chime
Quando crei un `AppInstanceUser` o un`Channel`, puoi utilizzarlo `ExpirationSettings` per configurare tali risorse per l'eliminazione automatica. `ExpirationSettings`aiuta a ridurre i costi di archiviazione e a prevenire resource-limit-exceeded problemi. Ad esempio, è possibile eliminare i canali inutilizzati dopo 7 giorni o eliminare un canale `AppInstanceUser` che è stato richiamato solo a scopo di test.
Per un`AppInstanceUser`, si specifica il periodo di scadenza in base all'ora di creazione dell'utente. Per a`Channel`, si specifica il periodo di scadenza in base all'ora di creazione del canale o all'ora dell'ultimo messaggio. Quest'ultimo consente di utilizzare le attività relative ai messaggi per personalizzare l'eliminazione automatica.
**Importante**
Poco dopo la scadenza di una risorsa, `ExpirationSettings` avvia un processo in background per eliminare quella risorsa. Il processo richiede in genere 6 ore, ma questo tempo può variare.
I dati `Channels` scaduti `AppInstanceUsers` e non ancora eliminati vengono comunque visualizzati come validi e attivi. Puoi aggiornare o rimuovere le impostazioni di scadenza e il sistema rispetterà le tue modifiche.
**Topics**
+ [Configurazione ExpirationSettings](#create-expiration)
+ [AWS CloudTrail eventi per l'eliminazione di risorse scadute](#ct-events)
## Configurazione ExpirationSettings
Le seguenti sezioni spiegano come configurare un `AppInstanceUser` o un`Channel`. `ExpirationSettings`
### Configurazione ExpirationSettings quando si crea una risorsa
È possibile eseguire la configurazione `ExpirationSettings` quando si esegue [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)o [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. Se imposti il `ExpirationSettings` parametro, devi concedere le seguenti autorizzazioni IAM:
+ `chime:PutAppInstanceUserExpirationSettings`quando si crea un `AppInstanceUser`
+ `chime:PutChannelExpirationSettings`quando si crea un`Channel`.
L'esempio seguente utilizza la AWS CLI per creare un codice `AppInstanceUser` che scade dopo un giorno.
```
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"
}'
```
L'esempio seguente utilizza la AWS CLI per creare un messaggio `Channel` che scade dopo un giorno dall'ultima ricezione di un messaggio.
```
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"
}'
```
### Utilizzo di Put APIs per configurare ExpirationSettings
Puoi anche usare [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_PutAppInstanceUserExpirationSettings.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_PutAppInstanceUserExpirationSettings.html)and [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 per creare, aggiornare ed eliminare`ExpirationSettings`.
L'esempio seguente mostra come utilizzare la AWS CLI per aggiornare un `AppInstanceUser` utente. `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"
}'
```
L'esempio seguente mostra come utilizzare la AWS CLI per eliminare un canale. `ExpirationSettings`
```
aws chime-sdk-messaging put-channel-expiration-settings \
--chime-bearer "app_instance_user_arn" \
--channel-arn "channel_arn"
```
## AWS CloudTrail eventi per l'eliminazione di risorse scadute
Dopo aver eliminato una risorsa scaduta, il sistema invia un evento `ExpireAppInstanceUser` or `ExpireChannel` a. AWS CloudTrail Il tipo di evento dipende dal tipo di risorsa eliminata.
L'esempio seguente mostra un `AppInstanceUser` evento.
```
{
"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"
}
```