Videos - Create Or Update

새 비디오 리소스를 만들거나 기존 비디오 리소스를 업데이트합니다.
새 비디오 리소스를 만들거나 지정된 이름으로 기존 비디오 리소스를 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/videos/{videoName}?api-version=2021-11-01-preview

URI 매개 변수

Name In Required Type Description
accountName
path True
  • string

Azure Video Analyzer 계정 이름입니다.

resourceGroupName
path True
  • string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True
  • string

대상 구독의 ID입니다.

videoName
path True
  • string

비디오 이름입니다.

api-version
query True
  • string

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

요청 본문

Name Type Description
properties.archival

비디오 보관 속성입니다.

properties.description
  • string

사용자가 제공하는 선택적 비디오 설명입니다. 값은 최대 2048자까지 가능합니다.

properties.mediaInfo

비디오 및 오디오 콘텐츠에 대한 정보를 포함합니다.

properties.title
  • string

사용자가 제공하는 선택적 비디오 제목입니다. 값은 최대 256자까지 가능합니다.

응답

Name Type Description
200 OK

확인

201 Created

생성일

Other Status Codes

자세한 오류 정보입니다.

예제

Register video entity.

Sample Request

PUT https://management.azure.com/subscriptions/591e76c3-3e97-44db-879c-3e2b12961b62/resourceGroups/testrg/providers/Microsoft.Media/videoAnalyzers/testaccount2/videos/video1?api-version=2021-11-01-preview

{
  "properties": {
    "title": "Sample Title 1",
    "description": "Sample Description 1"
  }
}

Sample Response

{
  "name": "video2",
  "id": "/subscriptions/591e76c3-3e97-44db-879c-3e2b12961b62/resourceGroups/testrg/providers/Microsoft.Media/videoAnalyzers/testaccount2/videos/video2",
  "type": "Microsoft.Media/videoAnalyzers/videos",
  "properties": {
    "title": "Sample Title 1",
    "description": "Sample Description 1",
    "type": "Archive",
    "flags": {
      "canStream": false,
      "hasData": false,
      "isInUse": false
    },
    "archival": {
      "retentionPeriod": "P7D"
    }
  },
  "systemData": {
    "createdBy": "user@microsoft.com",
    "createdByType": "User",
    "createdAt": "0001-01-01T00:00:00Z",
    "lastModifiedBy": "user@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "0001-01-01T00:00:00Z"
  }
}
{
  "name": "video1",
  "id": "/subscriptions/591e76c3-3e97-44db-879c-3e2b12961b62/resourceGroups/testrg/providers/Microsoft.Media/videoAnalyzers/testaccount2/videos/video1",
  "type": "Microsoft.Media/videoAnalyzers/videos",
  "properties": {
    "title": "Sample Title 1",
    "description": "Sample Description 1",
    "type": "Archive",
    "flags": {
      "canStream": true,
      "hasData": true,
      "isInUse": false
    },
    "contentUrls": {
      "downloadUrl": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/content.mp4",
      "archiveBaseUrl": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/content.ism",
      "rtspTunnelUrl": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62",
      "previewImageUrls": {
        "small": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/images/latest/small.jpg",
        "medium": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/images/latest/medium.jpg",
        "large": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/images/latest/large.jpg"
      }
    },
    "mediaInfo": {
      "segmentLength": "PT30S"
    },
    "archival": {
      "retentionPeriod": "P7D"
    }
  },
  "systemData": {
    "createdBy": "user@microsoft.com",
    "createdByType": "User",
    "createdAt": "0001-01-01T00:00:00Z",
    "lastModifiedBy": "user@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "0001-01-01T00:00:00Z"
  }
}

정의

createdByType

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

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

VideoArchival

비디오 보관 속성입니다.

VideoContentUrls

비디오 콘텐츠에 대한 URL 집합입니다.

VideoEntity

Azure Video Analyzer 내의 비디오 리소스를 나타냅니다. 라이브 파이프라인을 통해 RTSP 카메라에서 비디오를 수집하거나 파이프라인 작업을 통해 기존 캡처된 비디오에서 시퀀스를 내보내서 만들 수 있습니다. 라이브 파이프라인을 통해 수집된 비디오는 Azure Video Analyzer 플레이어 위젯 또는 호환되는 플레이어를 통해 스트리밍할 수 있습니다. 내보낸 비디오는 MP4 파일로 다운로드할 수 있습니다.

VideoFlags

비디오 플래그에는 현재 비디오 상태에 따라 사용 가능한 비디오 작업 및 동적 속성에 대한 정보가 포함됩니다.

VideoMediaInfo

비디오 및 오디오 콘텐츠에 대한 정보를 포함합니다.

