Event Hub Configuration Operations - Create Or Replace Event Hub Configuration

서비스:

Azure AI Services

API 버전:

2025-05-20

EventHub 구성을 만들거나 바꿉니다.

PUT {endpoint}/videotranslation/configurations/event-hub?api-version=2025-05-20

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://eastus.api.cognitive.microsoft.com).
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	Description
enabledEvents	True	EventHubVideoTranslationEventKind[]	알림에 사용할 수 있는 이벤트 종류입니다.
eventHubName	True	string	EventHub 이름입니다.
eventHubNamespaceHostName	True	string	EventHub 네임스페이스 호스트 이름(예: [YourNamespace].servicebus.windows.net)
isEnabled	True	boolean	EventHub로 이벤트 보내기를 활성화할지 여부를 나타냅니다.
managedIdentityClientId		string pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$	관리 ID 클라이언트 ID: 사용자가 할당한 관리 ID에 대한 ID를 지정하지 않으면 API는 시스템이 할당한 관리 ID를 사용합니다.

응답

Name	형식	Description
200 OK	EventHubConfiguration	요청이 성공했습니다.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

여기에서 Speech 리소스 키를 제공합니다.

형식: apiKey
In(다음 안에): header

AADToken

다음은 Microsoft ID 플랫폼 흐름입니다.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
https://cognitiveservices.azure.com/.default

예제

Create or replace EventHub configuration

샘플 요청

HTTP

PUT {endpoint}/videotranslation/configurations/event-hub?api-version=2025-05-20

{
  "isEnabled": true,
  "eventHubNamespaceHostName": "your-event-hub-namespace.servicebus.windows.net",
  "eventHubName": "your-event-hub-name",
  "managedIdentityClientId": "4b9ccd1c-c751-4afa-a430-a49a5471fd68",
  "enabledEvents": [
    "TranslationCompletion",
    "IterationCompletion"
  ]
}

샘플 응답

상태 코드:

200

{
  "isEnabled": true,
  "eventHubNamespaceHostName": "your-event-hub-namespace.servicebus.windows.net",
  "eventHubName": "your-event-hub-name",
  "managedIdentityClientId": "4b9ccd1c-c751-4afa-a430-a49a5471fd68",
  "enabledEvents": [
    "TranslationCompletion",
    "IterationCompletion"
  ]
}

정의

Name	Description
Azure.Core.Foundations.Error	오류 개체입니다.
Azure.Core.Foundations.ErrorResponse	오류 세부 정보가 포함된 응답입니다.
Azure.Core.Foundations.InnerError	오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
EventHubConfiguration	EventHub 구성.
EventHubVideoTranslationEventKind	EventHub 이벤트 종류입니다.

Azure.Core.Foundations.Error

Object

오류 개체입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	Azure.Core.Foundations.Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	Azure.Core.Foundations.InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

Object

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	Azure.Core.Foundations.Error	오류 개체입니다.

Azure.Core.Foundations.InnerError

Object

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Microsoft One API 지침에 따라 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
innererror	Azure.Core.Foundations.InnerError	내부 오류입니다.

EventHubConfiguration

Object

EventHub 구성.

Name	형식	Description
enabledEvents	EventHubVideoTranslationEventKind[]	알림에 사용할 수 있는 이벤트 종류입니다.
eventHubName	string	EventHub 이름입니다.
eventHubNamespaceHostName	string	EventHub 네임스페이스 호스트 이름(예: [YourNamespace].servicebus.windows.net)
isEnabled	boolean	EventHub로 이벤트 보내기를 활성화할지 여부를 나타냅니다.
managedIdentityClientId	string pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$	관리 ID 클라이언트 ID: 사용자가 할당한 관리 ID에 대한 ID를 지정하지 않으면 API는 시스템이 할당한 관리 ID를 사용합니다.

EventHubVideoTranslationEventKind

열거형

EventHub 이벤트 종류입니다.

값	Description
IterationCompletion	반복이 완료되거나 실패했을 때 EventHub로 이벤트를 보냅니다.
Ping	ping API가 요청되면 EventHub로 이벤트를 보냅니다.
TranslationCompletion	번역이 완료되거나 실패한 경우 EventHub로 이벤트를 보냅니다.