Live Events - Create

  • 참조
Service:
Media Services
API Version:
2022-11-01

라이브 이벤트 만들기
새 라이브 이벤트를 만듭니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01
With optional parameters: 
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01&autoStart={autoStart}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
accountName
 path True

string

Media Services 계정 이름입니다.
liveEventName
 path True

string

라이브 이벤트의 이름, 최대 길이는 32입니다.

Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
resourceGroupName
 path True

string

Azure 구독 내의 리소스 그룹 이름입니다.
subscriptionId
 path True

string

Microsoft Azure 구독의 고유 식별자입니다.
api-version
 query True

string

클라이언트 요청과 함께 사용할 API의 버전입니다.
autoStart
 query

boolean

플래그는 리소스를 만들 때 자동으로 시작해야 하는지를 나타냅니다.

요청 본문

Name 필수 형식 Description
location True

string

리소스가 있는 지리적 위치
properties.input True

LiveEventInput

라이브 이벤트 입력 설정입니다. 라이브 이벤트가 기여 인코더에서 입력을 받는 방법을 정의합니다.
properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

라이브 이벤트 사이트 간 액세스 정책.
properties.description

string

라이브 이벤트에 대한 설명입니다.
properties.encoding

LiveEventEncoding

라이브 이벤트에 대한 인코딩 설정입니다. 라이브 인코더가 라이브 이벤트에 사용되는지 여부와 라이브 인코더가 사용되는 경우 라이브 인코더에 대한 설정을 구성합니다.
properties.hostnamePrefix

string

useStaticHostname이 true로 설정된 경우 hostnamePrefix는 라이브 이벤트 미리 보기 및 수집 엔드포인트에 할당된 호스트 이름의 첫 번째 부분을 지정합니다. 최종 호스트 이름은 이 접두사, 미디어 서비스 계정 이름 및 Azure Media Services 데이터 센터에 대한 간단한 코드의 조합입니다.
properties.preview

LiveEventPreview

라이브 이벤트 미리 보기 설정. 미리 보기를 사용하면 라이브 이벤트 생산자가 라이브 출력을 만들지 않고 라이브 스트리밍 콘텐츠를 미리 볼 수 있습니다.
properties.streamOptions

StreamOptionsFlag[]

LiveEvent에 사용할 옵션입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 배열 항목 값에 유효한 값은 'Default' 및 'LowLatency'입니다.
properties.transcriptions

LiveEventTranscription[]

라이브 이벤트에 대한 라이브 전사 설정입니다. 라이브 전사 기능에 대한 자세한 내용은 를 참조하세요 https://go.microsoft.com/fwlink/?linkid=2133742 .
properties.useStaticHostname

boolean

정적 호스트 이름을 라이브 이벤트 미리 보기 및 수집 엔드포인트에 할당할지 여부를 지정합니다. 라이브 이벤트가 대기 상태인 경우에만 이 값을 업데이트할 수 있습니다.
tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

LiveEvent

OK. 요청이 성공했습니다.
201 Created

LiveEvent

만들어졌습니다. 처리를 위해 요청이 수락되었으며 작업이 비동기적으로 완료됩니다. Azure-AsyncOperation 응답 헤더를 사용하여 비동기 Azure 작업 모니터링에 대한 자세한 내용은 를 참조하세요 https://go.microsoft.com/fwlink/?linkid=2087017 .
Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 스트리밍 오류 응답입니다.

예제

Create a LiveEvent

Sample Request

PUT https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1?api-version=2022-11-01

{
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "input": {
      "streamingProtocol": "RTMP",
      "keyFrameIntervalDuration": "PT6S",
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      }
    },
    "preview": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      }
    }
  }
}

Sample Response

