Dela via


Billing Profiles - Create Or Update

Skapar eller uppdaterar en faktureringsprofil. Åtgärden stöds för faktureringskonton med avtalstypen Microsoft-kundavtal och Microsoft-partneravtal. Om du är mca-individkund (betala per användning) kan du använda Azure Portal-upplevelsen för att skapa faktureringsprofilen.

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

URI-parametrar

Name I Obligatorisk Typ Description
billingAccountName
path True

string

pattern: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$

Det ID som unikt identifierar ett faktureringskonto.

billingProfileName
path True

string

pattern: ^[a-zA-Z\d-_]{1,128}$

Det ID som unikt identifierar en faktureringsprofil.

api-version
query True

string

Den version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2024-04-01.

Begärandetext

Name Typ Description
properties

BillingProfileProperties

En faktureringsprofil.

tags

object

Ordlista med metadata som är associerade med resursen. Den kanske inte fylls i för alla resurstyper. Maximal nyckel/värdelängd som stöds på 256 tecken. Nycklar/värde får inte vara tomt eller null. Nycklar kan inte innehålla <> % & \ ? /

Svar

Name Typ Description
200 OK

BillingProfile

En faktureringsprofil.

201 Created

BillingProfile

En faktureringsprofil.

202 Accepted

En åtgärd accepterade resultatet som returnerar ett "Plats"-huvud som klienten kan avsöka för att visa resultatet av åtgärden.

Sidhuvuden

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

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Exempel

BillingProfilesCreateOrUpdate

Exempelbegäran

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx?api-version=2024-04-01

{
  "properties": {
    "billTo": {
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "companyName": "Contoso",
      "country": "US",
      "email": "abc@contoso.com",
      "firstName": "Test",
      "lastName": "User",
      "phoneNumber": "000-000-0000",
      "postalCode": "00000",
      "region": "WA",
      "isValidAddress": true
    },
    "displayName": "Billing Profile 1",
    "enabledAzurePlans": [
      {
        "skuId": "0001"
      },
      {
        "skuId": "0002"
      }
    ],
    "invoiceEmailOptIn": true,
    "poNumber": "ABC12345",
    "shipTo": {
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "companyName": "Contoso",
      "country": "US",
      "email": "abc@contoso.com",
      "firstName": "Test",
      "lastName": "User",
      "phoneNumber": "000-000-0000",
      "postalCode": "00000",
      "region": "WA",
      "isValidAddress": true
    }
  }
}

Exempelsvar

{
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
  "name": "xxxx-xxxx-xxx-xxx",
  "properties": {
    "billTo": {
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "companyName": "Contoso",
      "country": "US",
      "email": "abc@contoso.com",
      "firstName": "Test",
      "lastName": "User",
      "phoneNumber": "000-000-0000",
      "postalCode": "00000",
      "region": "WA",
      "isValidAddress": true
    },
    "currency": "USD",
    "displayName": "Billing Profile 1",
    "hasReadAccess": true,
    "invoiceDay": 5,
    "invoiceEmailOptIn": true,
    "poNumber": "ABC12345",
    "shipTo": {
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "companyName": "Contoso",
      "country": "US",
      "email": "abc@contoso.com",
      "firstName": "Test",
      "lastName": "User",
      "phoneNumber": "000-000-0000",
      "postalCode": "00000",
      "region": "WA",
      "isValidAddress": true
    },
    "status": "Active",
    "systemId": "11111111-1111-1111-1111-111111111111"
  },
  "type": "Microsoft.Billing/billingAccounts/billingProfiles"
}
{
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
  "name": "xxxx-xxxx-xxx-xxx",
  "properties": {
    "billTo": {
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "companyName": "Contoso",
      "country": "US",
      "email": "abc@contoso.com",
      "firstName": "Test",
      "lastName": "User",
      "phoneNumber": "000-000-0000",
      "postalCode": "00000",
      "region": "WA",
      "isValidAddress": true
    },
    "currency": "USD",
    "displayName": "Billing Profile 1",
    "hasReadAccess": true,
    "invoiceDay": 5,
    "invoiceEmailOptIn": true,
    "poNumber": "ABC12345",
    "shipTo": {
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "companyName": "Contoso",
      "country": "US",
      "email": "abc@contoso.com",
      "firstName": "Test",
      "lastName": "User",
      "phoneNumber": "000-000-0000",
      "postalCode": "00000",
      "region": "WA",
      "isValidAddress": true
    },
    "status": "Active",
    "systemId": "11111111-1111-1111-1111-111111111111"
  },
  "type": "Microsoft.Billing/billingAccounts/billingProfiles"
}
location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/operationResults/putBillingProfile_00000000-0000-0000-0000-000000000000?api-version=2024-04-01
retry-after: 10

