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

# Uso ExpirationSettings no sistema de mensagens do Amazon Chime SDK
<a name="expiration"></a>

Ao criar um `AppInstanceUser` ou um`Channel`, você pode usar `ExpirationSettings` para configurar esses recursos para exclusão automática. `ExpirationSettings`ajuda 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.

**Topics**
+ [Configurando ExpirationSettings](#create-expiration)
+ [AWS CloudTrail eventos para exclusão de recursos expirados](#ct-events)

## Configurando ExpirationSettings
<a name="create-expiration"></a>

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

### Configurar ExpirationSettings ao criar um recurso
<a name="configure-on-create"></a>

Você pode configurar `ExpirationSettings` ao executar o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateAppInstanceUser.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateAppInstanceUser.html)ou [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html) APIs. Se você definir o parâmetro `ExpirationSettings`, 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
<a name="configure-on-put"></a>

Você também pode usar o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_PutAppInstanceUserExpirationSettings.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_PutAppInstanceUserExpirationSettings.html)e [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutChannelExpirationSettings.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutChannelExpirationSettings.html) APIs para criar, atualizar e excluir`ExpirationSettings`. 

O exemplo a seguir mostra como usar a AWS CLI para atualizar um`AppInstanceUser`. `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
<a name="ct-events"></a>

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