Billing Role Assignments - Create By Invoice Section
Agrega una asignación de roles en una sección de factura. La operación es compatible con las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/createBillingRoleAssignment?api-version=2024-04-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
billing
|
path | True |
string |
Identificador que identifica de forma única una cuenta de facturación. Patrón de Regex: |
billing
|
path | True |
string |
Identificador que identifica de forma única un perfil de facturación. Patrón de Regex: |
invoice
|
path | True |
string |
Identificador que identifica de forma única una sección de factura. Patrón de Regex: |
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 2024-04-01. |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
roleDefinitionId | True |
string |
Identificador de la definición de roles. |
principalId |
string |
Identificador de objeto del usuario al que se asignó el rol. |
|
principalPuid |
string |
PuID principal del usuario al que se asignó el rol. |
|
principalTenantId |
string |
Identificador de inquilino principal del usuario al que se asignó el rol. |
|
scope |
string |
Ámbito en el que se asignó el rol. |
|
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 el tipo de contrato Enterprise Agreement. |
|
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 el tipo de contrato Enterprise Agreement. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Propiedades de la asignación de roles de facturación. |
|
202 Accepted |
Propiedades de la asignación de roles de facturación. Encabezados
|
|
Other Status Codes |
Respuesta de error que describe por qué se produjo un error en la operación. |
Ejemplos
BillingRoleAssignmentCreateByInvoiceSection
Solicitud de ejemplo
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/createBillingRoleAssignment?api-version=2024-04-01
{
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/10000000-aaaa-bbbb-cccc-100000000000",
"userEmailAddress": "john@contoso.com"
}
Respuesta de muestra
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleAssignments/10000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
"name": "10000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "47309529-17e6-4104-b9e8-39f62fa1e5ed",
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/10000000-aaaa-bbbb-cccc-100000000000",
"scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections/billingRoleAssignments"
}
location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/invoiceSections/xxxx-xxxx-xxx-xxx/operationResults/createBillingRoleAssignment_10000000-0000-0000-0000-000000000001?api-version=2024-04-01
retry-after: 5
Definiciones
Nombre | Description |
---|---|
Billing |
Propiedades de la asignación de roles de facturación. |
Billing |
Propiedades de la asignación de roles de facturación. |
created |
Tipo de identidad que creó el recurso. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Principal |
Tipo de una asignación de roles. |
Provisioning |
Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada. |
system |
Metadatos relativos a la creación y última modificación del recurso. |
BillingRoleAssignment
Propiedades de la asignación de roles de facturación.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Nombre del recurso |
properties |
Propiedades de la asignación de roles de facturación. |
|
systemData |
Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy. |
|
tags |
object |
Diccionario de metadatos asociados al recurso. Es posible que no se rellene para todos los tipos de recursos. Longitud máxima de clave/valor admitida de 256 caracteres. Las claves y el valor no deben estar vacíos ni null. Las claves no pueden contener <> % & \ ? / |
type |
string |
Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
BillingRoleAssignmentProperties
Propiedades de la asignación de roles de facturación.
Nombre | Tipo | Description |
---|---|---|
billingAccountDisplayName |
string |
Nombre de la cuenta de facturación. |
billingAccountId |
string |
Identificador completo que identifica de forma única una cuenta de facturación. |
billingProfileDisplayName |
string |
Nombre del perfil de facturación. |
billingProfileId |
string |
Identificador completo que identifica de forma única un perfil de facturación. |
billingRequestId |
string |
Identificador de la solicitud de facturación que se creó para la asignación de roles. Esto solo es aplicable a asignaciones de roles entre inquilinos o asignaciones de roles creadas a través de la solicitud de facturación. |
createdByPrincipalId |
string |
Identificador de objeto del usuario que creó la asignación de roles. |
createdByPrincipalPuid |
string |
PuID principal del usuario que creó la asignación de roles. |
createdByPrincipalTenantId |
string |
Identificador de inquilino del usuario que creó la asignación de roles. |
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 el tipo de contrato Enterprise Agreement. |
createdOn |
string |
Fecha en que se creó la asignación de roles. |
customerDisplayName |
string |
Nombre del cliente. |
customerId |
string |
Identificador completo que identifica de forma única a un cliente. |
invoiceSectionDisplayName |
string |
Nombre de la sección de factura. |
invoiceSectionId |
string |
Identificador completo que identifica de forma única una sección de factura. |
modifiedByPrincipalId |
string |
PuID principal del usuario que modificó la asignación de roles. |
modifiedByPrincipalPuid |
string |
PuID principal del usuario que modificó la asignación de roles. |
modifiedByPrincipalTenantId |
string |
Identificador de inquilino del usuario que modificó la asignación de roles. |
modifiedByUserEmailAddress |
string |
Dirección de correo electrónico del usuario que modificó la asignación de roles. Esto solo se admite para las cuentas de facturación con el tipo de contrato Enterprise Agreement. |
modifiedOn |
string |
Fecha en que se modificó la asignación de roles. |
principalDisplayName |
string |
Nombre para mostrar de la entidad de seguridad a la que se asignó el rol. |
principalId |
string |
Identificador de objeto del usuario al que se asignó el rol. |
principalPuid |
string |
PuID principal del usuario al que se asignó el rol. |
principalTenantId |
string |
Identificador de inquilino principal del usuario al que se asignó el rol. |
principalTenantName |
string |
Nombre descriptivo del inquilino del usuario al que se asignó el rol. Será "Inquilino principal" para el inquilino principal de la cuenta de facturación. |
principalType |
Tipo de una asignación de roles. |
|
provisioningState |
Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada. |
|
roleDefinitionId |
string |
Identificador de la definición de roles. |
scope |
string |
Ámbito en el que se asignó el rol. |
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 el tipo de contrato Enterprise Agreement. |
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 el tipo de contrato Enterprise Agreement. |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
Mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
PrincipalType
Tipo de una asignación de roles.
Nombre | Tipo | Description |
---|---|---|
DirectoryRole |
string |
|
Everyone |
string |
|
Group |
string |
|
None |
string |
|
ServicePrincipal |
string |
|
Unknown |
string |
|
User |
string |
ProvisioningState
Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada.
Nombre | Tipo | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
systemData
Metadatos relativos a la creación y última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |