Todos os produtos
Search
Central de documentação

ApsaraVideo Live:DescribeRTSNativeSDKVvData

Última atualização: Jun 28, 2026

Obtém a contagem de reproduções em um período de tempo especificado, incluindo a contagem total e a contagem de reproduções bem-sucedidas.

Descrição da operação

Limite de QPS\nO limite de QPS por usuário para esta operação é de 10 chamadas por segundo. Se o limite for excedido, as chamadas de API serão limitadas, o que pode afetar os seus negócios. Utilize esta operação de forma adequada. Para mais informações, consulte Limite de QPS.

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:DescribeRTSNativeSDKVvData

get

*Domain

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

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

StartTime

string

Não

A hora de início. Este parâmetro é obrigatório. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

2021-12-10T20:00:00Z

EndTime

string

Não

A hora de término. Este parâmetro é obrigatório. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

2021-12-10T21:00:00Z

DataInterval

string

Não

A granularidade de tempo. Valores válidos: 300, 3600, 14400, 28800 e 86400. Unidade: segundos. Se este parâmetro não for especificado ou se o valor especificado não for suportado, o valor padrão 300 será utilizado.

300

DomainNameList

array

Não

O array.

string

Não

Por padrão, todos os nomes de domínio são consultados (versão 2.1.0 e posterior). Você também pode especificar nomes de domínio. Separe vários nomes de domínio com vírgulas (,). É possível consultar no máximo 500 nomes de domínio por vez.

a.example.com

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

DataInterval

string

A granularidade de tempo.

300

EndTime

string

A hora de término. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.

2021-12-10T21:00:00Z

RequestId

string

Id

16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

StartTime

string

A hora de início. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.

2021-12-10T20:00:00Z

VvData

array<object>

A contagem total de reproduções e a contagem total de reproduções bem-sucedidas para cada intervalo de tempo. Unidade: contagem.

object

TimeStamp

string

A hora de início do intervalo de tempo. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.

2021-12-10T20:00:00Z

VvSuccess

string

O número total de reproduções bem-sucedidas no período de tempo especificado.

99

VvTotal

string

O número total de reproduções no período de tempo especificado.

100

Exemplos

Resposta de sucesso

JSON formato

{
  "DataInterval": "300",
  "EndTime": "2021-12-10T21:00:00Z",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  "StartTime": "2021-12-10T20:00:00Z",
  "VvData": [
    {
      "TimeStamp": "2021-12-10T20:00:00Z",
      "VvSuccess": "99",
      "VvTotal": "100"
    }
  ]
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 Meter.ParamError Param Error:%s,Please Check Again.
500 Meter.ServerInternalError The Request Processing Has Failed Due To Some Unknown Error.
500 Meter.DataSourceQueryError Data Source Error:%s,Please Try Again.
403 Meter.AuthError Authentication Failed,Please Try Again.
502 Meter.ReadyTsError Get ReadyTs Failed,Please Try Again.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.