Live Outputs - Create

Referenz

Service:: Media Services

API Version:: 2022-11-01

Erstellen einer Liveausgabe
Erstellt eine neue Liveausgabe.

PUT 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 pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
liveOutputName	path	True	string	Der Name der Liveausgabe. Regex pattern: `^([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.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.archiveWindowLength	True	string	ISO 8601 zeit zwischen 1 Minute und 25 Stunden, um die maximale Inhaltslänge anzugeben, die im Medienobjekt 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 für eine Stunde und 30 Minuten anzugeben.
properties.assetName	True	string	Das Medienobjekt, in das die Liveausgabe schreibt.
properties.description		string	Die Beschreibung der Liveausgabe.
properties.hls		Hls	HTTP Live Streaming (HLS)-Verpackungseinstellung für die Liveausgabe.
properties.manifestName		string	Der Name der Manifestdatei. Wenn keine Bereitstellung erfolgt, 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.rewindWindowLength		string	ISO 8601 Zeit zwischen 1 Minute und der Dauer von archiveWindowLength, um die suchfähige Fensterlänge während live zu steuern. Der Dienst verwendet diese Eigenschaft nicht, sobald LiveOutput beendet wird. Die archivierte VOD enthält vollständigen Inhalt mit dem originalen ArchiveWindowLength. Verwenden Sie z. B. PT1H30M, um die Länge des Zurückspulenfensters von 1 Stunde und 30 Minuten anzugeben. Der Dienst verwendet den impliziten Standardwert 30m nur, wenn das Liveereignis LL aktiviert.

Antworten

Name	Typ	Beschreibung
200 OK	LiveOutput	OK. Die Anforderung war erfolgreich.
201 Created	LiveOutput	Erstellt. Die Anforderung wurde für die Verarbeitung akzeptiert, und der Vorgang wird asynchron abgeschlossen. Ausführliche Informationen zum Überwachen asynchroner Azure-Vorgänge mithilfe des Azure-AsyncOperation-Antwortheaders finden Sie https://go.microsoft.com/fwlink/?linkid=2087017 unter .
Other Status Codes	ErrorResponse	Die Streamingfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

Create a LiveOutput

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

import com.azure.resourcemanager.mediaservices.models.Hls;
import java.time.Duration;

/** Samples for LiveOutputs Create. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveoutput-create.json
     */
    /**
     * Sample code: Create a LiveOutput.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createALiveOutput(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .liveOutputs()
            .define("myLiveOutput1")
            .withExistingLiveEvent("mediaresources", "slitestmedia10", "myLiveEvent1")
            .withDescription("test live output 1")
            .withAssetName("6f3264f5-a189-48b4-a29a-a40f22575212")
            .withArchiveWindowLength(Duration.parse("PT5M"))
            .withRewindWindowLength(Duration.parse("PT4M"))
            .withManifestName("testmanifest")
            .withHls(new Hls().withFragmentsPerTsSegment(5))
            .create();
    }
}

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

Sample Response

Status code:: 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": "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"
  }
}

Status code:: 201

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

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 (HLS)-Verpackungseinstellung 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 (HLS)-Verpackungseinstellung 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 Medienobjekt 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 für eine Stunde und 30 Minuten anzugeben.
properties.assetName	string	Das Medienobjekt, 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 (HLS)-Verpackungseinstellung 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 keine Bereitstellung erfolgt, 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 und der Dauer von archiveWindowLength, um die suchfähige Fensterlänge während live zu steuern. Der Dienst verwendet diese Eigenschaft nicht, sobald LiveOutput beendet wird. Die archivierte VOD enthält vollständigen Inhalt mit dem originalen ArchiveWindowLength. Verwenden Sie z. B. PT1H30M, um die Länge des Zurückspulenfensters von 1 Stunde und 30 Minuten anzugeben. Der Dienst verwendet den impliziten Standardwert 30m nur, wenn das Liveereignis 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 Medienobjekt wird kein Inhalt archiviert, bis sich die Liveausgabe im Ausführungszustand befindet.
Deleting	string	Die Liveausgabe wird gelöscht. Das Live-Medienobjekt wird von live zu on-demand-Medienobjekten konvertiert. Alle Streaming-URLs, die für das Liveausgabeobjekt erstellt werden, funktionieren weiterhin.
Running	string	Die Liveausgabe wird ausgeführt und archiviert Livestreaminginhalte im Medienobjekt, 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