다음을 통해 공유

Workspaces - Assign To Domain

서비스:
Core
API 버전:
v1

지정된 작업 영역을 지정된 도메인에 할당합니다.

Permissions

  • 호출자에게는 기여자 권한이 있거나 도메인 관리자여야 합니다.
  • 호출자에게는 작업 영역 관리자 역할이 있어야 합니다.

필수 범위

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

Microsoft Entra 지원 식별자

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

아이덴티티 Support
사용자 Yes
서비스 주체 및 관리 ID Yes

인터페이스

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/assignToDomain

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
workspaceId
 path True

string (uuid)

작업 영역 ID입니다.

요청 본문

Name 필수 형식 Description
domainId True

string (uuid)

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

응답

Name 형식 Description
200 OK

요청이 성공적으로 완료되었습니다.
Other Status Codes

ErrorResponse

일반적인 오류 코드:

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

  • WorkspaceNotFound - 제공된 작업 영역을 찾을 수 없습니다.

  • InsufficientPermissionsToDomain - 호출자가 작업을 수행하기에 도메인에 대한 충분한 권한이 없습니다.

  • InsufficientWorkspaceRole - 호출자에게 작업 영역을 수행할 수 있는 충분한 권한이 없습니다.

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

예제

Assign a workspace to a domain example

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/f97451ca-d6a0-482f-a46a-cc4b2c48ba56/assignToDomain

{
  "domainId": "9d04ca81-bb30-4009-bd1a-a9213a4c8d75"
}

샘플 응답

상태 코드:
200

정의

Name Description
AssignWorkspaceToDomainRequest

도메인 할당 요청입니다.
ErrorRelatedResource

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

오류 응답입니다.
ErrorResponseDetails

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

AssignWorkspaceToDomainRequest

Object

도메인 할당 요청입니다.

Name 형식 Description
domainId

string (uuid)

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

ErrorRelatedResource

Object

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

Name 형식 Description
resourceId

string

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

string

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

ErrorResponse

Object

오류 응답입니다.

Name 형식 Description
errorCode

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

Object

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

Name 형식 Description
errorCode

string

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

string

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

ErrorRelatedResource

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