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

Role Assignments - Put

参考

服务:: Billing

API 版本:: 2019-10-01-preview

创建或更新计费角色分配。

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2019-10-01-preview

URI 参数

名称	在	必需	类型	说明
billingAccountName	path	True	string	唯一标识计费帐户的 ID。
billingRoleAssignmentName	path	True	string	唯一标识角色分配的 ID。
api-version	query	True	string	要与客户端请求一起使用的 API 的版本。当前版本为 2019-10-01-preview。

请求正文

名称	类型	说明
properties.principalId	string	向其分配角色的用户的主体 ID。
properties.principalTenantId	string	向其分配角色的用户的主体租户 ID。
properties.roleDefinitionId	string	角色定义的 ID。
properties.userAuthenticationType	string	向其分配角色的用户的身份验证类型，无论是组织还是 MSA。只有协议类型为企业协议的计费帐户才支持此操作。
properties.userEmailAddress	string	向其分配角色的用户的电子邮件地址。只有协议类型为企业协议的计费帐户才支持此操作。

响应

名称	类型	说明
200 OK	BillingRoleAssignment	没问题。请求已成功。
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

PutEnrollmentAdministratorRoleAssignment

示例请求

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2019-10-01-preview

{
  "properties": {
    "principalId": "99a1a759-30dd-42c2-828c-db398826bb67",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db"
  }
}

示例响应

状态代码:: 200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "properties": {
    "createdOn": "2019-06-28T19:11:50.6168809+00:00",
    "createdByPrincipalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
    "principalId": "99a1a759-30dd-42c2-828c-db398826bb67",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901"
  },
  "type": "Microsoft.Billing/billingAccounts/billingRoleAssignments"
}

定义

名称	说明
BillingRoleAssignment	角色分配
ErrorDetails	错误的详细信息。
ErrorResponse	错误响应指示服务无法处理传入请求。错误消息中提供了原因。
ErrorSubDetails

BillingRoleAssignment

角色分配

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.createdByPrincipalId	string	创建角色分配的用户的主体 ID。
properties.createdByPrincipalTenantId	string	创建角色分配的用户的租户 ID。
properties.createdByUserEmailAddress	string	创建角色分配的用户的电子邮件地址。只有协议类型为企业协议的计费帐户才支持此操作。
properties.createdOn	string	创建角色分配的日期。
properties.name	string	角色分配的名称。
properties.principalId	string	向其分配角色的用户的主体 ID。
properties.principalTenantId	string	向其分配角色的用户的主体租户 ID。
properties.roleDefinitionId	string	角色定义的 ID。
properties.scope	string	分配角色的范围。
properties.userAuthenticationType	string	向其分配角色的用户的身份验证类型，无论是组织还是 MSA。只有协议类型为企业协议的计费帐户才支持此操作。
properties.userEmailAddress	string	向其分配角色的用户的电子邮件地址。只有协议类型为企业协议的计费帐户才支持此操作。
type	string	资源类型。

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	错误代码。
details	ErrorSubDetails[]	错误的子详细信息。
message	string	指示操作失败原因的错误消息。
target	string	特定错误的目标。

ErrorResponse

错误响应指示服务无法处理传入请求。错误消息中提供了原因。

名称	类型	说明
error	ErrorDetails	错误的详细信息。

ErrorSubDetails

名称	类型	说明
code	string	错误代码。
message	string	指示操作失败原因的错误消息。
target	string	特定错误的目标。

通过