Live Events - Update

Referenz

Dienst:: Media Services

API-Version:: 2022-11-01

Updates Einstellungen für ein vorhandenes Liveereignis.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?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])$`
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
location	True	string	Der geografische Standort, an dem sich die Ressource befindet
properties.input	True	LiveEventInput	Eingabeeinstellungen für Liveereignisse. Es definiert, wie das Liveereignis eingaben von einem Beitragsencoder empfängt.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Websiteübergreifende Zugriffsrichtlinien für Liveereignisse.
properties.description		string	Eine Beschreibung für das Liveereignis.
properties.encoding		LiveEventEncoding	Codierungseinstellungen für das Liveereignis. Es konfiguriert, ob ein Liveencoder für das Liveereignis verwendet wird, und einstellungen für den Liveencoder, falls er verwendet wird.
properties.hostnamePrefix		string	Wenn useStaticHostname auf true festgelegt ist, gibt hostnamePrefix den ersten Teil des Hostnamens an, der der Liveereignisvorschau und den Erfassungsendpunkten zugewiesen ist. Der endgültige Hostname ist dann eine Kombination aus diesem Präfix, dem Media Services-Kontonamen und einem kurzen Code für das Azure Media Services-Rechenzentrum.
properties.preview		LiveEventPreview	Liveereignisvorschaueinstellungen. Mit der Vorschau können Liveereignisproduzenten eine Vorschau der Livestreaminginhalte anzeigen, ohne eine Liveausgabe zu erstellen.
properties.streamOptions		StreamOptionsFlag[]	Die Optionen, die für das LiveEvent verwendet werden sollen. Dieser Wert wird zur Erstellungszeit angegeben und kann nicht aktualisiert werden. Die gültigen Werte für die Arrayeintragswerte sind "Default" und "LowLatency".
properties.transcriptions		LiveEventTranscription[]	Livetranskriptionseinstellungen für das Liveereignis. Weitere Informationen zur Livetranskription finden Sie https://go.microsoft.com/fwlink/?linkid=2133742 unter.
properties.useStaticHostname		boolean	Gibt an, ob den Liveereignisvorschau- und Erfassungsendpunkten ein statischer Hostname zugewiesen wird. Dieser Wert kann nur aktualisiert werden, wenn sich das Liveereignis im Standbymodus befindet.
tags		object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	LiveEvent	OK. Die Anforderung wurde erfolgreich durchgeführt.
202 Accepted	LiveEvent	Akzeptiert: Die Anforderung wurde für die Verarbeitung akzeptiert, und der Vorgang wird asynchron abgeschlossen. Weitere Informationen zur Überwachung asynchroner Azure-Vorgänge finden Sie https://go.microsoft.com/fwlink/?linkid=2087017 unter.
Other Status Codes	ErrorResponse	Die Streamingfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

Update a LiveEvent

PATCH https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1?api-version=2022-11-01

{
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2",
    "tag3": "value3"
  },
  "properties": {
    "description": "test event updated",
    "input": {
      "streamingProtocol": "FragmentedMP4",
      "keyFrameIntervalDuration": "PT6S",
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0"
            }
          ]
        }
      }
    },
    "preview": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0"
            }
          ]
        }
      }
    }
  }
}


import com.azure.resourcemanager.mediaservices.models.IpAccessControl;
import com.azure.resourcemanager.mediaservices.models.IpRange;
import com.azure.resourcemanager.mediaservices.models.LiveEvent;
import com.azure.resourcemanager.mediaservices.models.LiveEventInput;
import com.azure.resourcemanager.mediaservices.models.LiveEventInputAccessControl;
import com.azure.resourcemanager.mediaservices.models.LiveEventInputProtocol;
import com.azure.resourcemanager.mediaservices.models.LiveEventPreview;
import com.azure.resourcemanager.mediaservices.models.LiveEventPreviewAccessControl;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for LiveEvents Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-
     * update.json
     */
    /**
     * Sample code: Update a LiveEvent.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void updateALiveEvent(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        LiveEvent resource = manager.liveEvents()
            .getWithResponse("mediaresources", "slitestmedia10", "myLiveEvent1", com.azure.core.util.Context.NONE)
            .getValue();
        resource.update().withTags(mapOf("tag1", "value1", "tag2", "value2", "tag3", "value3"))
            .withDescription("test event updated")
            .withInput(new LiveEventInput().withStreamingProtocol(LiveEventInputProtocol.FRAGMENTED_MP4)
                .withAccessControl(new LiveEventInputAccessControl().withIp(new IpAccessControl()
                    .withAllow(Arrays.asList(new IpRange().withName("AllowOne").withAddress("192.1.1.0")))))
                .withKeyFrameIntervalDuration("fakeTokenPlaceholder"))
            .withPreview(new LiveEventPreview()
                .withAccessControl(new LiveEventPreviewAccessControl().withIp(new IpAccessControl()
                    .withAllow(Arrays.asList(new IpRange().withName("AllowOne").withAddress("192.1.1.0"))))))
            .apply();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveeventoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01

{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2",
    "tag3": "value3"
  },
  "properties": {
    "description": "test event updated",
    "resourceState": "Running",
    "provisioningState": "InProgress",
    "created": "0001-01-01T00:00:00Z",
    "lastModified": "0001-01-01T00:00:00Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c10ea3fc-587f-4daf-b2b2-fa8f647a9ed2",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    }
  }
}

Statuscode:: 200

{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2",
    "tag3": "value3"
  },
  "properties": {
    "description": "test event updated",
    "resourceState": "Running",
    "provisioningState": "Succeeded",
    "created": "0001-01-01T00:00:00Z",
    "lastModified": "0001-01-01T00:00:00Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      }
    },
    "preview": {
      "previewLocator": "c10ea3fc-587f-4daf-b2b2-fa8f647a9ed2",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    }
  }
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
CrossSiteAccessPolicies	Die Clientzugriffsrichtlinie.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
IPAccessControl	Die IP-Zugriffssteuerung.
IPRange	Der IP-Adressbereich im CIDR-Schema.
LiveEvent	Das Liveereignis.
LiveEventEncoding	Gibt den Liveereignistyp und optionale Codierungseinstellungen für die Codierung von Liveereignissen an.
LiveEventEncodingType	Liveereignistyp. Wenn encodingType auf PassthroughBasic oder PassthroughStandard festgelegt ist, übergibt der Dienst einfach die eingehenden Video- und Audioebenen an die Ausgabe. Wenn encodingType auf Standard oder Premium1080p festgelegt ist, transcodiert ein Liveencoder den eingehenden Stream in mehrere Bitraten oder Ebenen. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2095101. Diese Eigenschaft kann nicht geändert werden, nachdem das Liveereignis erstellt wurde.
LiveEventEndpoint	Der Endpunkt des Liveereignisses.
LiveEventInput	Die Liveereigniseingabe.
LiveEventInputAccessControl	Die IP-Zugriffssteuerung für die Liveereigniseingabe.
LiveEventInputProtocol	Das Eingabeprotokoll für das Liveereignis. Dies wird zur Erstellungszeit angegeben und kann nicht aktualisiert werden.
LiveEventInputTrackSelection	Eine Trackauswahlbedingung. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.
LiveEventOutputTranscriptionTrack	Beschreibt eine Transkriptionsspur in der Ausgabe eines Liveereignisses, die mithilfe der Sprach-zu-Text-Transkription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.
LiveEventPreview	Liveereignisvorschaueinstellungen.
LiveEventPreviewAccessControl	Die IP-Zugriffssteuerung für den Liveereignisvorschauendpunkt.
LiveEventResourceState	Der Ressourcenstatus des Liveereignisses. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventTimedMetadataEndpoint	Der Liveereignismetadateneinfügungsendpunkt.
LiveEventTranscription	Beschreibt die Transkriptionsspuren in der Ausgabe eines Liveereignisses, das mithilfe der Spracherkennungstranskription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt wird, wird ignoriert.
StreamOptionsFlag	Die Optionen, die für das LiveEvent verwendet werden sollen. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Die gültigen Werte für die Arrayeintragswerte sind "Default" und "LowLatency".
StretchMode	Gibt an, wie die Größe des Eingabevideos an die gewünschte Ausgabeauflösung angepasst wird. Der Standardwert ist "None".
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

CrossSiteAccessPolicies

Die Clientzugriffsrichtlinie.

Name	Typ	Beschreibung
clientAccessPolicy	string	Der Inhalt der von Silverlight verwendeten clientaccesspolicy.xml.
crossDomainPolicy	string	Der Inhalt der von Silverlight verwendeten crossdomain.xml.

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.

IPAccessControl

Die IP-Zugriffssteuerung.

Name	Typ	Beschreibung
allow	IPRange[]	Die IP-Zulassungsliste.

IPRange

Der IP-Adressbereich im CIDR-Schema.

Name	Typ	Beschreibung
address	string	Die IP-Adresse.
name	string	Der Anzeigename für den IP-Adressbereich.
subnetPrefixLength	integer	Die Präfixlänge der Subnetzmaske (siehe CIDR-Notation).

LiveEvent

Das Liveereignis.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.created	string	Die Erstellungszeit für das Liveereignis
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Websiteübergreifende Zugriffsrichtlinien für Liveereignisse.
properties.description	string	Eine Beschreibung für das Liveereignis.
properties.encoding	LiveEventEncoding	Codierungseinstellungen für das Liveereignis. Es konfiguriert, ob ein Liveencoder für das Liveereignis verwendet wird, und einstellungen für den Liveencoder, falls er verwendet wird.
properties.hostnamePrefix	string	Wenn useStaticHostname auf true festgelegt ist, gibt hostnamePrefix den ersten Teil des Hostnamens an, der der Liveereignisvorschau und den Erfassungsendpunkten zugewiesen ist. Der endgültige Hostname ist dann eine Kombination aus diesem Präfix, dem Media Services-Kontonamen und einem kurzen Code für das Azure Media Services-Rechenzentrum.
properties.input	LiveEventInput	Eingabeeinstellungen für Liveereignisse. Es definiert, wie das Liveereignis Eingaben von einem Beitragsencoder empfängt.
properties.lastModified	string	Der Zeitpunkt der letzten Änderung des Liveereignisses.
properties.preview	LiveEventPreview	Liveereignisvorschaueinstellungen. Mit der Vorschau können Liveereignisproduzenten eine Vorschau des Livestreaminginhalts anzeigen, ohne eine Liveausgabe zu erstellen.
properties.provisioningState	string	Der Bereitstellungsstatus des Liveereignisses.
properties.resourceState	LiveEventResourceState	Der Ressourcenstatus des Liveereignisses. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2139012.
properties.streamOptions	StreamOptionsFlag[]	Die Optionen, die für das LiveEvent verwendet werden sollen. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Die gültigen Werte für die Arrayeintragswerte sind "Default" und "LowLatency".
properties.transcriptions	LiveEventTranscription[]	Livetranskriptionseinstellungen für das Liveereignis. Weitere Informationen zur Livetranskription finden Sie https://go.microsoft.com/fwlink/?linkid=2133742 unter.
properties.useStaticHostname	boolean	Gibt an, ob der Liveereignisvorschau und den Erfassungsendpunkten ein statischer Hostname zugewiesen wird. Dieser Wert kann nur aktualisiert werden, wenn sich das Liveereignis im Standbyzustand befindet.
systemData	systemData	Die Systemmetadaten, die sich auf diese Ressource beziehen.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

LiveEventEncoding

Gibt den Liveereignistyp und optionale Codierungseinstellungen für die Codierung von Liveereignissen an.

Name	Typ	Beschreibung
encodingType	LiveEventEncodingType	Liveereignistyp. Wenn encodingType auf PassthroughBasic oder PassthroughStandard festgelegt ist, übergibt der Dienst einfach die eingehenden Video- und Audioebenen an die Ausgabe. Wenn encodingType auf Standard oder Premium1080p festgelegt ist, transkodiert ein Liveencoder den eingehenden Datenstrom in mehrere Bitraten oder Ebenen. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2095101. Diese Eigenschaft kann nicht geändert werden, nachdem das Liveereignis erstellt wurde.
keyFrameInterval	string	Verwenden Sie einen ISO 8601-Zeitwert zwischen 0,5 und 20 Sekunden, um die Länge des Ausgabefragments für die Video- und Audiospuren eines Codierungs-Liveereignisses anzugeben. Verwenden Sie beispielsweise PT2S, um 2 Sekunden anzugeben. Für die Videospur wird auch das Keyframeintervall oder die Länge eines GoP (Gruppe von Bildern) definiert. Wenn dieser Wert nicht für ein Codierungs-Liveereignis festgelegt ist, beträgt die Fragmentdauer standardmäßig 2 Sekunden. Der Wert kann nicht für Passthrough-Liveereignisse festgelegt werden.
presetName	string	Der optionale Codierungsvoreinstellungsname, der verwendet wird, wenn encodingType nicht None ist. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Wenn encodingType auf Standard festgelegt ist, lautet der Standardvoreinstellungsname "Default720p". Andernfalls, wenn encodingType auf Premium1080p festgelegt ist, lautet die Standardvoreinstellung "Default1080p".
stretchMode	StretchMode	Gibt an, wie die Größe des Eingabevideos an die gewünschte Ausgabeauflösung angepasst wird. Der Standardwert ist "None".

LiveEventEncodingType

Liveereignistyp. Wenn encodingType auf PassthroughBasic oder PassthroughStandard festgelegt ist, übergibt der Dienst einfach die eingehenden Video- und Audioebenen an die Ausgabe. Wenn encodingType auf Standard oder Premium1080p festgelegt ist, transcodiert ein Liveencoder den eingehenden Stream in mehrere Bitraten oder Ebenen. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2095101. Diese Eigenschaft kann nicht geändert werden, nachdem das Liveereignis erstellt wurde.

Name	Typ	Beschreibung
None	string	Dies ist identisch mit PassthroughStandard. Weitere Informationen finden Sie in der folgenden Beschreibung. Dieser Enumerationswert ist veraltet.
PassthroughBasic	string	Der erfasste Stream durchläuft das Liveereignis vom Beitragsencoder ohne weitere Verarbeitung. Im PassthroughBasic-Modus ist die Erfassung auf bis zu 5 Mbit/s beschränkt, und nur eine gleichzeitige Liveausgabe ist zulässig. Die Livetranskription ist nicht verfügbar.
PassthroughStandard	string	Der erfasste Stream durchläuft das Liveereignis vom Beitragsencoder ohne weitere Verarbeitung. Die Livetranskription ist verfügbar. Die Grenzwerte für die Erfassungsbitrate sind viel höher, und es sind bis zu 3 gleichzeitige Liveausgaben zulässig.
Premium1080p	string	Ein Beitrags-Liveencoder sendet einen einzelnen Bitratestream an das Liveereignis, und Media Services erstellt mehrere Bitratedatenströme. Die Ausgabe darf die Auflösung von 1080p nicht überschreiten.
Standard	string	Ein Beitrags-Liveencoder sendet einen einzelnen Bitratestream an das Liveereignis, und Media Services erstellt mehrere Bitratedatenströme. Die Ausgabe darf die Auflösung von 720p nicht überschreiten.

LiveEventEndpoint

Der Endpunkt des Liveereignisses.

Name	Typ	Beschreibung
protocol	string	Das Endpunktprotokoll.
url	string	Die Endpunkt-URL.

LiveEventInput

Die Liveereigniseingabe.

Name	Typ	Beschreibung
accessControl	LiveEventInputAccessControl	Zugriffssteuerung für Die Eingabe von Liveereignissen.
accessToken	string	Eine UUID in Zeichenfolgenform, um den Stream eindeutig zu identifizieren. Dies kann bei der Erstellung angegeben, aber nicht aktualisiert werden. Wenn er nicht angegeben wird, generiert der Dienst einen eindeutigen Wert.
endpoints	LiveEventEndpoint[]	Die Eingabeendpunkte für das Liveereignis.
keyFrameIntervalDuration	string	ISO 8601 Zeitdauer der Keyframeintervalldauer der Eingabe. Dieser Wert legt die EXT-X-TARGETDURATION-Eigenschaft in der HLS-Ausgabe fest. Verwenden Sie beispielsweise PT2S, um 2 Sekunden anzugeben. Lassen Sie den Wert für die Codierung von Liveereignissen leer.
streamingProtocol	LiveEventInputProtocol	Das Eingabeprotokoll für das Liveereignis. Dies wird bei der Erstellung angegeben und kann nicht aktualisiert werden.
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	Die Metadatenendpunkte für das Liveereignis.

LiveEventInputAccessControl

Die IP-Zugriffssteuerung für die Liveereigniseingabe.

Name	Typ	Beschreibung
ip	IPAccessControl	Die IP-Zugriffssteuerungseigenschaften.

LiveEventInputProtocol

Das Eingabeprotokoll für das Liveereignis. Dies wird zur Erstellungszeit angegeben und kann nicht aktualisiert werden.

Name	Typ	Beschreibung
FragmentedMP4	string	Die Smooth Streaming-Eingabe wird vom Beitragsencoder an das Liveereignis gesendet.
RTMP	string	DIE RTMP-Eingabe wird vom Beitragsencoder an das Liveereignis gesendet.

LiveEventInputTrackSelection

Eine Trackauswahlbedingung. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.

Name	Typ	Beschreibung
operation	string	Vergleichsvorgang. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.
property	string	Eigenschaftenname, der ausgewählt werden soll. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.
value	string	Eigenschaftenwert, der ausgewählt werden soll. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.

LiveEventOutputTranscriptionTrack

Beschreibt eine Transkriptionsspur in der Ausgabe eines Liveereignisses, die mithilfe der Sprach-zu-Text-Transkription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.

Name	Typ	Beschreibung
trackName	string	Der Name der Ausgabespur. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.

LiveEventPreview

Liveereignisvorschaueinstellungen.

Name	Typ	Beschreibung
accessControl	LiveEventPreviewAccessControl	Die Zugriffssteuerung für die Liveereignisvorschau.
alternativeMediaId	string	Ein alternativer Medienbezeichner, der dem streaminglocator zugeordnet ist, der für die Vorschau erstellt wurde. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Der Bezeichner kann in customLicenseAcquisitionUrlTemplate oder CustomKeyAcquisitionUrlTemplate der im Feld StreamingPolicyName angegebenen StreamingPolicy verwendet werden.
endpoints	LiveEventEndpoint[]	Die Endpunkte für die Vorschau. Geben Sie die Vorschau-URL nicht für die Liveereignis-Zielgruppe weiter.
previewLocator	string	Der Bezeichner des Vorschaulocators im GUID-Format. Wenn Sie dies bei der Erstellung angeben, kann der Aufrufer die Vorschaulocator-URL kennen, bevor das Ereignis erstellt wird. Wenn nicht angegeben, generiert der Dienst einen zufälligen Bezeichner. Dieser Wert kann nicht aktualisiert werden, nachdem das Liveereignis erstellt wurde.
streamingPolicyName	string	Der Name der Streamingrichtlinie, die für die Liveereignisvorschau verwendet wird. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden.

LiveEventPreviewAccessControl

Die IP-Zugriffssteuerung für den Liveereignisvorschauendpunkt.

Name	Typ	Beschreibung
ip	IPAccessControl	Die IP-Zugriffssteuerungseigenschaften.

LiveEventResourceState

Der Ressourcenstatus des Liveereignisses. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2139012.

Name	Typ	Beschreibung
Allocating	string	Die Zuordnungsaktion wurde für das Liveereignis aufgerufen, und für dieses Liveereignis werden Ressourcen bereitgestellt. Sobald die Zuordnung erfolgreich abgeschlossen wurde, wechselt das Liveereignis in den Status "StandBy".
Deleting	string	Das Liveereignis wird gelöscht. In diesem Übergangszustand erfolgt keine Berechnung. In diesem Zustand sind weder Updates noch Streaming zulässig.
Running	string	Die Liveereignisressourcen wurden zugewiesen, Erfassungs- und Vorschau-URLs wurden generiert, und Livestreams können empfangen werden. Zu diesem Zeitpunkt ist die Abrechnung aktiv. Sie müssen für die Liveereignisressource explizit „Beenden“ auswählen, damit keine Gebühren mehr anfallen.
StandBy	string	Liveereignisressourcen wurden bereitgestellt und können gestartet werden. In diesem Status werden Gebühren berechnet. Die meisten Eigenschaften können weiterhin aktualisiert werden, allerdings ist die Erfassung oder das Streaming während dieses Zustands nicht zulässig.
Starting	string	Das Liveereignis wird gestartet und Ressourcen werden zugewiesen. In diesem Status werden keine Gebühren berechnet. In diesem Zustand sind weder Updates noch Streaming zulässig. Wenn ein Fehler auftritt, wird das Liveereignis in den Zustand „Angehalten“ zurückgesetzt.
Stopped	string	Dies ist der anfängliche Zustand des Liveereignisses nach der Erstellung (es sei denn, der automatische Start wurde auf „true“ festgelegt). In diesem Status werden keine Gebühren berechnet. In diesem Zustand können die Liveereigniseigenschaften aktualisiert werden, streaming ist jedoch nicht zulässig.
Stopping	string	Das Liveereignis wird beendet und die Bereitstellung der Ressourcen aufgehoben. In diesem Übergangszustand erfolgt keine Berechnung. In diesem Zustand sind weder Updates noch Streaming zulässig.

LiveEventTimedMetadataEndpoint

Der Liveereignismetadateneinfügungsendpunkt.

Name	Typ	Beschreibung
url	string	Die Metadatenendpunkt-URL.

LiveEventTranscription

Beschreibt die Transkriptionsspuren in der Ausgabe eines Liveereignisses, das mithilfe der Spracherkennungstranskription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt wird, wird ignoriert.

Name	Typ	Beschreibung
inputTrackSelection	LiveEventInputTrackSelection[]	Stellt einen Mechanismus zum Auswählen der Audiospur im Eingabe-Livefeed bereit, auf den die Sprach-in-Text-Transkription angewendet wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt wird, wird ignoriert.
language	string	Gibt die Sprache (Gebietsschema) an, die für die Spracherkennungstranskription verwendet werden soll. Sie sollte mit der gesprochenen Sprache in der Audiospur übereinstimmen. Der Wert sollte im BCP-47-Format vorliegen (z. B. "en-US"). Weitere Informationen zur Livetranskription und zur Liste der unterstützten Sprachen finden Sie https://go.microsoft.com/fwlink/?linkid=2133742 unter.
outputTranscriptionTrack	LiveEventOutputTranscriptionTrack	Beschreibt eine Transkriptionsspur in der Ausgabe eines Liveereignisses, die mithilfe der Spracherkennungstranskription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt wird, wird ignoriert.

StreamOptionsFlag

Die Optionen, die für das LiveEvent verwendet werden sollen. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Die gültigen Werte für die Arrayeintragswerte sind "Default" und "LowLatency".

Name	Typ	Beschreibung
Default	string	Livestreaming ohne spezielle Latenzoptimierungen.
LowLatency	string	Das Liveereignis bietet eine niedrigere End-to-End-Latenz, indem die internen Puffer reduziert werden.
LowLatencyV2	string	Das Liveereignis ist für end-to-End-Latenz optimiert. Diese Option ist nur für die Codierung von Liveereignissen mit RTMP-Eingabe verfügbar. Die Ausgaben können im HLS- oder DASH-Format gestreamt werden. Die Länge des Archiv- oder DVR-Rücklaufs der Ausgaben ist auf 6 Stunden beschränkt. Verwenden Sie die Streamoption "LowLatency" für alle anderen Szenarien.

StretchMode

Gibt an, wie die Größe des Eingabevideos an die gewünschte Ausgabeauflösung angepasst wird. Der Standardwert ist "None".

Name	Typ	Beschreibung
AutoFit	string	Binden Sie die Ausgabe (entweder mit Briefkasten oder Säulenfeld) ein, um die Ausgabeauflösung zu berücksichtigen, und stellen Sie sicher, dass der aktive Videobereich in der Ausgabe das gleiche Seitenverhältnis wie die Eingabe aufweist. Wenn die Eingabe beispielsweise 1920x1080 ist und die Codierungsvoreinstellung nach 1280 x 1280 fragt, liegt die Ausgabe bei 1280 x 1280, die ein inneres Rechteck von 1280x720 im Seitenverhältnis von 16:9 und Säulenfeldbereiche mit einer Breite von 280 Pixeln links und rechts enthält.
AutoSize	string	Überschreiben Sie die Ausgabeauflösung, und ändern Sie sie so, dass sie dem Anzeigeseitenverhältnis der Eingabe ohne Auffüllung entspricht. Wenn die Auflösung der Eingabe beispielsweise 1920 × 1080 ist und die Codierungsvoreinstellung 1280 × 1280 fordert, wird der Wert in der Voreinstellung außer Kraft gesetzt, und die Ausgabe erfolgt in 1280 × 720, sodass das Eingabeseitenverhältnis von 16 : 9 beibehalten wird.
None	string	Berücksichtigt streng die in der Codierungsvoreinstellung angegebene Ausgabeauflösung, ohne das Pixelseitenverhältnis oder das Anzeigeseitenverhältnis des Eingabevideos zu berücksichtigen.

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