Workspaces - Create Workspace

서비스:
Core
API 버전:
v1

새 작업 영역을 만듭니다.

권한

필요한 위임된 범위

작업 공간. 읽기쓰기. 전체

스로틀 제한

한도 유형 Value
플랫폼 API에 대한 통합 할당량 200 통화/분
API 제한 200 통화/분

Microsoft Entra 지원 식별자

이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.

아이덴티티 지원
사용자 예
서비스 주체 및 관리 ID 예

인터페이스

POST https://api.fabric.microsoft.com/v1/workspaces

요청 본문

속성 필수 형식 Description
displayName True

string

작업 영역 표시 이름입니다.
표시 이름에는 256자를 초과할 수 없습니다.
사용되지 않는 작업 영역 이름만 허용됩니다.
"관리자 모니터링"은 예약된 작업 영역 이름입니다.
capacityId

string (uuid)

작업 영역을 할당할 용량의 ID입니다.
description

string

작업 영역 설명입니다.
설명은 4000자를 초과할 수 없습니다.
domainId

string (uuid)

작업 영역을 할당할 도메인의 ID입니다.

응답

속성 형식 Description
201 Created

Workspace

성공적으로 만들어졌습니다.

헤더

Location: string
429 Too Many Requests

ErrorResponse

서비스 속도 제한을 초과했습니다. 서버는 클라이언트가 Retry-After 추가 요청을 보내기 전에 대기해야 하는 시간을 초 단위로 나타내는 헤더를 반환합니다.

헤더

Retry-After: integer
Other Status Codes

ErrorResponse

일반적인 오류 코드:

  • DomainNotFound - 제공된 도메인을 찾을 수 없습니다.

  • InsufficientPermissionsToDomain - 도메인에 대한 사용자 권한만으로는 작업을 수행할 수 없습니다.

  • UnknownError - 오류가 발생했습니다.

예제

Create a workspace example

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces

{
  "displayName": "New workspace"
}

샘플 응답

상태 코드:
201 
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",
  "capacityRegion": "West US"
}

정의

속성 Description
CapacityRegion

이 작업 영역과 연결된 용량의 영역입니다. 추가 용량 지역 값은 시간이 지남에 따라 추가될 수 있습니다.
CreateWorkspaceRequest

작업 영역 요청 페이로드를 만듭니다.
ErrorParameter

오류에 대해 머신에서 읽을 수 있는 추가 컨텍스트를 제공하는 구조적 매개 변수입니다.
ErrorRelatedResource

오류 관련 리소스 세부 정보 개체입니다.
ErrorResponse

오류 응답입니다.
ErrorResponseDetails

오류 응답 세부 정보입니다.
Workspace

작업 영역 개체입니다.
WorkspaceAppliedTag

적용된 태그를 나타냅니다.
WorkspaceType

작업 영역 형식입니다. 추가 작업 영역 형식은 시간이 지남에 따라 추가될 수 있습니다.

CapacityRegion

열거형

이 작업 영역과 연결된 용량의 영역입니다. 추가 용량 지역 값은 시간이 지남에 따라 추가될 수 있습니다.

값 Description
Australia East

오스트레일리아 동부 지역
Australia Southeast

오스트레일리아 남동부 지역
Brazil South

브라질 남부 지역
Brazil Southeast

브라질 남동부 지역
Canada Central

캐나다 중부 지역
Canada East

캐나다 동부 지역
Central India

인도 중부 지역
Central US

미국 중부 지역
Central US EUAP

미국 중부 EUAP 지역
East Asia

동아시아 지역
East US

미국 동부 지역
East US 2

미국 동부 2 지역
France Central

프랑스 중부 지역
France South

프랑스 남부 지역
Germany Central

독일 중부 지역
Germany Northeast

독일 북동부 지역
Israel Central

이스라엘 중부 지역
Italy North

이탈리아 북부 지역
Japan East

일본 동부 지역
Japan West

일본 서부 지역
Korea Central

한국 중부 지역
Korea South

대한민국 남부 지역
Mexico Central

멕시코 중부 지역
North Central US

미국 중북부 지역
North Europe

북유럽 지역
Norway East

노르웨이 동부 지역
Norway West

노르웨이 서부 지역
Poland Central

폴란드 중부 지역
South Africa North

남아프리카 북부 지역
South Africa West

남아프리카 서부 지역
South Central US

미국 중남부 지역
South India

인도 남부 지역
Southeast Asia

동남 아시아 지역
Spain Central

스페인 중부 지역
Sweden Central

스웨덴 중부 지역
Switzerland North

스위스 북부 지역
Switzerland West

스위스 서부 지역
West Europe

