CmdID / aws / aws iot

aws iot update-stream

Updates an existing stream. AWS CLI reference

1 example 4 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To update a stream

The following update-stream example updates an existing stream. The stream version is incremented by one.

aws iot update-stream --cli-input-json file://update-stream.jsonIdentify

Contents of update-stream.json:

{
    "streamId": "stream12345",
    "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
    "files": [
        {
            "fileId": 123,
            "s3Location": {
                "bucket":"codesign-ota-bucket",
                "key":"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
            }
        }
    ],
    "roleArn": "arn:aws:iam::123456789012:role/service-role/my_ota_stream_role"
}

Its output

{
    "streamId": "stream12345",
    "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345",
    "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
    "streamVersion": 2
}

For more information, see MQTT-based file delivery in the AWS IoT Core Developer Guide.

Options

4 in the AWS CLI reference

--descriptionThe description of the stream.

--filesThe files associated with the stream.

--role-arnAn IAM role that allows the IoT service principal assumes to access your S3 files.

--stream-idThe stream ID.