Usando o ExpirationSettings sistema de mensagens do Amazon Chime SDK - SDK do Amazon Chime
Configurando ExpirationSettingsAWS CloudTrail eventos para exclusão de recursos expirados

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando o ExpirationSettings sistema de mensagens do Amazon Chime SDK

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.

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