Role Assignments - Put

Referência

Serviço:: Billing

Versão da API:: 2019-10-01-preview

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

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/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.
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.

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

PutEnrollmentAdministratorRoleAssignment

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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"
}

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.

Compartilhar via