Compartir a través de


Role Assignments - Put

Cree o actualice una asignación de roles de facturación.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
billingAccountName
path True

string

Identificador que identifica de forma única una cuenta de facturación.

billingRoleAssignmentName
path True

string

Identificador que identifica de forma única una asignación de roles.

api-version
query True

string

Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2019-10-01-preview.

Cuerpo de la solicitud

Nombre Tipo Description
properties.principalId

string

Identificador de entidad de seguridad del usuario al que se asignó el rol.

properties.principalTenantId

string

Identificador de inquilino principal del usuario al que se asignó el rol.

properties.roleDefinitionId

string

Identificador de la definición de rol.

properties.userAuthenticationType

string

Tipo de autenticación del usuario, ya sea organización o MSA, del usuario al que se asignó el rol. Esto solo se admite para las cuentas de facturación con tipo de contrato Enterprise Agreement.

properties.userEmailAddress

string

Dirección de correo electrónico del usuario al que se asignó el rol. Esto solo se admite para las cuentas de facturación con tipo de contrato Enterprise Agreement.

Respuestas

Nombre Tipo Description
200 OK

BillingRoleAssignment

Aceptar. La solicitud se ha realizado correctamente.

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

PutEnrollmentAdministratorRoleAssignment

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
BillingRoleAssignment

Asignación de roles

ErrorDetails

Detalles del error.

ErrorResponse

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.

ErrorSubDetails

BillingRoleAssignment

Asignación de roles

Nombre Tipo Description
id

string

Identificador de recurso.

name

string

Nombre del recurso.

properties.createdByPrincipalId

string

Identificador de entidad de seguridad del usuario que creó la asignación de roles.

properties.createdByPrincipalTenantId

string

Identificador de inquilino del usuario que creó la asignación de roles.

properties.createdByUserEmailAddress

string

Dirección de correo electrónico del usuario que creó la asignación de roles. Esto solo se admite para las cuentas de facturación con tipo de contrato Enterprise Agreement.

properties.createdOn

string

Fecha en que se creó la asignación de roles.

properties.name

string

Nombre de la asignación de roles.

properties.principalId

string

Identificador de entidad de seguridad del usuario al que se asignó el rol.

properties.principalTenantId

string

Identificador de inquilino principal del usuario al que se asignó el rol.

properties.roleDefinitionId

string

Identificador de la definición de rol.

properties.scope

string

Ámbito en el que se asignó el rol.

properties.userAuthenticationType

string

Tipo de autenticación del usuario, ya sea organización o MSA, del usuario al que se asignó el rol. Esto solo se admite para las cuentas de facturación con tipo de contrato Enterprise Agreement.

properties.userEmailAddress

string

Dirección de correo electrónico del usuario al que se asignó el rol. Esto solo se admite para las cuentas de facturación con tipo de contrato Enterprise Agreement.

type

string

Tipo de recurso.

ErrorDetails

Detalles del error.

Nombre Tipo Description
code

string

Código de error.

details

ErrorSubDetails[]

Los detalles secundarios del error.

message

string

Mensaje de error que indica por qué se produjo un error en la operación.

target

string

Destino del error determinado.

ErrorResponse

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.

Nombre Tipo Description
error

ErrorDetails

Detalles del error.

ErrorSubDetails

Nombre Tipo Description
code

string

Código de error.

message

string

Mensaje de error que indica por qué se produjo un error en la operación.

target

string

Destino del error determinado.