Videos - Create Or Update

Crea una nuova risorsa video o aggiorna una risorsa esistente.
Crea una nuova risorsa video o aggiorna una risorsa video esistente con il nome specificato.

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

Parametri dell'URI

Name In Required Type Description
accountName
path True
  • string

Nome dell'account analizzatore video di Azure.

resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

videoName
path True
  • string

Nome video.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Name Type Description
properties.archival

Proprietà di archiviazione video.

properties.description
  • string

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

properties.mediaInfo

Contiene informazioni sul contenuto video e audio.

properties.title
  • string

Titolo video facoltativo fornito dall'utente. Il valore può essere massimo di 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-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"
  }
}

Definizioni

createdByType

Tipo di identità che ha creato la risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

systemData

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

VideoArchival

Proprietà di archiviazione video.

VideoContentUrls

Set di URL sul contenuto video.

VideoEntity

Rappresenta una risorsa video in Azure Video Analyzer. I video possono essere inseriti da telecamere RTSP tramite pipeline live o possono essere creati esportando sequenze da video acquisiti esistenti tramite un processo della pipeline. I video inseriti tramite pipeline live possono essere trasmessi tramite il widget del lettore di Analizzatore video di Azure o i lettori compatibili. I video esportati possono essere scaricati come file MP4.

VideoFlags

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

VideoMediaInfo

Contiene informazioni sul contenuto video e audio.

VideoPreviewImageUrls

URL dell'immagine di anteprima video. Questi URL possono essere usati insieme al token di autorizzazione del contenuto video per scaricare l'immagine ancora più recente dall'archivio video in risoluzioni diverse. Sono disponibili quando il tipo di video è "archivio" e le immagini di anteprima sono abilitate.

VideoType

Tipo di contenuto video. Diversi tipi di contenuto sono adatti per applicazioni e scenari diversi.

createdByType

Tipo di identità che ha creato la risorsa.

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

ErrorAdditionalInfo

Informazioni aggiuntive sulla 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à che ha modificato l'ultima risorsa.

lastModifiedByType

Tipo di identità che ha modificato l'ultima risorsa.

VideoArchival

Proprietà di archiviazione video.

Name Type Description
retentionPeriod
  • string

Il periodo di conservazione video indica l'età massima dei segmenti di archivio video che devono essere mantenuti nell'archiviazione. Deve essere fornito nel formato di durata ISO8601 nella granularità di giorni, fino a un massimo di 10 anni. Ad esempio, se questa opzione è impostata su P30D (30 giorni), il contenuto precedente a 30 giorni verrà eliminato periodicamente. Questo valore può essere aggiornato in qualsiasi momento e il nuovo periodo di conservazione desiderato sarà effettivo entro 24 ore.

VideoContentUrls

Set di URL sul contenuto video.

Name Type Description
archiveBaseUrl
  • string

URL di streaming di archiviazione video. Il contenuto archiviato può essere riprodotto automaticamente dal widget del lettore Azure Video Analyzer. In alternativa, questo URL può essere usato insieme al token di autorizzazione del contenuto video in tutti i 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)

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 di download del file video. Questo URL può essere usato insieme al token di autorizzazione del contenuto video per scaricare il file MP4 video. Il file MP4 risultante può essere riprodotto in qualsiasi lettore multimediale standard. È disponibile quando il tipo di video è "file" e il file video è disponibile per l'utilizzo.

previewImageUrls

URL dell'immagine di anteprima video. Questi URL possono essere usati insieme al token di autorizzazione del contenuto video per scaricare l'immagine ancora più recente dall'archivio video in risoluzioni diverse. Sono disponibili quando il tipo di video è "archivio" e le immagini di anteprima sono abilitate.

rtspTunnelUrl
  • string

URL di streaming a bassa latenza video. Il contenuto live può essere riprodotto automaticamente dal widget lettore di Azure Video Analyzer. In alternativa, questo URL può essere usato insieme al token di autorizzazione del contenuto video per esporre un flusso RTSP in tunneling WebSocket. È disponibile quando il tipo di video è "archivio" e un feed live a bassa latenza è disponibile dall'origine.

VideoEntity

Rappresenta una risorsa video in Azure Video Analyzer. I video possono essere inseriti da telecamere RTSP tramite pipeline live o possono essere creati esportando sequenze da video acquisiti esistenti tramite un processo della pipeline. I video inseriti tramite pipeline live possono essere trasmessi tramite il widget del lettore di Analizzatore video di Azure o i lettori compatibili. I video esportati possono essere scaricati come file MP4.

Name Type Description
id
  • string

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

name
  • string

nome della risorsa.

properties.archival

Proprietà di archiviazione video.

properties.contentUrls

Set di URL sul contenuto video.

properties.description
  • string

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

properties.flags

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

properties.mediaInfo

Contiene informazioni sul contenuto video e audio.

properties.title
  • string

Titolo video facoltativo fornito dall'utente. Il valore può essere massimo di 256 caratteri.

properties.type

Tipo di contenuto video. Diversi tipi di contenuto sono adatti per applicazioni e scenari diversi.

systemData

Metadati di Azure Resource Manager contenenti le informazioni createBy e modificateBy.

type
  • string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft. Archiviazione/storageAccounts"

VideoFlags

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

Name Type Description
canStream
  • boolean

Valore che indica se il video può essere trasmesso o meno. È possibile trasmettere solo i video di tipo "archivio".

hasData
  • boolean

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

isInUse
  • boolean

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

VideoMediaInfo

Contiene informazioni sul contenuto video e audio.

Name Type Description
segmentLength
  • string

La lunghezza del segmento video indica la lunghezza dei singoli file video (segmenti) che vengono mantenuti 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 la latenza di riproduzione dell'archivio. Il valore deve essere specificato nel formato di durata ISO8601 (ad esempio "PT30S" uguale a 30 secondi) e può variare tra 30 secondi e 5 minuti, in 30 secondi incrementi.

VideoPreviewImageUrls

URL dell'immagine di anteprima video. Questi URL possono essere usati insieme al token di autorizzazione del contenuto video per scaricare l'immagine ancora più recente dall'archivio video in risoluzioni diverse. Sono disponibili quando il tipo di video è "archivio" e le immagini di anteprima sono abilitate.

Name Type Description
large
  • string

URL immagine di anteprima a risoluzione elevata.

medium
  • string

URL immagine di anteprima della risoluzione media.

small
  • string

URL immagine di anteprima a bassa risoluzione.

VideoType

Tipo di contenuto video. Diversi tipi di contenuto sono adatti per applicazioni e scenari diversi.

Name Type Description
Archive
  • string

L'archivio è formato flessibile che rappresenta un flusso video associato all'ora del muro. L'archivio video può essere continuo o discontinuo. Un archivio è discontinuo quando si verificano lacune nella registrazione a causa di vari motivi, ad esempio la pipeline live arrestata, la fotocamera viene disconnessa o a causa dell'uso di registrazioni basate su eventi tramite l'uso di un gate di segnale. Non è possibile limitare la 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. I video di questo tipo sono adatti per l'aggiunta e l'archiviazione a lungo termine.

File
  • string

Il file rappresenta un video archiviato come singolo file multimediale, ad esempio MP4. I video di questo tipo sono adatti per essere scaricati per l'utilizzo esterno.