Billing Role Assignments - Resolve By Customer
Lista as atribuições de função para o chamador em um cliente enquanto busca informações do usuário para cada atribuição de função. A operação é suportada para contas de cobrança com contrato do tipo Microsoft Partner Agreement.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/resolveBillingRoleAssignments?api-version=2024-04-01
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/resolveBillingRoleAssignments?resolveScopeDisplayNames={resolveScopeDisplayNames}&api-version=2024-04-01&filter={filter}
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
billing
|
path | True |
string |
O ID que identifica exclusivamente uma conta de cobrança. Padrão Regex: |
billing
|
path | True |
string |
O ID que identifica exclusivamente um perfil de faturamento. Padrão Regex: |
customer
|
path | True |
string |
O ID que identifica exclusivamente um cliente. Padrão Regex: |
api-version
|
query | True |
string |
A versão da API a ser usada com a solicitação do cliente. A versão atual é 2024-04-01. |
filter
|
query |
string |
A opção de consulta de filtro permite que os clientes filtrem uma coleção de recursos que são endereçados por uma URL de solicitação. |
|
resolve
|
query |
boolean |
Resolve o nome de exibição do escopo para cada uma das atribuições de função. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
A lista das atribuições de função de cobrança. |
|
202 Accepted |
A lista das atribuições de função de cobrança. Cabeçalhos
|
|
Other Status Codes |
Resposta de erro descrevendo por que a operação falhou. |
Exemplos
ResolveBillingRoleAssignmentByCustomer
Pedido de amostra
POST 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/customers/703ab484-dda2-4402-827b-a74513b61e2d/resolveBillingRoleAssignments?api-version=2024-04-01
Resposta da amostra
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/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": "00000000-0000-0000-0000-000000000001",
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "c360d6f1-2709-476d-81bb-d075b213d9fc",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/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/xxxx-xxxx-xxx-xxx/customers/703ab484-dda2-4402-827b-a74513b61e2d",
"userEmailAddress": "foo@bar.com",
"principalTenantName": "Foo Bar",
"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/xxxx-xxxx-xxx-xxx/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": "00000000-0000-0000-0000-000000000001",
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "c360d6f1-2709-476d-81bb-d075b213d9fc",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/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/xxxx-xxxx-xxx-xxx/customers/703ab484-dda2-4402-827b-a74513b61e2d",
"userEmailAddress": "foo@bar.com",
"principalTenantName": "Foo Bar",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/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/customers/703ab484-dda2-4402-827b-a74513b61e2d/operationResults/resolveBillingRoleAssignments_10000000-0000-0000-0000-000000000001?api-version=2024-04-01
retry-after: 5
Definições
Name | Description |
---|---|
Billing |
As propriedades da atribuição de função de cobrança. |
Billing |
Um contêiner para uma lista de recursos |
Billing |
As propriedades da atribuição de função de cobrança. |
created |
O tipo de identidade que criou o recurso. |
Error |
O erro de gerenciamento de recursos informações adicionais. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
Principal |
O tipo de uma atribuição de função. |
Provisioning |
O estado de provisionamento do recurso durante uma operação de longa duração. |
system |
Metadados referentes à criação e última modificação do recurso. |
BillingRoleAssignment
As propriedades da atribuição de função de cobrança.
Name | Tipo | Description |
---|---|---|
id |
string |
ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
O nome do recurso |
properties |
As propriedades da atribuição de função de cobrança. |
|
systemData |
Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy. |
|
tags |
object |
Dicionário de metadados associados ao recurso. Ele pode não ser preenchido para todos os tipos de recursos. Comprimento máximo de chave/valor suportado de 256 caracteres. Chaves/valor não devem esvaziar valor nem nulo. As chaves não podem conter <> % & \ ? / |
type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
BillingRoleAssignmentListResult
Um contêiner para uma lista de recursos
Name | Tipo | Description |
---|---|---|
nextLink |
string |
O link (url) para a próxima página de resultados. |
value |
A lista de recursos. |
BillingRoleAssignmentProperties
As propriedades da atribuição de função de cobrança.
Name | Tipo | Description |
---|---|---|
billingAccountDisplayName |
string |
O nome da conta de cobrança. |
billingAccountId |
string |
O ID totalmente qualificado que identifica exclusivamente uma conta de cobrança. |
billingProfileDisplayName |
string |
O nome do perfil de cobrança. |
billingProfileId |
string |
O ID totalmente qualificado que identifica exclusivamente um perfil de faturamento. |
billingRequestId |
string |
A ID da solicitação de cobrança que foi criada para a atribuição de função. Isso só é aplicável a atribuições de função entre locatários ou atribuições de função criadas por meio da solicitação de cobrança. |
createdByPrincipalId |
string |
A ID do objeto do usuário que criou a atribuição de função. |
createdByPrincipalPuid |
string |
O PUID principal do usuário que criou a atribuição de função. |
createdByPrincipalTenantId |
string |
A ID do locatário do usuário que criou a atribuição de função. |
createdByUserEmailAddress |
string |
O endereço de e-mail do usuário que criou a atribuição de função. Isso é suportado apenas para contas de cobrança com tipo de contrato Enterprise Agreement. |
createdOn |
string |
A data em que a atribuição de função foi criada. |
customerDisplayName |
string |
O nome do cliente. |
customerId |
string |
O ID totalmente qualificado que identifica exclusivamente um cliente. |
invoiceSectionDisplayName |
string |
O nome da seção da fatura. |
invoiceSectionId |
string |
O ID totalmente qualificado que identifica exclusivamente uma seção de fatura. |
modifiedByPrincipalId |
string |
O PUID principal do usuário que modificou a atribuição de função. |
modifiedByPrincipalPuid |
string |
O PUID principal do usuário que modificou a atribuição de função. |
modifiedByPrincipalTenantId |
string |
A ID do locatário do usuário que modificou a atribuição de função. |
modifiedByUserEmailAddress |
string |
O endereço de e-mail do usuário que modificou a atribuição de função. Isso é suportado apenas para contas de cobrança com tipo de contrato Enterprise Agreement. |
modifiedOn |
string |
A data em que a atribuição de função foi modificada. |
principalDisplayName |
string |
O nome para exibição do principal ao qual a função foi atribuída. |
principalId |
string |
A id do objeto do usuário ao qual a função foi atribuída. |
principalPuid |
string |
O PUID principal do usuário ao qual a função foi atribuída. |
principalTenantId |
string |
A ID do locatário principal do usuário ao qual a função foi atribuída. |
principalTenantName |
string |
O nome amigável do locatário do usuário ao qual a função foi atribuída. Este será o "Inquilino principal" para o inquilino principal da conta de faturação. |
principalType |
O tipo de uma atribuição de função. |
|
provisioningState |
O estado de provisionamento do recurso durante uma operação de longa duração. |
|
roleDefinitionId |
string |
A ID da definição de função. |
scope |
string |
O escopo no qual a função foi atribuída. |
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 é suportado apenas para contas de cobrança com tipo de contrato Enterprise Agreement. |
userEmailAddress |
string |
O endereço de e-mail do usuário ao qual a função foi atribuída. Isso é suportado apenas para contas de cobrança com tipo de contrato Enterprise Agreement. |
createdByType
O tipo de identidade que criou o recurso.
Name | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
O erro de gerenciamento de recursos informações adicionais.
Name | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
Name | Tipo | Description |
---|---|---|
additionalInfo |
O erro informações adicionais. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
PrincipalType
O tipo de uma atribuição de função.
Name | Tipo | Description |
---|---|---|
DirectoryRole |
string |
|
Everyone |
string |
|
Group |
string |
|
None |
string |
|
ServicePrincipal |
string |
|
Unknown |
string |
|
User |
string |
ProvisioningState
O estado de provisionamento do recurso durante uma operação de longa duração.
Name | Tipo | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
systemData
Metadados referentes à criação e última modificação do recurso.
Name | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |