Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
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.
# Ejemplos de DynamoDB Streams que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante DynamoDB Streams. AWS Command Line Interface
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `describe-stream`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-stream`.
**AWS CLI**
**Obtención de información sobre un flujo de DynamoDB**
El siguiente comando de `describe-stream` muestra información sobre el flujo de DynamoDB específico.
```
aws dynamodbstreams describe-stream \
--stream-arn arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576
```
Salida:
```
{
"StreamDescription": {
"StreamArn": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576",
"StreamLabel": "2019-10-22T18:02:01.576",
"StreamStatus": "ENABLED",
"StreamViewType": "NEW_AND_OLD_IMAGES",
"CreationRequestDateTime": 1571767321.571,
"TableName": "Music",
"KeySchema": [
{
"AttributeName": "Artist",
"KeyType": "HASH"
},
{
"AttributeName": "SongTitle",
"KeyType": "RANGE"
}
],
"Shards": [
{
"ShardId": "shardId-00000001571767321804-697ce3d2",
"SequenceNumberRange": {
"StartingSequenceNumber": "4000000000000642977831",
"EndingSequenceNumber": "4000000000000642977831"
}
},
{
"ShardId": "shardId-00000001571780995058-40810d86",
"SequenceNumberRange": {
"StartingSequenceNumber": "757400000000005655171150"
},
"ParentShardId": "shardId-00000001571767321804-697ce3d2"
}
]
}
}
```
Para obtener más información, consulte [Capturing Table Activity with DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) en la *Guía para desarrolladores de Amazon DynamoDB*.
+ Para obtener más información sobre la API, consulte la Referencia [DescribeStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/describe-stream.html)de *AWS CLI comandos*.
### `get-records`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-records`.
**AWS CLI**
**Obtención de registros de un flujo de Dynamodb**
El siguiente `get-records` comando recupera los registros mediante el iterador de fragmentos de Amazon DynamoDB especificado.
```
aws dynamodbstreams get-records \
--shard-iterator "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576|1|AAAAAAAAAAGgM3YZ89vLZZxjmoQeo33r9M4x3+zmmTLsiL86MfrF4+B4EbsByi52InVmiONmy6xVW4IRcIIbs1zO7MNIlqZfx8WQzMwVDyINtGG2hCLg78JKbYxFasXeePGlApTyf3rJxR765uyOVaBvBHAJuwF2TXIuxhaAlOupNGHr52qAC3a49ZOmf+CjNPlqQjnyRSAnfOwWmKhL1/KNParWSfz2odf780oOObIDIWRRMkt7+Hyzh9SD+hFxFAWR5C7QIlOXPc8mRBfNIazfrVCjJK8/jsjCzsqNyXKzJbhh+GXCoxYN+Kpmg4nyj1EAsYhbGL35muvHFoHjcyuynbsczbWaXNfThDwRAyvoTmc8XhHKtAWUbJiaVd8ZPtQwDsThCrmDRPIdmTRGWllGfUr5ezN5LscvkQezzgpaU5p8BgCqRzjv5Vl8LB6wHgQWNG+w/lEGS05ha1qNP+Vl4+tuhz2TRnhnJo/pny9GI/yGpce97mWvSPr5KPwy+Dtcm5BHayBs+PVYHITaTliInFlT+LCwvaz1QH3MY3b8A05Z800wjpktm60iQqtMeDwN4NX6FrcxR34JoFKGsgR8XkHVJzz2xr1xqSJ12ycpNTyHnndusw=="
```
Salida:
```
{
"Records": [
{
"eventID": "c3b5d798eef6215d42f8137b19a88e50",
"eventName": "INSERT",
"eventVersion": "1.1",
"eventSource": "aws:dynamodb",
"awsRegion": "us-west-1",
"dynamodb": {
"ApproximateCreationDateTime": 1571849028.0,
"Keys": {
"Artist": {
"S": "No One You Know"
},
"SongTitle": {
"S": "Call Me Today"
}
},
"NewImage": {
"AlbumTitle": {
"S": "Somewhat Famous"
},
"Artist": {
"S": "No One You Know"
},
"Awards": {
"N": "1"
},
"SongTitle": {
"S": "Call Me Today"
}
},
"SequenceNumber": "700000000013256296913",
"SizeBytes": 119,
"StreamViewType": "NEW_AND_OLD_IMAGES"
}
},
{
"eventID": "878960a6967867e2da16b27380a27328",
"eventName": "INSERT",
"eventVersion": "1.1",
"eventSource": "aws:dynamodb",
"awsRegion": "us-west-1",
"dynamodb": {
"ApproximateCreationDateTime": 1571849029.0,
"Keys": {
"Artist": {
"S": "Acme Band"
},
"SongTitle": {
"S": "Happy Day"
}
},
"NewImage": {
"AlbumTitle": {
"S": "Songs About Life"
},
"Artist": {
"S": "Acme Band"
},
"Awards": {
"N": "10"
},
"SongTitle": {
"S": "Happy Day"
}
},
"SequenceNumber": "800000000013256297217",
"SizeBytes": 100,
"StreamViewType": "NEW_AND_OLD_IMAGES"
}
},
{
"eventID": "520fabde080e159fc3710b15ee1d4daa",
"eventName": "MODIFY",
"eventVersion": "1.1",
"eventSource": "aws:dynamodb",
"awsRegion": "us-west-1",
"dynamodb": {
"ApproximateCreationDateTime": 1571849734.0,
"Keys": {
"Artist": {
"S": "Acme Band"
},
"SongTitle": {
"S": "Happy Day"
}
},
"NewImage": {
"AlbumTitle": {
"S": "Updated Album Title"
},
"Artist": {
"S": "Acme Band"
},
"Awards": {
"N": "10"
},
"SongTitle": {
"S": "Happy Day"
}
},
"OldImage": {
"AlbumTitle": {
"S": "Songs About Life"
},
"Artist": {
"S": "Acme Band"
},
"Awards": {
"N": "10"
},
"SongTitle": {
"S": "Happy Day"
}
},
"SequenceNumber": "900000000013256687845",
"SizeBytes": 170,
"StreamViewType": "NEW_AND_OLD_IMAGES"
}
}
],
"NextShardIterator": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-23T16:41:08.740|1|AAAAAAAAAAEhEI04jkFLW+LKOwivjT8d/IHEh3iExV2xK00aTxEzVy1C1C7Kbb5+ZOW6bT9VQ2n1/mrs7+PRiaOZCHJu7JHJVW7zlsqOi/ges3fw8GYEymyL+piEk35cx67rQqwKKyq+Q6w9JyjreIOj4F2lWLV26lBwRTrIYC4IB7C3BZZK4715QwYdDxNdVHiSBRZX8UqoS6WOt0F87xZLNB9F/NhYBLXi/wcGvAcBcC0TNIOH+N0NqwtoB/FGCkNrf8YZ0xRoNN6RgGuVWHF3pxOhxEJeFZoSoJTIKeG9YcYxzi5Ci/mhdtm7tBXnbw5c6xmsGsBqTirNjlDyJLcWl8Cl0UOLX63Ufo/5QliztcjEbKsQe28x8LM8o7VH1Is0fF/ITt8awSA4igyJS0P87GN8Qri8kj8iaE35805jBHWF2wvwT6Iy2xGrR2r2HzYps9dwGOarVdEITaJfWzNoL4HajMhmREZLYfM7Pb0PvRMO7JkENyPIU6e2w16W1CvJO2EGFIxtNk+V04i1YIeHMXJfcwetNRuIbdQXfJht2NQZa4PVV6iknY6d19MrdbSTMKoqAuvp6g3Q2jH4t7GKCLWgodcPAn8g5+43DaNkh4Z5zKOfNw=="
}
```
Para obtener más información, consulte [Capturing Table Activity with DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) en la *Guía para desarrolladores de Amazon DynamoDB*.
+ Para obtener más información sobre la API, consulte [GetRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/get-records.html)la *Referencia de AWS CLI comandos*.
### `get-shard-iterator`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-shard-iterator`.
**AWS CLI**
**Obtención de un iterador de fragmentos**
El siguiente comando de `get-shard-iterator` recupera un iterador de fragmentos para el fragmento especificado.
```
aws dynamodbstreams get-shard-iterator \
--stream-arn arn:aws:dynamodb:us-west-1:12356789012:table/Music/stream/2019-10-22T18:02:01.576 \
--shard-id shardId-00000001571780995058-40810d86 \
--shard-iterator-type LATEST
```
Salida:
```
{
"ShardIterator": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576|1|AAAAAAAAAAGgM3YZ89vLZZxjmoQeo33r9M4x3+zmmTLsiL86MfrF4+B4EbsByi52InVmiONmy6xVW4IRcIIbs1zO7MNIlqZfx8WQzMwVDyINtGG2hCLg78JKbYxFasXeePGlApTyf3rJxR765uyOVaBvBHAJuwF2TXIuxhaAlOupNGHr52qAC3a49ZOmf+CjNPlqQjnyRSAnfOwWmKhL1/KNParWSfz2odf780oOObIDIWRRMkt7+Hyzh9SD+hFxFAWR5C7QIlOXPc8mRBfNIazfrVCjJK8/jsjCzsqNyXKzJbhh+GXCoxYN+Kpmg4nyj1EAsYhbGL35muvHFoHjcyuynbsczbWaXNfThDwRAyvoTmc8XhHKtAWUbJiaVd8ZPtQwDsThCrmDRPIdmTRGWllGfUr5ezN5LscvkQezzgpaU5p8BgCqRzjv5Vl8LB6wHgQWNG+w/lEGS05ha1qNP+Vl4+tuhz2TRnhnJo/pny9GI/yGpce97mWvSPr5KPwy+Dtcm5BHayBs+PVYHITaTliInFlT+LCwvaz1QH3MY3b8A05Z800wjpktm60iQqtMeDwN4NX6FrcxR34JoFKGsgR8XkHVJzz2xr1xqSJ12ycpNTyHnndusw=="
}
```
Para obtener más información, consulte [Capturing Table Activity with DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) en la *Guía para desarrolladores de Amazon DynamoDB*.
+ Para obtener más información sobre la API, consulte [GetShardIterator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/get-shard-iterator.html)la *Referencia de AWS CLI comandos*.
### `list-streams`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-streams`.
**AWS CLI**
**Para enumerar flujos de DynamoDB**
El siguiente `list-streams` comando muestra todas las transmisiones de Amazon DynamoDB existentes en la región predeterminada. AWS
```
aws dynamodbstreams list-streams
```
Salida:
```
{
"Streams": [
{
"StreamArn": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576",
"TableName": "Music",
"StreamLabel": "2019-10-22T18:02:01.576"
}
]
}
```
Para obtener más información, consulte [Capturing Table Activity with DynamoDB Streams](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) en la *Guía para desarrolladores de Amazon DynamoDB*.
+ Para obtener más información sobre la API, consulte la Referencia [ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dynamodbstreams/list-streams.html)de *AWS CLI comandos*.