Billing Profiles - Create Or Update

Tworzy lub aktualizuje profil rozliczeń. Operacja jest obsługiwana w przypadku kont rozliczeń z typem umowy Umowa dla klientów firmy Microsoft lub umowa partnerska firmy Microsoft.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}?api-version=2020-05-01

Parametry identyfikatora URI

Name In Required Type Description
billingAccountName
path True
  • string

Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe.

billingProfileName
path True
  • string

Identyfikator, który jednoznacznie identyfikuje profil rozliczeń.

api-version
query True
  • string

Wersja interfejsu API, która ma być używana z żądaniem klienta. Bieżąca wersja to 2020-05-01.

Treść żądania

Name Type Description
properties.billTo

Adres rozliczeniowy.

properties.displayName
  • string

Nazwa profilu rozliczeń.

properties.enabledAzurePlans

Informacje na temat włączonych planów platformy Azure.

properties.invoiceEmailOptIn
  • boolean

Flaga kontrolująca, czy faktury dla profilu rozliczania są wysyłane za pośrednictwem poczty e-mail.

properties.invoiceSections

Sekcje faktury skojarzone z profilem rozliczania. Domyślnie ta wartość nie jest wypełniona, chyba że jest określona w $expand.

properties.poNumber
  • string

Nazwa zamówienia zakupu, która będzie wyświetlana na fakturach wygenerowanych dla profilu rozliczania.

properties.tags
  • object

Tagi profilów rozliczeń.

Odpowiedzi

Name Type Description
200 OK

OK. Żądanie zakończyło się pomyślnie.

202 Accepted

Zaakceptowano

Headers

  • Location: string
  • Retry-After: integer
Other Status Codes

Odpowiedź na błąd z opisem przyczyny niepowodzenia operacji.

Zabezpieczenia

azure_auth

Azure Active Directory przepływ OAuth2.

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

Scopes

Name Description
user_impersonation Personifikuj konto użytkownika

Przykłady

CreateBillingProfile

Sample Request

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}?api-version=2020-05-01
{
  "properties": {
    "displayName": "Finance",
    "billTo": {
      "firstName": "Test",
      "lastName": "User",
      "addressLine1": "Test Address 1",
      "city": "Redmond",
      "postalCode": "12345",
      "region": "WA",
      "country": "US"
    },
    "enabledAzurePlans": [
      {
        "skuId": "0001"
      },
      {
        "skuId": "0002"
      }
    ],
    "invoiceEmailOptIn": true,
    "poNumber": "ABC12345"
  }
}

Sample Response

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/operationResults/putBillingProfile_00000000-0000-0000-0000-000000000000?api-version=2020-05-01
Retry-After: 60
{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/billingProfileId1",
  "name": "billingProfileId1",
  "type": "Microsoft.Billing/billingAccounts/billingProfiles",
  "properties": {
    "displayName": "Finance",
    "billTo": {
      "firstName": "Test",
      "lastName": "User",
      "addressLine1": "Test Address 1",
      "city": "Redmond",
      "postalCode": "12345",
      "region": "WA",
      "country": "US"
    },
    "currency": "USD",
    "enabledAzurePlans": [
      {
        "skuId": "0001",
        "skuDescription": "Microsoft Azure Plan"
      },
      {
        "skuId": "0002",
        "skuDescription": "Microsoft Azure Plan for DevTest"
      }
    ],
    "invoiceDay": 5,
    "invoiceEmailOptIn": true,
    "poNumber": "ABC12345",
    "hasReadAccess": true,
    "systemId": "1XXX-11XX-XX1-XXXX-XXX",
    "status": "Active",
    "spendingLimit": "Off"
  }
}

Definicje

AddressDetails

Szczegóły adresu.

AzurePlan

Szczegóły planu platformy Azure.

BillingProfile

Profil rozliczania.

BillingProfileStatus

Stan profilu rozliczeń.

BillingRelationshipType

Określa, które usługi i zakupy są opłacane przez profil rozliczeniowy.

ErrorDetails

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Powód jest podany w komunikacie o błędzie.

ErrorSubDetails
IndirectRelationshipInfo

Szczegóły profilu rozliczeń partnera klienta na potrzeby pośredniego ruchu.

InvoiceSection

Sekcja faktury.

InvoiceSectionsOnExpand

Sekcje faktury skojarzone z profilem rozliczania. Domyślnie ta wartość nie jest wypełniona, chyba że jest określona w $expand.

InvoiceSectionState

Identyfikuje stan sekcji faktury.

SpendingLimit

Limit wydatków dla profilu rozliczeń.

StatusReasonCode

Przyczyna określonego stanu profilu rozliczeń.

targetCloud

Identyfikuje środowiska chmury, które są skojarzone z sekcją faktury. Jest to pole opcjonalne zarządzane przez system i zaktualizowane, gdy sekcja faktury zostanie skojarzona z kontami w różnych chmurach.

AddressDetails

Szczegóły adresu.

Name Type Description
addressLine1
  • string

Wiersz adresu 1.

addressLine2
  • string

Wiersz adresu 2.

addressLine3
  • string

Wiersz adresu 3.

city
  • string

Adres miasto.

companyName
  • string

Nazwa firmy.

country
  • string

Kod kraju używa ISO2, 2-cyfrowy format.

district
  • string

Okręg adresu.

email
  • string

Adres e-mail.

firstName
  • string

Imię.

lastName
  • string

Nazwisko.

middleName
  • string

Drugie imię.

phoneNumber
  • string

Numer telefonu.

postalCode
  • string

Kod pocztowy.

region
  • string

Region adresu.

AzurePlan

Szczegóły planu platformy Azure.

Name Type Description
skuDescription
  • string

Opis jednostki SKU.

skuId
  • string

