Live Outputs - Create

Referência

Serviço:: Media Services

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

Criar Saída em Direto
Cria uma nova saída em direto.

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 do URI

Name	Em	Necessário	Tipo	Description
accountName	path	True	string	O nome da conta dos Serviços de Multimédia.
liveEventName	path	True	string	O nome do evento em direto, comprimento máximo é 32. Padrão Regex: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
liveOutputName	path	True	string	O nome da saída em direto. Padrão Regex: `^([a-zA-Z0-9])+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	O nome do grupo de recursos na subscrição do Azure.
subscriptionId	path	True	string	O identificador exclusivo de uma subscrição do Microsoft Azure.
api-version	query	True	string	A versão da API a utilizar com o pedido de cliente.

Corpo do Pedido

Name	Necessário	Tipo	Description
properties.archiveWindowLength	True	string	ISO 8601 tempo entre 1 minuto e 25 horas para indicar o comprimento máximo de conteúdo que pode ser arquivado no recurso para esta saída em direto. Isto também define o comprimento máximo do conteúdo para a janela rebobinar. Por exemplo, utilize PT1H30M para indicar 1 hora e 30 minutos de janela de arquivo.
properties.assetName	True	string	O recurso para o qual a saída em direto irá escrever.
properties.description		string	A descrição da saída em direto.
properties.hls		Hls	HTTP Live Streaming (HLS) definição de embalagem para a saída em direto.
properties.manifestName		string	O nome do ficheiro de manifesto. Se não for fornecido, o serviço irá gerar um automaticamente.
properties.outputSnapTime		integer	O carimbo de data/hora inicial em que o resultado em direto será iniciado, qualquer conteúdo antes deste valor não será arquivado.
properties.rewindWindowLength		string	TEMPO ISO 8601 entre 1 minuto e a duração do arquivoWindowLength para controlar o comprimento da janela em direto. O serviço não utilizará esta propriedade quando o LiveOutput parar. O VOD arquivado terá conteúdo completo com ArchiveWindowLength original. Por exemplo, utilize PT1H30M para indicar 1 hora e 30 minutos de comprimento da janela rebobinar. O serviço utilizará o valor predefinido implícito de 30 m apenas se o Evento em Direto ativar LL.

Respostas

Name	Tipo	Description
200 OK	LiveOutput	OK. O pedido foi bem-sucedido.
201 Created	LiveOutput	Criado. O pedido foi aceite para processamento e a operação será concluída de forma assíncrona. Veja https://go.microsoft.com/fwlink/?linkid=2087017 os detalhes sobre a monitorização de operações assíncronas do Azure com o cabeçalho de resposta Azure-AsyncOperation.
Other Status Codes	ErrorResponse	A resposta a erros de transmissão em fluxo que descreve a razão pela qual 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 da amostra

Código de estado:: 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 estado:: 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

Name	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta a erros
Hls	HTTP Live Streaming (HLS) definição de embalagem para a saída em direto.
LiveOutput	A Saída Em Direto.
LiveOutputResourceState	O estado do recurso da saída em direto.
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

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

ErrorDetail

O detalhe do erro.

Name	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 a erros

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

Hls

HTTP Live Streaming (HLS) definição de embalagem para a saída em direto.

Name	Tipo	Description
fragmentsPerTsSegment	integer	O número de fragmentos num segmento TS de HTTP Live Streaming (HLS) na saída do evento em direto. Este valor não afeta a proporção de embalagem da saída de CMAF do HLS.

LiveOutput

A Saída Em Direto.

Name	Tipo	Description
id	string	ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties.archiveWindowLength	string	ISO 8601 tempo entre 1 minuto e 25 horas para indicar o comprimento máximo de conteúdo que pode ser arquivado no recurso para esta saída em direto. Isto também define o comprimento máximo do conteúdo para a janela rebobinar. Por exemplo, utilize PT1H30M para indicar 1 hora e 30 minutos de janela de arquivo.
properties.assetName	string	O recurso para o qual a saída em direto irá escrever.
properties.created	string	A hora de criação da saída em direto.
properties.description	string	A descrição da saída em direto.
properties.hls	Hls	HTTP Live Streaming (HLS) definição de embalagem para a saída em direto.
properties.lastModified	string	A hora em que a saída em direto foi modificada pela última vez.
properties.manifestName	string	O nome do ficheiro de manifesto. Se não for fornecido, o serviço irá gerar um automaticamente.
properties.outputSnapTime	integer	O carimbo de data/hora inicial em que o resultado em direto será iniciado, qualquer conteúdo antes deste valor não será arquivado.
properties.provisioningState	string	O estado de aprovisionamento da saída em direto.
properties.resourceState	LiveOutputResourceState	O estado do recurso da saída em direto.
properties.rewindWindowLength	string	TEMPO ISO 8601 entre 1 minuto e a duração do arquivoWindowLength para controlar o comprimento da janela em direto. O serviço não utilizará esta propriedade quando o LiveOutput parar. O VOD arquivado terá conteúdo completo com ArchiveWindowLength original. Por exemplo, utilize PT1H30M para indicar 1 hora e 30 minutos de comprimento da janela rebobinar. O serviço utilizará o valor predefinido implícito de 30 m apenas se o Evento em Direto ativar LL.
systemData	systemData	Os metadados do sistema relacionados com este recurso.
type	string	O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

LiveOutputResourceState

O estado do recurso da saída em direto.

Name	Tipo	Description
Creating	string	A saída em direto está a ser criada. Nenhum conteúdo é arquivado no recurso até que a saída em direto esteja no estado de execução.
Deleting	string	A saída em direto está a ser eliminada. O ativo vivo está a ser convertido do ativo em direto para o ativo a pedido. Todos os URLs de transmissão em fluxo criados no recurso de saída em direto continuam a funcionar.
Running	string	A saída em direto está a ser executada e a arquivar conteúdos de transmissão em fluxo em direto para o recurso se existir uma entrada válida de um codificador de contribuições.

systemData

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

Name	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.

Partilhar via