Status code:
201 
azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveeventoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
Response Body
{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "resourceState": "Creating",
    "provisioningState": "InProgress",
    "created": "2018-03-03T02:25:06.0982751Z",
    "lastModified": "2018-03-03T02:25:06.0982751Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": null,
      "crossDomainPolicy": null
    }
  }
}
Status code:
200 
{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "resourceState": "Stopped",
    "provisioningState": "Succeeded",
    "created": "2018-03-03T02:25:06.0982751Z",
    "lastModified": "2018-03-03T02:25:06.0982751Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": null,
      "crossDomainPolicy": null
    }
  }
}

정의

Name Description
createdByType

리소스를 만든 ID 유형입니다.
CrossSiteAccessPolicies

클라이언트 액세스 정책입니다.
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
IPAccessControl

IP 액세스 제어입니다.
IPRange

CIDR 체계의 IP 주소 범위입니다.
LiveEvent

라이브 이벤트입니다.
LiveEventEncoding

라이브 이벤트를 인코딩하기 위한 라이브 이벤트 유형 및 선택적 인코딩 설정을 지정합니다.
LiveEventEncodingType

라이브 이벤트 유형입니다. encodingType이 PassthroughBasic 또는 PassthroughStandard로 설정된 경우 서비스는 단순히 들어오는 비디오 및 오디오 계층을 통해 출력으로 전달됩니다. encodingType이 표준 또는 Premium1080p로 설정된 경우 라이브 인코더는 들어오는 스트림을 여러 비트 전송률 또는 계층으로 트랜스코딩합니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2095101 을 참조하세요. 라이브 이벤트를 만든 후에는 이 속성을 수정할 수 없습니다.
LiveEventEndpoint

라이브 이벤트 엔드포인트입니다.
LiveEventInput

라이브 이벤트 입력입니다.
LiveEventInputAccessControl

라이브 이벤트 입력에 대한 IP 액세스 제어입니다.
LiveEventInputProtocol

라이브 이벤트에 대한 입력 프로토콜입니다. 생성 시 지정되며 업데이트할 수 없습니다.
LiveEventInputTrackSelection

트랙 선택 조건입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.
LiveEventOutputTranscriptionTrack

음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에 있는 전사 트랙에 대해 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.
LiveEventPreview

라이브 이벤트 미리 보기 설정.
LiveEventPreviewAccessControl

라이브 이벤트 미리 보기 엔드포인트에 대한 IP 액세스 제어입니다.
LiveEventResourceState

라이브 이벤트의 리소스 상태입니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2139012 을 참조하세요.
LiveEventTimedMetadataEndpoint

라이브 이벤트 메타데이터 삽입 엔드포인트입니다.
LiveEventTranscription

음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에서 전사 트랙을 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.
StreamOptionsFlag

LiveEvent에 사용할 옵션입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 배열 항목 값에 유효한 값은 'Default' 및 'LowLatency'입니다.
StretchMode

원하는 출력 해상도에 맞게 입력 비디오의 크기를 조정하는 방법을 지정합니다. 기본값은 없음입니다.
systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

createdByType

리소스를 만든 ID 유형입니다.

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

CrossSiteAccessPolicies

클라이언트 액세스 정책입니다.

Name 형식 Description
clientAccessPolicy

string

Silverlight에서 사용하는 clientaccesspolicy.xml 콘텐츠입니다.
crossDomainPolicy

string

Silverlight에서 사용하는 crossdomain.xml 콘텐츠입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

IPAccessControl

IP 액세스 제어입니다.

Name 형식 Description
allow

IPRange[]

IP 허용 목록입니다.

IPRange

CIDR 체계의 IP 주소 범위입니다.

Name 형식 Description
address

string

IP 주소입니다.
name

string

IP 주소 범위의 이름입니다.
subnetPrefixLength

integer

서브넷 마스크 접두사 길이(CIDR 표기법 참조).

LiveEvent

라이브 이벤트입니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

리소스가 있는 지리적 위치
name

string

리소스의 이름입니다.
properties.created

string

라이브 이벤트의 생성 시간
properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

라이브 이벤트 사이트 간 액세스 정책.
properties.description

string

라이브 이벤트에 대한 설명입니다.
properties.encoding

