Menu
AWS IoT
Developer Guide

UpdateStream

Updates an existing stream. The stream version will be incremented by one.

Request syntax:

PUT /streams/streamId Content-type: application/json { "description": "string", "files": [ { "fileId": "integer", "s3Location": { "bucket": "string", "key": "string", "version": "string" } } ], "roleArn": "string" }

URI Request Parameters:

Name

Type

Req?

Description

streamId

StreamId

yes

The stream ID.

Request Body Parameters:

Name

Type

Req?

Description

description

StreamDescription

no

The description of the stream.

files

StreamFiles

no

The files associated with the stream.

roleArn

RoleArn

no

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

Response syntax:

Content-type: application/json { "streamId": "string", "streamArn": "string", "description": "string", "streamVersion": "integer" }

Response Body Parameters:

Name

Type

Req?

Description

streamId

StreamId

no

The stream ID.

streamArn

StreamArn

no

The stream ARN.

description

StreamDescription

no

A description of the stream.

streamVersion

StreamVersion

no

The stream version.

Errors:

InvalidRequestException

The contents of the request were invalid. For example, this code is returned when an UpdateJobExecution request contains invalid status details. The message contains details about the error.

HTTP response code: 400

ResourceNotFoundException

The specified resource does not exist.

HTTP response code: 404

ThrottlingException

The rate exceeds the limit.

HTTP response code: 429

UnauthorizedException

You are not authorized to perform this operation.

HTTP response code: 401

ServiceUnavailableException

The service is temporarily unavailable.

HTTP response code: 503

InternalFailureException

An unexpected error has occurred.

HTTP response code: 500

CLI

Synopsis:

aws iot update-stream \ --stream-id <value> \ [--description <value>] \ [--files <value>] \ [--role-arn <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "streamId": "string", "description": "string", "files": [ { "fileId": "integer", "s3Location": { "bucket": "string", "key": "string", "version": "string" } } ], "roleArn": "string" }

cli-input-json fields:

Name

Type

Description

streamId

string

length max:128 min:1

pattern: [a-zA-Z0-9_-]+

The stream ID.

description

string

length max:2028

pattern: [^\\p{C}]+

The description of the stream.

files

list

member: StreamFile

The files associated with the stream.

StreamFile

StreamFile

fileId

integer

java class: java.lang.Integer

range- max:255 min:0

The file ID.

s3Location

S3Location

The location of the file in S3.

bucket

string

length min:1

The S3 bucket that contains the file to stream.

key

string

length min:1

The name of the file within the S3 bucket to stream.

version

string

The file version.

roleArn

string

length max:2048 min:20

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

Output:

{ "streamId": "string", "streamArn": "string", "description": "string", "streamVersion": "integer" }

cli output fields:

Name

Type

Description

streamId

string

length max:128 min:1

pattern: [a-zA-Z0-9_-]+

The stream ID.

streamArn

string

The stream ARN.

description

string

length max:2028

pattern: [^\\p{C}]+

A description of the stream.

streamVersion

integer

java class: java.lang.Integer

range- max:65535 min:0

The stream version.

On this page: