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 faturação.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/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.
api-version	query	True	string	A versão da API a utilizar 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 de 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 é suportado apenas 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 é suportado apenas para contas de faturação com tipo de contrato Contrato Enterprise.

Respostas

Name	Tipo	Description
200 OK	BillingRoleAssignment	OK. O pedido foi bem-sucedido.
Other Status Codes	ErrorResponse	Resposta de erro que descreve a razão 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

PutEnrollmentAdministratorRoleAssignment

Pedido de amostra

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 da amostra

Código de estado:: 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

Name	Description
BillingRoleAssignment	A atribuição de função
ErrorDetails	Os detalhes do erro.
ErrorResponse	A resposta a erros 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 é suportado apenas 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 de 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 é suportado apenas 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 é suportado apenas 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 subdiretores do erro.
message	string	Mensagem de erro a indicar por que motivo a operação falhou.
target	string	O destino do erro específico.

ErrorResponse

A resposta a erros 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 por que motivo a operação falhou.
target	string	O destino do erro específico.

Partilhar via