Megosztás a következőn keresztül:


Billing Subscriptions - List By Customer At Billing Account

Egy ügyfél előfizetéseit listázza a számlázási fiók szintjén. A művelet csak a Microsoft PartnerSzerződés típusú számlázási fiókok esetében támogatott.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/billingSubscriptions?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/billingSubscriptions?includeDeleted={includeDeleted}&api-version=2024-04-01&expand={expand}&filter={filter}&orderBy={orderBy}&top={top}&skip={skip}&count={count}&search={search}

URI-paraméterek

Name In Kötelező Típus Description
billingAccountName
path True

string

A számlázási fiókot egyedileg azonosító azonosító.

customerName
path True

string

Az ügyfél egyedi azonosítója.

api-version
query True

string

Az ügyfélkéréshez használni kívánt API verziója. A jelenlegi verzió: 2024-04-01.

count
query

boolean

A számláló lekérdezési lehetőség lehetővé teszi az ügyfelek számára, hogy a válaszban szereplő erőforrásokhoz tartozó egyező erőforrások számát kérvényezik.

expand
query

string

Reseller, ConsumptionCostCenter, LastMonthCharges és MonthToDateCharges kibontására használható

filter
query

string

A szűrő lekérdezési lehetőség lehetővé teszi, hogy az ügyfelek szűrjenek egy kérelem URL-címével kezelt erőforrások gyűjteményét.

includeDeleted
query

boolean

A törölt számlázási előfizetések lekérésére használható.

orderBy
query

string

Az orderby lekérdezési lehetőség lehetővé teszi, hogy az ügyfelek egy adott sorrendben igényeljenek erőforrásokat.

search
query

string

A keresési lekérdezési lehetőség lehetővé teszi, hogy az ügyfelek egy szabad szöveges keresési kifejezésnek megfelelő gyűjteményben lévő elemeket kérjenek le. a keresés csak sztringmezők esetén támogatott.

skip
query

integer (int64)

A kihagyó lekérdezési beállítás a lekérdezett gyűjtemény azon elemeinek számát kéri, amelyeket ki kell hagyni, és nem kell belefoglalni az eredménybe.

top
query

integer (int64)

A legfelső lekérdezési beállítás kéri, hogy a lekérdezett gyűjtemény elemeinek száma szerepeljen az eredményben. A felső érték maximális támogatott értéke 50.

Válaszok

Name Típus Description
200 OK

BillingSubscriptionListResult

A számlázási előfizetések listája.

Other Status Codes

ErrorResponse

Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Példák

BillingSubscriptionsListByCustomerAtBillingAccount

Mintakérelem

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/customers/Q7GV-UUVA-PJA-TGB/billingSubscriptions?api-version=2024-04-01

