Billing Role Assignments - List By Invoice Section

서비스:: Billing

API 버전:: 2024-04-01

청구서 섹션에서 호출자에 대한 역할 할당을 나열합니다. 이 작업은 계약 유형이 Microsoft 고객 계약인 청구 계정에 대해 지원됩니다.

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 매개 변수

Name	In(다음 안에)	필수	형식	Description
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})?)$	청구 계정을 고유하게 식별하는 ID입니다.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	청구 프로필을 고유하게 식별하는 ID입니다.
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	청구서 섹션을 고유하게 식별하는 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
filter	query		string	필터 쿼리 옵션을 사용하면 클라이언트가 요청 URL로 처리되는 리소스 컬렉션을 필터링할 수 있습니다.
skip	query		integer (int64)	건너뛰기 쿼리 옵션은 건너뛰고 결과에 포함되지 않을 쿼리된 컬렉션의 항목 수를 요청합니다.
top	query		integer (int64)	최상위 쿼리 옵션은 쿼리된 컬렉션의 항목 수를 결과에 포함하도록 요청합니다. 상위에 지원되는 최대값은 50입니다.

응답

Name	형식	Description
200 OK	BillingRoleAssignmentListResult	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
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"
      }
    }
  ]
}

정의

Name	Description
BillingRoleAssignment	청구 역할 할당의 속성입니다.
BillingRoleAssignmentListResult	BillingRoleAssignment 항목의 페이지드 컬렉션
BillingRoleAssignmentProperties	청구 역할 할당의 속성입니다.
createdByType	리소스를 만든 ID의 형식입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
PrincipalType	역할 할당의 유형입니다.
ProvisioningState	장기 실행 작업 중 리소스의 프로비전 상태입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

BillingRoleAssignment

Object

청구 역할 할당의 속성입니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름
properties	BillingRoleAssignmentProperties	청구 역할 할당의 속성입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스와 연결된 메타데이터의 사전입니다. 모든 리소스 종류에 대해 채워지지 않을 수 있습니다. 최대 키/값 길이는 256자로 지원됩니다. 키/값은 값이나 null을 비워서는 안 됩니다. 키에는 <> % & \ ? /
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

BillingRoleAssignmentListResult

Object

BillingRoleAssignment 항목의 페이지드 컬렉션

Name	형식	Description
nextLink	string (uri)	항목의 다음 페이지에 대한 링크
value	BillingRoleAssignment[]	이 페이지의 BillingRoleAssignment 항목들

BillingRoleAssignmentProperties

Object

청구 역할 할당의 속성입니다.

Name	형식	Description
billingAccountDisplayName	string	청구 계정의 이름입니다.
billingAccountId	string	청구 계정을 고유하게 식별하는 정규화된 ID입니다.
billingProfileDisplayName	string	청구 프로필의 이름입니다.
billingProfileId	string	청구 프로필을 고유하게 식별하는 정규화된 ID입니다.
billingRequestId	string	역할 할당에 대해 생성된 청구 요청의 ID입니다. 이는 청구 요청을 통해 만든 교차 테넌트 역할 할당 또는 역할 할당에만 적용됩니다.
createdByPrincipalId	string	역할 할당을 만든 사용자의 개체 ID입니다.
createdByPrincipalPuid	string	역할 할당을 만든 사용자의 주요 PUID입니다.
createdByPrincipalTenantId	string	역할 할당을 만든 사용자의 테넌트 ID입니다.
createdByUserEmailAddress	string	역할 할당을 만든 사용자의 이메일 주소입니다. 이는 규약 유형 기업계약이 있는 청구 계정에 대해서만 지원됩니다.
createdOn	string (date-time)	역할 할당이 만들어진 날짜입니다.
customerDisplayName	string	고객의 이름입니다.
customerId	string	고객을 고유하게 식별하는 정규화된 ID입니다.
invoiceSectionDisplayName	string	청구서 섹션의 이름입니다.
invoiceSectionId	string	청구서 섹션을 고유하게 식별하는 정규화된 ID입니다.
modifiedByPrincipalId	string	역할 할당을 수정한 사용자의 주요 PUID입니다.
modifiedByPrincipalPuid	string	역할 할당을 수정한 사용자의 주요 PUID입니다.
modifiedByPrincipalTenantId	string	역할 할당을 수정한 사용자의 테넌트 ID입니다.
modifiedByUserEmailAddress	string	역할 할당을 수정한 사용자의 이메일 주소입니다. 이는 규약 유형 기업계약이 있는 청구 계정에 대해서만 지원됩니다.
modifiedOn	string (date-time)	역할 할당이 수정된 날짜입니다.
principalDisplayName	string	역할이 할당된 보안 주체의 표시 이름입니다.
principalId	string	역할이 할당된 사용자의 개체 ID입니다.
principalPuid	string	역할이 할당된 사용자의 주요 PUID입니다.
principalTenantId	string	역할이 할당된 사용자의 주 테넌트 ID입니다.
principalTenantName	string	역할이 할당된 사용자의 테넌트 이름입니다. 청구 계정의 기본 테넌트에 대한 '기본 테넌트'가 됩니다.
principalType	PrincipalType	역할 할당의 유형입니다.
provisioningState	ProvisioningState	장기 실행 작업 중 리소스의 프로비전 상태입니다.
roleDefinitionId	string minLength: 1	역할 정의의 ID입니다.
scope	string	역할이 할당된 범위입니다.
userAuthenticationType	string	역할이 할당된 사용자의 인증 유형(조직 또는 MSA)입니다. 이는 규약 유형 기업계약이 있는 청구 계정에 대해서만 지원됩니다.
userEmailAddress	string	역할이 할당된 사용자의 이메일 주소입니다. 이는 규약 유형 기업계약이 있는 청구 계정에 대해서만 지원됩니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

PrincipalType

열거형

역할 할당의 유형입니다.

값	Description
Unknown	알 수 없음
None	없음
User	사용자
Group	그룹
DirectoryRole	디렉터리 역할
ServicePrincipal	서비스프린시펄 (ServicePrincipal)
Everyone	Everyone

ProvisioningState

열거형

장기 실행 작업 중 리소스의 프로비전 상태입니다.

값	Description
Succeeded	성공함
Canceled	취소됨
Failed	실패
New	새롭다
Pending	보류 중
Provisioning	Provisioning
PendingBilling	청구 대기 중입니다
ConfirmedBilling	확인된 청구
Creating	만들기
Created	생성됨
Expired	만료됨

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

다음을 통해 공유

Billing Role Assignments - List By Invoice Section

URI 매개 변수

응답

보안

azure_auth

범위

예제

BillingRoleAssignmentListByInvoiceSection

샘플 요청

샘플 응답

정의

BillingRoleAssignment

BillingRoleAssignmentListResult

BillingRoleAssignmentProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrincipalType

ProvisioningState

systemData