LiveEventEncoding

라이브 이벤트에 대한 인코딩 설정입니다. 라이브 인코더가 라이브 이벤트에 사용되는지 여부와 라이브 인코더가 사용되는 경우 라이브 인코더의 설정이 사용되는지 여부를 구성합니다.
properties.hostnamePrefix

string

useStaticHostname이 true로 설정된 경우 hostnamePrefix는 라이브 이벤트 미리 보기 및 수집 엔드포인트에 할당된 호스트 이름의 첫 번째 부분을 지정합니다. 최종 호스트 이름은 이 접두사, 미디어 서비스 계정 이름 및 Azure Media Services 데이터 센터에 대한 간단한 코드의 조합입니다.
properties.input

LiveEventInput

라이브 이벤트 입력 설정입니다. 라이브 이벤트가 기여 인코더에서 입력을 받는 방법을 정의합니다.
properties.lastModified

string

라이브 이벤트의 마지막으로 수정된 시간입니다.
properties.preview

LiveEventPreview

라이브 이벤트 미리 보기 설정. 미리 보기를 사용하면 라이브 이벤트 생산자가 라이브 출력을 만들지 않고도 라이브 스트리밍 콘텐츠를 미리 볼 수 있습니다.
properties.provisioningState

string

라이브 이벤트의 프로비전 상태입니다.
properties.resourceState

LiveEventResourceState

라이브 이벤트의 리소스 상태입니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2139012 을 참조하세요.
properties.streamOptions

StreamOptionsFlag[]

LiveEvent에 사용할 옵션입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 배열 항목 값에 유효한 값은 'Default' 및 'LowLatency'입니다.
properties.transcriptions

LiveEventTranscription[]

라이브 이벤트에 대한 라이브 전사 설정입니다. 라이브 전사 기능에 대한 자세한 내용은 를 참조하세요 https://go.microsoft.com/fwlink/?linkid=2133742 .
properties.useStaticHostname

boolean

정적 호스트 이름을 라이브 이벤트 미리 보기 및 수집 엔드포인트에 할당할지 여부를 지정합니다. 라이브 이벤트가 대기 상태인 경우에만 이 값을 업데이트할 수 있습니다.
systemData

systemData

이 리소스와 관련된 시스템 메타데이터입니다.
tags

object

리소스 태그.
type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

LiveEventEncoding

라이브 이벤트를 인코딩하기 위한 라이브 이벤트 유형 및 선택적 인코딩 설정을 지정합니다.

Name 형식 Description
encodingType

LiveEventEncodingType

라이브 이벤트 유형입니다. encodingType이 PassthroughBasic 또는 PassthroughStandard로 설정된 경우 서비스는 들어오는 비디오 및 오디오 계층을 통해 출력으로 전달됩니다. encodingType이 Standard 또는 Premium1080p로 설정된 경우 라이브 인코더는 들어오는 스트림을 여러 비트 전송률 또는 계층으로 트랜스코딩합니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2095101 을 참조하세요. 라이브 이벤트를 만든 후에는 이 속성을 수정할 수 없습니다.
keyFrameInterval

string

0.5~20초 사이의 ISO 8601 시간 값을 사용하여 인코딩 라이브 이벤트의 비디오 및 오디오 트랙에 대한 출력 조각 길이를 지정합니다. 예를 들어 PT2S를 사용하여 2초를 나타냅니다. 비디오 트랙의 경우 키 프레임 간격 또는 GoP의 길이(그림 그룹)도 정의합니다. 인코딩 라이브 이벤트에 대해 이 값이 설정되지 않은 경우 조각 지속 시간은 기본적으로 2초로 설정됩니다. 통과 라이브 이벤트에 대해 값을 설정할 수 없습니다.
presetName

string

encodingType이 None이 아닌 경우 사용되는 선택적 인코딩 사전 설정 이름입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. encodingType이 표준으로 설정된 경우 기본 사전 설정 이름은 'Default720p'입니다. 그렇지 않고 encodingType이 Premium1080p로 설정된 경우 기본 사전 설정은 'Default1080p'입니다.
stretchMode

