View a markdown version of this page

Uso de ExpirationSettings la mensajería del SDK de Amazon Chime - Amazon Chime SDK
Configurando ExpirationSettingsAWS CloudTrail eventos para la eliminación de recursos caducados

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de ExpirationSettings la mensajería del SDK de Amazon Chime

Al crear un AppInstanceUser o Channel, puede utilizar ExpirationSettings para configurar esos recursos para que se eliminen automáticamente. ExpirationSettings ayuda a reducir los costos de almacenamiento y a evitar problemas relacionados con el exceso del límite de recursos. Por ejemplo, puede eliminar los canales no utilizados después de 7 días o eliminar un AppInstanceUser que solo se haya invocado con fines de prueba.

En el caso de un AppInstanceUser, se especifica el período de caducidad en función de la hora de creación del usuario. Para un Channel, especifica el período de caducidad en función de la hora de creación del canal o la hora del último mensaje. Esta última opción le permite utilizar las actividades de los mensajes para personalizar la eliminación automática.

importante

Poco después de que caduque un recurso, ExpirationSettings inicia un proceso en segundo plano para eliminarlo. El proceso suele tardar 6 horas, pero ese tiempo puede variar.

Las AppInstanceUsers y Channels que hayan caducado y que aún no se hayan eliminado siguen apareciendo como válidas y activas. Puede actualizar o eliminar su configuración de caducidad y el sistema respetará sus cambios.

Configurando ExpirationSettings

En las siguientes secciones se explica cómo configurar un ExpirationSettings, un AppInstanceUser o un Channel.

Configuración de ExpirationSettings al crear un recurso

Puede configurar ExpirationSettings cuándo ejecuta las API CreateAppInstanceUser o CreateChannel. Si establece el parámetro ExpirationSettings, debe conceder los siguientes permisos IAM:

  • chime:PutAppInstanceUserExpirationSettings al crear un AppInstanceUser

  • chime:PutChannelExpirationSettings al crear un Channel.

En el siguiente ejemplo, se utiliza la AWS CLI para crear una AppInstanceUser que caduca al cabo de un día.

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

El siguiente ejemplo usa la AWS CLI para crear una Channel que caduca un día después de recibir un mensaje por última vez.

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

Uso de las API Put para configurar ExpirationSettings

También puede usar las API PutAppInstanceUserExpirationSettings y PutChannelExpirationSettings para crear, actualizar y eliminar ExpirationSettings.

El siguiente ejemplo muestra cómo usar la AWS CLI para actualizar una AppInstanceUserExpirationSettings.

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

El siguiente ejemplo muestra cómo usar la AWS CLI para eliminar un canalExpirationSettings.

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

AWS CloudTrail eventos para la eliminación de recursos caducados

Cuando el sistema elimina un recurso caducado, envía un ExpireChannel evento ExpireAppInstanceUser o a AWS CloudTrail. El tipo de evento depende del tipo de activo eliminado.

En el siguiente ejemplo, se muestra un 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"
}