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 una AppInstanceUser o unaChannel, puede utilizarla ExpirationSettings para configurar esos recursos para su eliminación automática. ExpirationSettingsayuda a reducir los costes de almacenamiento y a evitar resource-limit-exceeded problemas. 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 configurarlo ExpirationSettings cuando ejecuta el CreateAppInstanceUsero CreateChannel APIs. 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"
        }'

En el siguiente ejemplo, se utiliza la AWS CLI para crear una Channel que caduque 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 Put APIs para configurar ExpirationSettings

También puede usar PutAppInstanceUserExpirationSettingsy PutChannelExpirationSettings APIs para crear, actualizar y eliminarExpirationSettings.

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

Una vez que 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"
}