다음을 통해 공유

Stream Operations - Get Media

  • 참조
서비스:
Communication
API 버전:
2024-08-30

사용자에서 비즈니스 메시지로 미디어 페이로드를 다운로드합니다.

GET {endpoint}/messages/streams/{id}?api-version=2024-08-30

URI 매개 변수

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

string

uri

통신 리소스(예: https://my-resource.communication.azure.com
id
 path True

string

스트림 ID입니다.
api-version
 query True

string

이 작업에 사용할 API 버전입니다.

요청 헤더

Name 필수 형식 Description
x-ms-client-request-id

string

uuid

요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다.

응답

Name 형식 Description
200 OK

file

요청이 성공했습니다.

Media Types: "application/octet-stream", "application/json"

헤더

x-ms-client-request-id: string
Other Status Codes

Azure.Core.Foundations.ErrorResponse

예기치 않은 오류 응답입니다.

Media Types: "application/octet-stream", "application/json"

헤더

x-ms-error-code: string

보안

AadOauth2Auth

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: accessCode
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize
토큰 URL: https://login.microsoftonline.com/common/oauth2/token

범위

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

Authorization

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

예제

Download media

샘플 요청

GET https://my-resource.communication.azure.com/messages/streams/d19e68ec-bdd6-4a50-8dfb-cbb1642df6ab?api-version=2024-08-30

샘플 응답

상태 코드:
200 
"<binary_media_data>"

정의

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/Guidelines.md#7102-error-condition-responses.

Azure.Core.Foundations.Error

오류 개체입니다.

Name 형식 Description
code

string

서버에서 정의한 오류 코드 집합 중 하나입니다.
details

Azure.Core.Foundations.Error[]

이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror

Azure.Core.Foundations.InnerError

오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message

string

사람이 읽을 수 있는 오류 표현입니다.
target

string

오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

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

Name 형식 Description
error

Azure.Core.Foundations.Error

오류 개체입니다.

Azure.Core.Foundations.InnerError

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

Name 형식 Description
code

string

서버에서 정의한 오류 코드 집합 중 하나입니다.
innererror

Azure.Core.Foundations.InnerError

내부 오류입니다.