En utilisant ExpirationSettings

Lorsque vous créez un AppInstanceUser ou unChannel, vous pouvez l'utiliser ExpirationSettings pour configurer la suppression automatique de ces ressources. ExpirationSettingspermet 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.

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:PutAppInstanceUserExpirationSettingslors de la création d'un AppInstanceUser

• chime:PutChannelExpirationSettingslors 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 AppInstanceUserExpirationSettings.

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