Items - Update Logical Id

서비스:: Core

API 버전:: v1

지정된 항목의 논리 ID를 업데이트합니다.
해당 항목 인스턴스는 동일한 논리 ID를 공유합니다. 이 작업을 사용하여 논리 ID 충돌을 해결합니다. 논리 ID를 변경하기 전에 현재 값을 사용하는 모든 자동화를 검토하고 필요에 따라 업데이트합니다. 그렇지 않으면 중복된 표시 이름으로 인해 이러한 자동화에서 항목을 찾지 못하거나 실패할 수 있습니다. 자세한 내용은 Microsoft Fabric 논리 ID 충돌 해결을 참조하세요.

Permissions

호출자에게 항목에 대한 읽기 및 쓰기 권한이 있어야 합니다.

필요한 위임된 범위

항목 API의 경우 다음 범위 유형 중 하나를 사용합니다.

제네릭 범위: Item.ReadWrite.All.
특정 범위: itemType. ReadWrite.All(예: Notebook.ReadWrite.All).

범위에 대한 자세한 내용은 범위를 참조하세요.

Limitations

논리 ID는 빈 GUID(00000000-0000-0000-0000-000000000000)일 수 없습니다.
논리 ID는 작업 영역 내에서 고유해야 합니다.
작업 영역에서 CI/CD 작업이 활성화되어 있는 동안에는 작업이 지원되지 않습니다.

Microsoft Entra 지원 식별자

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

Identity	Support
User	Yes
서비스 주체 및 관리 ID	Yes

인터페이스

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/logicalId

URI 매개 변수

속성	In(다음 안에)	필수	형식	Description
itemId	path	True	string (uuid)	항목 ID입니다.
workspaceId	path	True	string (uuid)	작업 영역 ID입니다.

요청 본문

속성	필수	형식	Description
logicalId	True	string (uuid)	항목에 대해 업데이트할 논리 ID입니다.

응답

속성 형식 Description

200 OK

속성	형식	Description
200 OK	LogicalIdResponse	요청이 성공적으로 완료되었습니다.
429 Too Many Requests	ErrorResponse	서비스 속도 제한을 초과했습니다. 서버는 클라이언트가 `Retry-After` 추가 요청을 보내기 전에 대기해야 하는 시간을 초 단위로 나타내는 헤더를 반환합니다. 헤더 Retry-After: integer
Other Status Codes	ErrorResponse	일반적인 오류 코드: ItemNotFound - 요청된 항목을 찾을 수 없습니다. ActiveCiCdOperationInProgress - 작업 영역에서 CI/CD 작업이 활성화됩니다.

LogicalIdResponse

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

429 Too Many Requests

ErrorResponse

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

헤더

Retry-After: integer

Other Status Codes

ErrorResponse

일반적인 오류 코드:

ItemNotFound - 요청된 항목을 찾을 수 없습니다.
ActiveCiCdOperationInProgress - 작업 영역에서 CI/CD 작업이 활성화됩니다.

예제

Update logical ID example

샘플 요청

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/logicalId

{
  "logicalId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

샘플 응답

상태 코드:: 200

{
  "logicalId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

정의

속성	Description
ErrorParameter	오류에 대해 머신에서 읽을 수 있는 추가 컨텍스트를 제공하는 구조적 매개 변수입니다.
ErrorRelatedResource	오류 관련 리소스 세부 정보 개체입니다.
ErrorResponse	오류 응답입니다.
ErrorResponseDetails	오류 응답 세부 정보입니다.
LogicalIdResponse	논리적 ID 응답입니다.
UpdateLogicalIdRequest	논리 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	오류 관련 리소스 세부 정보입니다.

LogicalIdResponse

Object

논리적 ID 응답입니다.

속성	형식	Description
logicalId	string (uuid)	항목의 논리적 ID입니다.

UpdateLogicalIdRequest

Object

논리 ID 요청 페이로드를 업데이트합니다.

속성	형식	Description
logicalId	string (uuid)	항목에 대해 업데이트할 논리 ID입니다.