Partilhar via


Enrollment Account Role Assignments - Put

Criar ou atualizar uma atribuição de função de faturação.

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

Parâmetros do URI

Name Em Necessário Tipo Description
billingAccountName
path True

string

O ID que identifica exclusivamente uma conta de faturação.

billingRoleAssignmentName
path True

string

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

enrollmentAccountName
path True

string

O ID que identifica exclusivamente uma conta de inscrição.

api-version
query True

string

A versão da API a ser utilizada com o pedido de cliente. A versão atual é 2019-10-01-preview.

Corpo do Pedido

Name Tipo Description
properties.principalId

string

O ID principal do utilizador a quem foi atribuída a função.

properties.principalTenantId

string

O ID de inquilino principal do utilizador a quem foi atribuída a função.

properties.roleDefinitionId

string

O ID da definição da função.

properties.userAuthenticationType

string

O tipo de autenticação do utilizador, seja Organização ou MSA, do utilizador a quem foi atribuída a função. Isto só é suportado para contas de faturação com tipo de contrato Contrato Enterprise.

properties.userEmailAddress

string

O endereço de e-mail do utilizador a quem foi atribuída a função. Isto só é suportado para contas de faturação com tipo de contrato Contrato Enterprise.

Respostas

Name Tipo Description
200 OK

BillingRoleAssignment

OK. O pedido foi efetuada com êxito.

Other Status Codes

ErrorResponse

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

PutEnrollmentAccountSubscriptionCreatorRoleAssignment

Pedido de amostra

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

Resposta da amostra

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

Name 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 consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro.

ErrorSubDetails

BillingRoleAssignment

A atribuição de função

Name Tipo Description
id

string

ID do Recurso.

name

string

Nome do recurso.

properties.createdByPrincipalId

string

O ID principal do utilizador que criou a atribuição de função.

properties.createdByPrincipalTenantId

string

O ID do inquilino do utilizador que criou a atribuição de função.

properties.createdByUserEmailAddress

string

O endereço de e-mail do utilizador que criou a atribuição de função. Isto só é suportado para contas de faturação com tipo de contrato Contrato Enterprise.

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

O ID principal do utilizador a quem foi atribuída a função.

properties.principalTenantId

string

O ID de inquilino principal do utilizador a quem foi atribuída a função.

properties.roleDefinitionId

string

O ID da definição da função.

properties.scope

string

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

properties.userAuthenticationType

string

O tipo de autenticação do utilizador, seja Organização ou MSA, do utilizador a quem foi atribuída a função. Isto só é suportado para contas de faturação com tipo de contrato Contrato Enterprise.

properties.userEmailAddress

string

O endereço de e-mail do utilizador a quem foi atribuída a função. Isto só é suportado para contas de faturação com tipo de contrato Contrato Enterprise.

type

string

Tipo de recurso.

ErrorDetails

Os detalhes do erro.

Name Tipo Description
code

string

Código de erro.

details

ErrorSubDetails[]

Os sub detalhes do erro.

message

string

Mensagem de erro a indicar o motivo pela qual a operação falhou.

target

string

O destino do erro específico.

ErrorResponse

A resposta de erro indica que o serviço não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro.

Name Tipo Description
error

ErrorDetails

Os detalhes do erro.

ErrorSubDetails

Name Tipo Description
code

string

Código de erro.

message

string

Mensagem de erro a indicar o motivo pela qual a operação falhou.

target

string

O destino do erro específico.