Lots - List

會依 billingAccountId 和 billingProfileId 列出大量。

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/lots?api-version=2019-10-01

URI 參數

Name In Required Type Description
scope
path True
  • string

與大量作業相關聯的範圍。 這包括適用于帳單設定檔範圍的「/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfile/{billingProfileId}」,以及合作夥伴專屬的「提供者/Microsoft. 帳單/billingAccounts/{billingAccountId}/customers/{customerId}」。

api-version
query True
  • string

要搭配用戶端要求使用的 API 版本。 目前的版本為2019-10-01。

回應

Name Type Description
200 OK

正常。 要求成功。

Other Status Codes

描述作業為何失敗的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 流程。

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

Scopes

Name Description
user_impersonation 模擬您的使用者帳戶

範例

LotsList-Modern
LotsListByBillingProfile

LotsList-Modern

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:5678/customers/2468/providers/Microsoft.Consumption/lots?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:5678/billingProficustomersles/2468/providers/Microsoft.Consumption/lots/lot1",
      "name": "lot1",
      "type": "Microsoft.Consumption/lots",
      "properties": {
        "originalAmount": {
          "currency": "USD",
          "value": 5000
        },
        "originalAmountInBillingCurrency": {
          "exchangeRate": 73.422500000000269,
          "exchangeRateMonth": 202101,
          "currency": "",
          "value": 7342.2500000000264
        },
        "closedBalance": {
          "currency": "USD",
          "value": 60.9
        },
        "closedBalanceInBillingCurrency": {
          "exchangeRate": 73.422500000000269,
          "exchangeRateMonth": 202101,
          "currency": "",
          "value": 7342.2500000000264
        },
        "source": "PurchasedCredit",
        "startDate": "2019-10-01T00:00:00Z",
        "expirationDate": "2019-11-01T00:00:00Z",
        "poNumber": "3524"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:5678/billingProfiles/2468/providers/Microsoft.Consumption/lots/lot2",
      "name": "lot2",
      "type": "Microsoft.Consumption/lots",
      "properties": {
        "originalAmount": {
          "currency": "USD",
          "value": 6000
        },
        "originalAmountInBillingCurrency": {
          "exchangeRate": 73.422500000000269,
          "exchangeRateMonth": 202101,
          "currency": "",
          "value": 7342.2500000000264
        },
        "closedBalance": {
          "currency": "USD",
          "value": 80.9
        },
        "closedBalanceInBillingCurrency": {
          "exchangeRate": 73.422500000000269,
          "exchangeRateMonth": 202101,
          "currency": "",
          "value": 7342.2500000000264
        },
        "source": "PurchasedCredit",
        "startDate": "2019-11-01T00:00:00Z",
        "expirationDate": "2019-12-31T00:00:00Z",
        "poNumber": "31224"
      }
    }
  ]
}

LotsListByBillingProfile

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:5678/billingProfiles/2468/providers/Microsoft.Consumption/lots?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:5678/billingProfiles/2468/providers/Microsoft.Consumption/lots/lot1",
      "name": "lot1",
      "type": "Microsoft.Consumption/lots",
      "properties": {
        "originalAmount": {
          "currency": "USD",
          "value": 5000
        },
        "closedBalance": {
          "currency": "USD",
          "value": 60.9
        },
        "source": "PurchasedCredit",
        "startDate": "2019-10-01T00:00:00Z",
        "expirationDate": "2019-11-01T00:00:00Z",
        "poNumber": "3524"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:5678/billingProfiles/2468/providers/Microsoft.Consumption/lots/lot2",
      "name": "lot2",
      "type": "Microsoft.Consumption/lots",
      "properties": {
        "originalAmount": {
          "currency": "USD",
          "value": 6000
        },
        "closedBalance": {
          "currency": "USD",
          "value": 80.9
        },
        "source": "PurchasedCredit",
        "startDate": "2019-11-01T00:00:00Z",
        "expirationDate": "2019-12-31T00:00:00Z",
        "poNumber": "31224"
      }
    }
  ]
}

定義

amount

數量加上貨幣。

AmountWithExchangeRate

轉售商詳細資料

ErrorDetails

錯誤的詳細資料。

ErrorResponse

錯誤回應表示服務無法處理傳入的要求。 錯誤訊息中提供了原因。

某些錯誤回應:

  • 429 TooManyRequests-要求已節流處理。 請在等候 "x-ratelimit-microsoft.--retry" 標頭中指定的時間後重試。

  • 503 ServiceUnavailable-服務暫時無法使用。 請在等候 "Retry" 標頭中指定的時間之後重試。

Lots

列出大量摘要的結果。

LotSource

很多來源。

LotSummary

大量摘要資源。

Reseller

轉售商詳細資料

amount

數量加上貨幣。

Name Type Description
currency
  • string

金額貨幣。

value
  • number

量。

AmountWithExchangeRate

轉售商詳細資料

Name Type Description
currency
  • string

金額貨幣。

exchangeRate
  • number

匯率。

exchangeRateMonth
  • number

Exchange 費率月份。

value
  • number

量。

ErrorDetails

錯誤的詳細資料。

Name Type Description
code
  • string

錯誤碼。

message
  • string

指出作業失敗原因的錯誤訊息。

ErrorResponse

錯誤回應表示服務無法處理傳入的要求。 錯誤訊息中提供了原因。

某些錯誤回應:

  • 429 TooManyRequests-要求已節流處理。 請在等候 "x-ratelimit-microsoft.--retry" 標頭中指定的時間後重試。

  • 503 ServiceUnavailable-服務暫時無法使用。 請在等候 "Retry" 標頭中指定的時間之後重試。

Name Type Description
error

錯誤的詳細資料。

Lots

列出大量摘要的結果。

Name Type Description
nextLink
  • string

連結 (url) 至下一個結果頁面。

value

大量摘要的清單。

LotSource

很多來源。

Name Type Description
PromotionalCredit
  • string
PurchasedCredit
  • string

LotSummary

大量摘要資源。

Name Type Description
etag
  • string

資源 etag。

id
  • string

資源識別碼。

name
  • string

資源名稱。

properties.billingCurrency
  • string

帳單貨幣。

properties.closedBalance

關閉餘額。

properties.closedBalanceInBillingCurrency

目前的餘額。

properties.creditCurrency
  • string

點數貨幣

properties.expirationDate
  • string

有效期。

properties.originalAmount

原始數量。

properties.originalAmountInBillingCurrency

目前的餘額。

properties.poNumber
  • string

PO 編號。

properties.reseller

轉售商詳細資料。

properties.source

很多來源。

properties.startDate
  • string

開始日期。

tags
  • object

資源標籤。

type
  • string

資源類型。

Reseller

轉售商詳細資料

Name Type Description
resellerDescription
  • string

轉銷商描述。

resellerId
  • string

轉售商識別碼。