Live Events - Stop

Service:

Media Services

API Version:

2022-11-01

Liveereignis beenden
Beendet ein ausgeführtes Liveereignis.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}/stop?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])*$
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	Typ	Beschreibung
removeOutputsOnStop	boolean	Das Flag gibt an, ob Liveausgaben automatisch gelöscht werden, wenn das Liveereignis beendet wird. Beim Löschen von Liveausgaben werden die zugrunde liegenden Ressourcen nicht gelöscht.

Antworten

Name	Typ	Beschreibung
200 OK		OK. Die Anforderung wurde erfolgreich durchgeführt.
202 Accepted		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

Stop a LiveEvent

Sample Request

HTTP

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

{
  "removeOutputsOnStop": false
}

Java

import com.azure.resourcemanager.mediaservices.models.LiveEventActionInput;

/** Samples for LiveEvents Stop. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-stop.json
     */
    /**
     * Sample code: Stop a LiveEvent.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void stopALiveEvent(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .liveEvents()
            .stop(
                "mediaresources",
                "slitestmedia10",
                "myLiveEvent1",
                new LiveEventActionInput().withRemoveOutputsOnStop(false),
                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

Sample Response

Status code:

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

Status code:

200

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
LiveEventActionInput	Die Definition des LiveEvent-Aktionsparameters.

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.

LiveEventActionInput

Die Definition des LiveEvent-Aktionsparameters.

Name	Typ	Beschreibung
removeOutputsOnStop	boolean	Das Flag gibt an, ob Liveausgaben automatisch gelöscht werden, wenn das Liveereignis beendet wird. Beim Löschen von Liveausgaben werden die zugrunde liegenden Ressourcen nicht gelöscht.