Definitioner

Name Description
AzurePlan

Information om Azure-planen.

BillingProfile

En faktureringsprofil.

BillingProfileProperties

En faktureringsprofil.

BillingProfileStatus

Status för faktureringsprofilen.

BillingProfileStatusReasonCode

Orsak till den angivna faktureringsprofilens status.

BillingRelationshipType

Identifierar faktureringsrelationen som representeras av faktureringsprofilen. Faktureringsrelationen kan vara mellan Microsoft, kunden och/eller en tredje part.

BillTo

Faktureringsadress.

createdByType

Den typ av identitet som skapade resursen.

CurrentPaymentTerm

Faktureringsprofilens aktuella betalningsperiod.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

IndirectRelationshipInfo

Identifierar faktureringsprofilen som är länkad till en annan faktureringsprofil i indirekt inköpsrörelse.

PaymentTerm

Egenskaperna för betalningsperioden.

ProvisioningState

Resursens etableringstillstånd under en långvarig åtgärd.

ShipTo

Standardadressen där produkterna levereras eller tjänsterna används. Om ett fartyg till inte har angetts för en produkt eller prenumeration används den här adressen.

SoldTo

Adressen till den person eller organisation som ansvarar för faktureringskontot.

SpendingLimit

Utgiftsgränsen för faktureringsprofilen.

SpendingLimitDetails

Utgiftsgränsen för faktureringsprofilen.

SpendingLimitStatus

Status för den aktuella utgiftsgränsen.

SpendingLimitType

Typ av utgiftsgräns.

systemData

Metadata som rör skapande och senaste ändring av resursen.

AzurePlan

Information om Azure-planen.

Name Typ Description
productId

string

Det ID som unikt identifierar en produkt.

skuDescription

string

SKU-beskrivningen.

skuId

string

Det ID som unikt identifierar en sku.

BillingProfile

En faktureringsprofil.

Name Typ Description
id

string (arm-id)

Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Namnet på resursen

properties

BillingProfileProperties

En faktureringsprofil.

systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.

tags

object

Ordlista med metadata som är associerade med resursen. Den kanske inte fylls i för alla resurstyper. Maximal nyckel/värdelängd som stöds på 256 tecken. Nycklar/värde får inte vara tomt eller null. Nycklar kan inte innehålla <> % & \ ? /

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

BillingProfileProperties

En faktureringsprofil.

Name Typ Description
billTo

BillTo

Faktureringsadress.

billingRelationshipType

BillingRelationshipType

Identifierar faktureringsrelationen som representeras av faktureringsprofilen. Faktureringsrelationen kan vara mellan Microsoft, kunden och/eller en tredje part.

currency

string

Den valuta där avgifterna för faktureringsprofilen debiteras.

currentPaymentTerm

CurrentPaymentTerm

Faktureringsprofilens aktuella betalningsperiod.

displayName

string

Namnet på faktureringsprofilen.

enabledAzurePlans

AzurePlan[]

Information om aktiverade Azure-planer.

hasReadAccess

boolean

Anger om användaren har läsbehörighet till faktureringsprofilen.

indirectRelationshipInfo

IndirectRelationshipInfo

Identifierar faktureringsprofilen som är länkad till en annan faktureringsprofil i indirekt inköpsrörelse.

invoiceDay

integer (int32)

