Billing Role Assignments - List By Invoice Section

Служба:: Billing

Версия API:: 2024-04-01

Выводит список назначений ролей для вызывающего объекта в разделе счета. Эта операция поддерживается для учетных записей выставления счетов с типом клиентского соглашения Майкрософт.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments?api-version=2024-04-01

С использованием необязательных параметров:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments?api-version=2024-04-01&filter={filter}&top={top}&skip={skip}

Параметры URI

Имя	В	Обязательно	Тип	Описание
billingAccountName	path	True	string pattern: ^([0-9]+\|([Pp][Cc][Nn]\.[A-Za-z0-9]+)\|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$	Идентификатор, который однозначно идентифицирует учетную запись выставления счетов.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Идентификатор, который однозначно идентифицирует профиль выставления счетов.
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Идентификатор, который однозначно идентифицирует раздел счета.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
filter	query		string	Параметр запроса фильтра позволяет клиентам фильтровать коллекцию ресурсов, адресованных URL-адресом запроса.
skip	query		integer (int64)	Параметр пропуска запроса запрашивает количество элементов в запрашиваемой коллекции, которые должны быть пропущены и не включены в результат.
top	query		integer (int64)	Верхний параметр запроса запрашивает количество элементов в запрашиваемой коллекции, которые будут включены в результат. Максимальное поддерживаемое значение для верхней части — 50.

Ответы

Имя	Тип	Описание
200 OK	BillingRoleAssignmentListResult	Операция Azure успешно завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

BillingRoleAssignmentListByInvoiceSection

Образец запроса

HTTP

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/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleAssignments?api-version=2024-04-01

Пример ответа

Код состояния:: 200

{
  "value": [
    {
      "name": "10000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
      "type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections/billingRoleAssignments",
      "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_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
      "properties": {
        "createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
        "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
        "createdOn": "2023-10-19T20:10:50.1028398Z",
        "principalId": "00000000-0000-0000-0000-000000000000",
        "principalType": "User",
        "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/30000000-aaaa-bbbb-cccc-100000000002",
        "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"
      }
    },
    {
      "name": "10000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
      "type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections/billingRoleAssignments",
      "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_b1839933-b3ac-42ca-8112-d29c43f3ab47",
      "properties": {
        "createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
        "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
        "createdOn": "2023-10-19T20:10:50.1028398Z",
        "principalId": "00000000-0000-0000-0000-000000000000",
        "principalType": "User",
        "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/30000000-aaaa-bbbb-cccc-100000000001",
        "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"
      }
    }
  ]
}

Определения

Имя	Описание
BillingRoleAssignment	Свойства назначения роли выставления счетов.
BillingRoleAssignmentListResult	Страница сборника пунктов BillingRoleAssignment
BillingRoleAssignmentProperties	Свойства назначения роли выставления счетов.
createdByType	Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
PrincipalType	Тип назначения роли.
ProvisioningState	Состояние подготовки ресурса во время длительной операции.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

BillingRoleAssignment

Объект

Свойства назначения роли выставления счетов.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties	BillingRoleAssignmentProperties	Свойства назначения роли выставления счетов.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Словарь метаданных, связанных с ресурсом. Он не может быть заполнен для всех типов ресурсов. Максимальная длина ключа и значения, поддерживаемая 256 символами. Ключи или значение не должны пустыми значениями и значениями NULL. Ключи не могут содержать <> % & \ ? /
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

BillingRoleAssignmentListResult

Объект

Страница сборника пунктов BillingRoleAssignment

Имя	Тип	Описание
nextLink	string (uri)	Ссылка на следующую страницу элементов
value	BillingRoleAssignment[]	Пункты BillingRoleAssignment на этой странице

BillingRoleAssignmentProperties

Объект

Свойства назначения роли выставления счетов.

Имя	Тип	Описание
billingAccountDisplayName	string	Имя учетной записи выставления счетов.
billingAccountId	string	Полный идентификатор, который однозначно идентифицирует учетную запись выставления счетов.
billingProfileDisplayName	string	Имя профиля выставления счетов.
billingProfileId	string	Полный идентификатор, который однозначно идентифицирует профиль выставления счетов.
billingRequestId	string	Идентификатор запроса на выставление счетов, созданного для назначения роли. Это применимо только к назначениям ролей клиента или назначениям ролей, созданным с помощью запроса выставления счетов.
createdByPrincipalId	string	Идентификатор объекта пользователя, создавшего назначение роли.
createdByPrincipalPuid	string	Основной PUID пользователя, создавшего назначение роли.
createdByPrincipalTenantId	string	Идентификатор клиента пользователя, создавшего назначение роли.
createdByUserEmailAddress	string	Адрес электронной почты пользователя, создавшего назначение роли. Это поддерживается только для учетных записей выставления счетов с типом соглашения Enterprise.
createdOn	string (date-time)	Дата создания назначения роли.
customerDisplayName	string	Имя клиента.
customerId	string	Полный идентификатор, который однозначно идентифицирует клиента.
invoiceSectionDisplayName	string	Имя раздела счета.
invoiceSectionId	string	Полный идентификатор, который однозначно идентифицирует раздел счета.
modifiedByPrincipalId	string	Основной PUID пользователя, который изменил назначение роли.
modifiedByPrincipalPuid	string	Основной PUID пользователя, который изменил назначение роли.
modifiedByPrincipalTenantId	string	Идентификатор клиента пользователя, изменившего назначение роли.
modifiedByUserEmailAddress	string	Адрес электронной почты пользователя, изменившего назначение роли. Это поддерживается только для учетных записей выставления счетов с типом соглашения Enterprise.
modifiedOn	string (date-time)	Дата изменения назначения роли.
principalDisplayName	string	Отображаемое имя субъекта, которому назначена роль.
principalId	string	Идентификатор объекта пользователя, которому была назначена роль.
principalPuid	string	Основной PUID пользователя, которому назначена роль.
principalTenantId	string	Идентификатор основного клиента пользователя, которому назначена роль.
principalTenantName	string	Понятное имя клиента пользователя, которому назначена роль. Это будет "основной клиент" для основного клиента учетной записи выставления счетов.
principalType	PrincipalType	Тип назначения роли.
provisioningState	ProvisioningState	Состояние подготовки ресурса во время длительной операции.
roleDefinitionId	string minLength: 1	Идентификатор определения роли.
scope	string	Область назначения роли.
userAuthenticationType	string	Тип проверки подлинности пользователя( организации или MSA) пользователя, которому назначена роль. Это поддерживается только для учетных записей выставления счетов с типом соглашения Enterprise.
userEmailAddress	string	Адрес электронной почты пользователя, которому назначена роль. Это поддерживается только для учетных записей выставления счетов с типом соглашения Enterprise.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

PrincipalType

Перечисление

Тип назначения роли.

Значение	Описание
Unknown	Неизвестно
None	Нет
User	User
Group	Группа
DirectoryRole	DirectoryRole
ServicePrincipal	Сервисный принципал (ServicePrincipal)
Everyone	Все

ProvisioningState

Перечисление

Состояние подготовки ресурса во время длительной операции.

Значение	Описание
Succeeded	Succeeded
Canceled	Отменено
Failed	Неудача
New	Новое
Pending	В ожидании
Provisioning	Provisioning
PendingBilling	Ожидается выставление счетов
ConfirmedBilling	ПодтвержденоВыставление счетов
Creating	Создавать
Created	Создано
Expired	Срок действия истек

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

Поделиться через

Billing Role Assignments - List By Invoice Section

Параметры URI

Ответы

Безопасность

azure_auth

Области

Примеры

BillingRoleAssignmentListByInvoiceSection

Образец запроса

Пример ответа

Определения

BillingRoleAssignment

BillingRoleAssignmentListResult

BillingRoleAssignmentProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrincipalType

ProvisioningState

systemData