Mintaválasz

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/6b96d3f2-9008-4a9d-912f-f87744185aa3",
      "name": "6b96d3f2-9008-4a9d-912f-f87744185aa3",
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998",
        "billingProfileDisplayName": "BillingProfile1",
        "billingProfileName": "ea36e548-1505-41db-bebc-46fff3d37998",
        "customerId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998/customers/Q7GV-UUVA-PJA-TGB",
        "customerDisplayName": "Customer1",
        "displayName": "My Subscription",
        "reseller": {
          "resellerId": "89e87bdf-a2a2-4687-925f-4c18b27bccfd",
          "description": "Reseller1"
        },
        "skuId": "0002",
        "skuDescription": "Microsoft Azure Standard",
        "resourceUri": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/6b96d3f2-9008-4a9d-912f-f87744185aa3",
        "status": "Active",
        "subscriptionId": "6b96d3f2-9008-4a9d-912f-f87744185aa3"
      },
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/CD0BBD7A-461A-4D9A-9C59-EAE51A0D5D12",
      "name": "CD0BBD7A-461A-4D9A-9C59-EAE51A0D5D12",
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998",
        "billingProfileDisplayName": "BillingProfile1",
        "billingProfileName": "ea36e548-1505-41db-bebc-46fff3d37998",
        "customerId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/customers/Q7GV-UUVA-PJA-TGB",
        "customerDisplayName": "Customer1",
        "displayName": "Test Subscription",
        "reseller": {
          "resellerId": "3b65b5a8-bd4f-4084-90e9-e1bd667a2b19",
          "description": "Reseller3"
        },
        "skuId": "0002",
        "skuDescription": "Microsoft Azure Standard",
        "resourceUri": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/CD0BBD7A-461A-4D9A-9C59-EAE51A0D5D12",
        "status": "Active",
        "subscriptionId": "CD0BBD7A-461A-4D9A-9C59-EAE51A0D5D12"
      },
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/9e90f86b-22fc-42f3-bfe2-0ac3e7c01d32",
      "name": "9e90f86b-22fc-42f3-bfe2-0ac3e7c01d32",
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998",
        "billingProfileDisplayName": "BillingProfile1",
        "billingProfileName": "ea36e548-1505-41db-bebc-46fff3d37998",
        "customerId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/customers/Q7GV-UUVA-PJA-TGB",
        "customerDisplayName": "Customer1",
        "displayName": "Dev Test Subscription",
        "skuId": "0001",
        "skuDescription": "Domain Name Registration ORG",
        "resourceUri": "/providers/Microsoft.Domain/domainSubscriptions/9e90f86b-22fc-42f3-bfe2-0ac3e7c01d32",
        "status": "Active",
        "subscriptionId": "9e90f86b-22fc-42f3-bfe2-0ac3e7c01d32"
      },
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions"
    }
  ]
}

Definíciók

Name Description
Amount

Az összeg.

AutoRenew

Azt jelzi, hogy az automatikus megújítás be van-e kapcsolva vagy ki van-e kapcsolva egy termék esetében.

Beneficiary

A kedvezményezett adatai.

BillingSubscription

Az előfizetés számlázási tulajdonságai.

BillingSubscriptionListResult

Tároló az erőforrások listájához

BillingSubscriptionOperationStatus

Az előfizetésen lévő művelet állapota. Ha nincs, nincs folyamatban lévő művelet. A LockedForUpdate használatakor az írási műveletek le lesznek tiltva a számlázási előfizetésben. Más az alapértelmezett érték, és további részletekért tekintse meg a legújabb API-verziót.

BillingSubscriptionStatus

Az előfizetés állapota. Ez a mező nem érhető el Nagyvállalati Szerződés számlázási fiókjaihoz

BillingSubscriptionStatusDetails

Az előfizetés felfüggesztési részletei. Ez a mező nem érhető el a Nagyvállalati Szerződés számlázási fiókjaihoz.

Cancellation

Az előfizetés házirend-felülbírálása azt jelzi, hogy engedélyezett-e az önkiszolgáló lemondás vagy az ülések csökkentése.

createdByType

Az erőforrást létrehozó identitás típusa.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

NextBillingCycleDetails

A termék számlázási ciklusának részletei.

ProvisioningState

Az erőforrás kiépítési állapota egy hosszú ideig futó művelet során.

RenewalTermDetails

Az előfizetés következő megújítási időszakának részletei.

Reseller

A viszonteladó adatai.

SubscriptionEnrollmentAccountStatus

Az előfizetés aktuális regisztrációs fiókállapota. Ez a mező csak a Nagyvállalati Szerződés típusa esetén érhető el.

SubscriptionStatusReason

Az előfizetés felfüggesztési oka. Ez a mező nem érhető el a Nagyvállalati Szerződés számlázási fiókjaihoz.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

SystemOverrides

Rendszer által előírt szabályzatok, amelyek szabályozzák az előfizetés viselkedését.

Amount

Az összeg.

Name Típus Description
currency

string

Az összegérték pénzneme.

value

number

Az összeg értéke. Ha például a pénznem USD, akkor a 600$-os érték 600,00 usd lesz.

AutoRenew

Azt jelzi, hogy az automatikus megújítás be van-e kapcsolva vagy ki van-e kapcsolva egy termék esetében.

Érték Description
Off
On

Beneficiary

A kedvezményezett adatai.

