Aracılığıyla paylaş


Billing Accounts - List

Kullanıcının erişimi olan ödeme hesaplarını listeler.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?includeAll={includeAll}&includeAllWithoutBillingProfiles={includeAllWithoutBillingProfiles}&includeDeleted={includeDeleted}&includePendingAgreement={includePendingAgreement}&includeResellee={includeResellee}&legalOwnerTID={legalOwnerTID}&legalOwnerOID={legalOwnerOID}&api-version=2024-04-01&filter={filter}&expand={expand}&top={top}&skip={skip}&search={search}

URI Parametreleri

Name İçinde Gerekli Tür Description
api-version
query True

string

İstemci isteğiyle kullanılacak API sürümü. Geçerli sürüm 2024-04-01'dir.

expand
query

string

SoldTo ve EnrollmentDetails/PONumber için genişletmeye izin verilir.

filter
query

string

Sorguyu filtrele seçeneği, istemcilerin istek URL'si tarafından ele alınan bir kaynak koleksiyonunu filtrelemesine olanak tanır.

includeAll
query

boolean

Doğru olduğunda, sonuçlar kullanıcının şu AAD rollerinden birine sahipse kullanıcının doğrudan rol ataması olmayan Faturalama Hesaplarını içerir: Genel Yönetici, Genel Okuyucu, Faturalama Yöneticisi.

includeAllWithoutBillingProfiles
query

boolean

Doğru olduğunda sonuçlar, kullanıcının şu AAD rollerinden birine sahip olması durumunda tam olarak oluşturulmayan Faturalama Hesaplarını içerir: Genel Yönetici, Genel Okuyucu, Faturalama Yöneticisi.

includeDeleted
query

boolean

Doğru olduğunda, sonuçlar silinmiş durumdaki tüm ödeme hesaplarını içerir.

includePendingAgreement
query

boolean

Kullanıcının erişimi olan sözleşme bekleyen imzaya sahip ödeme hesaplarını içerir.

includeResellee
query

boolean

Kullanıcının erişimi olan Microsoft İş Ortağı Sözleşmesi'nin müşterinin ödeme hesabını içerir.

legalOwnerOID
query

string

legalOwnerTID ile birleştirilmelidir, sonuçlar yalnızca Faturalama Hesaplarından yasal olarak sorumlu olan Faturalama Hesaplarını içerir. Opsiyonel.

legalOwnerTID
query

string

legalOwnerOID ile birleştirilmelidir, sonuçlar yalnızca Faturalama Hesaplarından yasal olarak sorumlu olan Faturalama Hesaplarını içerir. Opsiyonel.

search
query

string

Arama sorgusu seçeneği, istemcilerin serbest metin arama ifadesiyle eşleşen bir koleksiyon içindeki öğeleri istemesine olanak tanır. arama yalnızca dize alanları için desteklenir.

skip
query

integer

int64

Sorgu atla seçeneği sorgulanan koleksiyonda atlanacak ve sonube dahil edilmeyecek öğe sayısını istemektedir.

top
query

integer

int64

En üstteki sorgu seçeneği sorgulanan koleksiyondaki öğelerin sayısının sonube eklenmesini istemektedir. En üst için desteklenen en yüksek değer 50'dir.

Yanıtlar

Name Tür Description
200 OK

BillingAccountListResult

Ödeme hesaplarının listesi.

Other Status Codes

ErrorResponse

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Örnekler

BillingAccountForLegacyAccountDetails
BillingAccountsList
BillingAccountsListWithExpandForPONumber

BillingAccountForLegacyAccountDetails

Örnek isteği

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01

Örnek yanıt

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/20000000-0000-0000-0000-000000000001",
      "name": "20000000-0000-0000-0000-000000000001",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Individual",
        "agreementType": "MicrosoftOnlineServicesProgram",
        "displayName": "Individual Account 2",
        "hasReadAccess": true,
        "notificationEmailAddress": "individual@domain.com"
      },
      "type": "Microsoft.Billing/billingAccounts"
    }
  ]
}

BillingAccountsList

Örnek isteği

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01

