Compartilhar via


Live Outputs - Create

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

Solicitação de exemplo

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
    }
  }
}

Resposta de exemplo

{
  "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"
  }
}
{
  "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.