Videos - Create Or Update

Membuat sumber daya video baru atau memperbarui yang sudah ada.
Membuat sumber daya video baru atau memperbarui sumber daya video yang ada dengan nama yang diberikan.

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

Parameter URI

Name In Required Type Description
accountName
path True
  • string

Nama akun Azure Video Analyzer.

resourceGroupName
path True
  • string

Nama grup sumber daya. Nama tidak peka huruf besar/kecil.

subscriptionId
path True
  • string

ID langganan target.

videoName
path True
  • string

Nama Video.

api-version
query True
  • string

Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Name Type Description
properties.archival

Properti arsip video.

properties.description
  • string

Deskripsi video opsional yang disediakan oleh pengguna. Panjang nilainya bisa hingga 2048 karakter.

properties.mediaInfo

Berisi informasi tentang konten video dan audio.

properties.title
  • string

Judul video opsional yang disediakan oleh pengguna. Panjang nilainya bisa hingga 256 karakter.

Respons

Name Type Description
200 OK

OK

201 Created

Dibuat

Other Status Codes

Informasi kesalahan terperinci.

Contoh

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"
  }
}

Definisi

createdByType

Jenis identitas yang membuat sumber daya.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Respons kesalahan

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

VideoArchival

Properti arsip video.

VideoContentUrls

Kumpulan URL ke konten video.

VideoEntity

Mewakili sumber daya video dalam Azure Video Analyzer. Video dapat diserap dari kamera RTSP melalui alur langsung atau dapat dibuat dengan mengekspor urutan dari video yang diambil yang ada melalui pekerjaan alur. Video yang diserap melalui alur langsung dapat dialirkan melalui Widget Pemutar Azure Video Analyzer atau pemutar yang kompatibel. Video yang diekspor dapat diunduh sebagai file MP4.

VideoFlags

Bendera video berisi informasi tentang tindakan video yang tersedia dan properti dinamisnya berdasarkan status video saat ini.

VideoMediaInfo

Berisi informasi tentang konten video dan audio.

VideoPreviewImageUrls

URL gambar pratinjau video. URL ini dapat digunakan bersama dengan token otorisasi konten video untuk mengunduh gambar diam terbaru dari arsip video dalam resolusi yang berbeda. Mereka tersedia ketika jenis video 'arsip' dan gambar pratinjau diaktifkan.

VideoType

Jenis konten video. Jenis konten yang berbeda cocok untuk aplikasi dan skenario yang berbeda.

createdByType

Jenis identitas yang membuat sumber daya.

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

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Name Type Description
info
  • object

Info tambahan.

type
  • string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Name Type Description
additionalInfo

Info tambahan kesalahan.

code
  • string

Kode kesalahan.

details

Detail kesalahan.

message
  • string

Pesan kesalahan.

target
  • string

Target kesalahan.

ErrorResponse

Respons kesalahan

Name Type Description
error

Objek kesalahan.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Name Type Description
createdAt
  • string

Tanda waktu pembuatan sumber daya (UTC).

createdBy
  • string

Identitas yang membuat sumber daya.

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt
  • string

Tanda waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy
  • string

Identitas yang terakhir memodifikasi sumber daya.

lastModifiedByType

Jenis identitas yang terakhir mengubah sumber daya.

VideoArchival

Properti arsip video.

Name Type Description
retentionPeriod
  • string

Periode retensi video menunjukkan usia maksimum segmen arsip video yang dimaksudkan untuk disimpan dalam penyimpanan. Ini harus disediakan dalam format durasi ISO8601 dalam granularitas hari, hingga maksimum 10 tahun. Misalnya, jika ini diatur ke P30D (30 hari), konten yang lebih lama dari 30 hari akan dihapus secara berkala. Nilai ini dapat diperbarui kapan saja dan periode retensi baru yang diinginkan akan berlaku dalam waktu 24 jam.

VideoContentUrls

Kumpulan URL ke konten video.

Name Type Description
archiveBaseUrl
  • string

URL dasar streaming arsip video. Konten yang diarsipkan dapat diputar secara otomatis oleh widget pemutar Azure Video Analyzer. Atau, URL ini dapat digunakan bersama dengan token otorisasi konten video pada pemutar DASH atau HLS yang kompatibel dengan menambahkan yang berikut ke URL dasar:

- 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 unduhan file video. URL ini dapat digunakan bersama dengan token otorisasi konten video untuk mengunduh file MP4 video. File MP4 yang dihasilkan dapat dimainkan pada pemutar media standar apa pun. Ini tersedia ketika jenis video adalah 'file' dan file video tersedia untuk dikonsumsi.

previewImageUrls

URL gambar pratinjau video. URL ini dapat digunakan bersama dengan token otorisasi konten video untuk mengunduh gambar diam terbaru dari arsip video dalam resolusi yang berbeda. Mereka tersedia ketika jenis video 'arsip' dan gambar pratinjau diaktifkan.