Örnek yanıt

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "name": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Business",
        "accountSubType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Premier Business Account",
        "hasReadAccess": true,
        "primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/20000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "name": "20000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Business",
        "accountSubType": "Professional",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Standard Business Account",
        "hasReadAccess": true,
        "primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/30000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "name": "30000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Individual",
        "accountSubType": "Individual",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Individual Account",
        "hasReadAccess": true,
        "primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/40000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "name": "40000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Business",
        "accountSubType": "Enterprise",
        "agreementType": "MicrosoftPartnerAgreement",
        "displayName": "Premier Business Account",
        "hasReadAccess": true,
        "primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    }
  ]
}

BillingAccountsListWithExpandForPONumber

Örnek isteği

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01&expand=soldTo,enrollmentDetails/poNumber

Örnek yanıt

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/6564892",
      "name": "6564892",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "accountSubType": "None",
        "agreementType": "EnterpriseAgreement",
        "displayName": "Enterprise Account",
        "enrollmentDetails": {
          "startDate": "2018-05-01T17:32:28Z",
          "endDate": "2019-05-31T17:32:28Z",
          "currency": "USD",
          "channel": "EaDirect",
          "language": "en",
          "countryCode": "US",
          "billingCycle": "Monthly",
          "extendedTermOption": "Opted-Out",
          "supportLevel": "Standard",
          "supportCoverage": "1/26/2021 - 6/30/2021",
          "cloud": "Azure Commercial",
          "poNumber": "poNumber123"
        },
        "hasReadAccess": true,
        "soldTo": {
          "addressLine1": "Test Address",
          "city": "City",
          "companyName": "Enterprise Company",
          "country": "US",
          "postalCode": "00000-1111",
          "region": "WA"
        }
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    }
  ]
}

Tanımlar

Name Description
AccountStatus

Ödeme hesabının geçerli durumu.

AccountSubType

Hesabın katmanı.

AccountType

Müşterinin türü.

AgreementType

Sözleşme türü.

BillingAccount

Ödeme hesabı.

BillingAccountListResult

Kaynak listesi için kapsayıcı

BillingAccountProperties

Ödeme hesabı.

BillingAccountStatusReasonCode

Belirtilen ödeme hesabı durumunun nedeni.

BillingRelationshipType

Bir ödeme hesabıyla temsil edilen faturalama ilişkilerini tanımlar. Faturalama ilişkisi Microsoft, müşteri ve/veya üçüncü taraf arasında olabilir.

createdByType

Kaynağı oluşturan kimliğin türü.

EnrollmentDetails

Kaydın özellikleri.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

ExtendedTermOption

Şirket tarafından tercih edilen ödeme hesabı uzantısı.

IndirectRelationshipInfo

Dolaylı satın alma hareketinde başka bir faturalama profiline bağlı faturalama profilini tanımlar.

MarkupStatus

Kaydın işaretleme durumu; yalnızca dolaylı kayıtlar için geçerlidir.

ProvisioningState

Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu.

RegistrationNumber

Ödeme hesabıyla bağlantılı kuruluşun kayıt numarasını açıklar.

SoldTo

Ödeme hesabından sorumlu olan kişinin veya kuruluşun adresi.

SupportLevel

Bir kayıtla ilişkili destek düzeyi teklifi.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

TaxIdentifier

Ödeme hesabının vergi tanımlayıcısı.

TaxIdentifierStatus

Vergi tanımlayıcısının durumu.

TaxIdentifierType

Vergi tanımlayıcısının türü.

AccountStatus

Ödeme hesabının geçerli durumu.

Name Tür Description
Active

string

Deleted

string

Disabled

string

Expired

string

Extended

string

New

string

Other

string

Pending

string

Terminated

string

Transferred

string

UnderReview

string

AccountSubType

Hesabın katmanı.

Name Tür Description
Enterprise

string

Individual

string

None

string

Other

string

Professional

string

AccountType

Müşterinin türü.

Name Tür Description
Business

string

ClassicPartner

string

Enterprise

string

Individual

string

Internal

string

Other

string

Partner

string

Reseller

string

Tenant

string

AgreementType

Sözleşme türü.

Name Tür Description
EnterpriseAgreement

string

MicrosoftCustomerAgreement

string

MicrosoftOnlineServicesProgram

string

MicrosoftPartnerAgreement

string

Other

string

BillingAccount

Ödeme hesabı.

Name Tür Description
id

string

Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Kaynağın adı

properties

BillingAccountProperties

