Utilisation ExpirationSettings dans la messagerie du SDK Amazon Chime

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.

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.

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.

Configuration ExpirationSettings

Les sections suivantes expliquent comment configurer ExpirationSettings un AppInstanceUser ou unChannel.

Configuration ExpirationSettings lorsque vous créez une ressource

Vous pouvez configurer ExpirationSettings lorsque vous exécutez le CreateAppInstanceUser ou CreateChannel APIs. Si vous définissez le ExpirationSettings paramètre, vous devez accorder les autorisations IAM suivantes :

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

Utiliser Put APIs pour configurer ExpirationSettings

Vous pouvez également utiliser PutAppInstanceUserExpirationSettings et PutChannelExpirationSettings APIs 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"
}