Live Outputs - Create

Referência

Serviço:: Media Services

Versão da API:: 2022-11-01

Criar Saída Dinâmica
Cria uma nova saída ao vivo.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
accountName	path	True	string	O nome da conta dos Serviços de Mídia.
liveEventName	path	True	string	O nome do evento ao vivo, o comprimento máximo é 32. Padrão Regex: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
liveOutputName	path	True	string	O nome da saída ao vivo. Padrão Regex: `^([a-zA-Z0-9])+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	O nome do grupo de recursos na assinatura do Azure.
subscriptionId	path	True	string	O identificador exclusivo para uma assinatura do Microsoft Azure.
api-version	query	True	string	A versão da API a ser usada com a solicitação do cliente.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
properties.archiveWindowLength	True	string	Tempo ISO 8601 entre 1 minuto e 25 horas para indicar o comprimento máximo do conteúdo que pode ser arquivado no ativo para essa saída ao vivo. Isso também define o comprimento máximo do conteúdo para a janela de rebobinamento. Por exemplo, use PT1H30M para indicar 1 hora e 30 minutos de janela de arquivo morto.
properties.assetName	True	string	O ativo no qual a saída dinâmica gravará.
properties.description		string	A descrição da saída ao vivo.
properties.hls		Hls	HTTP Live Streaming (HLS) configuração de empacotamento para a saída ao vivo.
properties.manifestName		string	O nome do arquivo de manifesto. Se não for fornecido, o serviço gerará um automaticamente.
properties.outputSnapTime		integer	O carimbo de data/hora inicial em que a saída dinâmica será iniciada, qualquer conteúdo antes desse valor não será arquivado.
properties.rewindWindowLength		string	Tempo ISO 8601 entre 1 minuto e a duração de archiveWindowLength para controlar o comprimento da janela de busca durante o Live. O serviço não usará essa propriedade quando o LiveOutput for interrompido. O VOD arquivado terá conteúdo completo com ArchiveWindowLength original. Por exemplo, use PT1H30M para indicar 1 hora e 30 minutos de comprimento da janela de retrocesso. O serviço usará o valor padrão implícito de 30m somente se o Live Event habilitar LL.

Respostas

Nome	Tipo	Description
200 OK	LiveOutput	OK. A solicitação foi bem-sucedida.
201 Created	LiveOutput	Criado. A solicitação foi aceita para processamento e a operação será concluída de forma assíncrona. Consulte https://go.microsoft.com/fwlink/?linkid=2087017 para obter detalhes sobre como monitorar operações assíncronas do Azure usando o cabeçalho de resposta Azure-AsyncOperation.
Other Status Codes	ErrorResponse	A resposta de erro de streaming que descreve por que a operação falhou.

Exemplos

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

Resposta de exemplo

Código de status:: 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"
  }
}

Código de status:: 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"
  }
}

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
Hls	HTTP Live Streaming (HLS) configuração de empacotamento para a saída ao vivo.
LiveOutput	A saída ao vivo.
LiveOutputResourceState	O estado do recurso da saída dinâmica.
systemData	Metadados relativos à criação e à última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

Hls

HTTP Live Streaming (HLS) configuração de empacotamento para a saída ao vivo.

Nome	Tipo	Description
fragmentsPerTsSegment	integer	O número de fragmentos em um segmento de TS de HTTP Live Streaming (HLS) na saída do evento ao vivo. Esse valor não afeta a taxa de empacotamento para a saída HLS CMAF.

LiveOutput

A saída ao vivo.

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties.archiveWindowLength	string	Tempo ISO 8601 entre 1 minuto e 25 horas para indicar o comprimento máximo do conteúdo que pode ser arquivado no ativo para essa saída ao vivo. Isso também define o comprimento máximo do conteúdo para a janela de rebobinamento. Por exemplo, use PT1H30M para indicar 1 hora e 30 minutos de janela de arquivo morto.
properties.assetName	string	O ativo no qual a saída dinâmica gravará.
properties.created	string	A hora de criação da saída ao vivo.
properties.description	string	A descrição da saída ao vivo.
properties.hls	Hls	HTTP Live Streaming (HLS) configuração de empacotamento para a saída ao vivo.
properties.lastModified	string	A hora em que a saída ao vivo foi modificada pela última vez.
properties.manifestName	string	O nome do arquivo de manifesto. Se não for fornecido, o serviço gerará um automaticamente.
properties.outputSnapTime	integer	O carimbo de data/hora inicial em que a saída dinâmica será iniciada, qualquer conteúdo antes desse valor não será arquivado.
properties.provisioningState	string	O estado de provisionamento da saída dinâmica.
properties.resourceState	LiveOutputResourceState	O estado do recurso da saída dinâmica.
properties.rewindWindowLength	string	Tempo ISO 8601 entre 1 minuto e a duração de archiveWindowLength para controlar o comprimento da janela de busca durante o Live. O serviço não usará essa propriedade quando o LiveOutput for interrompido. O VOD arquivado terá conteúdo completo com ArchiveWindowLength original. Por exemplo, use PT1H30M para indicar 1 hora e 30 minutos de comprimento da janela de retrocesso. O serviço usará o valor padrão implícito de 30m somente se o Live Event habilitar LL.
systemData	systemData	Os metadados do sistema relacionados a esse recurso.
type	string	Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

LiveOutputResourceState

O estado do recurso da saída dinâmica.

Nome	Tipo	Description
Creating	string	A saída ao vivo está sendo criada. Nenhum conteúdo é arquivado no ativo até que a saída ao vivo esteja em estado de execução.
Deleting	string	A saída ao vivo está sendo excluída. O ativo ativo está sendo convertido de ativo ativo para sob demanda. Todas as URLs de streaming criadas no ativo de saída ao vivo continuam funcionando.
Running	string	A saída ao vivo está executando e arquivando conteúdo de transmissão ao vivo para o ativo se houver uma entrada válida de um codificador de contribuição.

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Compartilhar via