Price Sheet - Get

Obtém a tabela de preços de um escopo por subscriptionId. A tabela de preços está disponível por meio dessa API somente para 1º de maio de 2014 ou posterior.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2019-10-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}&api-version=2019-10-01

Parâmetros de URI

Name In Required Type Description
subscriptionId
path True
  • string

ID de assinatura do Azure.

api-version
query True
  • string

Versão da API a ser usada com a solicitação do cliente. A versão atual é 2019-10-01.

$expand
query
  • string

Pode ser usado para expandir as propriedades/meterDetails dentro de uma tabela de preços. Por padrão, esses campos não são incluídos ao retornar a tabela de preços.

$skiptoken
query
  • string

Skiptoken só será usado se uma operação anterior retornar um resultado parcial. Se uma resposta anterior contiver um elemento nextLink, o valor do elemento nextLink incluirá um parâmetro skiptoken que especifica um ponto de partida a ser usado para chamadas subsequentes.

$top
query
  • integer
int32

Pode ser usado para limitar o número de resultados aos primeiros N resultados.

Respostas

Name Type Description
200 OK

OK. A solicitação foi bem-sucedida.

Other Status Codes

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Azure Active Directory fluxo OAuth2.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

PriceSheet

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/pricesheets/default?api-version=2019-10-01

Sample Response

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "properties": {
    "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31&$skiptoken=AQAAAA%3D%3D",
    "pricesheets": [
      {
        "billingPeriodId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "unitOfMeasure": "100 Hours",
        "includedQuantity": 100,
        "partNumber": "XX-11110",
        "unitPrice": 0.00328,
        "currencyCode": "EUR",
        "offerId": "OfferId 1"
      }
    ]
  }
}

Definições

ErrorDetails

Os detalhes do erro.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Algumas respostas de erro:

  • 429 TooManyRequests – a solicitação é acelerada. Tentar novamente depois de aguardar o tempo especificado no header "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable – o serviço está temporariamente indisponível. Tentar novamente depois de aguardar o tempo especificado no header "Retry-After".

MeterDetails

As propriedades dos detalhes do medidor.

PriceSheetProperties

As propriedades da tabela de preços.

PriceSheetResult

Um recurso pricesheet.

ErrorDetails

Os detalhes do erro.

Name Type Description
code
  • string

Código do erro.

message
  • string

Mensagem de erro indicando por que a operação falhou.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Algumas respostas de erro:

  • 429 TooManyRequests – a solicitação é acelerada. Tentar novamente depois de aguardar o tempo especificado no header "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable – o serviço está temporariamente indisponível. Tentar novamente depois de aguardar o tempo especificado no header "Retry-After".

Name Type Description
error

Os detalhes do erro.

MeterDetails

As propriedades dos detalhes do medidor.

Name Type Description
meterCategory
  • string

A categoria do medidor, por exemplo, 'Serviços de nuvem', 'Rede', etc..

meterLocation
  • string

O local no qual o serviço do Azure está disponível.

meterName
  • string

O nome do medidor, dentro da categoria de medidor determinada

meterSubCategory
  • string

A subcategoria do medidor, por exemplo, 'Serviços de nuvem A6', 'ExpressRoute (IXP)', etc..

pretaxStandardRate
  • number

O preço de listagem pretax.

serviceName
  • string

O nome do serviço.

serviceTier
  • string

A camada de serviço.

totalIncludedQuantity
  • number

A quantidade total incluída associada à oferta.

unit
  • string

A unidade na qual o consumo do medidor é cobrado, por exemplo, 'Horas', 'GB', etc.

PriceSheetProperties

As propriedades da tabela de preços.

Name Type Description
billingPeriodId
  • string

A ID do recurso de período de cobrança ao que o uso pertence.

currencyCode
  • string

Código de moeda

includedQuantity
  • number

Qualidade incluída para uma oferta

meterDetails

Os detalhes sobre o medidor. Por padrão, isso não é populado, a menos que seja especificado em $expand.

meterId
  • string

A ID do medidor (GUID)

offerId
  • string

ID da oferta

partNumber
  • string

Número de peça

unitOfMeasure
  • string

Unidade de medida

unitPrice
  • number

Preço Unitário

PriceSheetResult

Um recurso pricesheet.

Name Type Description
etag
  • string

Etag de recurso.

id
  • string

ID do recurso.

name
  • string

Nome do recurso.

properties.download

Detalhes de download do Pricesheet.

properties.nextLink
  • string

O link (url) para a próxima página de resultados.

properties.pricesheets

Tabela de preços

tags
  • object

Marcas de recurso.

type
  • string

Tipo de recurso.