Todos os produtos
Search
Central de documentação

ActionTrail:DescribeTrailDeliveryMetricData

Última atualização: Aug 18, 2026

Obtém métricas de monitoramento de entrega.

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

actiontrail:DescribeTrailDeliveryMetricData

get

*Todos os recursos.

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

MetricName

string

Sim

O nome da métrica de monitoramento. Valores válidos:

  • delivery_sls_success_count: o número de logs entregues com sucesso ao Simple Log Service (SLS).

  • delivery_sls_fail_count: o número de logs que falharam na entrega ao SLS.

  • delivery_oss_success_count: o número de logs entregues com sucesso ao Object Storage Service (OSS).

  • delivery_oss_fail_count: o número de logs que falharam na entrega ao OSS.

delivery_sls_success_count

TrailName

string

Sim

O nome do rastro.

trail-name

StartTime

string

Sim

A hora de início. Formato: 2026-02-25T00:35:00Z.

2026-04-09T01:00:00Z

EndTime

string

Sim

A hora de término. O formato é o mesmo de StartTime.

2026-04-10T01:00:00Z

Period

integer

Sim

O período estatístico dos dados de monitoramento. O valor mínimo é 60. Múltiplos de 60 são suportados.

Valores recomendados: 60, 900 e 3600. Unidade: segundos.

3600

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

MetricList

array<object>

A lista de métricas de monitoramento.

object

O objeto de métricas de monitoramento.

Count

integer

A contagem das métricas de monitoramento. O significado específico é determinado pelo parâmetro de solicitação MetricName.

Por exemplo, se MetricName estiver definido como delivery_sls_success_count, o Count na resposta representa o número de logs entregues com sucesso ao SLS.

21

Timestamp

integer

A janela de tempo correspondente a Count. Este é o timestamp do ponto de dados da métrica, expresso como um timestamp UNIX em milissegundos.

1775721600000

RequestId

string

O ID da solicitação.

851038F3-33AB-4C49-97D7-6AB37D35****

Exemplos

Resposta de sucesso

JSON formato

{
  "MetricList": [
    {
      "Count": 21,
      "Timestamp": 1775721600000
    }
  ],
  "RequestId": "851038F3-33AB-4C49-97D7-6AB37D35****"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.