Live Outputs - Get

Referenz

Dienst:: Media Services

API-Version:: 2022-11-01

Abrufen der Liveausgabe
Ruft eine Liveausgabe ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}/liveOutputs/{liveOutputName}?api-version=2022-11-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string	Der Name des Media Services-Kontos.
liveEventName	path	True	string	Der Name des Liveereignisses, die maximale Länge beträgt 32. RegEx-Muster: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
liveOutputName	path	True	string	Der Name der Liveausgabe. RegEx-Muster: `^([a-zA-Z0-9])+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Der Name der Ressourcengruppe innerhalb des Azure-Abonnements.
subscriptionId	path	True	string	Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement.
api-version	query	True	string	Die Version der API, die mit der Clientanforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	LiveOutput	OK. Die Anforderung wurde erfolgreich durchgeführt.
Other Status Codes	ErrorResponse	Die Streamingfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
Hls	HTTP Live Streaming Packeinstellung (HLS) für die Liveausgabe.
LiveOutput	Die Liveausgabe.
LiveOutputResourceState	Der Ressourcenstatus der Liveausgabe.
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

Hls

HTTP Live Streaming Packeinstellung (HLS) für die Liveausgabe.

Name	Typ	Beschreibung
fragmentsPerTsSegment	integer	Die Anzahl der Fragmente in einem HTTP Live Streaming TS-Segment (HLS) in der Ausgabe des Liveereignisses. Dieser Wert wirkt sich nicht auf das Packungsverhältnis für die HLS-CMAF-Ausgabe aus.

LiveOutput

Die Liveausgabe.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties.archiveWindowLength	string	ISO 8601-Zeit zwischen 1 Minute und 25 Stunden, um die maximale Inhaltslänge anzugeben, die im Asset für diese Liveausgabe archiviert werden kann. Dadurch wird auch die maximale Inhaltslänge für das Zurückspulenfenster festgelegt. Verwenden Sie beispielsweise PT1H30M, um ein Archivfenster von 1 Stunde und 30 Minuten anzugeben.
properties.assetName	string	Das Objekt, in das die Liveausgabe schreibt.
properties.created	string	Die Erstellungszeit der Liveausgabe.
properties.description	string	Die Beschreibung der Liveausgabe.
properties.hls	Hls	HTTP Live Streaming Packeinstellung (HLS) für die Liveausgabe.
properties.lastModified	string	Der Zeitpunkt, zu dem die Liveausgabe zuletzt geändert wurde.
properties.manifestName	string	Der Name der Manifestdatei. Wenn nicht bereitgestellt, generiert der Dienst automatisch eine.
properties.outputSnapTime	integer	Der anfängliche Zeitstempel, bei dem die Liveausgabe beginnt, alle Inhalte vor diesem Wert werden nicht archiviert.
properties.provisioningState	string	Der Bereitstellungsstatus der Liveausgabe.
properties.resourceState	LiveOutputResourceState	Der Ressourcenstatus der Liveausgabe.
properties.rewindWindowLength	string	ISO 8601 Zeit zwischen 1 Minute bis zur Dauer des ArchivsWindowLength, um suchfähige Fensterlänge während live zu steuern. Der Dienst verwendet diese Eigenschaft nicht, sobald LiveOutput beendet wird. Die archivierte VOD verfügt über vollständigen Inhalt mit original ArchiveWindowLength. Verwenden Sie z. B. PT1H30M, um die Fensterlänge von 1 Stunde und 30 Minuten anzugeben. Der Dienst verwendet den impliziten Standardwert 30m nur, wenn Live Event LL aktiviert.
systemData	systemData	Die Systemmetadaten, die sich auf diese Ressource beziehen.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

LiveOutputResourceState

Der Ressourcenstatus der Liveausgabe.

Name	Typ	Beschreibung
Creating	string	Die Liveausgabe wird erstellt. Im Asset werden keine Inhalte archiviert, bis sich die Liveausgabe im Ausführungszustand befindet.
Deleting	string	Die Liveausgabe wird gelöscht. Das Live-Asset wird von Live- zu On-Demand-Asset konvertiert. Alle streaming-URLs, die für das Liveausgabeobjekt erstellt werden, funktionieren weiterhin.
Running	string	Die Liveausgabe wird ausgeführt und archiviert Livestreaminginhalte auf dem Asset, wenn eine gültige Eingabe von einem Beitragsencoder vorhanden ist.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über