서유럽 지역
West India

인도 서부 지역
West US

미국 서부 지역
West US 2

미국 서부 2 지역
West US 3

미국 서부 3 지역
West Central US

미국 중서부 지역
UAE Central

UAE 중부 지역
UAE North

UAE 북부 지역
Qatar Central

카타르 중부 지역
Germany West Central

독일 중서부 지역
Germany North

독일 북부 지역
UK South

영국 남부 지역
UK West

영국 서부 지역
China North

중국 북부 지역
China East

중국 동부 지역
China East 2

중국 동부 2 지역
China East 3

중국 동부 3 지역
China North 2

중국 북부 2 지역
China North 3

중국 북부 3 지역

CreateWorkspaceRequest

Object

작업 영역 요청 페이로드를 만듭니다.

속성 형식 Description
capacityId

string (uuid)

작업 영역을 할당할 용량의 ID입니다.
description

string

작업 영역 설명입니다.
설명은 4000자를 초과할 수 없습니다.
displayName

string

작업 영역 표시 이름입니다.
표시 이름에는 256자를 초과할 수 없습니다.
사용되지 않는 작업 영역 이름만 허용됩니다.
"관리자 모니터링"은 예약된 작업 영역 이름입니다.
domainId

string (uuid)

작업 영역을 할당할 도메인의 ID입니다.

ErrorParameter

Object

오류에 대해 머신에서 읽을 수 있는 추가 컨텍스트를 제공하는 구조적 매개 변수입니다.

속성 형식 Description
message

string

매개 변수의 의미에 대한 사람이 읽을 수 있는 설명입니다.
name

string

매개변수 식별자입니다.
value

string

매개 변수 값입니다.

ErrorRelatedResource

Object

오류 관련 리소스 세부 정보 개체입니다.

속성 형식 Description
resourceId

string

오류와 관련된 리소스 ID입니다.
resourceType

string

오류와 관련된 리소스의 형식입니다.

ErrorResponse

Object

오류 응답입니다.

속성 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
isRetriable

boolean

true이면 요청을 다시 시도 할 수 있습니다. 응답 헤더를 Retry-After 사용하여 가능한 경우 지연을 확인합니다.
message

string

사용자가 읽을 수 있는 오류 표현입니다.
moreDetails

ErrorResponseDetails[]

추가 오류 세부 정보 목록입니다.
parameters

ErrorParameter[]

오류에 대해 머신에서 읽을 수 있는 추가 컨텍스트를 제공하는 구조적 매개 변수입니다.
relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.
requestId

string (uuid)

오류와 연결된 요청의 ID입니다.

ErrorResponseDetails

Object

오류 응답 세부 정보입니다.

속성 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message

string

사용자가 읽을 수 있는 오류 표현입니다.
parameters

ErrorParameter[]

오류에 대해 머신에서 읽을 수 있는 추가 컨텍스트를 제공하는 구조적 매개 변수입니다.
relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.

Workspace

Object

작업 영역 개체입니다.

속성 형식 Description
apiEndpoint

string (uri)

작업 영역과 관련된 API 엔드포인트를 나타내는 HTTP URL입니다. 이 엔드포인트 값은 사용자가 preferWorkspaceSpecificEndpoints를 사용하도록 설정하면 반환됩니다. 프라이빗 링크를 통해 API에 액세스할 수 있습니다.
capacityId

string (uuid)

작업 영역이 할당된 용량의 ID입니다.
capacityRegion

CapacityRegion

이 작업 영역과 연결된 용량의 영역입니다.
description

string

작업 영역 설명입니다.
displayName

string

작업 영역 표시 이름입니다.
domainId

string (uuid)

작업 영역이 할당된 도메인의 ID입니다.
id

string (uuid)

작업 영역 ID입니다.
tags

WorkspaceAppliedTag[]

적용된 태그 목록입니다.
type

WorkspaceType

작업 영역 형식입니다.

WorkspaceAppliedTag

Object

적용된 태그를 나타냅니다.

속성 형식 Description
displayName

string

태그의 이름입니다.
id

string (uuid)

태그 ID입니다.

WorkspaceType

열거형

작업 영역 형식입니다. 추가 작업 영역 형식은 시간이 지남에 따라 추가될 수 있습니다.

값 Description
Personal

사용자 항목을 관리하는 데 사용되는 내 폴더 또는 내 작업 영역입니다.
Workspace

패브릭 항목을 관리하는 데 사용되는 작업 영역입니다.
AdminWorkspace

관리자 모니터링 작업 영역. 감사 보고서, 사용 현황 및 채택 보고서와 같은 관리자 보고서를 포함합니다.