Microsoft Fabric REST API는 개발자가 패브릭을 자동화할 수 있도록 설계되었습니다. Fabric REST API 참조 페이지(설명서)는 개발자가 필요한 정보를 찾을 수 있도록 구조화되어 있습니다.
참조 페이지는 다음 두 개의 주요 섹션으로 나뉩니다.
핵심 API - 핵심 API는 Microsoft Fabric 내의 모든 항목에 대한 정보와 기능을 제공합니다. 핵심 API는 하나의 워크로드에만 국한되지 않으며 모든 워크로드에서 사용할 수 있습니다. 핵심 API는 CRUD(만들기, 읽기, 업데이트 및 삭제) API입니다. 이러한 항목을 사용하여 공통 속성과 함께 패브릭 항목을 만들거나 업데이트할 수 있습니다. 특정 항목 유형과 관련된 속성을 강제로 조작하지 않는 일괄 처리 작업을 실행하는 동안 핵심 API를 사용할 수 있습니다.
워크로드 API - 워크로드 API는 패브릭의 특정 항목 유형을 대상으로 합니다.
코어 및 워크로드 참조 페이지 섹션에는 모든 API가 사전순으로 나열됩니다. 각 섹션에는 섹션의 모든 API 목록과 섹션의 API 사전순 목록이 포함된 개요가 포함되어 있습니다.
항목별 입력
항목별 섹션에서는 Fabric에서 각 항목 형식의 세부 정보를 자세히 설명합니다. 각 항목 유형 항목에는 다음이 포함됩니다.
개요: 항목 유형에 대한 간략한 설명입니다.
엔드포인트: 매개 변수, 요청 및 응답 형식 및 예제에 대한 세부 정보와 함께 항목 유형에 사용 가능한 엔드포인트를 나열합니다.
모델: 속성 및 형식을 지정하여 항목 형식에 대한 데이터 모델을 정의합니다.
작업: 매개 변수, 요청 및 응답 형식 및 예제에 대한 세부 정보를 포함하여 항목 유형에 사용 가능한 작업을 나열합니다.
항목별 항목을 사용하여 특정 항목 유형과 관련된 API의 고유한 측면과 해당 항목 유형과 관련된 작업을 수행하는 방법에 대한 지침을 이해합니다.
참조 페이지 구조
각 참조 페이지에는 다음 섹션이 있습니다.
개요 - API를 설명하는 문서의 맨 위에 있는 짧은 단락입니다.
사용 권한 - API를 호출하는 데 필요한 사용자 권한 목록입니다.
필수 범위 - API에 필요한 권한 목록(범위라고도 함)
제한 사항 - (선택 사항) API에 대한 제한 사항 목록입니다.
인터페이스 - API의 HTTP 형식을 표시합니다.
URI 매개 변수 - 특정 리소스 또는 리소스를 식별하는 데 사용되는 매개 변수 목록입니다.
요청 본문 - API에 전달할 수 있는 속성 목록입니다.
응답 - API에서 가능한 응답 목록입니다.
예제 - API를 사용하는 방법을 보여 주는 예제 목록입니다.
정의 - API에 전달할 수 있는 개체의 구조 및 속성을 정의하는 매개 변수입니다.
새 API 설명서 참조 구조는 API 정보에 액세스하고 사용하는 명확하고 일관된 방법을 제공하기 위한 것입니다. CORE 섹션과 항목별 항목을 구분하여 개발자가 Microsoft Fabric 서비스와 통합하는 데 필요한 정보를 더 쉽게 찾고 사용할 수 있기를 바랍니다.
설명서 및 API를 개선하는 방법에 대한 피드백과 제안을 환영합니다.