Ödeme hesabı.

systemData

systemData

createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.

tags

object

Kaynakla ilişkilendirilmiş meta verilerin sözlüğü. Tüm kaynak türleri için doldurulmayabilir. Desteklenen en fazla anahtar/değer uzunluğu 256 karakterdir. Anahtarlar/değer boş değer veya null olmamalıdır. Anahtarlar <> % & \ ? içeremez /

type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

BillingAccountListResult

Kaynak listesi için kapsayıcı

Name Tür Description
nextLink

string

Sonuçların sonraki sayfasına bağlantı (URL).

value

BillingAccount[]

Kaynak listesi.

BillingAccountProperties

Ödeme hesabı.

Name Tür Description
accountStatus

AccountStatus

Ödeme hesabının geçerli durumu.

accountStatusReasonCode

BillingAccountStatusReasonCode

Belirtilen ödeme hesabı durumunun nedeni.

accountSubType

AccountSubType

Hesabın katmanı.

accountType

AccountType

Müşterinin türü.

agreementType

AgreementType

Sözleşme türü.

billingRelationshipTypes

BillingRelationshipType[]

Bir ödeme hesabıyla temsil edilen faturalama ilişkilerini tanımlar. Faturalama ilişkisi Microsoft, müşteri ve/veya üçüncü taraf arasında olabilir.

displayName

string

Ödeme hesabı adı.

enrollmentDetails

EnrollmentDetails

Kaydın özellikleri.

hasNoBillingProfiles

boolean

Ödeme hesabının herhangi bir faturalama profili olup olmadığını gösterir.

hasReadAccess

boolean

Kullanıcının ödeme hesabına okuma erişimi olup olmadığını gösterir.

notificationEmailAddress

string

Eski hesap için bildirim e-posta adresi. Microsoft Online Services Programı sözleşme türü için kullanılabilir.

primaryBillingTenantId

string

Ödeme hesabını ayarlamak için kullanılan kiracı. Varsayılan olarak, yalnızca bu kiracıdaki kullanıcılar ödeme hesabında rol atamaları alabilir ve tüm satın almalar bu kiracıda sağlanır.

provisioningState

ProvisioningState

Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu.

qualifications

string[]

Bir ödeme hesabında fiyatlandırma için nitelikler. Değerler Ticari, Eğitim, Hayır Kurumu veya Kamu olabilir.

registrationNumber

RegistrationNumber

Ödeme hesabıyla bağlantılı kuruluşun kayıt numarasını açıklar.

soldTo

SoldTo

Ödeme hesabından sorumlu olan kişinin veya kuruluşun adresi.

taxIds

TaxIdentifier[]

Ödeme hesabı için vergi tanımlayıcılarının listesi.

BillingAccountStatusReasonCode

Belirtilen ödeme hesabı durumunun nedeni.

Name Tür Description
Expired

string

ManuallyTerminated

string

Other

string

TerminateProcessing

string

Transferred

string

UnusualActivity

string

BillingRelationshipType

Bir ödeme hesabıyla temsil edilen faturalama ilişkilerini tanımlar. Faturalama ilişkisi Microsoft, müşteri ve/veya üçüncü taraf arasında olabilir.

Name Tür Description
CSPCustomer

string

CSPPartner

string

Direct

string

IndirectCustomer

string

IndirectPartner

string

Other

string

createdByType

Kaynağı oluşturan kimliğin türü.

Name Tür Description
Application

string

Key

string

ManagedIdentity

string

User

string

EnrollmentDetails

Kaydın özellikleri.

Name Tür Description
billingCycle

string

Kaydın faturalama döngüsü.

channel

string

Kaydın kanal türü.

cloud

string

Kaydın bulutu.

countryCode

string

Kaydın ülke kodu.

currency

string

Kaydın faturalama para birimi.

endDate

string

Kaydın bitiş tarihi.

extendedTermOption

ExtendedTermOption

Şirket tarafından tercih edilen ödeme hesabı uzantısı.

indirectRelationshipInfo

IndirectRelationshipInfo

Bir kaydın yalnızca dolaylı kayıtlar için geçerli olan özellikleri.

invoiceRecipient

string

Kaydın faturalarını alan kişi.

language

string

Kaydın dili.

markupStatus

MarkupStatus

