Live Outputs - Create
Creare l'output live
Crea un nuovo output live.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}/liveOutputs/{liveOutputName}?api-version=2022-11-01
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account di Servizi multimediali. |
live
|
path | True |
string |
Il nome dell'evento live, la lunghezza massima è 32. Criterio di espressione regolare: |
live
|
path | True |
string |
Nome dell'output live. Criterio di espressione regolare: |
resource
|
path | True |
string |
Nome del gruppo di risorse all'interno della sottoscrizione di Azure. |
subscription
|
path | True |
string |
Identificatore univoco per una sottoscrizione di Microsoft Azure. |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta client. |
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
properties.archiveWindowLength | True |
string |
ISO 8601 tempo compreso tra 1 minuto e 25 ore per indicare la lunghezza massima del contenuto che può essere archiviata nell'asset per questo output live. In questo modo viene impostata anche la lunghezza massima del contenuto per la finestra di riavvolgimento. Ad esempio, usare PT1H30M per indicare 1 ora e 30 minuti di finestra di archivio. |
properties.assetName | True |
string |
Asset a cui verrà scritto l'output live. |
properties.description |
string |
Descrizione dell'output live. |
|
properties.hls |
HTTP Live Streaming (HLS) impostazione di imballaggio per l'output live. |
||
properties.manifestName |
string |
Nome file manifesto. Se non specificato, il servizio genererà automaticamente uno. |
|
properties.outputSnapTime |
integer |
Timestamp iniziale che l'output live inizierà in corrispondenza di qualsiasi contenuto prima che questo valore non venga archiviato. |
|
properties.rewindWindowLength |
string |
ISO 8601 tempo compreso tra 1 minuto e durata dell'archivioWindowLength per controllare la lunghezza della finestra in grado di cercare durante Live. Il servizio non userà questa proprietà dopo l'arresto di LiveOutput. Il VOD archiviato avrà contenuto completo con ArchiveWindowLength originale. Ad esempio, usare PT1H30M per indicare 1 ora e 30 minuti di lunghezza della finestra di riavvolgimento. Il servizio userà il valore predefinito implicito 30m solo se Live Event abilita LL. |
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK. La richiesta ha avuto esito positivo. |
|
201 Created |
Creazione riuscita. La richiesta è stata accettata per l'elaborazione e l'operazione verrà completata in modo asincrono. Per https://go.microsoft.com/fwlink/?linkid=2087017 informazioni dettagliate sul monitoraggio delle operazioni asincrone di Azure tramite l'intestazione di risposta Azure-AsyncOperation. |
|
Other Status Codes |
Risposta di errore di streaming che descrive perché l'operazione non è riuscita. |
Esempio di richiesta
PUT https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1/liveOutputs/myLiveOutput1?api-version=2022-11-01
{
"properties": {
"description": "test live output 1",
"assetName": "6f3264f5-a189-48b4-a29a-a40f22575212",
"archiveWindowLength": "PT5M",
"rewindWindowLength": "PT4M",
"manifestName": "testmanifest",
"hls": {
"fragmentsPerTsSegment": 5
}
}
}
Risposta di esempio
{
"name": "myLiveOutput1",
"id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/liveoutputs/myLiveOutput1",
"type": "Microsoft.Media/mediaservices/liveevents/liveoutputs",
"properties": {
"description": "test live output 1",
"assetName": "6f3264f5-a189-48b4-a29a-a40f22575212",
"archiveWindowLength": "PT5M",
"manifestName": "testmanifest",
"outputSnapTime": 0,
"resourceState": "Stopped",
"provisioningState": "Succeeded",
"created": "2018-03-03T02:25:09.9431835Z",
"lastModified": "2018-03-03T02:25:09.9431835Z",
"hls": {
"fragmentsPerTsSegment": 5
},
"rewindWindowLength": "PT4M"
},
"systemData": {
"createdBy": "example@microsoft.com",
"createdByType": "User",
"createdAt": "2018-03-03T02:25:09.9431835Z",
"lastModifiedBy": "example@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2018-03-03T02:25:09.9431835Z"
}
}
{
"name": "myLiveOutput1",
"id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/liveoutputs/myLiveOutput1",
"type": "Microsoft.Media/mediaservices/liveevents/liveoutputs",
"properties": {
"description": "test live output 1",
"assetName": "6f3264f5-a189-48b4-a29a-a40f22575212",
"archiveWindowLength": "PT5M",
"manifestName": "testmanifest",
"outputSnapTime": 0,
"resourceState": "Creating",
"provisioningState": "InProgress",
"created": "2018-03-03T02:25:09.9431835Z",
"lastModified": "2018-03-03T02:25:09.9431835Z",
"hls": {
"fragmentsPerTsSegment": 5
},
"rewindWindowLength": "PT4M"
},
"systemData": {
"createdBy": "example@microsoft.com",
"createdByType": "User",
"createdAt": "2018-03-03T02:25:09.9431835Z",
"lastModifiedBy": "example@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2018-03-03T02:25:09.9431835Z"
}
}
Nome | Descrizione |
---|---|
created |
Tipo di identità che ha creato la risorsa. |
Error |
Informazioni aggiuntive sulla gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Hls |
HTTP Live Streaming (HLS) impostazione di imballaggio per l'output live. |
Live |
Output live. |
Live |
Stato della risorsa dell'output live. |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Tipo di identità che ha creato la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Informazioni aggiuntive sulla gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
HTTP Live Streaming (HLS) impostazione di imballaggio per l'output live.
Nome | Tipo | Descrizione |
---|---|---|
fragmentsPerTsSegment |
integer |
Numero di frammenti in un segmento TS (HLS) HTTP Live Streaming nell'output dell'evento live. Questo valore non influisce sul rapporto di compressione per l'output CMAF di HLS. |
Output live.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nome della risorsa. |
properties.archiveWindowLength |
string |
ISO 8601 tempo compreso tra 1 minuto e 25 ore per indicare la lunghezza massima del contenuto che può essere archiviata nell'asset per questo output live. In questo modo viene impostata anche la lunghezza massima del contenuto per la finestra di riavvolgimento. Ad esempio, usare PT1H30M per indicare 1 ora e 30 minuti di finestra di archivio. |
properties.assetName |
string |
Asset a cui verrà scritto l'output live. |
properties.created |
string |
Ora di creazione dell'output live. |
properties.description |
string |
Descrizione dell'output live. |
properties.hls |
HTTP Live Streaming (HLS) impostazione di imballaggio per l'output live. |
|
properties.lastModified |
string |
Ora dell'ultima modifica dell'output live. |
properties.manifestName |
string |
Nome file manifesto. Se non specificato, il servizio genererà automaticamente uno. |
properties.outputSnapTime |
integer |
Timestamp iniziale che l'output live inizierà in corrispondenza di qualsiasi contenuto prima che questo valore non venga archiviato. |
properties.provisioningState |
string |
Stato di provisioning dell'output live. |
properties.resourceState |
Stato della risorsa dell'output live. |
|
properties.rewindWindowLength |
string |
ISO 8601 tempo compreso tra 1 minuto e durata dell'archivioWindowLength per controllare la lunghezza della finestra in grado di cercare durante Live. Il servizio non userà questa proprietà dopo l'arresto di LiveOutput. Il VOD archiviato avrà contenuto completo con ArchiveWindowLength originale. Ad esempio, usare PT1H30M per indicare 1 ora e 30 minuti di lunghezza della finestra di riavvolgimento. Il servizio userà il valore predefinito implicito 30m solo se Live Event abilita LL. |
systemData |
Metadati di sistema relativi a questa risorsa. |
|
type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
Stato della risorsa dell'output live.
Nome | Tipo | Descrizione |
---|---|---|
Creating |
string |
L'output live viene creato. Nessun contenuto archiviato nell'asset finché l'output attivo non è in esecuzione. |
Deleting |
string |
L'output live viene eliminato. L'asset live viene convertito da live ad asset su richiesta. Tutti gli URL di streaming creati nell'asset di output live continuano a funzionare. |
Running |
string |
L'output live è in esecuzione e archivia il contenuto live streaming nell'asset se è disponibile un input valido da un codificatore di contributi. |
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
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. |