Live Outputs - Create

Referens

Tjänst:: Media Services

API-version:: 2022-11-01

Skapa liveutdata
Skapar en ny live-utdata.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string	Media Services-kontonamnet.
liveEventName	path	True	string	Namnet på livehändelsen, maxlängden är 32. Reguljärt uttrycksmönster: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
liveOutputName	path	True	string	Namnet på liveutdata. Reguljärt uttrycksmönster: `^([a-zA-Z0-9])+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Namnet på resursgruppen i Azure-prenumerationen.
subscriptionId	path	True	string	Den unika identifieraren för en Microsoft Azure-prenumeration.
api-version	query	True	string	Den version av API:et som ska användas med klientbegäran.

Begärandetext

Name	Obligatorisk	Typ	Description
properties.archiveWindowLength	True	string	ISO 8601-tid mellan 1 minut och 25 timmar för att ange den maximala innehållslängden som kan arkiveras i tillgången för dessa liveutdata. Detta anger också den maximala innehållslängden för fönstret för bakåtspolning. Använd till exempel PT1H30M för att ange 1 timme och 30 minuters arkivfönster.
properties.assetName	True	string	Den tillgång som liveutdata skrivs till.
properties.description		string	Beskrivningen av liveutdata.
properties.hls		Hls	HTTP Live Streaming (HLS) förpackningsinställning för liveutdata.
properties.manifestName		string	Manifestfilens namn. Om det inte tillhandahålls genererar tjänsten en automatiskt.
properties.outputSnapTime		integer	Den första tidsstämpeln som liveutdata börjar vid, allt innehåll innan det här värdet inte arkiveras.
properties.rewindWindowLength		string	ISO 8601 tid mellan 1 minut och varaktigheten för arkivWindowLength för att kontrollera sök-kan fönsterlängd under Live. Tjänsten använder inte den här egenskapen när LiveOutput stoppas. Den arkiverade VOD:en har fullständigt innehåll med originalarkivWindowLength. Använd till exempel PT1H30M för att ange 1 timme och 30 minuters bakåtspolning av fönsterlängden. Tjänsten använder implicit standardvärde 30 m endast om livehändelsen aktiverar LL.

Svar

Name	Typ	Description
200 OK	LiveOutput	OK. Begäran har slutförts.
201 Created	LiveOutput	Skapad. Begäran har accepterats för bearbetning och åtgärden slutförs asynkront. Mer https://go.microsoft.com/fwlink/?linkid=2087017 information om hur du övervakar asynkrona Azure-åtgärder med hjälp av Azure-AsyncOperation svarsrubrik finns i .
Other Status Codes	ErrorResponse	Strömningsfelsvaret som beskriver varför åtgärden misslyckades.

Exempel

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

Exempelsvar

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

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

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
Hls	HTTP Live Streaming (HLS) förpackningsinställning för liveutdata.
LiveOutput	Live-utdata.
LiveOutputResourceState	Resurstillståndet för liveutdata.
systemData	Metadata som rör skapande och senaste ändring av resursen.

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

Hls

HTTP Live Streaming (HLS) förpackningsinställning för liveutdata.

Name	Typ	Description
fragmentsPerTsSegment	integer	Antalet fragment i ett HTTP Live Streaming (HLS) TS-segment i utdata från livehändelsen. Det här värdet påverkar inte förpackningsförhållandet för HLS CMAF-utdata.

LiveOutput

Live-utdata.

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Namnet på resursen
properties.archiveWindowLength	string	ISO 8601-tid mellan 1 minut och 25 timmar för att ange den maximala innehållslängden som kan arkiveras i tillgången för dessa liveutdata. Detta anger också den maximala innehållslängden för fönstret för bakåtspolning. Använd till exempel PT1H30M för att ange 1 timme och 30 minuters arkivfönster.
properties.assetName	string	Den tillgång som liveutdata skrivs till.
properties.created	string	Skapandetiden för liveutdata.
properties.description	string	Beskrivningen av liveutdata.
properties.hls	Hls	HTTP Live Streaming (HLS) förpackningsinställning för liveutdata.
properties.lastModified	string	Den tid då liveutdata senast ändrades.
properties.manifestName	string	Manifestfilens namn. Om det inte tillhandahålls genererar tjänsten en automatiskt.
properties.outputSnapTime	integer	Den första tidsstämpeln som liveutdata börjar vid, allt innehåll innan det här värdet inte arkiveras.
properties.provisioningState	string	Etableringstillståndet för liveutdata.
properties.resourceState	LiveOutputResourceState	Resurstillståndet för liveutdata.
properties.rewindWindowLength	string	ISO 8601 tid mellan 1 minut och varaktigheten för arkivWindowLength för att kontrollera sök-kan fönsterlängd under Live. Tjänsten använder inte den här egenskapen när LiveOutput stoppas. Den arkiverade VOD:en har fullständigt innehåll med originalarkivWindowLength. Använd till exempel PT1H30M för att ange 1 timme och 30 minuters bakåtspolning av fönsterlängden. Tjänsten använder implicit standardvärde 30 m endast om livehändelsen aktiverar LL.
systemData	systemData	Systemmetadata som är relaterade till den här resursen.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

LiveOutputResourceState

Resurstillståndet för liveutdata.

Name	Typ	Description
Creating	string	Liveutdata skapas. Inget innehåll arkiveras i tillgången förrän liveutdata är i körningstillstånd.
Deleting	string	Liveutdata tas bort. Den levande tillgången konverteras från live till en tillgång på begäran. Alla strömmande URL:er som skapats på live-utdatatillgången fortsätter att fungera.
Running	string	Liveutdata körs och arkiverar liveuppspelningsinnehåll till tillgången om det finns giltiga indata från en bidragskodare.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via