VideoPreviewImageUrls

비디오 미리 보기 이미지 URL입니다. 이러한 URL은 비디오 콘텐츠 권한 부여 토큰과 함께 사용하여 비디오 아카이브의 최신 스틸 이미지를 다른 해상도로 다운로드할 수 있습니다. 비디오 유형이 '보관'이고 미리 보기 이미지가 사용하도록 설정된 경우 사용할 수 있습니다.

VideoType

비디오 콘텐츠 형식입니다. 다양한 콘텐츠 형식은 다양한 애플리케이션 및 시나리오에 적합합니다.

createdByType

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

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

ErrorAdditionalInfo

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

Name Type Description
info
  • object

추가 정보입니다.

type
  • string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name Type Description
additionalInfo

오류 추가 정보입니다.

code
  • string

오류 코드입니다.

details

오류 세부 정보입니다.

message
  • string

오류 메시지입니다.

target
  • string

오류 대상입니다.

ErrorResponse

오류 응답

Name Type Description
error

오류 개체입니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name Type Description
createdAt
  • string

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

createdBy
  • string

리소스를 만든 ID입니다.

createdByType

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

lastModifiedAt
  • string

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

lastModifiedBy
  • string

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

lastModifiedByType

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

VideoArchival

비디오 보관 속성입니다.

Name Type Description
retentionPeriod
  • string

비디오 보존 기간은 스토리지에 보관할 비디오 보관 세그먼트의 최대 기간을 나타냅니다. ISO8601 기간 형식은 최대 10년의 세분성으로 제공되어야 합니다. 예를 들어 P30D(30일)로 설정된 경우 30일보다 오래된 콘텐츠는 주기적으로 삭제됩니다. 이 값은 언제든지 업데이트할 수 있으며 원하는 새 보존 기간은 24시간 이내에 적용됩니다.

VideoContentUrls

비디오 콘텐츠에 대한 URL 집합입니다.

Name Type Description
archiveBaseUrl
  • string

비디오 보관 스트리밍 기본 URL입니다. 보관된 콘텐츠는 Azure Video Analyzer 플레이어 위젯에서 자동으로 재생할 수 있습니다. 또는 기본 URL에 다음을 추가하여 호환되는 DASH 또는 HLS 플레이어의 비디오 콘텐츠 권한 부여 토큰과 함께 이 URL을 사용할 수 있습니다.

- HLSv4:     /manifest(format=m3u8-aapl).m3u8
- HLS CMAF:  /manifest(format=m3u8-cmaf)
- DASH CMAF: /manifest(format=mpd-time-cmaf)

Moreover, an ongoing video recording can be played in "live mode" with latencies which are approximately double of the chosen video segment length. It is available when the video type is 'archive' and video archiving is enabled.
downloadUrl
  • string

비디오 파일 다운로드 URL입니다. 이 URL은 비디오 콘텐츠 권한 부여 토큰과 함께 사용하여 비디오 MP4 파일을 다운로드할 수 있습니다. 결과 MP4 파일은 모든 표준 미디어 플레이어에서 재생할 수 있습니다. 비디오 형식이 'file'이고 비디오 파일을 사용할 수 있는 경우 사용할 수 있습니다.

previewImageUrls

비디오 미리 보기 이미지 URL입니다. 이러한 URL은 비디오 콘텐츠 권한 부여 토큰과 함께 사용하여 비디오 아카이브의 최신 스틸 이미지를 다른 해상도로 다운로드할 수 있습니다. 비디오 유형이 '보관'이고 미리 보기 이미지가 사용하도록 설정된 경우 사용할 수 있습니다.

rtspTunnelUrl
  • string

비디오 대기 시간이 짧은 스트리밍 URL입니다. 라이브 콘텐츠는 Azure Video Analyzer 플레이어 위젯에서 자동으로 재생할 수 있습니다. 또는 이 URL을 비디오 콘텐츠 권한 부여 토큰과 함께 사용하여 WebSocket 터널된 RTSP 스트림을 노출할 수 있습니다. 비디오 유형이 '보관'이고 라이브 대기 시간이 짧은 피드를 원본에서 사용할 수 있는 경우에 사용할 수 있습니다.

VideoEntity

Azure Video Analyzer 내의 비디오 리소스를 나타냅니다. 라이브 파이프라인을 통해 RTSP 카메라에서 비디오를 수집하거나 파이프라인 작업을 통해 기존 캡처된 비디오에서 시퀀스를 내보내서 만들 수 있습니다. 라이브 파이프라인을 통해 수집된 비디오는 Azure Video Analyzer 플레이어 위젯 또는 호환되는 플레이어를 통해 스트리밍할 수 있습니다. 내보낸 비디오는 MP4 파일로 다운로드할 수 있습니다.

