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 i problemi legati al superamento del limite di risorse. Ad esempio, è possibile eliminare i canali inutilizzati dopo 7 giorni o eliminare un `AppInstanceUser` canale 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 relative impostazioni di scadenza e il sistema rispetterà le modifiche apportate.
**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 configurare `ExpirationSettings` quando si eseguono le [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 le [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)API. 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 delle API Put per configurare ExpirationSettings
Puoi anche utilizzare le [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)API [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 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"
}
```