Name Típus Description
objectId

string

Az azonosító, amely egyedileg azonosít egy felhasználót egy bérlőben.

tenantId

string

A bérlőt egyedileg azonosító azonosító.

BillingSubscription

Az előfizetés számlázási tulajdonságai.

Name Típus Description
id

string (arm-id)

Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Az erőforrás neve

properties.autoRenew

AutoRenew

Azt jelzi, hogy az automatikus megújítás be van-e kapcsolva vagy ki van-e kapcsolva egy termék esetében.

properties.beneficiary

Beneficiary

A számlázási előfizetés kedvezményezettje.

properties.beneficiaryTenantId

string

Az előfizetés kiépítési bérlője.

properties.billingFrequency

string

A számlázási gyakoriság ISO8601 termékformátumban az előfizetésben. Példa: P1M, P3M, P1Y

properties.billingPolicies

object

Az előfizetéshez társított számlázási szabályzatok szótára.

properties.billingProfileDisplayName

string

A számlázási profil neve.

properties.billingProfileId

string

A számlázási profilt egyedileg azonosító teljes körű azonosító.

properties.billingProfileName

string

A számlázási profilt egyedileg azonosító azonosító.

properties.consumptionCostCenter

string

Az előfizetésre alkalmazott költséghely. Ez a mező csak a Microsoft Ügyfélszerződés vagy Nagyvállalati Szerződés típusú számlázási fiókok használati előfizetéseihez érhető el.

properties.customerDisplayName

string

Az ügyfél neve.

properties.customerId

string

A teljes azonosító, amely egyedileg azonosítja az ügyfelet.

properties.customerName

string

Az ügyfél egyedi azonosítója.

properties.displayName

string

A számlázási előfizetés neve.

properties.enrollmentAccountDisplayName

string

Az előfizetéshez társított regisztrációs fiók neve. Ez a mező csak a Nagyvállalati Szerződés típusú számlázási fiókokhoz érhető el.

properties.enrollmentAccountId

string

Az előfizetéshez társított regisztrációs fiók azonosítója. Ez a mező csak a Nagyvállalati Szerződés típusú számlázási fiókokhoz érhető el.

properties.enrollmentAccountSubscriptionDetails.enrollmentAccountStartDate

string (date-time)

A regisztrációs fiók és az előfizetés-társítás kezdő dátuma. Ez a mező csak a Nagyvállalati Szerződés típusa esetén érhető el.

properties.enrollmentAccountSubscriptionDetails.subscriptionEnrollmentAccountStatus

SubscriptionEnrollmentAccountStatus

Az előfizetés aktuális regisztrációs fiókállapota. Ez a mező csak a Nagyvállalati Szerződés típusa esetén érhető el.

properties.invoiceSectionDisplayName

string

A számlaszakasz neve.

properties.invoiceSectionId

string

A számlaszakaszt egyedileg azonosító teljes azonosító.

properties.invoiceSectionName

string

A számlaszakaszt egyedileg azonosító azonosító.

properties.lastMonthCharges

Amount

Az elmúlt hónap díjai. Ez a mező csak a Microsoft Ügyfélszerződés számlázási fiókok használatalapú előfizetéseihez érhető el.

properties.monthToDateCharges

Amount

Az aktuális havi díjak. Ez a mező csak a Microsoft Ügyfélszerződés számlázási fiókok használatalapú előfizetéseihez érhető el.

properties.nextBillingCycleDetails

NextBillingCycleDetails

Az előfizetés következő számlázási ciklusának részletei.

properties.offerId

string

Az előfizetés ajánlatazonosítója. Ez a mező csak a Microsoft Online Services Program nagyvállalati szerződés típusú számlázási fiókjaihoz vagy számlázási fiókjaihoz érhető el.

properties.operationStatus

BillingSubscriptionOperationStatus

Az előfizetésen lévő művelet állapota. Ha nincs, nincs folyamatban lévő művelet. A LockedForUpdate használatakor az írási műveletek le lesznek tiltva a számlázási előfizetésben. Más az alapértelmezett érték, és további részletekért tekintse meg a legújabb API-verziót.

