Power Platform 인벤토리 API는 Azure Resource Graph의 PowerPlatformResources 테이블을 통해 현재 인벤토리 데이터를 제공합니다. API에는 핵심 리소스, 소유권, 환경 및 커넥터 정보가 포함되지만 해당 스키마는 데이터 내보내기 인벤토리 스키마와 다릅니다.
이 문서에서는 다음을 설명합니다.
- Power Platform 인벤토리 API를 통해 사용할 수 있는 인벤토리 데이터입니다.
- 데이터 내보내기에 사용할 수 없는 인벤토리 속성입니다.
- 부분적이거나 다른 적용 범위를 가진 속성입니다.
인벤토리 쿼리에 대한 자세한 내용은 Power Platform 인벤토리 API를 참조하세요. 전체 API 스키마는 Power Platform 인벤토리 스키마 참조를 참조하세요.
Note
Microsoft 데이터 내보내기의 미리 보기 버전을 종료합니다. 인벤토리 데이터 내보내기는 2026년 12월 1일까지만 지원됩니다. 사용량 및 환경 데이터 내보내기는 기존 및 새 구성에서 계속되며 이미 내보낸 데이터는 데이터 레이크에 남아 있습니다. 인벤토리 데이터 내보내기가 중지되면 Microsoft에서 또 다른 알림을 받게 됩니다.
준비하려면 Power Platform 인벤토리 API를 사용하여 인벤토리 데이터를 프로그래밍 방식으로 내보낼 수 있습니다. 마이그레이션하기 전에 필드 매핑 및 알려진 격차를 검토합니다. 일부 데이터 내보내기 인벤토리 필드는 API를 통해 사용할 수 없거나 적용 범위가 다릅니다.
Power Platform 인벤토리 API는 자동으로 데이터를 고객 소유 스토리지로 내보내지 않습니다. 되풀이 내보내기를 만들려면 Azure Functions, Azure Logic Apps 또는 Azure Automation 같은 Azure 서비스를 사용하여 일정에 따라 Power Platform 인벤토리 API를 쿼리하고 결과를 Azure Blob Storage, Azure Data Lake Storage 또는 지원되는 다른 대상에 작성합니다.
지원되는 리소스 유형
Power Platform 인벤토리 API에는 다음과 같은 리소스 종류가 포함됩니다.
| Resource | Power Platform 인벤토리 API 유형 |
|---|---|
| 캔버스 앱 | microsoft.powerapps/canvasapps |
| 모델 기반 앱 | microsoft.powerapps/modeldrivenapps |
| 코드 앱 | microsoft.powerapps/codeapps |
| 관리형 앱 및 App Builder 앱 | microsoft.powerapps/apps |
| 클라우드 흐름 | microsoft.powerautomate/cloudflows |
| 에이전트 흐름 | microsoft.powerautomate/agentflows |
| 워크플로 에이전트 흐름 | microsoft.powerautomate/m365agentflows |
| Copilot Studio 에이전트 | microsoft.copilotstudio/agents |
| Connectors | microsoft.powerplatformconnector/connectors |
| Environments | microsoft.powerplatform/environments |
| 환경 그룹 | microsoft.powerplatform/environmentgroups |
사용 가능한 인벤토리 데이터
다음 섹션에서는 리소스 종류 및 데이터 범주별로 사용 가능한 필드에 대해 설명합니다.
공유 리소스 정보
지원되는 리소스 유형에 대해 사용할 수 있는 다음 필드가 있습니다. 커넥터는 카탈로그 엔터티이며 인벤토리 스키마 참조에서 식별된 공유 필드만 지원합니다.
| 데이터 범주 | 사용 가능한 정보 | Power Platform 인벤토리 API 필드 |
|---|---|---|
| 리소스 ID | 고유 인벤토리 리소스 식별자 | name |
| 리소스 이름 | 리소스 표시 이름 | properties.displayName |
| 리소스 종류 | 표준화된 Power Platform 리소스 종류 | type |
| Tenant | 테넌트 식별자 | tenantId |
| Location | 리소스의 지리적 위치 | location |
| 생성일자 | 리소스가 생성된 날짜 및 시간 | properties.createdAt |
| 만든 사람 | 리소스를 만든 사용자의 개체 ID | properties.createdBy |
앱 정보
다음 정보는 지원되는 앱 유형에 대해 제공됩니다.
| 데이터 범주 | 사용 가능한 정보 | Power Platform 인벤토리 API 필드 |
|---|---|---|
| Owner | 앱 소유자의 개체 ID | properties.ownerId |
| Environment | 앱이 포함된 환경의 식별자 | properties.environmentId |
| 마지막 수정 | 앱이 마지막으로 수정된 날짜 및 시간 | properties.lastModifiedAt |
| 마지막 수정 날짜 | 앱을 마지막으로 수정한 사용자의 개체 ID | properties.lastModifiedBy |
| 격리 상태 | 앱이 격리되었는지 여부 | properties.isQuarantined |
| 모델 기반 앱 ID | Dataverse 앱-모듈 식별자 | properties.appModuleId |
| 모델 기반 앱 논리 이름 | Dataverse 논리 이름 | properties.logicalName |
| 코드 앱 하위 형식 |
byocApp 또는 vibeApp |
properties.subType |
| 관리되는 앱 하위 유형 | microsoftApp |
properties.subType |
| App Builder 하위 유형 | appBuilderApp |
properties.subType |
흐름 정보
다음 정보는 클라우드 흐름, 에이전트 흐름 및 워크플로 에이전트 흐름에 사용할 수 있습니다.
| 데이터 범주 | 사용 가능한 정보 | Power Platform 인벤토리 API 필드 |
|---|---|---|
| Owner | 흐름 소유자의 개체 ID | properties.ownerId |
| Environment | 흐름을 포함하는 환경의 식별자 | properties.environmentId |
| 마지막 수정 | 흐름이 마지막으로 수정된 날짜 및 시간 | properties.lastModifiedAt |
| 마지막 수정 날짜 | 흐름을 마지막으로 수정한 사용자의 개체 ID | properties.lastModifiedBy |
| 워크플로 엔터티 | Dataverse 워크플로 엔터티 식별자 | properties.workflowEntityId |
| 트리거 커넥터 | 흐름을 시작하는 커넥터 | properties.trigger |
| 트리거 동작 | 흐름을 시작하는 커넥터 작업 | properties.triggerOperation |
흐름이 되풀이 또는 수동 트리거와 같이 커넥터 기반이 아닌 트리거를 사용하는 경우 트리거 필드는 비어 있습니다.
커넥터 사용
지원되는 앱, 흐름 및 에이전트에서 커넥터 사용이 가능합니다.
| 데이터 범주 | 사용 가능한 정보 | Power Platform 인벤토리 API 필드 |
|---|---|---|
| 사용된 커넥터 | 리소스에서 사용하는 커넥터의 식별자 | properties.powerPlatformConnectors[].connectorId |
| 사용된 연산 | 커넥터에서 호출된 작업의 식별자 | properties.powerPlatformConnectors[].operations[].operationId |
| 흐름 시작 조건 | 지원되는 흐름을 시작하는 커넥터 | properties.trigger |
| 흐름 트리거 동작 | 지원되는 흐름을 시작하는 커넥터 작업 | properties.triggerOperation |
커넥터 및 작업 사용량 필드는 현재 미리 보기로 제공됩니다.
커넥터 카탈로그 정보
커넥터를 개별 인벤토리 리소스로 찾을 수도 있습니다.
| 데이터 범주 | 사용 가능한 정보 | Power Platform 인벤토리 API 필드 |
|---|---|---|
| 연결기 ID | 커넥터 식별자 | properties.connectorId |
| Description | 커넥터 설명 | properties.description |
| Publisher | 커넥터 퍼블리셔 | properties.publisher |
| Tier | 표준 또는 프리미엄 분류 | properties.tier |
| 배포 단계 | 프로덕션 또는 프리뷰와 같은 릴리스 종류 | properties.releaseTag |
| 사용 중단 상태 | 커넥터가 더 이상 사용되지 않는지 여부 | properties.isDeprecated |
| Operations | 커넥터에 의해 노출되는 작업 | properties.operations |
| 작업 ID | 고유 연산 식별자 | properties.operations[].operationId |
| 작업 이름 | 작업 표시 이름 | properties.operations[].displayName |
| 작업 설명 | 작업에 대한 설명 | properties.operations[].description |
| HTTP 메서드 | 작업에서 사용하는 HTTP 메서드 | properties.operations[].method |
환경 정보
환경 인벤토리 레코드에 대한 다음 정보를 찾을 수 있습니다.
| 데이터 범주 | 사용 가능한 정보 | Power Platform 인벤토리 API 필드 |
|---|---|---|
| 환경 ID | 고유 환경 식별자 | name |
| 환경 이름 | 환경 표시 이름 | properties.displayName |
| Location | 환경의 지리적 위치 | location |
| 환경 유형 | 프로덕션, 기본값, 샌드박스, 평가판, 개발자 또는 Dataverse for Teams | properties.environmentType |
| 관리 상태 | 환경이 관리되는 환경인지 여부 | properties.isManaged |
| 환경 그룹 | 할당된 환경 그룹의 이름 | properties.environmentGroup |
| 환경 그룹 ID | 할당된 환경 그룹의 식별자 | properties.environmentGroupId |
| 마지막 수정 | 환경이 마지막으로 수정된 날짜 및 시간 | properties.lastModifiedAt |
데이터를 사용할 수 없음
다음 데이터 내보내기 인벤토리 속성에는 게시된 Power Platform 인벤토리 API 스키마에 직접적인 동등한 항목이 없습니다.
| 데이터 범주 | Power Platform 인벤토리 API에서 사용할 수 없는 데이터 내보내기 인벤토리 정보 |
|---|---|
| 앱 설명 | 캔버스 또는 모델 기반 앱에 대한 설명 |
| 애플리케이션 링크 | 앱 URI, 문서 URI, 아이콘 URI 및 SharePoint 양식 URL |
| 공유 중 | 앱이 공유된 사용자 및 그룹 수 |
| 삭제 상태 | 명시적으로 삭제된 리소스 표시기 |
| 활성화 기록 | 앱을 마지막으로 사용하도록 설정한 날짜 및 앱을 사용하도록 설정한 주체 |
| 솔루션 및 ALM 정보 | 솔루션 연결 및 ALM 모드 |
| DLP 평가 | 평가 상태, 평가 날짜, 위반 메시지 및 정책별 위반 |
| 앱 구성 | 설정, 만들기 유형, 클라이언트 디바이스 유형, 임베딩 호스트, 사용자 지정 확장 및 성능 최적화 설정 |
| 앱 소개 | 배경 이미지, 배경색, Hero-app 지정, 추천 앱 지정 및 앱-플랜 분류 |
| 동의 및 라이선스 | 바이패스 동의 설정 및 앱 패스 자격 |
| 문서 버전 | 앱과 연결된 문서 버전 |
| 온-프레미스 게이트웨이 사용 | 앱이 온-프레미스 데이터 게이트웨이를 사용하는 명시적 표시기 |
| Dataverse 테이블 사용량 | 앱에서 Dataverse 테이블을 사용하는 명시적 표시기 |
| PCF 외부 서비스 사용 | Power Apps 구성 요소 프레임워크 컨트롤이 외부 서비스를 사용한다는 명시적 표시기 |
Important
properties.isQuarantined 는 앱이 격리되었는지 여부를 나타냅니다. 이는 데이터 내보내기 삭제 표시와 동등한 것이 아닙니다.
서로 다른 범위로 제공되는 데이터
일부 Power Platform 인벤토리 API 필드는 관련 정보를 제공하지만 데이터 내보내기 속성과 직접 동일하지는 않습니다.
| 데이터 범주 | 데이터 내보내기 목록 | Power Platform 인벤토리 API 적용 범위 |
|---|---|---|
| 리소스 종류 |
type 값과 subType 값을 분리 |
type의 표준화된 리소스 식별자.
properties.subType을(를) 제공하는 리소스 종류도 있습니다. |
| 상태 및 수명 주기 | 리소스 상태 및 수명 주기 상태 | 격리 상태는 지원되는 앱 유형에 사용할 수 있지만 모든 상태 또는 수명 주기 값을 나타내지는 않습니다. |
| Owner | 소유자 값 및 소유자 개체 ID |
properties.ownerId 는 사용 가능한 경우 개체 ID를 제공합니다. 소유자 표시 이름이 포함되지 않음 |
| 사용자 지정 API 사용 | 명시적 사용자 지정 API 표시기 | 커넥터 식별자는 지원되는 리소스에 사용할 수 있지만 동등한 사용자 지정 API 표시기를 사용할 수 없습니다. |
| 프리미엄 커넥터 사용 | 명시적 프리미엄 API 표시기 | 커넥터 계층은 커넥터 인벤토리 레코드에서 사용할 수 있지만 동등한 리소스 수준 표시기를 사용할 수 없습니다. |
| 워크플로 작업 | 워크플로 작업 및 커넥터 관련 지표 | 구조적 커넥터 및 작업 식별자는 지원되는 리소스 종류에 대해 제공됩니다. |
| 환경 정보 | 리소스에 있는 환경 식별자 및 별도의 환경 내보내기 데이터 | 리소스에는 properties.environmentId가 포함됩니다. 환경 세부 정보는 환경 인벤토리 레코드를 통해 사용할 수 있습니다. |
식별자 매핑
리소스 식별자는 데이터 내보내기 및 Power Platform 인벤토리 API에서 동일하게 표시되지 않습니다.
모델 기반 앱
모델 기반 앱에 대해 다음 매핑을 사용합니다.
| 데이터 내보내기 인벤토리 필드 | Power Platform 인벤토리 API 필드 |
|---|---|
environmentId |
properties.environmentId |
resourceId |
properties.appModuleId |
name |
properties.displayName |
type 및 subType |
type |
Power Platform 인벤토리 API 최상위 name 필드는 고유한 인벤토리 리소스 식별자입니다. 모델 기반 앱의 데이터 내보내기 resourceId와 동일하지 않습니다.
두 스키마 간에 모델 기반 앱을 연결하려면 properties.appModuleId 및 properties.environmentId를 모두 사용하세요.
커넥터 재고 제한 사항
커넥터 인벤토리에는 다음과 같은 문서화된 제한 사항이 있습니다.
- 테이블 형식 커넥터는 빈 작업 배열과 함께 나타날 수 있습니다.
- HTTP, 컨트롤 및 데이터 작업을 비롯한 기본 제공 Power Automate 작업은 커넥터로 표시되지 않습니다.
- 코드 앱, 바이브 앱, 관리되는 앱 및 App Builder 앱은 커넥터 사용량 데이터를 내보내지 않습니다.
- 모델 기반 앱은 커넥터에서 직접 보고하지는 않는 경우가 거의 없습니다.
- 임베드된 캔버스 페이지의 커넥터 사용량은 이를 포함하는 모델 기반 앱 대신 캔버스 페이지 레코드와 연결됩니다.
- 리소스별 커넥터 데이터에는 커넥터 및 작업 식별자가 포함되지만 커넥터 표시 이름, 게시자 정보 또는 계층은 포함되지 않습니다.
- 커넥터 표시 이름, 게시자 정보 및 계층은 커넥터 인벤토리 레코드에서 사용할 수 있습니다.
- 커넥터 존재 여부는 온-프레미스 게이트웨이가 사용되는지 여부를 나타내지 않습니다.