rtspTunnelUrl
  • string

URL streaming latensi rendah video. Konten langsung dapat diputar secara otomatis oleh widget pemutar Azure Video Analyzer. Atau, URL ini dapat digunakan bersama dengan token otorisasi konten video untuk mengekspos aliran RTSP terowongan WebSocket. Ini tersedia ketika jenis video adalah 'arsip' dan umpan latensi rendah langsung tersedia dari sumbernya.

VideoEntity

Mewakili sumber daya video dalam Azure Video Analyzer. Video dapat diserap dari kamera RTSP melalui alur langsung atau dapat dibuat dengan mengekspor urutan dari video yang diambil yang ada melalui pekerjaan alur. Video yang diserap melalui alur langsung dapat dialirkan melalui Widget Pemutar Azure Video Analyzer atau pemutar yang kompatibel. Video yang diekspor dapat diunduh sebagai file MP4.

Name Type Description
id
  • string

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Nama sumber daya.

properties.archival

Properti arsip video.

properties.contentUrls

Kumpulan URL ke konten video.

properties.description
  • string

Deskripsi video opsional yang disediakan oleh pengguna. Panjang nilainya bisa hingga 2048 karakter.

properties.flags

Bendera video berisi informasi tentang tindakan video yang tersedia dan properti dinamisnya berdasarkan status video saat ini.

properties.mediaInfo

Berisi informasi tentang konten video dan audio.

properties.title
  • string

Judul video opsional yang disediakan oleh pengguna. Panjang nilainya bisa hingga 256 karakter.

properties.type

Jenis konten video. Jenis konten yang berbeda cocok untuk aplikasi dan skenario yang berbeda.

systemData

Metadata Azure Resource Manager berisi informasi createdBy dan modifiedBy.

type
  • string

Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft. Storage/storageAccounts"

VideoFlags

Bendera video berisi informasi tentang tindakan video yang tersedia dan properti dinamisnya berdasarkan status video saat ini.

Name Type Description
canStream
  • boolean

Nilai yang menunjukkan apakah video dapat di-streaming atau tidak. Hanya video jenis "arsip" yang dapat di-streaming.

hasData
  • boolean

Nilai yang menunjukkan apakah pernah ada data yang direkam atau diunggah ke dalam video atau tidak. Video yang baru dibuat memiliki nilai ini diatur ke false.

isInUse
  • boolean

Nilai yang menunjukkan apakah video saat ini sedang dirujuk atau tidak menjadi alur aktif. Fakta yang sedang dirujuk, tidak selalu menunjukkan bahwa data sedang diterima. Misalnya, perekaman video mungkin terjaga pada peristiwa atau kamera mungkin tidak dapat diakses pada saat itu.

VideoMediaInfo

Berisi informasi tentang konten video dan audio.

Name Type Description
segmentLength
  • string

Panjang segmen video menunjukkan panjang file video individual (segmen) yang bertahan pada penyimpanan. Segmen yang lebih kecil memberikan latensi pemutaran arsip yang lebih rendah tetapi menghasilkan volume transaksi penyimpanan yang lebih besar. Segmen yang lebih besar mengurangi jumlah transaksi penyimpanan sekaligus meningkatkan latensi pemutaran arsip. Nilai harus ditentukan dalam format durasi ISO8601 (yaitu "PT30S" sama dengan 30 detik) dan dapat bervariasi antara 30 detik hingga 5 menit, dalam kenaikan 30 detik.

VideoPreviewImageUrls

URL gambar pratinjau video. URL ini dapat digunakan bersama dengan token otorisasi konten video untuk mengunduh gambar diam terbaru dari arsip video dalam resolusi yang berbeda. Mereka tersedia ketika jenis video 'arsip' dan gambar pratinjau diaktifkan.

Name Type Description
large
  • string

URL gambar pratinjau resolusi tinggi.

medium
  • string

URL gambar pratinjau resolusi sedang.

small
  • string

URL gambar pratinjau resolusi rendah.

VideoType

Jenis konten video. Jenis konten yang berbeda cocok untuk aplikasi dan skenario yang berbeda.

Name Type Description
Archive
  • string

Arsip adalah format fleksibel yang mewakili aliran video yang terkait dengan waktu jam dinding. Arsip video dapat berkelanjutan atau tidak berkelanjutan. Arsip dihentikan ketika ada celah dalam rekaman karena berbagai alasan, seperti alur langsung dihentikan, kamera terputus atau karena penggunaan rekaman berbasis peristiwa melalui penggunaan gerbang sinyal. Tidak ada batasan untuk durasi arsip dan data video baru dapat ditambahkan ke arsip yang ada kapan saja, selama codec video dan parameter codec yang sama digunakan. Video jenis ini cocok untuk ditambahkan dan arsip jangka panjang.

File
  • string

File mewakili video yang disimpan sebagai file media tunggal, seperti MP4. Video jenis ini cocok untuk diunduh untuk konsumsi eksternal.