Adiciona uma configuração de retransmissão de stream do centro ao vivo.
Descrição da operação
Você pode chamar esta operação até 100 vezes por segundo por conta. O sistema descarta solicitações que excedem esse limite, o que pode causar interrupções no serviço. Considere essa restrição ao chamar esta operação.
Depuração
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 permissões a um usuário RAM ou função RAM e permitir a chamada desta 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 leitura, gravação e listagem.
-
Tipo de recurso: tipo de recurso no qual o usuário RAM ou a função RAM recebe autorização para executar a operação. Observe os seguintes pontos:
Tipos de recurso obrigatórios são indicados com o prefixo * .
Se não for possível conceder permissões no nível do recurso, a coluna Tipo de recurso da operação exibirá
All Resources.
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 finalizar a tarefa, é necessário possuir permissões também nas operações associadas.
Chave de condição: chave de condição definida pelo serviço de nuvem.
| Operação | Nível de acesso | Tipo de recurso | Chave de condição | Operação associada |
|---|---|---|---|---|
| live:AddLiveCenterTransfer | crie | *Domain acs:cdn:*:{#accountId}:domain/{#DomainName} |
| none |
Parâmetros da solicitação
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| DomainName | string | Sim | O domínio de streaming. | example.com |
| AppName | string | Sim | Nome do aplicativo ao qual o stream ao vivo pertence. Este valor deve corresponder exatamente ao nome do aplicativo do stream que você deseja retransmitir; caso contrário, a configuração não terá efeito. Consulte o nome do aplicativo na página Stream Management do console ApsaraVideo Live. | testapp |
| StreamName | string | Sim | Nome do stream ao vivo. Verifique o nome do stream na página Stream Management do console ApsaraVideo Live. | teststream |
| DstUrl | string | Sim | URL de terceiros para onde o stream ao vivo será retransmitido. É permitido adicionar apenas uma URL. Nota
O protocolo da URL deve ser idêntico ao protocolo do stream ao vivo. Há suporte apenas para URLs via RTMP e SRT.
| rtmp://push.example2.aliyunlive.com/testapp1/teststream2 |
| TransferArgs | string | Sim | Período de validade da retransmissão do stream. Valores válidos:
Nota
Ao definir este parâmetro como time, os campos StartTime e EndTime tornam-se obrigatórios.
| always |
| StartTime | string | Não | Horário de início da retransmissão do stream. Especifique o horário no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. | 2017-12-21T10:00:00Z |
| EndTime | string | Não | Horário de término da retransmissão do stream. Especifique o horário no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. Nota
O horário de término deve ser posterior ao horário de início.
| 2017-12-22T08:00:00Z |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Descrição |
Exemplo |
|
object |
|||
|
RequestId |
string |
ID da solicitação. |
7908F2FF-44F8-120F-9FD6-85AE4B6C19EC |
Exemplos
Exemplos de respostas de sucesso
Formato JSON
{
"RequestId": "7908F2FF-44F8-120F-9FD6-85AE4B6C19EC"
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
InvalidParam |
Parameter invalid. |
Parâmetros de entrada inválidos |
|
400 |
CenterTransfersStreamOverLimit |
CenterTransfers stream is over limit for this domainName. |
- |
|
400 |
ConfigAlreadyExists |
Config has already exist. |
- |
|
400 |
CodeIllegalDuration |
param end_time is before start_time |
- |
|
500 |
InternalError |
The request processing has failed due to backend service exception. |
- |
Para obter uma lista completa de códigos de erro, consulte os Códigos de erro do serviço.
Histórico de alterações
|
Data da alteração |
Resumo das alterações |
Operação |
|
2023-03-14 |
O código de erro foi alterado |