StretchMode

원하는 출력 해상도에 맞게 입력 비디오의 크기를 조정하는 방법을 지정합니다. 기본값은 없음입니다.

LiveEventEncodingType

라이브 이벤트 유형입니다. encodingType이 PassthroughBasic 또는 PassthroughStandard로 설정된 경우 서비스는 단순히 들어오는 비디오 및 오디오 계층을 통해 출력으로 전달됩니다. encodingType이 표준 또는 Premium1080p로 설정된 경우 라이브 인코더는 들어오는 스트림을 여러 비트 전송률 또는 계층으로 트랜스코딩합니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2095101 을 참조하세요. 라이브 이벤트를 만든 후에는 이 속성을 수정할 수 없습니다.

Name 형식 Description
None

string

PassthroughStandard와 동일합니다. 아래 설명을 참조하세요. 이 열거형 값은 더 이상 사용되지 않습니다.
PassthroughBasic

string

수집된 스트림은 추가 처리 없이 기여 인코더에서 라이브 이벤트를 통과합니다. PassthroughBasic 모드에서 수집은 최대 5Mbps로 제한되며 1개의 동시 라이브 출력만 허용됩니다. 라이브 전사를 사용할 수 없습니다.
PassthroughStandard

string

수집된 스트림은 추가 처리 없이 기여 인코더에서 라이브 이벤트를 통과합니다. 라이브 전사를 사용할 수 있습니다. 수집 비트 전송률 제한은 훨씬 높으며 최대 3개의 동시 라이브 출력이 허용됩니다.
Premium1080p

string

기여 라이브 인코더는 단일 비트 전송률 스트림을 라이브 이벤트로 보내고 Media Services는 여러 비트 전송률 스트림을 만듭니다. 출력은 해상도가 1080p를 초과할 수 없습니다.
Standard

string

기여 라이브 인코더는 단일 비트 전송률 스트림을 라이브 이벤트로 보내고 Media Services는 여러 비트 전송률 스트림을 만듭니다. 출력은 해상도가 720p를 초과할 수 없습니다.

LiveEventEndpoint

라이브 이벤트 엔드포인트입니다.

Name 형식 Description
protocol

string

엔드포인트 프로토콜입니다.
url

string

엔드포인트 URL입니다.

LiveEventInput

라이브 이벤트 입력입니다.

Name 형식 Description
accessControl

LiveEventInputAccessControl

라이브 이벤트 입력에 대한 액세스 제어입니다.
accessToken

string

스트림을 고유하게 식별하는 문자열 형식의 UUID입니다. 생성 시 지정할 수 있지만 업데이트할 수는 없습니다. 생략하면 서비스는 고유한 값을 생성합니다.
endpoints

LiveEventEndpoint[]

라이브 이벤트에 대한 입력 엔드포인트입니다.
keyFrameIntervalDuration

string

입력의 키 프레임 간격 기간의 ISO 8601 기간입니다. 이 값은 HLS 출력에서 EXT-X-TARGETDURATION 속성을 설정합니다. 예를 들어 PT2S를 사용하여 2초를 나타냅니다. 라이브 이벤트를 인코딩하기 위해 값을 비워 둡니다.
streamingProtocol

LiveEventInputProtocol

라이브 이벤트에 대한 입력 프로토콜입니다. 생성 시 지정되며 업데이트할 수 없습니다.
timedMetadataEndpoints

LiveEventTimedMetadataEndpoint[]

라이브 이벤트에 대한 메타데이터 엔드포인트입니다.

LiveEventInputAccessControl

라이브 이벤트 입력에 대한 IP 액세스 제어입니다.

Name 형식 Description
ip

IPAccessControl

IP 액세스 제어 속성입니다.

LiveEventInputProtocol

