Workspaces - Create Workspace
새 작업 영역을 만듭니다.
권한
- 호출자에게 패브릭 관리자가 부여한 작업 영역을 만들 수 있는 권한이 있어야 합니다. 자세한 내용은 작업 영역 만들기를 참조하세요.
- 호출자에게 는 참가자 권한이 있거나 용량에 대한 관리자여야 합니다. 자세한 내용은 용량 사용자 권한을 참조하세요.
- 서비스 주체에는 패브릭 관리자가 부여한 권한이 있어야 합니다. 자세한 내용은 서비스 주체가 작업 영역, 연결 및 배포 파이프라인을 만들 수 있습니다.
필요한 위임된 범위
작업 공간. 읽기쓰기. 전체
Microsoft Entra 지원 식별자
이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.
| 아이덴티티 | 지원 |
|---|---|
| 사용자 | 예 |
| 서비스 주체 및 관리 ID | 예 |
인터페이스
POST https://api.fabric.microsoft.com/v1/workspaces요청 본문
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| displayName | True |
string |
작업 영역 표시 이름입니다. |
| capacityId |
string (uuid) |
작업 영역을 할당할 용량의 ID입니다. |
|
| description |
string |
작업 영역 설명입니다. |
|
| domainId |
string (uuid) |
작업 영역을 할당할 도메인의 ID입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 201 Created |
성공적으로 만들어졌습니다. 헤더 Location: string |
|
| Other Status Codes |
일반적인 오류 코드:
|
예제
Create a workspace example
샘플 요청
POST https://api.fabric.microsoft.com/v1/workspaces
{
"displayName": "New workspace"
}
샘플 응답
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb22287ff{
"id": "cfafbeb1-8037-4d0c-896e-a46fb22287ff",
"displayName": "New workspace",
"description": "",
"type": "Workspace"
}정의
| Name | Description |
|---|---|
|
Create |
작업 영역 요청 페이로드를 만듭니다. |
|
Error |
오류 관련 리소스 세부 정보 개체입니다. |
|
Error |
오류 응답입니다. |
|
Error |
오류 응답 세부 정보입니다. |
| Workspace |
작업 영역 개체입니다. |
|
Workspace |
작업 영역 형식입니다. 추가 작업 영역 형식은 시간이 지남에 따라 추가될 수 있습니다. |
CreateWorkspaceRequest
작업 영역 요청 페이로드를 만듭니다.
| Name | 형식 | Description |
|---|---|---|
| capacityId |
string (uuid) |
작업 영역을 할당할 용량의 ID입니다. |
| description |
string |
작업 영역 설명입니다. |
| displayName |
string |
작업 영역 표시 이름입니다. |
| domainId |
string (uuid) |
작업 영역을 할당할 도메인의 ID입니다. |
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 |
오류 관련 리소스 세부 정보입니다. |
Workspace
작업 영역 개체입니다.
| Name | 형식 | Description |
|---|---|---|
| apiEndpoint |
string (uri) |
작업 영역과 관련된 API 엔드포인트를 나타내는 HTTP URL입니다. 이 엔드포인트 값은 사용자가 preferWorkspaceSpecificEndpoints를 사용하도록 설정하면 반환됩니다. 프라이빗 링크를 통해 API에 액세스할 수 있습니다. |
| capacityId |
string (uuid) |
작업 영역이 할당된 용량의 ID입니다. |
| description |
string |
작업 영역 설명입니다. |
| displayName |
string |
작업 영역 표시 이름입니다. |
| domainId |
string (uuid) |
작업 영역이 할당된 도메인의 ID입니다. |
| id |
string (uuid) |
작업 영역 ID입니다. |
| type |
작업 영역 형식입니다. |
WorkspaceType
작업 영역 형식입니다. 추가 작업 영역 형식은 시간이 지남에 따라 추가될 수 있습니다.
| 값 | Description |
|---|---|
| Personal |
사용자 항목을 관리하는 데 사용되는 내 폴더 또는 내 작업 영역입니다. |
| Workspace |
패브릭 항목을 관리하는 데 사용되는 작업 영역입니다. |
| AdminWorkspace |
관리자 모니터링 작업 영역. 감사 보고서, 사용 현황 및 채택 보고서와 같은 관리자 보고서를 포함합니다. |