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 |
---|---|---|---|---|
billing
|
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. |
billing
|
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 |
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 |
En faktureringsprofil. |
|
201 Created |
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
|
|
Other Status Codes |
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 |
---|---|
Azure |
Information om Azure-planen. |
Billing |
En faktureringsprofil. |
Billing |
En faktureringsprofil. |
Billing |
Status för faktureringsprofilen. |
Billing |
Orsak till den angivna faktureringsprofilens status. |
Billing |
Identifierar faktureringsrelationen som representeras av faktureringsprofilen. Faktureringsrelationen kan vara mellan Microsoft, kunden och/eller en tredje part. |
Bill |
Faktureringsadress. |
created |
Den typ av identitet som skapade resursen. |
Current |
Faktureringsprofilens aktuella betalningsperiod. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Indirect |
Identifierar faktureringsprofilen som är länkad till en annan faktureringsprofil i indirekt inköpsrörelse. |
Payment |
Egenskaperna för betalningsperioden. |
Provisioning |
Resursens etableringstillstånd under en långvarig åtgärd. |
Ship |
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. |
Sold |
Adressen till den person eller organisation som ansvarar för faktureringskontot. |
Spending |
Utgiftsgränsen för faktureringsprofilen. |
Spending |
Utgiftsgränsen för faktureringsprofilen. |
Spending |
Status för den aktuella utgiftsgränsen. |
Spending |
Typ av utgiftsgräns. |
system |
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 |
En faktureringsprofil. |
|
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 |
Faktureringsadress. |
|
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 |
Faktureringsprofilens aktuella betalningsperiod. |
|
displayName |
string |
Namnet på faktureringsprofilen. |
enabledAzurePlans |
Information om aktiverade Azure-planer. |
|
hasReadAccess |
boolean |
Anger om användaren har läsbehörighet till faktureringsprofilen. |
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 |
Övriga betalningsvillkor för faktureringsprofilen. |
|
poNumber |
string |
Standardnumret för inköpsorder som visas på de fakturor som genereras för faktureringsprofilen. |
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 |
Information om utgiftsgränsen för faktureringsprofilen. |
|
status |
Status för faktureringsprofilen. |
|
statusReasonCode |
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. |
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 |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
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. |
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. |
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 |
Status för den aktuella utgiftsgränsen. |
|
type |
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 |
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 |
Den typ av identitet som senast ändrade resursen. |