Live Outputs - Create

Odwołanie

Usługa:: Media Services

Wersja interfejsu API:: 2022-11-01

Tworzenie danych wyjściowych na żywo
Tworzy nowe dane wyjściowe na żywo.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string	Nazwa konta usługi Media Services.
liveEventName	path	True	string	Nazwa wydarzenia na żywo, maksymalna długość to 32. Wzorzec wyrażenia regularnego: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
liveOutputName	path	True	string	Nazwa danych wyjściowych na żywo. Wzorzec wyrażenia regularnego: `^([a-zA-Z0-9])+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
subscriptionId	path	True	string	Unikatowy identyfikator subskrypcji platformy Microsoft Azure.
api-version	query	True	string	Wersja interfejsu API, która ma być używana z żądaniem klienta.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties.archiveWindowLength	True	string	Czas ISO 8601 z zakresu od 1 minuty do 25 godzin wskazujący maksymalną długość zawartości, którą można zarchiwizować w zasobie dla tych danych wyjściowych na żywo. Spowoduje to również ustawienie maksymalnej długości zawartości okna przewijania. Na przykład użyj PT1H30M, aby wskazać 1 godzinę i 30 minut okna archiwum.
properties.assetName	True	string	Zasób, do którego będą zapisywane dane wyjściowe na żywo.
properties.description		string	Opis danych wyjściowych na żywo.
properties.hls		Hls	ustawienie pakowania HTTP Live Streaming (HLS) dla danych wyjściowych na żywo.
properties.manifestName		string	Nazwa pliku manifestu. Jeśli nie zostanie podana, usługa wygeneruje je automatycznie.
properties.outputSnapTime		integer	Początkowy znacznik czasu, od którego będą uruchamiane dane wyjściowe na żywo, każdą zawartość, zanim ta wartość nie zostanie zarchiwizowana.
properties.rewindWindowLength		string	Czas ISO 8601 z zakresu od 1 minuty do czasu trwania archiwumWindowLength w celu kontrolowania długości okna w trybie wyszukiwania podczas transmisji na żywo. Usługa nie będzie używać tej właściwości po zatrzymaniu funkcji LiveOutput. Zarchiwizowane voD będą miały pełną zawartość z oryginalnym ArchiwumWindowLength. Na przykład użyj PT1H30M, aby wskazać 1 godzinę i 30 minut długości okna przewijania. Usługa będzie używać niejawnej wartości domyślnej 30 m tylko wtedy, gdy wydarzenie na żywo włączy ll.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	LiveOutput	OK. Żądanie zakończyło się pomyślnie.
201 Created	LiveOutput	Utworzone. Żądanie zostało zaakceptowane na potrzeby przetwarzania, a operacja zostanie ukończona asynchronicznie. Aby https://go.microsoft.com/fwlink/?linkid=2087017 uzyskać szczegółowe informacje na temat monitorowania asynchronicznych operacji platformy Azure przy użyciu nagłówka odpowiedzi Azure-AsyncOperation.
Other Status Codes	ErrorResponse	Odpowiedź z błędem przesyłania strumieniowego opisująca, dlaczego operacja nie powiodła się.

Przykłady

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

Przykładowa odpowiedź

Kod stanu:: 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"
  }
}

Kod stanu:: 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"
  }
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
Hls	ustawienie pakowania HTTP Live Streaming (HLS) dla danych wyjściowych na żywo.
LiveOutput	Dane wyjściowe na żywo.
LiveOutputResourceState	Stan zasobu danych wyjściowych na żywo.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

Hls

ustawienie pakowania HTTP Live Streaming (HLS) dla danych wyjściowych na żywo.

Nazwa	Typ	Opis
fragmentsPerTsSegment	integer	Liczba fragmentów w segmencie TS HTTP Live Streaming (HLS) w danych wyjściowych wydarzenia na żywo. Ta wartość nie ma wpływu na współczynnik pakowania dla danych wyjściowych HLS CMAF.

LiveOutput

Dane wyjściowe na żywo.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nazwa zasobu
properties.archiveWindowLength	string	Czas ISO 8601 z zakresu od 1 minuty do 25 godzin wskazujący maksymalną długość zawartości, którą można zarchiwizować w zasobie dla tych danych wyjściowych na żywo. Spowoduje to również ustawienie maksymalnej długości zawartości okna przewijania. Na przykład użyj PT1H30M, aby wskazać 1 godzinę i 30 minut okna archiwum.
properties.assetName	string	Zasób, do którego będą zapisywane dane wyjściowe na żywo.
properties.created	string	Czas tworzenia danych wyjściowych na żywo.
properties.description	string	Opis danych wyjściowych na żywo.
properties.hls	Hls	ustawienie pakowania HTTP Live Streaming (HLS) dla danych wyjściowych na żywo.
properties.lastModified	string	Czas ostatniej modyfikacji danych wyjściowych na żywo.
properties.manifestName	string	Nazwa pliku manifestu. Jeśli nie zostanie podana, usługa wygeneruje je automatycznie.
properties.outputSnapTime	integer	Początkowy znacznik czasu, od którego będą uruchamiane dane wyjściowe na żywo, każdą zawartość, zanim ta wartość nie zostanie zarchiwizowana.
properties.provisioningState	string	Stan aprowizacji danych wyjściowych na żywo.
properties.resourceState	LiveOutputResourceState	Stan zasobu danych wyjściowych na żywo.
properties.rewindWindowLength	string	Czas ISO 8601 z zakresu od 1 minuty do czasu trwania archiwumWindowLength w celu kontrolowania długości okna w trybie wyszukiwania podczas transmisji na żywo. Usługa nie będzie używać tej właściwości po zatrzymaniu funkcji LiveOutput. Zarchiwizowane voD będą miały pełną zawartość z oryginalnym ArchiwumWindowLength. Na przykład użyj PT1H30M, aby wskazać 1 godzinę i 30 minut długości okna przewijania. Usługa będzie używać niejawnej wartości domyślnej 30 m tylko wtedy, gdy wydarzenie na żywo włączy ll.
systemData	systemData	Metadane systemowe odnoszące się do tego zasobu.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

LiveOutputResourceState

Stan zasobu danych wyjściowych na żywo.

Nazwa	Typ	Opis
Creating	string	Tworzone są dane wyjściowe na żywo. Żadna zawartość nie jest archiwizowana w zasobie, dopóki dane wyjściowe na żywo nie będą w stanie uruchomienia.
Deleting	string	Dane wyjściowe na żywo są usuwane. Zasób na żywo jest konwertowany z zasobu na żywo na zasób na żądanie. Wszystkie adresy URL przesyłania strumieniowego utworzone w zasobie danych wyjściowych na żywo nadal działają.
Running	string	Dane wyjściowe na żywo są uruchomione i archiwizowanie zawartości przesyłania strumieniowego na żywo do zasobu, jeśli istnieją prawidłowe dane wejściowe z kodera współtworzenia.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij za pośrednictwem