properties.productCategory

string

Annak a terméknek a kategóriája, amelyhez az előfizetést megvásárolják. Lehetséges értékek: AzureSupport, Hardver, ReservationOrder, SaaS, SavingsPlanOrder, Szoftver, UsageBased, Egyéb.

properties.productType

string

Annak a terméknek a típusa, amelyhez az előfizetést megvásárolják.

properties.productTypeId

string

Annak a terméknek az azonosítója, amelyhez az előfizetést megvásárolták.

properties.provisioningState

ProvisioningState

Az erőforrás kiépítési állapota egy hosszú ideig futó művelet során.

properties.provisioningTenantId

string

Az a bérlő, amelyben az előfizetés ki van építve.

properties.purchaseDate

string (date-time)

A termék vásárlásának dátuma UTC-időpontban.

properties.quantity

integer (int64)

Az előfizetés licenceinek vagy teljesítési egységeinek mennyisége.

properties.renewalTermDetails

RenewalTermDetails

Az előfizetés következő megújítási időszakának részletei.

properties.reseller

Reseller

Az előfizetés viszonteladója. A mezők nem érhetők el a Microsoft Partnerszerződés számlázási fiókjaihoz.

properties.resourceUri

string

A csatolt erőforrás egyedi azonosítója.

properties.skuDescription

string

Annak a terméknek a termékváltozata, amelyhez az előfizetést megvásárolják. Ez a mező csak a Microsoft Ügyfélszerződés és a Microsoft Partnerszerződés típusú számlázási fiókokhoz érhető el.

properties.skuId

string

Annak a terméknek az termékváltozat-azonosítója, amelyhez az előfizetést megvásárolják. Ez a mező csak a Microsoft Ügyfélszerződés számlázási fiókjaihoz érhető el.

properties.status

BillingSubscriptionStatus

Az előfizetés állapota. Ez a mező nem érhető el Nagyvállalati Szerződés számlázási fiókjaihoz

properties.subscriptionId

string

Az előfizetés azonosítója.

properties.suspensionReasonDetails

BillingSubscriptionStatusDetails[]

Az előfizetés felfüggesztési részletei. Ez a mező nem érhető el a Nagyvállalati Szerződés számlázási fiókjaihoz.

properties.suspensionReasons

string[]

Az előfizetés felfüggesztési oka. Ez a mező nem érhető el a Nagyvállalati Szerződés számlázási fiókjaihoz.

properties.systemOverrides

SystemOverrides

Rendszer által előírt szabályzatok, amelyek szabályozzák az előfizetés viselkedését.

properties.termDuration

string

Az időtartam ISO8601 formátumban, amelyhez használhatja az előfizetést. Példa: P1M, P3M, P1Y

properties.termEndDate

string (date-time)

A kifejezés záró dátuma UTC-időpontban.

properties.termStartDate

string (date-time)

A kifejezés kezdő dátuma UTC-időpontban.

systemData

systemData

A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.

tags

object

Az erőforráshoz társított metaadatok szótára. Lehet, hogy nem minden erőforrástípushoz van feltöltve. Legfeljebb 256 karakter hosszúságú kulcs/érték. A kulcsok/értékek nem üresek és nem lehet nullak. A kulcsok nem tartalmazhatnak <> % & \ ? /

type

string

Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

BillingSubscriptionListResult

Tároló az erőforrások listájához

Name Típus Description
nextLink

string

Az eredmények következő oldalára mutató hivatkozás (URL- cím).

totalCount

number (int32)

Rekordok teljes száma.

value

BillingSubscription[]

Az erőforrások listája.

BillingSubscriptionOperationStatus

Az előfizetésen lévő művelet állapota. Ha nincs, nincs folyamatban lévő művelet. A LockedForUpdate használatakor az írási műveletek le lesznek tiltva a számlázási előfizetésben. Más az alapértelmezett érték, és további részletekért tekintse meg a legújabb API-verziót.

Érték Description
LockedForUpdate
None
Other

BillingSubscriptionStatus

