Compartilhar via


Enrollment Account Role Assignments - Put

Criar ou atualizar uma atribuição de função de cobrança.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
billingAccountName
path True

string

A ID que identifica exclusivamente uma conta de cobrança.

billingRoleAssignmentName
path True

string

A ID que identifica exclusivamente uma atribuição de função.

enrollmentAccountName
path True

string

A ID que identifica exclusivamente uma conta de registro.

api-version
query True

string

A versão da API a ser usada com a solicitação do cliente. A versão atual é 2019-10-01-preview.

Corpo da solicitação

Nome Tipo Description
properties.principalId

string

A ID da entidade de segurança do usuário ao qual a função foi atribuída.

properties.principalTenantId

string

A ID do locatário principal do usuário ao qual a função foi atribuída.

properties.roleDefinitionId

string

A ID da definição de função.

properties.userAuthenticationType

string

O tipo de autenticação do usuário, seja Organização ou MSA, do usuário ao qual a função foi atribuída. Isso tem suporte apenas para contas de cobrança com o tipo de contrato Enterprise Agreement.

properties.userEmailAddress

string

O endereço de email do usuário ao qual a função foi atribuída. Isso tem suporte apenas para contas de cobrança com o tipo de contrato Enterprise Agreement.

Respostas

Nome Tipo Description
200 OK

BillingRoleAssignment

OK. A solicitação foi bem-sucedida.

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

PutEnrollmentAccountSubscriptionCreatorRoleAssignment

Sample Request

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}/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/enrollmentAccounts/225314/billingRoleDefinitions/a0bcee42-bf30-4d1b-926a-48d21664ef71"
  }
}

Sample Response

{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/225314/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/enrollmentAccounts/225314/billingRoleDefinitions/a0bcee42-bf30-4d1b-926a-48d21664ef71",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/225314"
  },
  "type": "Microsoft.Billing/billingAccounts/enrollmentAccounts/billingRoleAssignments"
}

Definições

Nome Description
BillingRoleAssignment

A atribuição de função

ErrorDetails

Os detalhes do erro.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

ErrorSubDetails

BillingRoleAssignment

A atribuição de função

Nome Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.createdByPrincipalId

string

A ID da entidade de segurança do usuário que criou a atribuição de função.

properties.createdByPrincipalTenantId

string

A ID do locatário do usuário que criou a atribuição de função.

properties.createdByUserEmailAddress

string

O endereço de email do usuário que criou a atribuição de função. Isso tem suporte apenas para contas de cobrança com o tipo de contrato Enterprise Agreement.

properties.createdOn

string

A data em que a atribuição de função foi criada.

properties.name

string

O nome da atribuição de função.

properties.principalId

string

A ID da entidade de segurança do usuário ao qual a função foi atribuída.

properties.principalTenantId

string

A ID do locatário principal do usuário ao qual a função foi atribuída.

properties.roleDefinitionId

string

A ID da definição de função.

properties.scope

string

O escopo no qual a função foi atribuída.

properties.userAuthenticationType

string

O tipo de autenticação do usuário, seja Organização ou MSA, do usuário ao qual a função foi atribuída. Isso tem suporte apenas para contas de cobrança com o tipo de contrato Enterprise Agreement.

properties.userEmailAddress

string

O endereço de email do usuário ao qual a função foi atribuída. Isso tem suporte apenas para contas de cobrança com o tipo de contrato Enterprise Agreement.

type

string

Tipo de recurso.

ErrorDetails

Os detalhes do erro.

Nome Tipo Description
code

string

Código do erro.

details

ErrorSubDetails[]

Os sub-detalhes do erro.

message

string

Mensagem de erro indicando por que a operação falhou.

target

string

O destino do erro específico.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Nome Tipo Description
error

ErrorDetails

Os detalhes do erro.

ErrorSubDetails

Nome Tipo Description
code

string

Código do erro.

message

string

Mensagem de erro indicando por que a operação falhou.

target

string

O destino do erro específico.