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

Role Assignments - Put

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

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

示例请求

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"
  }
}

示例响应

{
  "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

特定错误的目标。