Az előfizetés állapota. Ez a mező nem érhető el Nagyvállalati Szerződés számlázási fiókjaihoz

Érték Description
Active
AutoRenew
Cancelled
Deleted
Disabled
Expired
Expiring
Failed
Other
Suspended
Unknown
Warned

BillingSubscriptionStatusDetails

Az előfizetés felfüggesztési részletei. Ez a mező nem érhető el a Nagyvállalati Szerződés számlázási fiókjaihoz.

Name Típus Description
effectiveDate

string (date-time)

Az előfizetés felfüggesztési hatálybalépési dátuma. Ez a mező nem érhető el a Nagyvállalati Szerződés számlázási fiókjaihoz.

reason

SubscriptionStatusReason

Az előfizetés felfüggesztési oka. Ez a mező nem érhető el a Nagyvállalati Szerződés számlázási fiókjaihoz.

Cancellation

Az előfizetés házirend-felülbírálása azt jelzi, hogy engedélyezett-e az önkiszolgáló lemondás vagy az ülések csökkentése.

Érték Description
Allowed
NotAllowed

createdByType

Az erőforrást létrehozó identitás típusa.

Érték Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

NextBillingCycleDetails

A termék számlázási ciklusának részletei.

Name Típus Description
billingFrequency

string

A termék számlázási gyakorisága az előfizetés alatt.

ProvisioningState

Az erőforrás kiépítési állapota egy hosszú ideig futó művelet során.

Érték Description
Canceled
Failed
New
Pending
Provisioning
Succeeded

RenewalTermDetails

Az előfizetés következő megújítási időszakának részletei.

Name Típus Description
billingFrequency

string

A számlázási gyakoriság ISO8601 termékformátumban az előfizetésben. Példa: P1M, P3M, P1Y

productId

string

Annak a terméknek az azonosítója, amelyhez az előfizetést megvásárolták.

productTypeId

string

Annak a terméknek a típusazonosítója, amelyhez az előfizetést megvásárolták.

quantity

integer (int64)

Az előfizetés licenceinek vagy teljesítési egységeinek mennyisége.

skuId

string

Annak a terméknek az termékváltozat-azonosítója, amelyhez az előfizetést megvásárolják. Ez a mező csak a Microsoft Ügyfélszerződés számlázási fiókjaihoz érhető el.

termDuration

string

Az időtartam ISO8601 formátumban, amelyhez használhatja az előfizetést. Példa: P1M, P3M, P1Y

termEndDate

string (date-time)

A kifejezés záró dátuma UTC-időpontban.

Reseller

A viszonteladó adatai.

Name Típus Description
description

string

A viszonteladó neve.

resellerId

string

A viszonteladó MPN-azonosítója.

SubscriptionEnrollmentAccountStatus

Az előfizetés aktuális regisztrációs fiókállapota. Ez a mező csak a Nagyvállalati Szerződés típusa esetén érhető el.

Érték Description
Active
Cancelled
Deleted
Expired
Inactive
TransferredOut
Transferring

SubscriptionStatusReason

Az előfizetés felfüggesztési oka. Ez a mező nem érhető el a Nagyvállalati Szerződés számlázási fiókjaihoz.

Érték Description
Cancelled
Expired
None
Other
PastDue
PolicyViolation
SpendingLimitReached
SuspiciousActivity
Transferred

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string (date-time)

Az erőforrás-létrehozás időbélyege (UTC).

createdBy

string

Az erőforrást létrehozó identitás.

createdByType

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt

string (date-time)

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy

string

Az erőforrást legutóbb módosító identitás.

lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.

SystemOverrides

Rendszer által előírt szabályzatok, amelyek szabályozzák az előfizetés viselkedését.

Name Típus Description
cancellation

Cancellation

Az előfizetés házirend-felülbírálása azt jelzi, hogy engedélyezett-e az önkiszolgáló lemondás vagy az ülések csökkentése.

cancellationAllowedEndDate

string (date-time)

Az önkiszolgáló lemondás befejezésének időpontja (UTC) szerinti befejezési dátum.