Todos os produtos
Search
Central de documentação

ApsaraVideo Live:HotLiveRtcStream

Última atualização: Jun 28, 2026

Realiza o prefetch de fluxos de Comunicação em Tempo Real (RTC).

Descrição da operação

Limite de QPS

O limite de consultas por segundo (QPS) para um único usuário é de 10 chamadas por segundo. As chamadas de API que excederem esse limite estarão sujeitas à limitação de taxa, o que pode afetar o seu negócio. Planeje suas chamadas adequadamente.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

live:HotLiveRtcStream

none

*Domain

acs:live:*:{#accountId}:domain/{#DomainName}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Não

O ID da região.

cn-shanghai

DomainName

string

Sim

O domínio de streaming.

example.com

AppName

string

Sim

O nome do aplicativo do stream ao vivo para prefetch.

app

StreamName

string

Sim

O nome do stream ao vivo para prefetch.

stream

RegionCode

string

Sim

A área de prefetch. Para mais informações, consulte a tabela de consulta RegionCode.

Nota

Para regiões dentro da China, especifique o código correspondente na tabela "Códigos de região para a China". Para todas as outras regiões, especifique o código do país.

  • Se o erro CodeRegionHasNoNode for retornado após você especificar um RegionCode, a área correspondente não é coberta por nós L1 e não é possível realizar o prefetch. Nesse caso, especifique um RegionCode diferente.

ZHJ

AudioMsid

string

Sim

O Msid de áudio.

rts audio

VideoMsid

string

Sim

O Msid de vídeo.

rts video

ConnectionTimeout

string

Não

A duração para manter a conexão de prefetch. Unidade: milissegundos. O valor padrão, 0, significa que a conexão é sempre mantida.

0

MediaTimeout

string

Não

O período de tempo limite personalizado para um evento de tempo limite. Unidade: milissegundos.

100000

Tabela de consulta RegionCode

Códigos de região para a China

NameCode
PequimBEJ
TianjinTAJ
HebeiHEB
ShanxiSHX
Mongólia InteriorNMG
LiaoningLIA
JilinJIL
HeilongjiangHLJ
XangaiSHH
JiangsuJSU
ZhejiangZHJ
AnhuiANH
FujianFUJ
JiangxiJXI
ShandongSHD
HenanHEN
HubeiHUB
HunanHUN
GuangdongGUD
GuangxiGXI
HainanHAI
ChongqingCHQ
SichuanSCH
GuizhouGUI
YunnanYUN
TibeteTIB
ShaanxiSHA
GansuGAN
QinghaiQIH
NingxiaNXA
XinjiangXIN
TaiwanTAI
Hong KongHKG
MacauMAC

Códigos de país

NameCode
Papua-Nova GuinéPG
EslováquiaSK
PeruPE
LetôniaLV
Emirados Árabes UnidosAE
CanadáCA
CubaCU
MauritâniaMR
JapãoJP
ArmêniaAM
TurcomenistãoTM
RússiaRU
BielorrússiaBY
GuinéGN
IraqueIQ
ArgentinaAR
ChileCL
EssuatíniSZ
Congo (RDC)CD
BélgicaBE
CazaquistãoKZ
SérviaRS
TurquiaTR
NamíbiaNA
LituâniaLT
Porto RicoPR
Congo (Brazzaville)CG
Nova CaledôniaNC
MarrocosMA
GroenlândiaGL
KuwaitKW
LibériaLR
UcrâniaUA
IndonésiaID
MianmarMM
BolíviaBO
MoldáviaMD
GréciaGR
Nova ZelândiaNZ
Ilhas SalomãoSB
EtiópiaET
FijiFJ
IêmenYE
ChipreCY
Bósnia e HerzegovinaBA
EritreiaER
AlemanhaDE
PaquistãoPK
República Centro-AfricanaCF
CroáciaHR
EgitoEG
TailândiaTH
Costa RicaCR
TanzâniaTZ
LaosLA
LíbiaLY
TunísiaTN
PolôniaPL
Reino UnidoGB
Guiné EquatorialGQ
ChinaCN
IslândiaIS
OmãOM
MongóliaMN
ChadeTD
Estados UnidosUS
MéxicoMX
QuirguistãoKG
SurinameSR
ÍndiaIN
Guiné-BissauGW
VenezuelaVE
ItáliaIT
ArgéliaDZ
CatarQA
FrançaFR
África do SulZA
NoruegaNO
PortugalPT
HungriaHU
Coreia do SulKR
UzbequistãoUZ
BurundiBI
EstôniaEE
BangladeshBD
ButãoBT
AfeganistãoAF
SuíçaCH
BelizeBZ
Timor-LesteTL
HaitiHT
TogoTG
AlbâniaAL
CamarõesCM
NicaráguaNI
NigériaNG
HondurasHN
Burkina FasoBF
MoçambiqueMZ
GeórgiaGE
VanuatuVU
ParaguaiPY
LuxemburgoLU
LíbanoLB
UgandaUG
MaliML
Arábia SauditaSA
PalestinaPS
MontenegroME
ColômbiaCO
FilipinasPH
SuéciaSE
FinlândiaFI
QuêniaKE
RomêniaRO
PanamáPA
JordâniaJO
RuandaRW
LesotoLS
Macedônia do NorteMK
ZâmbiaZM
SíriaSY
EspanhaES
EquadorEC
GabãoGA
IrlandaIE
República DominicanaDO
GanaGH
MadagascarMG
MalásiaMY
ÁustriaAT
TadjiquistãoTJ
DinamarcaDK
UruguaiUY
CambojaKH
SenegalSN
El SalvadorSV
Serra LeoaSL
Brunei DarussalamBN
Saara OcidentalEH
NígerNE
IrãIR
GuianaGY
AngolaAO
BotsuanaBW
BrasilBR
AustráliaAU
Costa do MarfimCI
República TchecaCZ
GâmbiaGM
BeninBJ
VietnãVN
SudãoSD
Países BaixosNL
DjibutiDJ
EslovêniaSI
NepalNP
ZimbábueZW
JamaicaJM
MalauiMW
AzerbaijãoAZ
SomáliaSO
IsraelIL
Ilhas Malvinas (Falkland)FK
Coreia do NorteKP
GuatemalaGT
BahamasBS
Sri LankaLK
SingapuraSG
BahreinBH

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O ID da solicitação.

RequestId

string

O ID da solicitação.

16BFE188-B193-4C3C-ADC5-79A7E31486EA

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "16BFE188-B193-4C3C-ADC5-79A7E31486EA"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParam Parameter invalid. Illegal input parameters
400 NoSpecialConfiguration no special configuration for domain name.
400 CodeRegionHasNoNode this region has no corresponding node.
500 InternalError The request processing has failed due to backend service exception.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.