Kaydın işaretleme durumu; yalnızca dolaylı kayıtlar için geçerlidir.

poNumber

string

Kaydın satın alma siparişi numarası.

startDate

string

Kaydın başlangıç tarihi.

supportCoverage

string

Kaydın destek kapsamı dönemi.

supportLevel

SupportLevel

Bir kayıtla ilişkili destek düzeyi teklifi.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

ExtendedTermOption

Şirket tarafından tercih edilen ödeme hesabı uzantısı.

Name Tür Description
Opted-In

string

Opted-Out

string

Other

string

IndirectRelationshipInfo

Dolaylı satın alma hareketinde başka bir faturalama profiline bağlı faturalama profilini tanımlar.

Name Tür Description
billingAccountName

string

Dolaylı hareket için iş ortağının veya müşterinin ödeme hesabı adı.

billingProfileName

string

Dolaylı hareket için iş ortağının veya müşterinin faturalama profili adı.

displayName

string

Dolaylı hareket için iş ortağının veya müşterinin görünen adı.

MarkupStatus

Kaydın işaretleme durumu; yalnızca dolaylı kayıtlar için geçerlidir.

Name Tür Description
Disabled

string

Locked

string

Other

string

Preview

string

Published

string

ProvisioningState

Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu.

Name Tür Description
Canceled

string

Failed

string

New

string

Pending

string

Provisioning

string

Succeeded

string

RegistrationNumber

Ödeme hesabıyla bağlantılı kuruluşun kayıt numarasını açıklar.

Name Tür Description
id

string

Ödeme hesabıyla bağlantılı kuruluşun benzersiz kimlik numarası.

required

boolean

Ödeme hesabı için kayıt numarasının gerekli olup olmadığını tanımlar.

type

string[]

Ödeme hesabının ülkesine göre izin verilen kayıt numarası türleri.

SoldTo

Ödeme hesabından sorumlu olan kişinin veya kuruluşun adresi.

Name Tür Description
addressLine1

string

Adres satırı 1.

addressLine2

string

Adres satırı 2.

addressLine3

string

Adres satırı 3.

city

string

Adres şehri.

companyName

string

Şirket adı. MCA Bireysel için isteğe bağlı (Kullandıkça öde).

country

string

Ülke kodu ISO 3166-1 Alfa-2 biçimini kullanır.

district

string

Adres bölgesi.

email

string

E-posta adresi.

firstName

string

Ad. MCA Enterprise için isteğe bağlı.

isValidAddress

boolean

Adresin tamamlanmamış olup olmadığını gösterir.

lastName

string

Soyadı. MCA Enterprise için isteğe bağlı.

middleName

string

İkinci ad.

phoneNumber

string

Telefon numarası.

postalCode

string

Posta kodu.

region

string

Adres bölgesi.

SupportLevel

Bir kayıtla ilişkili destek düzeyi teklifi.

Name Tür Description
Developer

string

Other

string

Pro-Direct

string

Standard

string

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string

Kaynak oluşturma (UTC) zaman damgası.

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt

string

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy

string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

createdByType

Kaynağı en son değiştiren kimlik türü.

TaxIdentifier

Ödeme hesabının vergi tanımlayıcısı.

Name Tür Description
country

string

Vergi tanımlayıcısının ülkesi.

id

string

Vergi tanımlayıcısının kimliği.

scope

string

Vergi tanımlayıcısının kapsamı.

status

TaxIdentifierStatus

Vergi tanımlayıcısının durumu.

type

TaxIdentifierType

Vergi tanımlayıcısının türü.

TaxIdentifierStatus

Vergi tanımlayıcısının durumu.

Name Tür Description
Invalid

string

Other

string

Valid

string

TaxIdentifierType

Vergi tanımlayıcısının türü.

Name Tür Description
BrazilCcmId

string

BrazilCnpjId

string

BrazilCpfId

string

CanadianFederalExempt

string

CanadianProvinceExempt

string

ExternalTaxation

string

IndiaFederalServiceTaxId

string

IndiaFederalTanId

string

IndiaPanId

string

IndiaStateCstId

string

IndiaStateGstINId

string

IndiaStateVatId

string

IntlExempt

string

LoveCode

string

MobileBarCode

string

NationalIdentificationNumber

string

Other

string

PublicSectorId

string

USExempt

string

VatId

string