External Data Shares Provider - Delete External Data Share
지정된 외부 데이터 공유를 삭제합니다.
권한
호출자에게 항목에 대한 읽기 및 다시 공유 권한이 있어야 합니다.
필요한 위임된 범위
항목 API는 토큰에 다음 범위 중 하나를 포함할 수 있습니다.
- 제네릭 범위: Item.ExternalDataShare.All
- 특정 범위: itemType. ExternalDataShare.All, 예: Lakehouse.ExternalDataShare.All
범위에 대한 자세한 내용은 범위 문서참조하세요.
필수 테넌트 설정
이 API를 사용하려면 호출 주체에 대해 외부 데이터 공유 관리자 스위치를 사용하도록 설정합니다.
제한점
분당 최대 10개의 요청.
Microsoft Entra 지원 식별자
이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.
| 아이덴티티 | 지원 |
|---|---|
| 사용자 | 예 |
| 서비스 주체 및 관리 ID | 예 |
인터페이스
DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/externalDataShares/{externalDataShareId}
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
external
|
path | True |
string (uuid) |
외부 데이터 공유 ID입니다. |
|
item
|
path | True |
string (uuid) |
항목 ID입니다. |
|
workspace
|
path | True |
string (uuid) |
작업 영역 ID입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
요청이 성공적으로 완료되었습니다. |
|
| Other Status Codes |
일반적인 오류 코드:
|
예제
Delete external data share example
샘플 요청
DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/externalDataShares/dccc162f-7a41-4720-83c3-5c7e81187959
샘플 응답
정의
| Name | Description |
|---|---|
|
Error |
오류 관련 리소스 세부 정보 개체입니다. |
|
Error |
오류 응답입니다. |
|
Error |
오류 응답 세부 정보입니다. |
ErrorRelatedResource
오류 관련 리소스 세부 정보 개체입니다.
| Name | 형식 | Description |
|---|---|---|
| resourceId |
string |
오류와 관련된 리소스 ID입니다. |
| resourceType |
string |
오류와 관련된 리소스의 형식입니다. |
ErrorResponse
오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| errorCode |
string |
오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다. |
| message |
string |
사용자가 읽을 수 있는 오류 표현입니다. |
| moreDetails |
추가 오류 세부 정보 목록입니다. |
|
| relatedResource |
오류 관련 리소스 세부 정보입니다. |
|
| requestId |
string |
오류와 연결된 요청의 ID입니다. |
ErrorResponseDetails
오류 응답 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| errorCode |
string |
오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다. |
| message |
string |
사용자가 읽을 수 있는 오류 표현입니다. |
| relatedResource |
오류 관련 리소스 세부 정보입니다. |