Creates a stream.
POST {{baseUrl}}/streams
Starts the provisioning of a new stream.
The stream will be created in the given compartment id or stream pool id, depending on which parameter is specified.
Compartment id and stream pool id cannot be specified at the same time.
To track the progress of the provisioning, you can periodically call GetStream.
In the response, the lifecycleState
parameter of the Stream object tells you its current state.
Request Body
{"name"=>"TelemetryEvents", "partitions"=>1, "compartmentId"=>"{{compartment_ocid}}", "retentionInHours"=>24, "streamPoolId"=>"ocid1.streampool.realm.region.zxcvbn432765"}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
opc-request-id | string | The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a | |
particular request, please provide the request ID. | |||
Content-Type | string | ||
Date | string | (Required) Current Date | |
Authorization | string | (Required) Signature Authentication on Authorization header | |
x-content-sha256 | string | (Required) Content sha256 for POST, PUT and PATCH operations |
RESPONSES
status: OK
{"compartmentId":"ocid1.compinstance.realm.region.zxcvbn432765","id":"ocid1.stream.realm.region.mnopqr789","lifecycleState":"DELETED","messagesEndpoint":"ut incididun","name":"TelemetryEvents","partitions":10,"retentionInHours":24,"streamPoolId":"ocid1.streampool.realm.region.zxcvbn432765","timeCreated":"1944-09-01T17:11:38.401Z","definedTags":{},"freeformTags":{},"lifecycleStateDetails":"magna commodo"}