Videos - Create Or Update

Yeni bir video kaynağı oluşturur veya mevcut bir video kaynağını güncelleştirir.
Yeni bir video kaynağı oluşturur veya mevcut bir video kaynağını verilen adla güncelleştirir.

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

URI Parametreleri

Name In Required Type Description
accountName
path True
  • string

Azure Video Analyzer hesap adı.

resourceGroupName
path True
  • string

Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir.

subscriptionId
path True
  • string

Hedef aboneliğin kimliği.

videoName
path True
  • string

Video adı.

api-version
query True
  • string

Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name Type Description
properties.archival

Video arşivleme özellikleri.

properties.description
  • string

kullanıcı tarafından sağlanan isteğe bağlı video açıklaması. Değer en fazla 2048 karakter uzunluğunda olabilir.

properties.mediaInfo

Video ve ses içeriği hakkında bilgi içerir.

properties.title
  • string

kullanıcı tarafından sağlanan isteğe bağlı video başlığı. Değer en çok 256 karakter uzunluğunda olabilir.

Yanıtlar

Name Type Description
200 OK

Tamam

201 Created

Oluşturulan

Other Status Codes

Ayrıntılı hata bilgileri.

Örnekler

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

Tanımlar

createdByType

Kaynağı oluşturan kimliğin türü.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

VideoArchival

Video arşivleme özellikleri.

VideoContentUrls

Video içeriğinin URL'leri kümesi.

VideoEntity

Azure Video Analyzer içindeki bir video kaynağını temsil eder. Videolar canlı işlem hatları aracılığıyla RTSP kameralarından alınabileceği gibi, bir işlem hattı işi aracılığıyla mevcut yakalanan videolardan diziler dışarı aktarılarak da oluşturulabilir. Canlı işlem hatları aracılığıyla alınan videolar Azure Video Analyzer Oynatıcı Pencere Öğesi veya uyumlu oyuncular aracılığıyla akışla aktarılabilir. Dışarı aktarılan videolar MP4 dosyaları olarak indirilebilir.

VideoFlags

Video bayrakları, geçerli video durumuna göre kullanılabilir video eylemleri ve dinamik özellikleri hakkında bilgi içerir.

VideoMediaInfo

Video ve ses içeriği hakkında bilgi içerir.

VideoPreviewImageUrls

Video önizleme görüntüsü URL'leri. Bu URL'ler, video arşivinden en son hareketsiz görüntüyü farklı çözünürlüklerde indirmek için video içeriği yetkilendirme belirteci ile birlikte kullanılabilir. Bunlar, video türü 'arşiv' olduğunda ve önizleme görüntüleri etkinleştirildiğinde kullanılabilir.

VideoType

Video içerik türü. Farklı içerik türleri farklı uygulamalar ve senaryolar için uygundur.

createdByType

Kaynağı oluşturan kimliğin türü.

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

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Type Description
info
  • object

Ek bilgiler.

type
  • string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Type Description
additionalInfo

Hata ek bilgileri.

code
  • string

Hata kodu.

details

Hata ayrıntıları.

message
  • string

Hata iletisi.

target
  • string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Type Description
error

Hata nesnesi.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Type Description
createdAt
  • string

Kaynak oluşturma (UTC) zaman damgası.

createdBy
  • string

Kaynağı oluşturan kimlik.

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt
  • string

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy
  • string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

Kaynağı en son değiştiren kimliğin türü.

VideoArchival

Video arşivleme özellikleri.

Name Type Description
retentionPeriod
  • string

Video saklama süresi, depolamada tutulması amaçlanan video arşiv segmentlerinin maksimum yaşını gösterir. Iso8601 süre biçiminde, en fazla 10 yıla kadar, günlerin ayrıntı düzeyinde sağlanmalıdır. Örneğin, bu P30D (30 gün) olarak ayarlanırsa, 30 günden eski içerik düzenli aralıklarla silinir. Bu değer herhangi bir zamanda güncelleştirilebilir ve yeni istenen saklama süresi 24 saat içinde geçerli olur.

VideoContentUrls

Video içeriğinin URL'leri kümesi.

Name Type Description
archiveBaseUrl
  • string

Video arşivi akış temel URL'si. Arşivlenen içerik, Azure Video Analyzer oynatıcı pencere öğesi tarafından otomatik olarak oynatılabilir. Alternatif olarak, bu URL, aşağıdakiler temel URL'ye eklenerek uyumlu herhangi bir DASH veya HLS oynatıcıdaki video içeriği yetkilendirme belirteci ile birlikte kullanılabilir:

- 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

Video dosyası indirme URL'si. Bu URL, video MP4 dosyasını indirmek için video içeriği yetkilendirme belirteci ile birlikte kullanılabilir. Elde edilen MP4 dosyası herhangi bir standart medya oynatıcıda oynatılabilir. Video türü 'dosya' olduğunda ve video dosyası kullanım için kullanılabilir olduğunda kullanılabilir.

previewImageUrls

Video önizleme görüntüsü URL'leri. Bu URL'ler, video arşivinden en son hareketsiz görüntüyü farklı çözünürlüklerde indirmek için video içeriği yetkilendirme belirteci ile birlikte kullanılabilir. Bunlar, video türü 'arşiv' olduğunda ve önizleme görüntüleri etkinleştirildiğinde kullanılabilir.

rtspTunnelUrl
  • string

