Usando o ExpirationSettings sistema de mensagens do Amazon Chime SDK

Modo de foco

Usando o ExpirationSettings sistema de mensagens do Amazon Chime SDK - SDK do Amazon Chime

Configurando ExpirationSettings AWS CloudTrail eventos para exclusão de recursos expirados

Ao criar um AppInstanceUser ou umChannel, você pode usar ExpirationSettings para configurar esses recursos para exclusão automática. ExpirationSettingsajuda a reduzir os custos de armazenamento e evitar resource-limit-exceeded problemas. Por exemplo, você pode excluir canais não utilizados após 7 dias ou excluir um AppInstanceUser que foi invocado apenas para fins de teste.

Para um AppInstanceUser, você especifica o período de expiração com base no horário de criação do usuário. Para um Channel, você especifica o período de expiração com base no horário de criação do canal ou no horário da última mensagem. O último permite que você use atividades de mensagens para personalizar a exclusão automática.

Importante

Logo após a expiração de um recurso, ExpirationSettings inicia um processo em segundo plano para excluir esse recurso. O processo geralmente leva 6 horas, mas esse tempo pode variar.

Expirou AppInstanceUsers e Channels, que ainda não foram excluídos e ainda aparecem como válidos e ativos. Você pode atualizar ou remover suas configurações de expiração, e o sistema respeita suas alterações.

Tópicos

Configurando ExpirationSettings
AWS CloudTrail eventos para exclusão de recursos expirados

Configurando ExpirationSettings

As seções a seguir explicam como configurar ExpirationSettings de um AppInstanceUser ou um Channel.

Configuração ExpirationSettings quando você cria um recurso

Você pode configurar ExpirationSettings ao executar o CreateAppInstanceUser ou CreateChannel APIs. Se você definir o ExpirationSettings parâmetro, deverá conceder as seguintes permissões do IAM:

chime:PutAppInstanceUserExpirationSettings ao criar um AppInstanceUser
chime:PutChannelExpirationSettings ao criar um Channel.

O exemplo a seguir usa a AWS CLI para criar uma AppInstanceUser que expira após um dia.


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

O exemplo a seguir usa a AWS CLI para criar uma Channel que expira após um dia após o último recebimento de uma mensagem.


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

Usando o Put APIs para configurar ExpirationSettings

Você também pode usar o PutAppInstanceUserExpirationSettings e PutChannelExpirationSettings APIs para criar, atualizar e excluirExpirationSettings.

O exemplo a seguir mostra como usar a AWS CLI para atualizar umAppInstanceUser. 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"
        }'

O exemplo a seguir mostra como usar a AWS CLI para excluir a de um canal. ExpirationSettings


aws chime-sdk-messaging put-channel-expiration-settings \
--chime-bearer "app_instance_user_arn" \
--channel-arn "channel_arn"

AWS CloudTrail eventos para exclusão de recursos expirados

Depois que o sistema exclui um recurso expirado, ele envia um ExpireChannel evento ExpireAppInstanceUser ou para. AWS CloudTrail O tipo de evento depende do tipo de ativo excluído.

O exemplo a seguir mostra um evento AppInstanceUser.


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