View a markdown version of this page

Utilizzo ExpirationSettings nella messaggistica SDK Amazon Chime - SDK Amazon Chime
Configurazione ExpirationSettingsAWS CloudTrail eventi per l'eliminazione di risorse scadute

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 unChannel, puoi utilizzarlo ExpirationSettings per configurare tali risorse per l'eliminazione automatica. ExpirationSettingsaiuta 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 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.

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.

Configurazione ExpirationSettings

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

Configurazione ExpirationSettings quando si crea una risorsa

È possibile configurare ExpirationSettings quando si eseguono le CreateAppInstanceUsero le CreateChannelAPI. Se imposti il ExpirationSettings parametro, devi concedere le seguenti autorizzazioni IAM:

  • chime:PutAppInstanceUserExpirationSettingsquando si crea un AppInstanceUser

  • chime:PutChannelExpirationSettingsquando si crea unChannel.

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