Video düşük gecikme süreli akış URL'si. Canlı içerik, Azure Video Analyzer oynatıcı pencere öğesi tarafından otomatik olarak oynatılabilir. Alternatif olarak bu URL, WebSocket tünelli RTSP akışını kullanıma açmak için video içeriği yetkilendirme belirteci ile birlikte kullanılabilir. Video türü 'arşiv' olduğunda ve kaynaktan canlı, düşük gecikme süreli bir akış sağlandığında kullanılabilir.

VideoEntity

Azure Video Analyzer içindeki bir video kaynağını temsil eder. Videolar canlı işlem hatları aracılığıyla RTSP kameralarından alınabileceği gibi, bir işlem hattı işi aracılığıyla mevcut yakalanan videolardan diziler dışarı aktarılarak da oluşturulabilir. Canlı işlem hatları aracılığıyla alınan videolar Azure Video Analyzer Oynatıcı Pencere Öğesi veya uyumlu oyuncular aracılığıyla akışla aktarılabilir. Dışarı aktarılan videolar MP4 dosyaları olarak indirilebilir.

Name Type Description
id
  • string

Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Kaynağın adı

properties.archival

Video arşivleme özellikleri.

properties.contentUrls

Video içeriğinin URL'leri kümesi.

properties.description
  • string

kullanıcı tarafından sağlanan isteğe bağlı video açıklaması. Değer en fazla 2048 karakter uzunluğunda olabilir.

properties.flags

Video bayrakları, geçerli video durumuna göre kullanılabilir video eylemleri ve dinamik özellikleri hakkında bilgi içerir.

properties.mediaInfo

Video ve ses içeriği hakkında bilgi içerir.

properties.title
  • string

kullanıcı tarafından sağlanan isteğe bağlı video başlığı. Değer en çok 256 karakter uzunluğunda olabilir.

properties.type

Video içerik türü. Farklı içerik türleri farklı uygulamalar ve senaryolar için uygundur.

systemData

Azure Resource Manager createdBy ve modifiedBy bilgilerini içeren meta veriler.

type
  • string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft. Depolama/storageAccounts"

VideoFlags

Video bayrakları, geçerli video durumuna göre kullanılabilir video eylemleri ve dinamik özellikleri hakkında bilgi içerir.

Name Type Description
canStream
  • boolean

Videonun akışla aktarılıp aktarılamayacağını gösteren değer. Yalnızca "arşiv" türünde videolar akışla aktarılabilir.

hasData
  • boolean

Videoya kaydedilmiş veya karşıya yüklenmiş veri olup olmadığını gösteren değer. Yeni oluşturulan videolarda bu değer false olarak ayarlanmıştır.

isInUse
  • boolean

Videoya şu anda başvurulup başvurulmadığını belirten değer etkin bir işlem hattıdır. Başvurulmakta olan gerçek, verilerin alındığını belirtmez. Örneğin, olaylarda video kaydına kapı açılabilir veya kameraya o sırada erişilemiyor olabilir.

VideoMediaInfo

Video ve ses içeriği hakkında bilgi içerir.

Name Type Description
segmentLength
  • string

Video segmenti uzunluğu, depolamada kalıcı olan tek tek video dosyalarının (segmentler) uzunluğunu gösterir. Daha küçük segmentler daha düşük arşiv kayıttan yürütme gecikme süresi sağlar ancak daha büyük hacimli depolama işlemleri oluşturur. Daha büyük segmentler, arşiv kayıttan yürütme gecikme süresini artırırken depolama işlemlerinin miktarını azaltır. Değer ISO8601 süre biçiminde belirtilmelidir (yani "PT30S" 30 saniyeye eşittir) ve 30 saniyelik artışlarla 30 saniye ile 5 dakika arasında değişebilir.

VideoPreviewImageUrls

Video önizleme görüntüsü URL'leri. Bu URL'ler, video arşivinden en son hareketsiz görüntüyü farklı çözünürlüklerde indirmek için video içeriği yetkilendirme belirteci ile birlikte kullanılabilir. Bunlar, video türü 'arşiv' olduğunda ve önizleme görüntüleri etkinleştirildiğinde kullanılabilir.

Name Type Description
large
  • string

Yüksek çözünürlüklü önizleme görüntüsü URL'si.

medium
  • string

Orta çözünürlüklü önizleme görüntüsü URL'si.

small
  • string

Düşük çözünürlüklü önizleme görüntüsü URL'si.

VideoType

Video içerik türü. Farklı içerik türleri farklı uygulamalar ve senaryolar için uygundur.

Name Type Description
Archive
  • string

Arşiv, duvar saati saatiyle ilişkili bir video akışını temsil eden esnek biçimdir. Video arşivi sürekli veya kesintili olabilir. Canlı işlem hattının durdurulması, kameranın bağlantısının kesilmesi veya sinyal kapısı kullanımı aracılığıyla olay tabanlı kayıtların kullanılması gibi çeşitli nedenlerle kayıtta boşluklar olduğunda arşiv kesintili olur. Arşiv süresiyle ilgili bir sınır yoktur ve aynı video codec'i ve codec parametreleri kullanıldığı sürece mevcut arşive herhangi bir zamanda yeni video verileri eklenebilir. Bu tür videolar ekleme ve uzun süreli arşivleme için uygundur.

File
  • string

Dosya, MP4 gibi tek bir medya dosyası olarak depolanan bir videodur. Bu tür videolar dış tüketim için indirilmeye uygundur.