Identyfikator jednostki SKU.

BillingProfile

Profil rozliczania.

Name Type Description
id
  • string

Identyfikator zasobu.

name
  • string

Nazwa zasobu.

properties.billTo

Adres rozliczeniowy.

properties.billingRelationshipType

Określa, które usługi i zakupy są opłacane przez profil rozliczeniowy.

properties.currency
  • string

Waluta, w której naliczane są opłaty za profil rozliczania.

properties.displayName
  • string

Nazwa profilu rozliczeń.

properties.enabledAzurePlans

Informacje na temat włączonych planów platformy Azure.

properties.hasReadAccess
  • boolean

Wskazuje, czy użytkownik ma dostęp do odczytu do profilu rozliczeń.

properties.indirectRelationshipInfo

Identyfikuje profil rozliczeń połączony z innym profilem rozliczeń w pośrednim ruchu zakupu.

properties.invoiceDay
  • integer

Dzień miesiąca, w którym jest generowany faktura dla profilu rozliczania.

properties.invoiceEmailOptIn
  • boolean

Flaga kontrolująca, czy faktury dla profilu rozliczania są wysyłane za pośrednictwem poczty e-mail.

properties.invoiceSections

Sekcje faktury skojarzone z profilem rozliczania. Domyślnie ta wartość nie jest wypełniona, chyba że jest określona w $expand.

properties.poNumber
  • string

Nazwa zamówienia zakupu, która będzie wyświetlana na fakturach wygenerowanych dla profilu rozliczania.

properties.spendingLimit

Limit wydatków dla profilu rozliczeń.

properties.status

Stan profilu rozliczeń.

properties.statusReasonCode

Przyczyna określonego stanu profilu rozliczeń.

properties.systemId
  • string

System wygenerował unikatowy identyfikator dla profilu rozliczeń.

properties.tags
  • object

Tagi profilów rozliczeń.

properties.targetClouds
  • string[]

Identyfikuje środowiska chmury, które są skojarzone z profilem rozliczeń. Jest to pole opcjonalne zarządzane przez system i zaktualizowane, gdy profil rozliczeń jest skojarzony z kontami w różnych chmurach.

type
  • string

Typ zasobu.

BillingProfileStatus

Stan profilu rozliczeń.

Name Type Description
Active
  • string
Disabled
  • string
Warned
  • string

BillingRelationshipType

Określa, które usługi i zakupy są opłacane przez profil rozliczeniowy.

Name Type Description
CSPPartner
  • string
Direct
  • string
IndirectCustomer
  • string
IndirectPartner
  • string

ErrorDetails

Szczegóły błędu.

Name Type Description
code
  • string

Kod błędu.

details

Szczegóły podrzędne błędu.

message
  • string

Komunikat o błędzie informujący o tym, dlaczego operacja nie powiodła się.

target
  • string

Obiekt docelowy konkretnego błędu.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Powód jest podany w komunikacie o błędzie.

Name Type Description
error

Szczegóły błędu.

ErrorSubDetails

Name Type Description
code
  • string

Kod błędu.

message
  • string

Komunikat o błędzie informujący o tym, dlaczego operacja nie powiodła się.

target
  • string

Obiekt docelowy konkretnego błędu.

IndirectRelationshipInfo

Szczegóły profilu rozliczeń partnera klienta na potrzeby pośredniego ruchu.

Name Type Description
billingAccountName
  • string

Nazwa konta rozliczeniowego partnera lub klienta dla pośredniego ruchu.

billingProfileName
  • string

Nazwa profilu rozliczenia partnera lub klienta dla pośredniego ruchu.

displayName
  • string

Nazwa wyświetlana partnera lub klienta dla pośredniego ruchu.

InvoiceSection

Sekcja faktury.

Name Type Description
id
  • string

Identyfikator zasobu.

name
  • string

Nazwa zasobu.

properties.displayName
  • string

Nazwa sekcji faktury.

properties.labels
  • object

Słownik metadanych skojarzonych z sekcją faktury.

properties.state

Identyfikuje stan sekcji faktury.

properties.systemId
  • string

System wygenerował unikatowy identyfikator sekcji faktury.

properties.targetCloud

Identyfikuje środowiska chmury, które są skojarzone z sekcją faktury. Jest to pole opcjonalne zarządzane przez system i zaktualizowane, gdy sekcja faktury zostanie skojarzona z kontami w różnych chmurach.

type
  • string

Typ zasobu.

InvoiceSectionsOnExpand

Sekcje faktury skojarzone z profilem rozliczania. Domyślnie ta wartość nie jest wypełniona, chyba że jest określona w $expand.

Name Type Description
hasMoreResults
  • boolean

Wskazuje, czy więcej sekcji faktur nie ma na liście w tej kolekcji. Kolekcja zawiera maksymalnie 50 sekcji faktur. Aby uzyskać wszystkie sekcje faktury, użyj interfejsu API list faktur.

value

Sekcje faktury skojarzone z profilem rozliczania.

InvoiceSectionState

Identyfikuje stan sekcji faktury.

Name Type Description
Active
  • string
Restricted
  • string

SpendingLimit

Limit wydatków dla profilu rozliczeń.

Name Type Description
Off
  • string
On
  • string

StatusReasonCode

Przyczyna określonego stanu profilu rozliczeń.

Name Type Description
PastDue
  • string
SpendingLimitExpired
  • string
SpendingLimitReached
  • string

targetCloud

Identyfikuje środowiska chmury, które są skojarzone z sekcją faktury. Jest to pole opcjonalne zarządzane przez system i zaktualizowane, gdy sekcja faktury zostanie skojarzona z kontami w różnych chmurach.

Name Type Description
USGov
  • string
USNat
  • string
USSec
  • string