라이브 이벤트에 대한 입력 프로토콜입니다. 생성 시 지정되며 업데이트할 수 없습니다.

Name 형식 Description
FragmentedMP4

string

부드러운 스트리밍 입력은 기여 인코더에서 라이브 이벤트로 전송됩니다.
RTMP

string

RTMP 입력은 기여 인코더에서 라이브 이벤트로 전송됩니다.

LiveEventInputTrackSelection

트랙 선택 조건입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.

Name 형식 Description
operation

string

작업 비교. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.
property

string

선택할 속성 이름입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.
value

string

선택할 속성 값입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.

LiveEventOutputTranscriptionTrack

음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에 있는 전사 트랙에 대해 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.

Name 형식 Description
trackName

string

출력 트랙 이름입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.

LiveEventPreview

라이브 이벤트 미리 보기 설정.

Name 형식 Description
accessControl

LiveEventPreviewAccessControl

라이브 이벤트 미리 보기에 대한 액세스 제어입니다.
alternativeMediaId

string

미리 보기용으로 만든 스트리밍 로케이터와 연결된 대체 미디어 식별자입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 식별자는 StreamingPolicyName 필드에 지정된 StreamingPolicy의 CustomLicenseAcquisitionUrlTemplate 또는 CustomKeyAcquisitionUrlTemplate에서 사용할 수 있습니다.
endpoints

LiveEventEndpoint[]

미리 보기용 엔드포인트입니다. 미리 보기 URL을 라이브 이벤트 대상 그룹과 공유하지 마세요.
previewLocator

string

Guid 형식의 미리 보기 로케이터 식별자입니다. 생성 시 이를 지정하면 이벤트를 만들기 전에 호출자가 미리 보기 로케이터 URL을 알 수 있습니다. 생략하면 서비스는 임의 식별자를 생성합니다. 라이브 이벤트가 만들어지면 이 값을 업데이트할 수 없습니다.
streamingPolicyName

string

라이브 이벤트 미리 보기에 사용되는 스트리밍 정책의 이름입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다.

LiveEventPreviewAccessControl

라이브 이벤트 미리 보기 엔드포인트에 대한 IP 액세스 제어입니다.

Name 형식 Description
ip

IPAccessControl

IP 액세스 제어 속성입니다.

LiveEventResourceState

라이브 이벤트의 리소스 상태입니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2139012 을 참조하세요.

Name 형식 Description
Allocating

string

라이브 이벤트에서 할당 작업이 호출되었으며 이 라이브 이벤트에 대한 리소스가 프로비전되고 있습니다. 할당이 성공적으로 완료되면 라이브 이벤트가 대기 상태로 전환됩니다.
Deleting

string

라이브 이벤트가 삭제됩니다. 이 일시적인 상태에서는 요금이 청구되지 않습니다. 이 상태 중에는 업데이트나 스트리밍이 허용되지 않습니다.
Running

string

라이브 이벤트 리소스가 할당되고, 수집 및 미리 보기 URL이 생성되었으며, 라이브 스트림을 수신할 수 있습니다. 이 시점에는 청구가 활성 상태입니다. 추가 청구를 중지하려면 라이브 이벤트 리소스에 대해 명시적으로 Stop을 호출해야 합니다.
StandBy

string

라이브 이벤트 리소스가 프로비전되었으며 시작할 준비가 되었습니다. 이 상태에서는 요금이 청구됩니다. 이 상태에서도 대부분의 속성을 업데이트할 수 있지만 수집이나 스트리밍은 허용되지 않습니다.
Starting

string

라이브 이벤트가 시작되고 리소스가 할당되고 있습니다. 이 상태에서는 요금이 청구되지 않습니다. 이 상태 중에는 업데이트나 스트리밍이 허용되지 않습니다. 오류가 발생하면 라이브 이벤트가 중지 상태로 돌아갑니다.
Stopped

string

