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

# Reproduzir eventos retidos para um assinante
<a name="eb-custom-bus-replay"></a>

Para entregar eventos que o ônibus já realiza, crie um assinante com `--starting-position POINT_IN_TIME` um ponto de partida dentro da janela de retenção do ônibus, por exemplo`--point-in-time-configuration '{ "PointType": "TIMESTAMP", "StartingPoint": "2026-09-01T00:00:00Z" }'`. Não há uma API de reprodução separada: um assinante lê os eventos retidos a partir de sua posição inicial, portanto, qualquer coisa que ainda esteja dentro do período de retenção pode ser entregue novamente. `DescribeEventBus`retorna`RetentionWindowStartTime`, o ponto mais antigo a partir do qual um assinante pode ler; em um novo barramento, essa é a hora de criação do barramento, portanto, um carimbo de data/hora recente ainda pode cair fora da janela. Para o período de retenção em si, consulte[Escolhendo o período de retenção](eb-custom-bus-create.md#eb-custom-bus-create-retention).

## Posição inicial
<a name="eb-custom-bus-retention-start"></a>

Quando você cria um assinante, `--starting-position` é `LATEST` para receber somente eventos publicados após a existência do assinante, ou `POINT_IN_TIME` para ler o histórico retido. Com`POINT_IN_TIME`, `--point-in-time-configuration` define `PointType` como`HORIZON`, o primeiro evento retido, ou `TIMESTAMP` com um`StartingPoint`. O ponto de partida deve estar dentro da janela de retenção: no ou depois `RetentionWindowStartTime` e não no futuro. Um opcional `EndPoint` interrompe o assinante naquele momento. Omita `EndPoint` e o assinante lê os eventos retidos, acompanha os eventos ao vivo e continua entregando.

```
aws eventsv2 create-subscriber \
    --name reprocess-september \
    --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \
    --starting-position POINT_IN_TIME \
    --point-in-time-configuration '{ "PointType": "TIMESTAMP", "StartingPoint": "2026-09-01T00:00:00Z" }' \
    --invoke-configuration '{
        "TargetArn": "arn:aws:sqs:us-east-1:111122223333:reprocess",
        "RoleArn": "arn:aws:iam::111122223333:role/EventBusDeliveryRole"
    }'
```

Um replay tem um atraso na inicialização e, em seguida, é executado em velocidade ao vivo. Aguarde o atraso antes de concluir que uma repetição não está funcionando. Para pausar um assinante e depois retomá-lo com ou sem a lista de pendências, consulte. [Pausar e reiniciar](eb-custom-bus-update.md#eb-custom-bus-update-pause)

## Diferenciando eventos repetidos
<a name="eb-custom-bus-retention-marked"></a>

Cada evento entregue é válido`SystemMetadata."aws:DeliveryType"`, ou seja, `LIVE` para um evento entregue assim que chegou e `REPLAY` para um evento lido do histórico retido. Use-o para tornar os consumidores idempotentes durante uma repetição.