Todos os produtos
Search
Central de documentação

Expenses and Costs:DescribeSavingsPlansCoverageDetail

Última atualização: Oct 22, 2026

Consulta os detalhes da 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

A hora de início do intervalo de tempo a ser consultado. A hora de início está incluída no intervalo de tempo. Especifique a hora no formato yyyy-MM-dd HH:mm:ss.

2021-01-01 00:00:00

EndPeriod

string

Não

A hora de término do intervalo de tempo a ser consultado. A hora de término não está incluída no intervalo de tempo. Se você não especificar este parâmetro, a hora de término será a hora atual. Especifique a hora no formato yyyy-MM-dd HH:mm:ss.

2021-01-01 00:00:00

PeriodType

string

Sim

A granularidade de tempo para consultar o resumo de uso. Valores válidos: MONTH, DAY e HOUR.

HOUR

Token

string

Não

O token de paginação. Deixe este parâmetro vazio ao consultar a primeira página. O token para a próxima página é retornado na resposta. Um token vazio indica que todos os resultados foram recuperados.

eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9

MaxResults

integer

Não

O número máximo de resultados a serem retornados.

20

BillOwnerId

integer

Não

O ID da conta com propriedade do recurso. A conta com propriedade do recurso é a conta que realmente utiliza o recurso.

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 de consulta retornados.

Items

array<object>

Os itens de dados.

object

CoveragePercentage

number

A taxa de cobertura.

0.9

Currency

string

A moeda.

CNY

DeductAmount

number

O valor deduzido.

5.5

EndPeriod

string

A hora de término.

2023-05-01 00:00:00

InstanceId

string

O ID da instância.

i-bp1d9x623987rlj0dx4xx

InstanceSpec

string

O tipo da instância.

ecs.sn1ne.3xlarge

OwnerId

integer

O ID do proprietário do produto deduzido.

1906589291020438

PostpaidCost

number

O custo pós-pago.

200

Region

string

A região.

China (Hangzhou)

StartPeriod

string

A hora de início.

2023-04-01 00:00:00

TotalAmount

number

O valor total.

6.11

UserId

integer

O ID do usuário.

1906589291020438

UserName

string

O nome de usuário da conta.

xxx@test.aliyunid.com

NextToken

string

O token para a próxima página.

eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9

TotalCount

integer

O número total de entradas de dados.

100

Message

string

A mensagem da chamada de API.

Successful!

RequestId

string

O ID da solicitação.

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

Success

boolean

Indica se a chamada de API foi bem-sucedida.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "success",
  "Data": {
    "Items": [
      {
        "CoveragePercentage": 0.9,
        "Currency": "CNY",
        "DeductAmount": 5.5,
        "EndPeriod": "2023-05-01 00:00:00",
        "InstanceId": "i-bp1d9x623987rlj0dx4xx",
        "InstanceSpec": "ecs.sn1ne.3xlarge",
        "OwnerId": 1906589291020438,
        "PostpaidCost": 200,
        "Region": "China (Hangzhou)",
        "StartPeriod": "2023-04-01 00:00:00",
        "TotalAmount": 6.11,
        "UserId": 1906589291020438,
        "UserName": "xxx@test.aliyunid.com"
      }
    ],
    "NextToken": "eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9",
    "TotalCount": 100
  },
  "Message": "Successful!",
  "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.