Todos os produtos
Search
Central de documentação

:PushMeteringData

Última atualização: Jun 28, 2026

Envia dados de medição para instâncias de serviço do Compute Nest no modelo pay-as-you-go. Os itens de medição devem ser predefinidos pelo provedor de serviços.

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

computenestsupplier:PushMeteringData

none

*ServiceInstance

acs:computenestsupplier:{#regionId}:{#accountId}:serviceinstance/{#ServiceInstanceId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Metering

string

Sim

Os parâmetros são descritos da seguinte forma:

  • InstanceId: O ID da instância do Alibaba Cloud Marketplace. O tipo de parâmetro é String.

  • StartTime: A hora de início da medição. A unidade é segundos. O formato é um timestamp UNIX. O tipo de parâmetro é Long.

  • EndTime: A hora de término da medição. A unidade é segundos. O formato é um timestamp UNIX. O tipo de parâmetro é Long.

  • Entities: O objeto de entidade de medição. O tipo de parâmetro é List<Map>.

    • Key: O nome da propriedade do item de medição. O tipo de parâmetro é String.

      • Frequency: O número de vezes de uso.

      • Period: A duração de uso em segundos. Nota: A duração no parâmetro de solicitação é medida em segundos, mas a unidade de faturamento é horas. A duração é convertida em horas para faturamento. Por exemplo, se você enviar um uso de 1800 para o período das 19:00 às 20:00 e o preço for USD 1/hora, a fatura horária para este período será 1800 / 3600 × 1 = USD 0,5. Se a taxa for um decimal, ela será truncada para duas casas decimais.

      • Storage: O espaço de armazenamento utilizado, em bytes. Nota: A unidade no parâmetro de solicitação é bytes, mas a unidade de faturamento é MB. O valor é convertido em MB para faturamento. Por exemplo, se você enviar um uso de 524288 para o período das 19:00 às 20:00 e o preço for USD 1/MB, a fatura horária para este período será 524288 / 1024 / 1024 × 1 = USD 0,5. Se a taxa for um decimal, ela será truncada para duas casas decimais.

      • NetworkOut: A transferência de dados de saída, em bits. Nota: A unidade no parâmetro de solicitação é bits, mas a unidade de faturamento é Mb. O valor é convertido em Mb para faturamento. Por exemplo, se você enviar um uso de 524288 para o período das 19:00 às 20:00 e o preço for USD 1/Mb, a fatura horária para este período será 524288 / 1024 / 1024 × 1 = USD 0,5. Se a taxa for um decimal, ela será truncada para duas casas decimais.

      • NetworkIn: A transferência de dados de entrada, em bits. Nota: A unidade no parâmetro de solicitação é bits, mas a unidade de faturamento é Mb. O valor é convertido em Mb para faturamento. Por exemplo, se você enviar um uso de 524288 para o período das 19:00 às 20:00 e o preço for USD 1/Mb, a fatura horária para este período será 524288 / 1024 / 1024 × 1 = USD 0,5. Se a taxa for um decimal, ela será truncada para duas casas decimais.

      • Character: O número de caracteres.

      • DailyActiveUser: O número de usuários ativos diários (DAU).

      • PeriodMin: A duração de uso em minutos.

      • VirtualCpu: O número de núcleos de vCPU.

        • Unit: O número de unidades.

        • Memory: O tamanho da memória em GB.

    • Value: O valor de medição. O valor deve ser maior ou igual a 0. O tipo de parâmetro é Integer.

Nota:

  • Para produtos com faturamento em tempo real, o intervalo entre StartTime e EndTime pode ter qualquer duração. EndTime deve ser posterior a StartTime.

  • Para produtos que não são faturados em tempo real, como aqueles faturados por hora, dia ou mês, o intervalo entre StartTime e EndTime deve ser superior a 5 minutos.

  • Ao enviar dados de medição em lotes, a propriedade InstanceId deve ser para instâncias do mesmo produto. Não há suporte para o envio de dados para instâncias de vários produtos ao mesmo tempo.

[{"StartTime":1711527396,"EndTime":1711527397,"Entities":[{"Key":"Unit","Value":"0"}]}]

ServiceInstanceId

string

Sim

O ID da instância de serviço.

si-0e6fca6a51a54420****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

94E89857-B994-44B6-9C4F-DBD200E9XXXX

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "94E89857-B994-44B6-9C4F-DBD200E9XXXX"
}

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.