Utilizzo ExpirationSettings nella messaggistica SDK Amazon Chime

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à.

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à.

Quando crei un AppInstanceUser o unChannel, puoi utilizzarlo ExpirationSettings per configurare tali risorse per l'eliminazione automatica. ExpirationSettingsaiuta 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 unAppInstanceUser, si specifica il periodo di scadenza in base all'ora di creazione dell'utente. Per aChannel, 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.

Configurazione ExpirationSettings

Le seguenti sezioni spiegano come configurare un AppInstanceUser o unChannel. ExpirationSettings

Configurazione ExpirationSettings quando crei una risorsa

È possibile configurare ExpirationSettings quando si esegue il CreateAppInstanceUser o CreateChannel APIs. Se imposti il ExpirationSettings parametro, devi concedere le seguenti autorizzazioni IAM:

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 il PutAppInstanceUserExpirationSettings e PutChannelExpirationSettings APIs per creare, aggiornare ed eliminareExpirationSettings.

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