Live Inputs

resource cloudflare_stream_live_input

required Expand Collapse

account_id: String

Identifier.

optional Expand Collapse

live_input_identifier?: String

A unique identifier for a live input.

default_creator?: String

Sets the creator ID asssociated with this live input.

delete_recording_after_days?: Float64

Indicates the number of days after which the live inputs recordings will be deleted. When a stream completes and the recording is ready, the value is used to calculate a scheduled deletion date for that recording. Omit the field to indicate no change, or include with a null value to remove an existing scheduled deletion.

meta?: JSON

A user modifiable key-value store used to reference other systems of record for managing live inputs.

enabled?: Bool

Indicates whether the live input is enabled and can accept streams.

prefer_low_latency?: Bool

When enabled, the live stream is delivered using Low-Latency HLS (LL-HLS), reducing glass-to-glass latency for viewers at the cost of reduced player compatibility.

recording?: Attributes

Records the input to a Cloudflare Stream video. Behavior depends on the mode. In most cases, the video will initially be viewable as a live video and transition to on-demand after a condition is satisfied.

allowed_origins?: List[String]

Lists the origins allowed to display videos created with this input. Enter allowed origin domains in an array and use * for wildcard subdomains. An empty array allows videos to be viewed on any origin.

hide_live_viewer_count?: Bool

Disables reporting the number of live viewers when this property is set to true.

mode?: String

Specifies the recording behavior for the live input. Set this value to off to prevent a recording. Set the value to automatic to begin a recording and transition to on-demand after Stream Live stops receiving input.

require_signed_urls?: Bool

Indicates if a video using the live input has the requireSignedURLs property set. Also enforces access controls on any video recording of the livestream with the live input.

timeout_seconds?: Int64

Determines the amount of time a live input configured in automatic mode should wait before a recording transitions from live to on-demand. 0 is recommended for most use cases and indicates the platform default should be used.

computed Expand Collapse

created: Time

The date and time the live input was created.

keys_rotated_at: Time

The date and time the live input keys were last rotated. Omitted for live inputs that have never had their keys rotated.

modified: Time

The date and time the live input was last modified.

status: String

The connection status of a live input.

uid: String

A unique identifier for a live input.

rtmps: Attributes

Details for streaming to an live input using RTMPS.

stream_key: String

The secret key to use when streaming via RTMPS to a live input.

url: String

The RTMPS URL you provide to the broadcaster, which they stream live video to.

rtmps_playback: Attributes

Details for playback from an live input using RTMPS.

stream_key: String

The secret key to use for playback via RTMPS.

url: String

The URL used to play live video over RTMPS.

srt: Attributes

Details for streaming to a live input using SRT.

passphrase: String

The secret key to use when streaming via SRT to a live input.

stream_id: String

The identifier of the live input to use when streaming via SRT.

url: String

The SRT URL you provide to the broadcaster, which they stream live video to.

srt_playback: Attributes

Details for playback from an live input using SRT.

passphrase: String

The secret key to use for playback via SRT.

stream_id: String

The identifier of the live input to use for playback via SRT.

url: String

The URL used to play live video over SRT.

web_rtc: Attributes

Details for streaming to a live input using WebRTC.

url: String

The WebRTC URL you provide to the broadcaster, which they stream live video to.

web_rtc_playback: Attributes

Details for playback from a live input using WebRTC.

url: String

The URL used to play live video over WebRTC.

cloudflare_stream_live_input

resource "cloudflare_stream_live_input" "example_stream_live_input" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  default_creator = "defaultCreator"
  delete_recording_after_days = 45
  enabled = true
  meta = {
    name = "test stream 1"
  }
  prefer_low_latency = true
  recording = {
    allowed_origins = ["example.com"]
    hide_live_viewer_count = false
    mode = "off"
    require_signed_urls = false
    timeout_seconds = 0
  }
}

data cloudflare_stream_live_input

required Expand Collapse

account_id: String

Identifier.

live_input_identifier: String

A unique identifier for a live input.

computed Expand Collapse

created: Time

The date and time the live input was created.

delete_recording_after_days: Float64

enabled: Bool

Indicates whether the live input is enabled and can accept streams.

keys_rotated_at: Time

The date and time the live input keys were last rotated. Omitted for live inputs that have never had their keys rotated.

modified: Time

The date and time the live input was last modified.

prefer_low_latency: Bool

When enabled, the live stream is delivered using Low-Latency HLS (LL-HLS), reducing glass-to-glass latency for viewers at the cost of reduced player compatibility.

status: String

The connection status of a live input.

uid: String

A unique identifier for a live input.

recording: Attributes

allowed_origins: List[String]

hide_live_viewer_count: Bool

Disables reporting the number of live viewers when this property is set to true.

mode: String

require_signed_urls: Bool

Indicates if a video using the live input has the requireSignedURLs property set. Also enforces access controls on any video recording of the livestream with the live input.

timeout_seconds: Int64

rtmps: Attributes

Details for streaming to an live input using RTMPS.

stream_key: String

The secret key to use when streaming via RTMPS to a live input.

url: String

The RTMPS URL you provide to the broadcaster, which they stream live video to.

rtmps_playback: Attributes

Details for playback from an live input using RTMPS.

stream_key: String

The secret key to use for playback via RTMPS.

url: String

The URL used to play live video over RTMPS.

srt: Attributes

Details for streaming to a live input using SRT.

passphrase: String

The secret key to use when streaming via SRT to a live input.

stream_id: String

The identifier of the live input to use when streaming via SRT.

url: String

The SRT URL you provide to the broadcaster, which they stream live video to.

srt_playback: Attributes

Details for playback from an live input using SRT.

passphrase: String

The secret key to use for playback via SRT.

stream_id: String

The identifier of the live input to use for playback via SRT.

url: String

The URL used to play live video over SRT.

web_rtc: Attributes

Details for streaming to a live input using WebRTC.

url: String

The WebRTC URL you provide to the broadcaster, which they stream live video to.

web_rtc_playback: Attributes

Details for playback from a live input using WebRTC.

url: String

The URL used to play live video over WebRTC.

meta: JSON

A user modifiable key-value store used to reference other systems of record for managing live inputs.

cloudflare_stream_live_input

data "cloudflare_stream_live_input" "example_stream_live_input" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  live_input_identifier = "66be4bf738797e01e1fca35a7bdecdcd"
}