Billing Role Assignments - List By Customer
Enumera las asignaciones de roles para el autor de la llamada en el cliente. La operación es compatible con las cuentas de facturación con el tipo de contrato Microsoft Partner Agreement.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/billingRoleAssignments?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/billingRoleAssignments?api-version=2024-04-01&filter={filter}&top={top}&skip={skip}
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: |
customer
|
path | True |
string |
Identificador que identifica de forma única a un cliente. 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. |
filter
|
query |
string |
La opción de consulta de filtro permite a los clientes filtrar una colección de recursos que se abordan mediante una dirección URL de solicitud. |
|
skip
|
query |
integer int64 |
La opción omitir consulta solicita el número de elementos de la colección consultada que se omitirán y no se incluirán en el resultado. |
|
top
|
query |
integer int64 |
La opción de consulta superior solicita el número de elementos de la colección consultada que se incluirán en el resultado. El valor máximo admitido para top es 50. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Lista de las asignaciones de roles de facturación. |
|
Other Status Codes |
Respuesta de error que describe por qué se produjo un error en la operación. |
Ejemplos
BillingRoleAssignmentListByCustomer
Solicitud de ejemplo
GET 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/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments?api-version=2024-04-01
Respuesta de muestra
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments/30000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"name": "30000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "",
"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/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleDefinitions/30000000-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/customers/703ab484-dda2-4402-827b-a74513b61e2d",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/billingRoleAssignments"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments/30000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"name": "30000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "",
"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/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleDefinitions/30000000-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/customers/703ab484-dda2-4402-827b-a74513b61e2d",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/billingRoleAssignments"
}
]
}
Definiciones
Nombre | Description |
---|---|
Billing |
Propiedades de la asignación de roles de facturación. |
Billing |
Un contenedor para obtener una lista de recursos |
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" |
BillingRoleAssignmentListResult
Un contenedor para obtener una lista de recursos
Nombre | Tipo | Description |
---|---|---|
nextLink |
string |
Vínculo (url) a la página siguiente de resultados. |
value |
Lista de recursos. |
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. |