Marketplaces By Billing Account - List
A hatókörök piactereit a billingAccountId és az aktuális számlázási időszak szerint sorolja fel. A piacterek csak 2014. május 1-jei vagy újabb api-val érhetők el.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/marketplaces?api-version=2018-03-31
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/marketplaces?$filter={$filter}&$top={$top}&$skiptoken={$skiptoken}&api-version=2018-03-31
URI-paraméterek
| Name | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
billing
|
path | True |
string |
BillingAccount azonosítója |
|
api-version
|
query | True |
string |
Az ügyfélkéréshez használandó API verziója. A jelenlegi verzió: 2018-03-31. |
|
$filter
|
query |
string |
A piacterek szűrésére használható tulajdonságok/usageEnd (Utc idő), properties/usageStart (Utc idő), properties/resourceGroup, properties/instanceName vagy properties/instanceId szerint. A szűrő támogatja az "eq", az "lt", a "gt", a "le", a "ge" és az "and" elemet. Jelenleg nem támogatja a "ne", "vagy" vagy "nem" elemet. |
|
|
$skiptoken
|
query |
string |
A Skiptoken csak akkor használatos, ha egy korábbi művelet részleges eredményt adott vissza. Ha egy előző válasz tartalmaz nextLink elemet, a nextLink elem értéke tartalmaz egy skiptoken paramétert, amely megadja a kezdőpontot, amelyet a későbbi hívásokhoz használhat. |
|
|
$top
|
query |
integer minimum: 1maximum: 1000 |
Az eredmények számát a legutóbbi N piacterekre korlátozhatja. |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
OKÉ. A kérés sikeres volt. |
|
| Other Status Codes |
Hibaválasz, amely leírja, hogy miért nem sikerült a művelet. |
Biztonság
azure_auth
Azure Active Directory Oauth2-folyamat.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
| Name | Description |
|---|---|
| user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
MarketplacesList
Mintakérelem
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/marketplaces?api-version=2018-03-31
Mintaválasz
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/marketplaces/marketplaceId1",
"name": "marketplaceId1",
"type": "Microsoft.Consumption/marketPlaces",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
"billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Billing/billingPeriods/201702",
"usageStart": "2017-02-13T00:00:00Z",
"usageEnd": "2017-02-13T23:59:59Z",
"instanceName": "shared1",
"instanceId": "/subscriptions/subid/resourceGroups/Default-Web-eastasia/providers/Microsoft.Web/sites/shared1",
"currency": "USD",
"consumedQuantity": 0.00328,
"pretaxCost": 0.67,
"isEstimated": false,
"offerName": "offer1",
"resourceGroup": "TEST",
"orderNumber": "00000000-0000-0000-0000-000000000000",
"publisherName": "xyz",
"planName": "plan1",
"resourceRate": 0.24,
"subscriptionGuid": "00000000-0000-0000-0000-000000000000",
"subscriptionName": "azure subscription"
}
}
]
}
Definíciók
| Name | Description |
|---|---|
|
Error |
A hiba részletei. |
|
Error |
A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg. |
| Marketplace |
Piactéri erőforrás. |
|
Marketplaces |
Piacterek listázásának eredménye. Az elérhető piacterek listáját tartalmazza fordított időrendi sorrendben a számlázási időszak szerint. |
ErrorDetails
A hiba részletei.
| Name | Típus | Description |
|---|---|---|
| code |
string |
Hibakód. |
| message |
string |
A művelet sikertelen voltát jelző hibaüzenet. |
ErrorResponse
A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.
| Name | Típus | Description |
|---|---|---|
| error |
A hiba részletei. |
Marketplace
Piactéri erőforrás.
| Name | Típus | Description |
|---|---|---|
| id |
string |
Erőforrás-azonosító. |
| name |
string |
Erőforrás neve. |
| properties.accountName |
string |
Fióknév. |
| properties.additionalProperties |
string |
A használati elem további részletei. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva. |
| properties.billingPeriodId |
string |
Annak a számlázási időszak-erőforrásnak az azonosítója, amelyhez a használat tartozik. |
| properties.consumedQuantity |
number (decimal) |
A használat mennyisége. |
| properties.consumedService |
string |
Felhasznált szolgáltatásnév. |
| properties.costCenter |
string |
A részleg költségközpontja, ha részlegről van szó, és létezik költségközpont |
| properties.currency |
string |
Az ISO pénznem, amelyben a fogyasztásmérőt felszámítják, például USD. |
| properties.departmentName |
string |
Részleg neve. |
| properties.instanceId |
string |
Annak az erőforráspéldánynak az URI-ja, amelyről a használat szól. |
| properties.instanceName |
string |
Annak az erőforráspéldánynak a neve, amelyről a használat szól. |
| properties.isEstimated |
boolean |
A becsült használat változhat. |
| properties.meterId |
string (uuid) |
A fogyasztásmérő azonosítója (GUID). |
| properties.offerName |
string |
Az ajánlat típusa. |
| properties.orderNumber |
string |
A rendelés száma. |
| properties.planName |
string |
A terv neve. |
| properties.pretaxCost |
number (decimal) |
Az adó előtti költség összege. |
| properties.publisherName |
string |
A közzétevő neve. |
| properties.resourceGroup |
string |
Az erőforráscsoport neve. |
| properties.resourceRate |
number (decimal) |
A Piactér erőforrás-díjszabása. |
| properties.subscriptionGuid |
string (uuid) |
Előfizetés guid azonosítója. |
| properties.subscriptionName |
string |
Előfizetés neve. |
| properties.unitOfMeasure |
string |
A mértékegység. |
| properties.usageEnd |
string (date-time) |
A használati adatok által lefedett dátum-időtartomány vége. |
| properties.usageStart |
string (date-time) |
A használati adatok által lefedett dátum-időtartomány kezdete. |
| tags |
object |
Erőforráscímkék. |
| type |
string |
Erőforrás típusa. |
MarketplacesListResult
Piacterek listázásának eredménye. Az elérhető piacterek listáját tartalmazza fordított időrendi sorrendben a számlázási időszak szerint.
| Name | Típus | Description |
|---|---|---|
| nextLink |
string |
Az eredmények következő oldalára mutató hivatkozás (URL- cím). |
| value |
A piacterek listája. |