Den dag i månaden då fakturan för faktureringsprofilen genereras.

invoiceEmailOptIn

boolean

Flagga som styr om fakturorna för faktureringsprofilen skickas via e-post.

invoiceRecipients

string[]

Listan över e-postadresser som ska ta emot fakturor via e-post för faktureringsprofilen.

otherPaymentTerms

PaymentTerm[]

Övriga betalningsvillkor för faktureringsprofilen.

poNumber

string

Standardnumret för inköpsorder som visas på de fakturor som genereras för faktureringsprofilen.

provisioningState

ProvisioningState

Resursens etableringstillstånd under en långvarig åtgärd.

shipTo

ShipTo

Standardadressen där produkterna levereras eller tjänsterna används. Om ett fartyg till inte har angetts för en produkt eller prenumeration används den här adressen.

soldTo

SoldTo

Adressen till den person eller organisation som ansvarar för faktureringskontot.

spendingLimit

SpendingLimit

Utgiftsgränsen för faktureringsprofilen.

spendingLimitDetails

SpendingLimitDetails[]

Information om utgiftsgränsen för faktureringsprofilen.

status

BillingProfileStatus

Status för faktureringsprofilen.

statusReasonCode

BillingProfileStatusReasonCode

Orsak till den angivna faktureringsprofilens status.

systemId

string

Systemet genererade unik identifierare för en faktureringsprofil.

tags

object

Ordlista med metadata som är associerade med resursen. Maximal nyckel/värdelängd som stöds på 256 tecken. Nycklar/värde får inte vara tomt eller null. Nycklar kan inte innehålla <> % & \ ? /

targetClouds

string[]

Identifierar de molnmiljöer som är associerade med en faktureringsprofil. Det här är ett systemhanterat valfritt fält och uppdateras när faktureringsprofilen associeras med konton i olika moln.

BillingProfileStatus

Status för faktureringsprofilen.

Värde Description
Active
Deleted
Disabled
Other
UnderReview
Warned

BillingProfileStatusReasonCode

Orsak till den angivna faktureringsprofilens status.

Värde Description
Other
PastDue
SpendingLimitExpired
SpendingLimitReached
UnusualActivity

BillingRelationshipType

Identifierar faktureringsrelationen som representeras av faktureringsprofilen. Faktureringsrelationen kan vara mellan Microsoft, kunden och/eller en tredje part.

Värde Description
CSPCustomer
CSPPartner
Direct
IndirectCustomer
IndirectPartner
Other

BillTo

Faktureringsadress.

Name Typ Description
addressLine1

string

minLength: 1

Adressrad 1.

addressLine2

string

Adressrad 2.

addressLine3

string

Adressrad 3.

city

string

Adressort.

companyName

string

Företagsnamn. Valfritt för MCA Individual (Betala per användning).

country

string

minLength: 1

Landskoden använder FORMATET ISO 3166-1 Alpha-2.

district

string

Adressområde.

email

string

E-postadress.

firstName

string

Förnamn. Valfritt för MCA Enterprise.

isValidAddress

boolean

Anger om adressen är ofullständig.

lastName

string

Efternamn. Valfritt för MCA Enterprise.

middleName

string

Mellannamn.

phoneNumber

string

Telefonnummer.

postalCode

string

Postnummer.

region

string

Adressregion.

createdByType

Den typ av identitet som skapade resursen.

Värde Description
Application
Key
ManagedIdentity
User

CurrentPaymentTerm

Faktureringsprofilens aktuella betalningsperiod.

Name Typ Description
endDate

string (date-time)

Datumet då den definierade "betalningsperioden" upphör och är alltid i UTC.

isDefault

boolean

Anger att betalningsperioden är standardbetalningsperioden.

startDate

string (date-time)

Datumet då den definierade "betalningsperioden" träder i kraft och är alltid i UTC.

term

string

Representerar varaktighet i netXX-format. Alltid i dagar.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

IndirectRelationshipInfo

Identifierar faktureringsprofilen som är länkad till en annan faktureringsprofil i indirekt inköpsrörelse.

Name Typ Description
billingAccountName

string

Faktureringskontonamnet för partnern eller kunden för en indirekt rörelse.

billingProfileName

string

Faktureringsprofilens namn på partnern eller kunden för en indirekt rörelse.

displayName

string

Partnerns eller kundens visningsnamn för en indirekt rörelse.

PaymentTerm

Egenskaperna för betalningsperioden.

Name Typ Description
endDate

string (date-time)

Datumet då den definierade "betalningsperioden" upphör och är alltid i UTC.

isDefault

boolean

Anger att betalningsperioden är standardbetalningsperioden.

startDate

string (date-time)

Datumet då den definierade "betalningsperioden" träder i kraft och är alltid i UTC.

term

string

Representerar varaktighet i netXX-format. Alltid i dagar.

ProvisioningState

Resursens etableringstillstånd under en långvarig åtgärd.

Värde Description
Canceled
Failed
New
Pending
Provisioning
Succeeded

ShipTo

Standardadressen där produkterna levereras eller tjänsterna används. Om ett fartyg till inte har angetts för en produkt eller prenumeration används den här adressen.

Name Typ Description
addressLine1

string

minLength: 1

Adressrad 1.

addressLine2

string

Adressrad 2.

addressLine3

string

Adressrad 3.

city

string

Adressort.

companyName

string

Företagsnamn. Valfritt för MCA Individual (Betala per användning).

country

string

minLength: 1

Landskoden använder FORMATET ISO 3166-1 Alpha-2.

district

string

Adressområde.

email

string

E-postadress.

firstName

string

Förnamn. Valfritt för MCA Enterprise.

isValidAddress

boolean

Anger om adressen är ofullständig.

lastName

string

Efternamn. Valfritt för MCA Enterprise.

middleName

string

Mellannamn.

phoneNumber

string

Telefonnummer.

postalCode

string

Postnummer.

region

string

Adressregion.

SoldTo

Adressen till den person eller organisation som ansvarar för faktureringskontot.

Name Typ Description
addressLine1

string

minLength: 1

Adressrad 1.

addressLine2

string

Adressrad 2.

addressLine3

string

Adressrad 3.

city

string

Adressort.

companyName

string

Företagsnamn. Valfritt för MCA Individual (Betala per användning).

country

string

minLength: 1

Landskoden använder FORMATET ISO 3166-1 Alpha-2.

district

string

Adressområde.

email

string

E-postadress.

firstName

string

Förnamn. Valfritt för MCA Enterprise.

isValidAddress

boolean

Anger om adressen är ofullständig.

lastName

string

Efternamn. Valfritt för MCA Enterprise.

middleName

string

Mellannamn.

phoneNumber

string

Telefonnummer.

postalCode

string

Postnummer.

region

string

Adressregion.

SpendingLimit

Utgiftsgränsen för faktureringsprofilen.

Värde Description
Off
On

SpendingLimitDetails

Utgiftsgränsen för faktureringsprofilen.

Name Typ Description
amount

number

Det ursprungliga beloppet för faktureringsprofilen.

currency

string

Den valuta där avgifterna för faktureringsprofilen debiteras.

endDate

string (date-time)

Det datum då utgiftsgränsen inte längre gäller.

startDate

string (date-time)

Det datum då utgiftsgränsen träder i kraft.

status

SpendingLimitStatus

Status för den aktuella utgiftsgränsen.

type

SpendingLimitType

Typ av utgiftsgräns.

SpendingLimitStatus

Status för den aktuella utgiftsgränsen.

Värde Description
Active
Expired
LimitReached
LimitRemoved
None
Other

SpendingLimitType

Typ av utgiftsgräns.

Värde Description
AcademicSponsorship
AzureConsumptionCredit
AzureForStudents
AzureForStudentsStarter
AzurePassSponsorship
FreeAccount
MSDN
MpnSponsorship
NonProfitSponsorship
None
Other
Sandbox
Sponsorship
StartupSponsorship
VisualStudio

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string (date-time)

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.