Aracılığıyla paylaş


Billing Role Assignments - Create By Invoice Section

Fatura bölümüne rol ataması ekler. İşlem, Microsoft Müşteri Sözleşmesi sözleşme türüne sahip ödeme hesapları için desteklenir.

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

URI Parametreleri

Name İçinde Gerekli Tür 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})?)$

Bir ödeme hesabını benzersiz olarak tanımlayan kimlik.

billingProfileName
path True

string

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

Faturalama profilini benzersiz olarak tanımlayan kimlik.

invoiceSectionName
path True

string

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

Bir fatura bölümünü benzersiz olarak tanımlayan kimlik.

api-version
query True

string

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

İstek Gövdesi

Name Gerekli Tür Description
roleDefinitionId True

string

minLength: 1

Rol tanımının kimliği.

principalId

string

Rolün atandığı kullanıcının nesne kimliği.

principalPuid

string

Rolün atandığı kullanıcının asıl PUID değeri.

principalTenantId

string

Rolün atandığı kullanıcının asıl kiracı kimliği.

scope

string

Rolün atandığı kapsam.

userAuthenticationType

string

Rolün atandığı kullanıcının kuruluş veya MSA kimlik doğrulama türü. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir.

userEmailAddress

string

Rolün atandığı kullanıcının e-posta adresi. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir.

Yanıtlar

Name Tür Description
200 OK

BillingRoleAssignment

Faturalama rolü atamasının özellikleri.

202 Accepted

Faturalama rolü atamasının özellikleri.

Üst Bilgiler

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

ErrorResponse

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

Örnekler

BillingRoleAssignmentCreateByInvoiceSection

Örnek isteği

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/createBillingRoleAssignment?api-version=2024-04-01

{
  "principalId": "00000000-0000-0000-0000-000000000000",
  "principalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
  "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/10000000-aaaa-bbbb-cccc-100000000000",
  "userEmailAddress": "john@contoso.com"
}

Örnek yanıt

{
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleAssignments/10000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
  "name": "10000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
  "properties": {
    "createdOn": "2023-10-19T20:10:50.1028398Z",
    "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
    "createdByPrincipalId": "47309529-17e6-4104-b9e8-39f62fa1e5ed",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/10000000-aaaa-bbbb-cccc-100000000000",
    "scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx",
    "principalType": "User"
  },
  "type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections/billingRoleAssignments"
}
location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/invoiceSections/xxxx-xxxx-xxx-xxx/operationResults/createBillingRoleAssignment_10000000-0000-0000-0000-000000000001?api-version=2024-04-01
retry-after: 5

Tanımlar

Name Description
BillingRoleAssignment

Faturalama rolü atamasının özellikleri.

BillingRoleAssignmentProperties

Faturalama rolü atamasının özellikleri.

createdByType

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

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

PrincipalType

Rol Ataması türü.

ProvisioningState

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

systemData

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

BillingRoleAssignment

Faturalama rolü atamasının özellikleri.

Name Tür Description
id

string (arm-id)

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

name

string

Kaynağın adı

properties

BillingRoleAssignmentProperties

Faturalama rolü atamasının özellikleri.

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"

BillingRoleAssignmentProperties

Faturalama rolü atamasının özellikleri.

Name Tür Description
billingAccountDisplayName

string

Ödeme hesabının adı.

billingAccountId

string

Bir ödeme hesabını benzersiz olarak tanımlayan tam kimlik.

billingProfileDisplayName

string

Faturalama profilinin adı.

billingProfileId

string

Faturalama profilini benzersiz olarak tanımlayan tam kimlik.

billingRequestId

string

Rol ataması için oluşturulan faturalama isteğinin kimliği. Bu yalnızca faturalama isteği aracılığıyla oluşturulan kiracılar arası rol atamaları veya rol atamaları için geçerlidir.

createdByPrincipalId

string

Rol atamasını oluşturan kullanıcının nesne kimliği.

createdByPrincipalPuid

string

Rol atamasını oluşturan kullanıcının asıl PUID değeri.

createdByPrincipalTenantId

string

Rol atamasını oluşturan kullanıcının kiracı kimliği.

createdByUserEmailAddress

string

Rol atamasını oluşturan kullanıcının e-posta adresi. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir.

createdOn

string (date-time)

Rol atamasının oluşturulduğu tarih.

customerDisplayName

string

Müşterinin adı.

customerId

string

Bir müşteriyi benzersiz olarak tanımlayan tam kimlik.

invoiceSectionDisplayName

string

Fatura bölümünün adı.

invoiceSectionId

string

Bir fatura bölümünü benzersiz olarak tanımlayan tam kimlik.

modifiedByPrincipalId

string

Rol atamasını değiştiren kullanıcının asıl PUID değeri.

modifiedByPrincipalPuid

string

Rol atamasını değiştiren kullanıcının asıl PUID değeri.

modifiedByPrincipalTenantId

string

Rol atamasını değiştiren kullanıcının kiracı kimliği.

modifiedByUserEmailAddress

string

Rol atamasını değiştiren kullanıcının e-posta adresi. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir.

modifiedOn

string (date-time)

Rol atamasının değiştirildiği tarih.

principalDisplayName

string

Rolün atandığı sorumlunun görünen adı.

principalId

string

Rolün atandığı kullanıcının nesne kimliği.

principalPuid

string

Rolün atandığı kullanıcının asıl PUID değeri.

principalTenantId

string

Rolün atandığı kullanıcının asıl kiracı kimliği.

principalTenantName

string

Rolün atandığı kullanıcının kiracısının kolay adı. Bu, ödeme hesabının birincil kiracısı için 'Birincil Kiracı' olacaktır.

principalType

PrincipalType

Rol Ataması türü.

provisioningState

ProvisioningState

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

roleDefinitionId

string

minLength: 1

Rol tanımının kimliği.

scope

string

Rolün atandığı kapsam.

userAuthenticationType

string

Rolün atandığı kullanıcının kuruluş veya MSA kimlik doğrulama türü. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir.

userEmailAddress

string

Rolün atandığı kullanıcının e-posta adresi. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir.

createdByType

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

Değer Description
Application
Key
ManagedIdentity
User

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.

PrincipalType

Rol Ataması türü.

Değer Description
DirectoryRole
Everyone
Group
None
ServicePrincipal
Unknown
User

ProvisioningState

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

Değer Description
Canceled
Failed
New
Pending
Provisioning
Succeeded

systemData

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

Name Tür Description
createdAt

string (date-time)

Kaynak oluşturma (UTC) zaman damgası.

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

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

lastModifiedAt

string (date-time)

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ü.