Videos - Create Or Update

Crea o aggiorna una risorsa video.
Crea una nuova risorsa video o ne aggiorna una esistente in un account.

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

Parametri dell'URI

Name In Required Type Description
accountName
path True
  • string

Nome dell'account di Analizzatore video di Azure.

resourceGroupName
path True
  • string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

videoName
path True
  • string

Nome del video da creare o aggiornare.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Name Type Description
properties.description
  • string

Descrizione video facoltativa fornita dall'utente. Il valore può contenere fino a 2048 caratteri.

properties.title
  • string

Titolo video facoltativo fornito dall'utente. Il valore può contenere fino a 256 caratteri.

Risposte

Name Type Description
200 OK

OK

201 Created

Data di creazione

Other Status Codes

Informazioni dettagliate sull'errore.

Esempio

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-05-01-preview
{
  "properties": {
    "title": "Sample Title 1",
    "description": "Sample Description 1"
  }
}

Sample Response

{
  "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": false,
      "hasData": false,
      "isRecording": false
    }
  },
  "systemData": {}
}
{
  "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": false,
      "hasData": false,
      "isRecording": false
    }
  },
  "systemData": {}
}

Definizioni

createdByType

Tipo di identità che ha creato la risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

VideoEntity

Rappresentazione di un singolo video in un account di Video Analyzer.

VideoFlags

I flag video contengono informazioni sulle azioni video disponibili e sulle relative proprietà dinamiche in base allo stato del video corrente.

VideoMediaInfo

Contiene informazioni sul contenuto audio e video.

VideoStreaming

Lo streaming video contiene informazioni sugli URL di streaming video.

VideoType

Tipo di archivio video. Formati di archivio diversi offrono funzionalità diverse.

createdByType

Tipo di identità che ha creato la risorsa.

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

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Name Type Description
info
  • object

Informazioni aggiuntive.

type
  • string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Name Type Description
additionalInfo

Informazioni aggiuntive sull'errore.

code
  • string

Codice di errore.

details

Dettagli dell'errore.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Name Type Description
error

Oggetto error.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Name Type Description
createdAt
  • string

Timestamp della creazione di risorse (UTC).

createdBy
  • string

Identità che ha creato la risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt
  • string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy
  • string

Identità dell'ultima modifica della risorsa.

lastModifiedByType

Tipo di identità che ha modificato la risorsa per ultima.

VideoEntity

Rappresentazione di un singolo video in un account di Video Analyzer.

Name Type Description
id
  • string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

nome della risorsa.

properties.description
  • string

Descrizione video facoltativa fornita dall'utente. Il valore può contenere fino a 2048 caratteri.

properties.flags

I flag video contengono informazioni sulle azioni video disponibili e sulle relative proprietà dinamiche in base allo stato del video corrente.

properties.mediaInfo

Contiene informazioni sul contenuto audio e video.

properties.streaming

Lo streaming video contiene informazioni sugli URL di streaming video.

properties.title
  • string

Titolo video facoltativo fornito dall'utente. Il valore può contenere fino a 256 caratteri.

properties.type

Tipo di archivio video. Formati di archivio diversi offrono funzionalità diverse.

systemData

Metadati di sistema relativi a questa risorsa.

type
  • string

Tipo di risorsa. ad esempio "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

VideoFlags

I flag video contengono informazioni sulle azioni video disponibili e sulle relative proprietà dinamiche in base allo stato del video corrente.

Name Type Description
canStream
  • boolean

Valore che indica se il video può essere trasmesso o meno. Solo i video di tipo "archivio" possono essere trasmessi in streaming.

hasData
  • boolean

Valore che indica se nel video sono stati registrati o caricati dati. I video appena creati hanno questo valore impostato su false.

isRecording
  • boolean

Valore che indica se il video a cui si fa riferimento è una pipeline live attiva. Il fatto che si fa riferimento a non indica necessariamente che i dati vengono ricevuti. Ad esempio, la registrazione video può essere in esecuzione su eventi o la fotocamera potrebbe non essere accessibile al momento.

VideoMediaInfo

Contiene informazioni sul contenuto audio e video.

Name Type Description
segmentLength
  • string

Lunghezza segmento video indica la lunghezza dei singoli file video (segmenti) che vengono resi persistenti nell'archiviazione. I segmenti più piccoli offrono una latenza di riproduzione dell'archivio inferiore, ma generano un volume maggiore di transazioni di archiviazione. I segmenti più grandi riducono la quantità di transazioni di archiviazione aumentando al tempo stesso la latenza di riproduzione dell'archivio. Il valore deve essere specificato nel formato di durata ISO8601 ,ad esempio "PT30S" equivale a 30 secondi, e può variare da 30 secondi a 5 minuti, in incrementi di 30 secondi.

VideoStreaming

Lo streaming video contiene informazioni sugli URL di streaming video.

Name Type Description
archiveBaseUrl
  • string

URL di base dello streaming video per l'archivio video. Se presente, il video archiviato può essere riprodotto tramite il lettore di Analizzatore video di Azure. In alternativa, questo URL può essere usato con lettori DASH o HLS compatibili aggiungendo quanto segue all'URL di base:

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

Inoltre, una registrazione video in corso può essere riprodotta in "modalità live" con latenze che sono circa il doppio della lunghezza del segmento video scelto.

VideoType

Tipo di archivio video. Formati di archivio diversi offrono funzionalità diverse.

Name Type Description
Archive
  • string

L'archivio è un formato flessibile che rappresenta un flusso video associato all'ora del tempo reale. L'archivio video può essere continuo o discontinuo. Un archivio è discontinuo in caso di lacune nella registrazione a causa di vari motivi, ad esempio l'arresto della pipeline live, la disconnessione della fotocamera o l'uso di registrazioni basate su eventi tramite l'uso di un controllo del segnale. Infine, non esiste alcun limite alla durata dell'archivio e i nuovi dati video possono essere aggiunti all'archivio esistente in qualsiasi momento, purché vengano usati gli stessi parametri di codec e codec video.