자동 시작이 true로 설정되지 않은 경우 라이브 이벤트를 생성한 후의 초기 상태입니다. 이 상태에서는 요금이 청구되지 않습니다. 이 상태에서는 라이브 이벤트 속성을 업데이트할 수 있지만 스트리밍은 허용되지 않습니다.
Stopping

string

라이브 이벤트가 중지되고, 리소스가 프로비저닝 해제되고 있습니다. 이 일시적인 상태에서는 요금이 청구되지 않습니다. 이 상태 중에는 업데이트나 스트리밍이 허용되지 않습니다.

LiveEventTimedMetadataEndpoint

라이브 이벤트 메타데이터 삽입 엔드포인트입니다.

Name 형식 Description
url

string

메타데이터 엔드포인트 URL입니다.

LiveEventTranscription

음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에서 전사 트랙을 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.

Name 형식 Description
inputTrackSelection

LiveEventInputTrackSelection[]

음성 텍스트 변환 전사가 적용되는 입력 라이브 피드에서 오디오 트랙을 선택하는 메커니즘을 제공합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.
language

string

음성 텍스트 변환 전사에 사용할 언어(로캘)를 지정합니다. 오디오 트랙의 음성 언어와 일치해야 합니다. 값은 BCP-47 형식이어야 합니다(예: 'en-US'). 라이브 전사 기능 및 지원되는 언어 목록에 대한 자세한 내용은 를 참조 https://go.microsoft.com/fwlink/?linkid=2133742 하세요.
outputTranscriptionTrack

LiveEventOutputTranscriptionTrack

음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에서 전사 트랙에 대해 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.

StreamOptionsFlag

LiveEvent에 사용할 옵션입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 배열 항목 값에 유효한 값은 'Default' 및 'LowLatency'입니다.

Name 형식 Description
Default

string

특별한 대기 시간 최적화 없이 라이브 스트리밍.
LowLatency

string

라이브 이벤트는 내부 버퍼를 줄여 종단 간 대기 시간을 줄입니다.
LowLatencyV2

string

라이브 이벤트는 종단 간 대기 시간에 최적화되어 있습니다. 이 옵션은 RTMP 입력을 사용하여 라이브 이벤트를 인코딩하는 경우에만 사용할 수 있습니다. 출력은 HLS 또는 DASH 형식을 사용하여 스트리밍할 수 있습니다. 출력의 보관 또는 DVR 되윈드 길이는 6시간으로 제한됩니다. 다른 모든 시나리오에 대해 "LowLatency" 스트림 옵션을 사용합니다.

StretchMode

원하는 출력 해상도에 맞게 입력 비디오의 크기를 조정하는 방법을 지정합니다. 기본값은 없음입니다.

Name 형식 Description
AutoFit

string

출력의 활성 비디오 영역이 입력과 동일한 가로 세로 비율을 가지도록 하면서 출력 해상도를 적용하기 위해 출력(레터박스 또는 필라 상자 포함)을 채우세요. 예를 들어 입력이 1920x1080이고 인코딩 사전 설정이 1280x1280을 요청하는 경우 출력은 1280x1280으로, 가로 세로 비율이 16:9인 내부 사각형 1280x720을 포함하고 기둥 상자 영역은 왼쪽과 오른쪽에서 너비가 280픽셀입니다.
AutoSize

string

출력 해상도를 재정의하고 패딩 없이 입력의 표시 가로 세로 비율과 일치하도록 변경합니다. 예를 들어, 입력이 1920x1080이고 인코딩 사전 설정에서 1280x1280을 요청하는 경우 사전 설정의 값이 재정의되고 출력이 1280x720이 되어 16:9의 입력 가로 세로 비율이 유지됩니다.
None

string

입력 비디오의 픽셀 가로 세로 비율 또는 표시 가로 세로 비율을 고려하지 않고 인코딩 사전 설정에 지정된 출력 해상도를 엄격하게 준수합니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.
createdBy

string

리소스를 만든 ID입니다.
createdByType

createdByType

리소스를 만든 ID의 형식입니다.
lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.