Name Type Description
id
  • string

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

name
  • string

리소스의 이름입니다.

properties.archival

비디오 보관 속성입니다.

properties.contentUrls

비디오 콘텐츠에 대한 URL 집합입니다.

properties.description
  • string

사용자가 제공하는 선택적 비디오 설명입니다. 값은 최대 2048자까지 가능합니다.

properties.flags

비디오 플래그에는 현재 비디오 상태에 따라 사용 가능한 비디오 작업 및 동적 속성에 대한 정보가 포함됩니다.

properties.mediaInfo

비디오 및 오디오 콘텐츠에 대한 정보를 포함합니다.

properties.title
  • string

사용자가 제공하는 선택적 비디오 제목입니다. 값은 최대 256자까지 가능합니다.

properties.type

비디오 콘텐츠 형식입니다. 다양한 콘텐츠 형식은 다양한 애플리케이션 및 시나리오에 적합합니다.

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.

type
  • string

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

VideoFlags

비디오 플래그에는 현재 비디오 상태에 따라 사용 가능한 비디오 작업 및 동적 속성에 대한 정보가 포함됩니다.

Name Type Description
canStream
  • boolean

비디오를 스트리밍할 수 있는지 여부를 나타내는 값입니다. "보관" 형식 비디오만 스트리밍할 수 있습니다.

hasData
  • boolean

비디오에 기록되거나 업로드된 데이터가 있는지 여부를 나타내는 값입니다. 새로 만든 비디오에는 이 값이 false로 설정됩니다.

isInUse
  • boolean

현재 비디오가 활성 파이프라인으로 참조되고 있는지 여부를 나타내는 값입니다. 참조되는 사실이 반드시 데이터가 수신되고 있음을 나타내는 것은 아닙니다. 예를 들어, 이벤트 또는 카메라에서 비디오 녹화가 제어될 수 있으며, 당시에는 카메라에 액세스할 수 없습니다.

VideoMediaInfo

비디오 및 오디오 콘텐츠에 대한 정보를 포함합니다.

Name Type Description
segmentLength
  • string

비디오 세그먼트 길이는 스토리지에 유지되는 개별 비디오 파일(세그먼트)의 길이를 나타냅니다. 세그먼트가 작을수록 보관 재생 대기 시간이 짧아지지만 더 많은 양의 스토리지 트랜잭션이 생성됩니다. 세그먼트가 클수록 스토리지 트랜잭션의 양이 줄어들고 보관 재생 대기 시간이 늘어나게 됩니다. 값은 ISO8601 기간 형식(즉, "PT30S"은 30초)으로 지정해야 하며 30초에서 5분 사이(30초 단위로) 달라질 수 있습니다.

VideoPreviewImageUrls

비디오 미리 보기 이미지 URL입니다. 이러한 URL은 비디오 콘텐츠 권한 부여 토큰과 함께 사용하여 비디오 아카이브의 최신 스틸 이미지를 다른 해상도로 다운로드할 수 있습니다. 비디오 유형이 '보관'이고 미리 보기 이미지가 사용하도록 설정된 경우 사용할 수 있습니다.

Name Type Description
large
  • string

고해상도 미리 보기 이미지 URL입니다.

medium
  • string

중간 해상도 미리 보기 이미지 URL입니다.

small
  • string

낮은 해상도 미리 보기 이미지 URL입니다.

VideoType

비디오 콘텐츠 형식입니다. 다양한 콘텐츠 형식은 다양한 애플리케이션 및 시나리오에 적합합니다.

Name Type Description
Archive
  • string

보관은 벽시계 시간과 연결된 비디오 스트림을 나타내는 유연한 형식입니다. 비디오 보관은 연속적이거나 불연속적일 수 있습니다. 라이브 파이프라인이 중지되거나, 카메라 연결이 끊어지거나, 신호 게이트를 사용하여 이벤트 기반 녹화를 사용하기 때문에 여러 가지 이유로 인해 기록에 간격이 있는 경우 보관은 불연속적입니다. 동일한 비디오 코덱 및 코덱 매개 변수를 사용하는 한 보관 기간에 제한이 없으며 새 비디오 데이터를 언제든지 기존 아카이브에 추가할 수 있습니다. 이 유형의 비디오는 추가 및 장기 보관에 적합합니다.

File
  • string

파일은 MP4와 같은 단일 미디어 파일로 저장되는 비디오를 나타냅니다. 이 유형의 비디오는 외부 사용을 위해 다운로드하기에 적합합니다.