Todos os produtos
Search
Central de documentação

Expenses and Costs:DescribeSavingsPlansCoverageTotal

Última atualização: Oct 22, 2026

Consulta o resumo de cobertura do plano de economia.

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

bss:SavingsPlansAnalysis

get

*All resources.

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

StartPeriod

string

Sim

O horário de início da consulta. Formato: yyyy-MM-dd HH:mm:ss. O horário de início especificado é incluído na consulta.

2021-07-15 00:00:00

EndPeriod

string

Não

O horário de término da consulta. Formato: yyyy-MM-dd HH:mm:ss. O horário de término especificado é excluído da consulta. Se este parâmetro for deixado vazio, o horário atual será usado como horário de término.

2021-07-20 00:00:00

PeriodType

string

Sim

A granularidade de tempo. Valores válidos:

  • MONTH: mês

  • DAY: dia

  • HOUR: hora

HOUR

BillOwnerId

integer

Não

O ID da conta de propriedade do recurso. A conta de propriedade do recurso é a conta que realmente utiliza os recursos.

123745698925000

FilterParam

object

Não

Os parâmetros de filtro.

Dimensions

array<object>

Não

A lista de condições de filtro de dimensão.

object

Não

A condição de filtro de dimensão.

Code

string

Não

O código da dimensão.

SelectType

string

Não

O método de seleção para filtragem de dimensão.

Values

array

Não

A lista de valores de filtro de dimensão.

string

Não

O valor do filtro de dimensão.

Tags

array<object>

Não

A lista de condições de filtro de tag.

object

Não

A condição de filtro de tag.

Code

string

Não

O código da tag.

SelectType

string

Não

O método de seleção para filtragem de tag.

Values

array

Não

A lista de valores de filtro de tag.

string

Não

O valor do filtro de tag.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Code

string

O código de status.

Success

Data

object

Os dados retornados.

PeriodCoverage

array<object>

A taxa de cobertura por período.

object

Percentage

number

A taxa de cobertura.

1

Period

string

O período. Formato: yyyyMMddHH.

2021071500

TotalCoverage

object

A taxa de cobertura total.

CoveragePercentage

number

A taxa de cobertura total.

1

DeductAmount

number

O valor total deduzido.

100

Message

string

A mensagem de erro.

Successful!

RequestId

string

O ID da solicitação.

79EE7556-0CFD-44EB-9CD6-B3B526E3A85F

Success

boolean

Indica se a solicitação foi bem-sucedida.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "Success",
  "Data": {
    "PeriodCoverage": [
      {
        "Percentage": 1,
        "Period": "2021071500"
      }
    ],
    "TotalCoverage": {
      "CoveragePercentage": 1,
      "DeductAmount": 100
    }
  },
  "Message": "Sucesso!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true
}

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.