Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
En utilisant ExpirationSettings
Lorsque vous créez un AppInstanceUser
ou unChannel
, vous pouvez l'utiliser ExpirationSettings
pour configurer la suppression automatique de ces ressources. ExpirationSettings
permet de réduire les coûts de stockage et de prévenir resource-limit-exceeded les problèmes. Par exemple, vous pouvez supprimer les chaînes inutilisées au bout de 7 jours ou supprimer celles AppInstanceUser
qui n'ont été invoquées qu'à des fins de test.
Pour unAppInstanceUser
, vous spécifiez la période d'expiration en fonction de l'heure de création de l'utilisateur. Pour unChannel
, vous spécifiez la période d'expiration en fonction de l'heure de création de la chaîne ou de l'heure du dernier message. Ce dernier vous permet d'utiliser les activités liées aux messages pour personnaliser la suppression automatique.
Important
Peu après l'expiration d'une ressource, ExpirationSettings
lance un processus en arrière-plan pour supprimer cette ressource. Le processus prend généralement 6 heures, mais ce temps peut varier.
Les AppInstanceUsers
fichiers expirés et Channels
qui n'ont pas encore été supprimés apparaissent toujours comme valides et actifs. Vous pouvez mettre à jour ou supprimer leurs paramètres d'expiration, et le système tiendra compte de vos modifications.
Rubriques
Configuration ExpirationSettings
Les sections suivantes expliquent comment configurer ExpirationSettings
un AppInstanceUser
ou unChannel
.
Configuration ExpirationSettings lors de la création d'une ressource
Vous pouvez configurer le ExpirationSettings
moment où vous exécutez les CreateChannelAPI CreateAppInstanceUseror. Si vous définissez le ExpirationSettings
paramètre, vous devez accorder les autorisations IAM suivantes :
chime:PutAppInstanceUserExpirationSettings
lors de la création d'unAppInstanceUser
chime:PutChannelExpirationSettings
lors de la création d'unChannel
.
L'exemple suivant utilise la AWS CLI pour créer un fichier AppInstanceUser
expirant au bout d'un jour.
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'exemple suivant utilise la AWS CLI pour créer un message Channel
qui expire un jour après la dernière réception d'un message.
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
" }'
Utilisation des API Put pour configurer ExpirationSettings
Vous pouvez également utiliser les PutChannelExpirationSettingsAPI PutAppInstanceUserExpirationSettingset pour créer, mettre à jour et supprimerExpirationSettings
.
L'exemple suivant vous montre comment utiliser la AWS CLI pour mettre à jour un AppInstanceUser
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'exemple suivant montre comment utiliser la AWS CLI pour supprimer un canalExpirationSettings
.
aws chime-sdk-messaging put-channel-expiration-settings \ --chime-bearer "
app_instance_user_arn
" \ --channel-arn "channel_arn
"
AWS CloudTrail événements relatifs à la suppression de ressources expirées
Une fois que le système a supprimé une ressource expirée, il envoie un ExpireChannel
événement ExpireAppInstanceUser
or à AWS CloudTrail. Le type d'événement dépend du type de ressource supprimée.
L'exemple suivant montre un AppInstanceUser
événement.
{ "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" }