Live Outputs - Get

Riferimento

Servizio:: Media Services

Versione API:: 2022-11-01

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

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


/**
 * Samples for LiveOutputs Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveoutput-list
     * -by-name.json
     */
    /**
     * Sample code: Get a LiveOutput by name.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getALiveOutputByName(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.liveOutputs().getWithResponse("mediaresources", "slitestmedia10", "myLiveEvent1", "myLiveOutput1",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:: 200

{
  "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.

Condividi tramite