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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
accountName
path True

string

Nome dell'account di Servizi multimediali.

liveEventName
path True

string

Il nome dell'evento live, la lunghezza massima è 32.

Criterio di espressione regolare: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

liveOutputName
path True

string

Nome dell'output live.

Criterio di espressione regolare: ^([a-zA-Z0-9])+(-*[a-zA-Z0-9])*$

resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione di Azure.

subscriptionId
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.

Corpo della richiesta

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

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.

Risposte

Nome Tipo Descrizione
200 OK

LiveOutput

OK. La richiesta ha avuto esito positivo.

201 Created

LiveOutput

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

ErrorResponse

Risposta di errore di streaming che descrive perché l'operazione non è riuscita.

Esempio

Create a LiveOutput

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

Definizioni

Nome Descrizione
createdByType

Tipo di identità che ha creato la risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

Hls

HTTP Live Streaming (HLS) impostazione di imballaggio per l'output live.

LiveOutput

Output live.

LiveOutputResourceState

Stato della risorsa dell'output live.

systemData

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

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

Hls

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.

LiveOutput

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

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

LiveOutputResourceState

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

systemData

Metadati di sistema relativi a questa risorsa.

type

string

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

LiveOutputResourceState

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.

systemData

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

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

createdByType

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