通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Billing Role Assignments - Create Or Update By Enrollment Account

服务:
Billing
API 版本:
2024-04-01

创建或更新计费角色分配。 只有协议类型为企业协议的计费帐户才支持该操作。

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2024-04-01

URI 参数

名称 在 必需 类型 说明
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})?)$

唯一标识计费帐户的 ID。
billingRoleAssignmentName
 path True

string

pattern: ^[a-fA-F0-9]{8}[-]?([a-fA-F0-9]{4}[-]?){3}[a-fA-F0-9]{12}(_[a-fA-F0-9]{8}[-]?([a-fA-F0-9]{4}[-]?){3}[a-fA-F0-9]{12})?$

唯一标识角色分配的 ID。
enrollmentAccountName
 path True

string

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

注册帐户的名称。
api-version
 query True

string

要用于客户端请求的 API 的版本。 当前版本为 2024-04-01。

请求正文

名称 类型 说明
properties

BillingRoleAssignmentProperties

计费角色分配的属性。
tags

object

与资源关联的元数据字典。 它可能不会针对所有资源类型进行填充。 支持的最大键/值长度为 256 个字符。 键/值不应为空值，也不应为 null。 键不能包含 <> % & \ ？ /

响应

名称 类型 说明
200 OK

BillingRoleAssignment

计费角色分配的属性。
201 Created

BillingRoleAssignment

计费角色分配的属性。

标头

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

ErrorResponse

描述操作失败的原因的错误响应。

示例

BillingRoleAssignmentCreateOrUpdateByEnrollmentAccount

示例请求

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402?api-version=2024-04-01

{
  "properties": {
    "principalId": "00000000-0000-0000-0000-000000000000",
    "principalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
    "userEmailAddress": "john@contoso.com"
  }
}

示例响应

状态代码:
200 
{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "properties": {
    "createdOn": "2023-10-19T20:10:50.1028398Z",
    "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
    "createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456"
  },
  "type": "Microsoft.Billing/billingAccounts/enrollmentAccounts/billingRoleAssignments"
}
状态代码:
201 
{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "properties": {
    "createdOn": "2023-10-19T20:10:50.1028398Z",
    "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
    "createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456"
  },
  "type": "Microsoft.Billing/billingAccounts/enrollmentAccounts/billingRoleAssignments"
}

定义

名称 说明
BillingRoleAssignment

计费角色分配的属性。
BillingRoleAssignmentProperties

计费角色分配的属性。
createdByType

创建资源的标识的类型。
ErrorAdditionalInfo

资源管理错误附加信息。
ErrorDetail

错误详细信息。
ErrorResponse

错误响应
PrincipalType

角色分配的类型。
ProvisioningState

长时间运行的操作期间资源的预配状态。
systemData

与创建和上次修改资源相关的元数据。

BillingRoleAssignment

Object

计费角色分配的属性。

名称 类型 说明
id

string (arm-id)

资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name

string

资源的名称
properties

BillingRoleAssignmentProperties

计费角色分配的属性。
systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags

object

与资源关联的元数据字典。 它可能不会针对所有资源类型进行填充。 支持的最大键/值长度为 256 个字符。 键/值不应为空值，也不应为 null。 键不能包含 <> % & \ ？ /
type

string

资源的类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

BillingRoleAssignmentProperties

Object

计费角色分配的属性。

名称 类型 说明
billingAccountDisplayName

string

计费帐户的名称。
billingAccountId

string

唯一标识计费帐户的完全限定 ID。
billingProfileDisplayName

string

计费配置文件的名称。
billingProfileId

string

唯一标识计费配置文件的完全限定 ID。
billingRequestId

string

为角色分配创建的计费请求的 ID。 这仅适用于通过计费请求创建的跨租户角色分配或角色分配。
createdByPrincipalId

string

创建角色分配的用户的对象 ID。
createdByPrincipalPuid

string

创建角色分配的用户的主体 PUID。
createdByPrincipalTenantId

string

创建角色分配的用户的租户 ID。
createdByUserEmailAddress

string

创建角色分配的用户的电子邮件地址。 仅支持协议类型为企业协议的计费帐户。
createdOn

string (date-time)

创建角色分配的日期。
customerDisplayName

string

客户的名称。
customerId

string

唯一标识客户的完全限定 ID。
invoiceSectionDisplayName

string

发票科目的名称。
invoiceSectionId

string

唯一标识发票科目的完全限定 ID。
modifiedByPrincipalId

string

修改角色分配的用户的主体 PUID。
modifiedByPrincipalPuid

string

修改角色分配的用户的主体 PUID。
modifiedByPrincipalTenantId

string

修改角色分配的用户的租户 ID。
modifiedByUserEmailAddress

string

修改角色分配的用户的电子邮件地址。 仅支持协议类型为企业协议的计费帐户。
modifiedOn

string (date-time)

修改角色分配的日期。
principalDisplayName

string

为其分配角色的主体的显示名称。
principalId

string

为其分配角色的用户的对象 ID。
principalPuid

string

向其分配角色的用户的主体 PUID。
principalTenantId

string

向其分配角色的用户的主体租户 ID。
principalTenantName

string

为其分配角色的用户的租户的友好名称。 对于计费帐户的主租户，这将成为“主租户”。
principalType

PrincipalType

角色分配的类型。
provisioningState

ProvisioningState

长时间运行的操作期间资源的预配状态。
roleDefinitionId

string

minLength: 1

角色定义的 ID。
scope

string

分配角色的范围。
userAuthenticationType

string

分配角色的用户的身份验证类型（无论是组织还是 MSA）。 仅支持协议类型为企业协议的计费帐户。
userEmailAddress

string

为其分配角色的用户的电子邮件地址。 仅支持协议类型为企业协议的计费帐户。

createdByType

枚举

创建资源的标识的类型。

值 说明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。
type

string

其他信息类型。

ErrorDetail

Object

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。
code

string

错误代码。
details

ErrorDetail[]

错误详细信息。
message

string

错误消息。
target

string

错误目标。

ErrorResponse

Object

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

PrincipalType

枚举

角色分配的类型。

值 说明
Unknown
None
User
Group
DirectoryRole
ServicePrincipal
Everyone

ProvisioningState

枚举

长时间运行的操作期间资源的预配状态。

值 说明
Succeeded
Canceled
Failed
New
Pending
Provisioning

systemData

Object

与创建和上次修改资源相关的元数据。

名称 类型 说明
createdAt

string (date-time)

资源创建时间戳（UTC）。
createdBy

string

创建资源的标识。
createdByType

createdByType

创建资源的标识的类型。
lastModifiedAt

string (date-time)

上次修改的资源时间戳（UTC）
lastModifiedBy

string

上次修改资源的标识。
lastModifiedByType

createdByType

上次修改资源的标识的类型。