Live Outputs - Get

Ottenere l'output live
Ottiene un output live.

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

Risposte

Nome Tipo Descrizione
200 OK

LiveOutput

OK. La richiesta ha avuto esito positivo.

Other Status Codes

ErrorResponse

Risposta di errore di streaming che descrive il motivo per cui l'operazione non è riuscita.

Esempio

Get a LiveOutput by name

Esempio di richiesta

GET 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

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": null,
    "assetName": "cb2ae0bc-677a-4830-9c8e-06ce4c4cb607",
    "archiveWindowLength": "PT5M",
    "manifestName": "fc7096f5-c488-4b86-8302-f3bfde53fc27",
    "outputSnapTime": 0,
    "resourceState": "Running",
    "provisioningState": "Succeeded",
    "created": "0001-01-01T00:00:00-08:00",
    "lastModified": "0001-01-01T00:00:00-08:00",
    "hls": {
      "fragmentsPerTsSegment": 5
    },
    "rewindWindowLength": "PT4M"
  },
  "systemData": {
    "createdBy": "example@microsoft.com",
    "createdByType": "User",
    "createdAt": "0001-01-01T00:00:00-08:00",
    "lastModifiedBy": "example@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "0001-01-01T00:00:00-08:00"
  }
}

Definizioni

Nome Descrizione
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

Hls

impostazione di compressione HTTP Live Streaming (HLS) 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 sull'errore di 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

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

Nome Tipo Descrizione
fragmentsPerTsSegment

integer

Numero di frammenti in un segmento TS HTTP Live Streaming (HLS) nell'output dell'evento live. Questo valore non influisce sul rapporto di compressione per l'output CMAF HLS.

LiveOutput

Output live.

Nome Tipo Descrizione
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.archiveWindowLength

string

Tempo ISO 8601 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 archiviazione.

properties.assetName

string

Asset in 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

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

properties.lastModified

string

Ora dell'ultima modifica dell'output live.

properties.manifestName

string

Nome del file manifesto. Se non specificato, il servizio ne genererà automaticamente uno.

properties.outputSnapTime

integer

Timestamp iniziale in cui verrà avviato l'output live, 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

Tempo ISO 8601 compreso tra 1 minuto e la durata di archiveWindowLength per controllare la lunghezza della finestra in grado di ricerca 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 l'evento live 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

Viene creato l'output live. Nessun contenuto archiviato nell'asset finché l'output live non è in esecuzione.

Deleting

string

L'output live viene eliminato. L'asset live viene convertito da un asset attivo a un 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 l'archiviazione del contenuto di streaming live nell'asset se è presente 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 volta la risorsa.

lastModifiedByType

createdByType

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