:SetLiveEdgeTransfer

Descrição da operação

Chame a operação SetLiveEdgeTransfer para configurar a retransmissão de stream na borda. A configuração aplica-se apenas a streams ingeridos após a ativação do recurso. A tabela a seguir descreve os cenários em que a retransmissão entra ou não em vigor.

Limite de QPS

É possível chamar esta operação até 100 vezes por segundo por conta. Solicitações que excedem esse limite são descartadas, o que pode causar interrupções no serviço. Recomendamos considerar esse limiar ao executar esta operação.

Depuração

Execute esta interface diretamente no OpenAPI Explorer e evite o cálculo manual de assinaturas. Após a execução bem-sucedida, o OpenAPI Explorer gera automaticamente exemplos de código SDK.

Depurar

Informações de autorização

A tabela a seguir apresenta as informações de autorização correspondentes à API. Use essas informações no elemento de política Action para conceder a um usuário RAM ou função RAM as permissões necessárias para chamar esta operação da API. Descrição:

• Operação: valor usado no elemento Action para especificar a ação sobre um recurso.

• Nível de acesso: nível de acesso de cada operação. Os níveis disponíveis são read, write e list.

• Tipo de recurso: tipo de recurso no qual o usuário RAM ou a função RAM pode ser autorizado a executar a operação. Observe os seguintes pontos:

  • Tipos de recurso obrigatórios são indicados com o prefixo * .

  • Caso não seja possível conceder permissões no nível do recurso, All Resources será exibido na coluna Tipo de recurso da operação.

• Chave de condição: chave de condição definida pelo serviço de nuvem.

• Operação associada: outras operações que o usuário RAM ou a função RAM precisa ter permissão para executar a fim de concluir a operação principal. Para concluir a operação, o usuário RAM ou a função RAM deve possuir permissões para realizar as operações associadas.

Parâmetros da requisição

Descrição dos parâmetros AppName e StreamName

Os parâmetros AppName e StreamName não aceitam acentos circunflexos (^) nem cifrões ($). A presença de um acento circunflexo (^) ou cifrão ($) nos valores desses parâmetros causa falha na retransmissão de stream.

Descrição da API HTTPDNS

Quando o parâmetro HttpDns está configurado, os nomes de domínio de destino são obtidos por meio do acesso à API HTTPDNS especificada nesse mesmo parâmetro.

Exemplo: http://developer.aliyundoc.com/?host={}&app={}&name={}{<_ali_user_args>} Observação: Durante o acesso à API HTTPDNS, os parâmetros abaixo são substituídos pelos valores reais presentes na URL de ingestão.

• {}: O domínio de ingestão.

• {}: O nome do aplicativo ao qual o stream ao vivo pertence.

• {}: O nome do stream.

• {<_ali_user_args>}: Os parâmetros personalizados incluídos na URL de ingestão.

A resposta retorna os seguintes códigos de status HTTP e resultados.

• O código de status HTTP 403 indica falha no acesso à API HTTPDNS. Nesse caso, a retransmissão de stream não é necessária.

• O código de status HTTP 200 confirma o acesso bem-sucedido à API HTTPDNS. O resultado retornado vem no formato JSON. O exemplo a seguir ilustra a estrutura da mensagem e seus parâmetros.

{

"cdn_types": [

{

"name": "cdnA****",

"upstream_url": "rtmp://developer.aliyundoc.com/live/testedge****"

},

{

"name": "cdnB****",

"upstream_url": "rtmp://developer.aliyundoc.com/live/testedge****"

}

]

}

Observação: O nome de domínio de destino pode ser extraído diretamente do resultado em formato JSON. Caso múltiplos domínios de destino sejam retornados, o stream ingerido será retransmitido para todos eles.

• Se a estrutura dos dados retornados não atender aos requisitos, a retransmissão de stream falhará.

Parâmetros de resposta

Exemplos

Exemplos de respostas de sucesso

Formato JSON

{

"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CF8"

}

Códigos de erro

Para obter a lista completa de códigos de erro, consulte os Códigos de erro do serviço.