다음을 통해 공유

OneLake Shortcuts - Create Shortcut

서비스:
Core
API 버전:
v1

새 바로 가기를 만들거나 기존 바로 가기를 업데이트합니다.

필요한 위임된 범위

OneLake.ReadWrite.All

Microsoft Entra 지원 식별자

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

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

인터페이스

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/shortcuts
선택적 매개 변수: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/shortcuts?shortcutConflictPolicy={shortcutConflictPolicy}

URI 매개 변수

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

string (uuid)

데이터 항목의 ID입니다.
workspaceId
 path True

string (uuid)

작업 영역의 ID입니다.
shortcutConflictPolicy
 query

ShortcutConflictPolicy

제공된 경우 이름과 경로가 같은 바로 가기가 이미 있을 때 수행할 작업을 정의합니다. 기본 동작은 '중단'입니다. 시간에 따라 추가 ShortcutConflictPolicy 형식을 추가할 수 있습니다.

요청 본문

Name 필수 형식 Description
name True

string

바로 가기의 이름입니다.
path True

string

"파일" 또는 "테이블"을 포함하여 바로 가기가 만들어지는 전체 경로를 나타내는 문자열입니다.
target True

CreatableShortcutTarget

대상 데이터 원본을 포함하는 개체이며 지원되는 대상 중 하나(OneLake, Amazon S3, ADLS Gen2, Google Cloud Storage, S3 호환, Dataverse, Azure Blob Storage 또는 OneDrive SharePoint) 중 하나를 지정해야 합니다.

응답

Name 형식 Description
200 OK

Shortcut

성공적으로 업데이트되었습니다.

헤더

Location: string
201 Created

Shortcut

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

헤더

Location: string
Other Status Codes

ErrorResponse

일반적인 오류 코드:

  • ItemNotFound - 서버에서 요청된 항목을 찾을 수 없습니다.

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

예제

Create or update shortcut target to OneLake
Create shortcut AdlsGen2 target example
Create shortcut AmazonS3 target example
Create shortcut Azure Blob Storage target example
Create shortcut Google Cloud Storage target example
Create shortcut One Lake target example
Create shortcut OneDriveSharePoint or OneDrive for Business or SharePoint Online target example
Create shortcut S3 Compatible target example
Update shortcut target to OneLake

Create or update shortcut target to OneLake

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts?shortcutConflictPolicy=CreateOrOverwrite

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

샘플 응답

상태 코드:
200 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut
{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Create shortcut AdlsGen2 target example

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "PartnerProducts",
  "target": {
    "adlsGen2": {
      "location": "https://contosoadlsaccount.dfs.core.windows.net",
      "subpath": "/mycontainer/data/ContosoProducts",
      "connectionId": "91324db9-8dc4-4730-a1e5-bafabf1fb91e"
    }
  }
}

샘플 응답

상태 코드:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/PartnerProducts
{
  "path": "Files/landingZone",
  "name": "PartnerProducts",
  "target": {
    "type": "AdlsGen2",
    "adlsGen2": {
      "location": "https://contosoadlsaccount.dfs.core.windows.net",
      "subpath": "/mycontainer/data/ContosoProducts",
      "connectionId": "91324db9-8dc4-4730-a1e5-bafabf1fb91e"
    }
  }
}

Create shortcut AmazonS3 target example

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "PartnerEmployees",
  "target": {
    "amazonS3": {
      "location": "https://my-s3-bucket.s3.us-west-2.amazonaws.com",
      "subpath": "/data/ContosoEmployees",
      "connectionId": "cf480513-2c1c-46b2-958a-42556ee584c3"
    }
  }
}

샘플 응답

상태 코드:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/PartnerEmployees
{
  "path": "Files/landingZone",
  "name": "PartnerEmployees",
  "target": {
    "type": "AmazonS3",
    "amazonS3": {
      "location": "https://my-s3-bucket.s3.us-west-2.amazonaws.com",
      "subpath": "/data/ContosoEmployees",
      "connectionId": "cf480513-2c1c-46b2-958a-42556ee584c3"
    }
  }
}

Create shortcut Azure Blob Storage target example

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts

{
  "path": "Files",
  "name": "MyAzureBlobStorage",
  "target": {
    "azureBlobStorage": {
      "location": "https://azureblobstoragetesting.blob.core.windows.net",
      "subpath": "/tables",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

샘플 응답

상태 코드:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts/Files/MyAzureBlobStorage
{
  "path": "Files",
  "name": "MyAzureBlobStorage",
  "target": {
    "type": "AzureBlobStorage",
    "azureBlobStorage": {
      "location": "https://azureblobstoragetesting.blob.core.windows.net",
      "subpath": "/tables",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

Create shortcut Google Cloud Storage target example

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "MyGCSShortcut1",
  "target": {
    "googleCloudStorage": {
      "location": "https://gcs-contosoBucket.storage.googleapis.com",
      "subpath": "/gcsDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

샘플 응답

상태 코드:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/MyGCSShortcut1
{
  "path": "Files/landingZone",
  "name": "MyGCSShortcut1",
  "target": {
    "type": "GoogleCloudStorage",
    "googleCloudStorage": {
      "location": "https://gcs-contosoBucket.storage.googleapis.com",
      "subpath": "/gcsDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Create shortcut One Lake target example

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

샘플 응답

상태 코드:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut
{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Create shortcut OneDriveSharePoint or OneDrive for Business or SharePoint Online target example

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts

{
  "path": "Files",
  "name": "MyOneDriveSharePoint",
  "target": {
    "oneDriveSharePoint": {
      "location": "https://microsoft.sharepoint.com",
      "subpath": "/Shared Documents/Test Folder",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

샘플 응답

상태 코드:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts/Files/MyOneDriveSharePoint
{
  "path": "Files",
  "name": "MyOneDriveSharePoint",
  "target": {
    "type": "OneDriveSharePoint",
    "oneDriveSharePoint": {
      "location": "https://microsoft.sharepoint.com",
      "subpath": "/Shared Documents/Test Folder",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

Create shortcut S3 Compatible target example

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "MyS3CompatibleShortcut1",
  "target": {
    "s3Compatible": {
      "location": "https://s3endpoint.contoso.com",
      "bucket": "contosoBucket1",
      "subpath": "/s3CompatibleDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

샘플 응답

상태 코드:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/MyS3CompatibleShortcut1
{
  "path": "Files/landingZone",
  "name": "MyS3CompatibleShortcut1",
  "target": {
    "type": "S3Compatible",
    "s3Compatible": {
      "location": "https://s3endpoint.contoso.com",
      "bucket": "contosoBucket1",
      "subpath": "/s3CompatibleDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Update shortcut target to OneLake

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts?shortcutConflictPolicy=CreateOrOverwrite

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

샘플 응답

상태 코드:
200 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut
{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

정의

Name Description
AdlsGen2

대상 ADLS Gen2 데이터 원본의 속성을 포함하는 개체입니다.
AmazonS3

대상 Amazon S3 데이터 원본의 속성을 포함하는 개체입니다.
AzureBlobStorage

대상 Azure Blob Storage 데이터 원본의 속성을 포함하는 개체입니다.
CreatableShortcutTarget

대상 데이터 원본을 포함하고 아래 표에 설명된 대로 지원되는 대상 중 하나를 정확히 지정해야 하는 개체입니다.
CreateShortcutRequest

다른 스토리지 위치에 대한 참조를 나타내는 개체가 있는 바로 가기 만들기 요청입니다.
CsvToDeltaTransform

CSV에서 델타로 변환합니다.
CsvToDeltaTransformProperties

CSV에서 델타 변환에 대한 속성입니다.
Dataverse

대상 Dataverse 데이터 원본의 속성을 포함하는 개체입니다.
ErrorRelatedResource

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

오류 응답입니다.
ErrorResponseDetails

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

대상 외부 데이터 공유의 속성을 포함하는 개체입니다.
GoogleCloudStorage

대상 Google Cloud Storage 데이터 원본의 속성을 포함하는 개체입니다.
OneDriveSharePoint

대상 비즈니스용 OneDrive 또는 SharePoint Online 데이터 원본의 속성을 포함하는 개체입니다.
OneLake

대상 OneLake 데이터 원본의 속성을 포함하는 개체입니다.
S3Compatible

대상 S3 호환 데이터 원본의 속성을 포함하는 개체입니다.
Shortcut

OneLake 내부 또는 외부에 있을 수 있는 다른 스토리지 위치를 가리키는 참조를 나타내는 개체입니다. 바로 가기는 이름, 바로 가기가 만들어지는 경로 및 대상 스토리지 위치를 지정하는 대상으로 정의됩니다.
ShortcutConflictPolicy

제공된 경우 이름과 경로가 같은 바로 가기가 이미 있을 때 수행할 작업을 정의합니다. 기본 동작은 '중단'입니다. 시간에 따라 추가 ShortcutConflictPolicy 형식을 추가할 수 있습니다.
Target

대상 데이터 원본을 포함하고 아래 표에 설명된 대로 지원되는 대상 중 하나를 정확히 지정해야 하는 개체입니다.
Type

형식 개체에는 대상 바로 가기 계정 유형과 같은 속성이 포함됩니다. 시간이 지남에 따라 추가 형식을 추가할 수 있습니다.

AdlsGen2

Object

대상 ADLS Gen2 데이터 원본의 속성을 포함하는 개체입니다.

Name 형식 Description
connectionId

string (uuid)

바로 가기로 바인딩된 연결을 나타내는 문자열입니다. connectionId는 바로 가기와 대상 데이터 원본 간의 연결을 설정하는 데 사용되는 고유 식별자입니다. 이 연결 ID를 찾으려면 먼저 ADLS 데이터 위치에 연결할 때 바로 가기에서 사용할 클라우드 연결을 만듭니 다. 클라우드 연결의 설정 보기를 열고 연결 ID를 복사합니다. GUID입니다.
location

string (uri)

대상 ADLS 컨테이너의 위치를 지정합니다. URI는 [account-name].dfs.core.windows.net https:// 형식이어야 합니다. 여기서 [account-name]은 대상 ADLS 계정의 이름입니다.
subpath

string

대상 폴더가 있는 ADLS 계정 내의 컨테이너 및 하위 폴더를 지정합니다. [container]는 파일 및 폴더를 보유하는 컨테이너의 이름인 [container]/[subfolder] 형식이어야 합니다. [subfolder]는 컨테이너 내의 하위 폴더 이름입니다(선택 사항). 예: /mycontainer/mysubfolder

AmazonS3

Object

대상 Amazon S3 데이터 원본의 속성을 포함하는 개체입니다.

Name 형식 Description
connectionId

string (uuid)

바로 가기로 바인딩된 연결을 나타내는 문자열입니다. connectionId는 바로 가기와 대상 데이터 원본 간의 연결을 설정하는 데 사용되는 고유 식별자입니다. 이 연결 ID를 찾으려면 먼저 Amazon S3 데이터 위치에 연결할 때 바로 가기에서 사용할 클라우드 연결을 만듭니 다. 클라우드 연결의 설정 보기를 열고 연결 ID를 복사합니다. GUID입니다.
location

string (uri)

S3의 대상 버킷을 가리키는 HTTP URL입니다. URL은 https://[bucket-name].s3 형식이어야 합니다. [region-code].amazonaws.com 여기서 "bucket-name"은 가리키려는 S3 버킷의 이름이고 " region-code"는 버킷이 있는 지역의 코드입니다. 예: https://my-s3-bucket.s3.us-west-2.amazonaws.com
subpath

string

S3 버킷 내의 대상 폴더 또는 하위 폴더를 지정합니다.

AzureBlobStorage

Object

대상 Azure Blob Storage 데이터 원본의 속성을 포함하는 개체입니다.

Name 형식 Description
connectionId

string (uuid)

바로 가기로 바인딩된 연결을 나타내는 문자열입니다. connectionId는 바로 가기와 대상 데이터 원본 간의 연결을 설정하는 데 사용되는 고유 식별자입니다. 이 연결 ID를 찾으려면 먼저 Azure Blob Storage 데이터 위치에 연결할 때 바로 가기에서 사용할 클라우드 연결을 만듭니 다. 클라우드 연결의 설정 보기를 열고 연결 ID인 GUID를 복사합니다.
location

string (uri)

대상 Azure Blob Storage 컨테이너의 위치를 지정합니다. URI는 대상 Azure Blob Storage 계정의 이름이 있는 https://[account-name].blob.core.windows.net 형식 [account-name] 이어야 합니다.
subpath

string

대상 폴더가 있는 Azure Blob Storage 계정 내의 컨테이너 및 하위 폴더를 지정합니다. [container]/[subfolder] 형식이어야 합니다. [컨테이너]는 파일 및 폴더를 보유하는 컨테이너의 이름입니다. [하위 폴더]는 컨테이너 내의 하위 폴더 이름이며 선택 사항입니다. 예: /mycontainer/mysubfolder

CreatableShortcutTarget

Object

대상 데이터 원본을 포함하고 아래 표에 설명된 대로 지원되는 대상 중 하나를 정확히 지정해야 하는 개체입니다.

Name 형식 Description
adlsGen2

AdlsGen2

대상 ADLS Gen2 데이터 원본의 속성을 포함하는 개체입니다.
amazonS3

AmazonS3

대상 Amazon S3 데이터 원본의 속성을 포함하는 개체입니다.
azureBlobStorage

AzureBlobStorage

대상 Azure Blob Storage 데이터 원본의 속성을 포함하는 개체입니다.
dataverse

Dataverse

대상 Dataverse 데이터 원본의 속성을 포함하는 개체입니다.
googleCloudStorage

GoogleCloudStorage

대상 Google Cloud Storage 데이터 원본의 속성을 포함하는 개체입니다.
oneDriveSharePoint

OneDriveSharePoint

대상 비즈니스용 OneDrive 및 SharePoint Online 데이터 원본의 속성을 포함하는 개체입니다.
oneLake

OneLake

대상 OneLake 데이터 원본의 속성을 포함하는 개체입니다.
s3Compatible

S3Compatible

대상 S3 호환 데이터 원본의 속성을 포함하는 개체입니다.

CreateShortcutRequest

Object

다른 스토리지 위치에 대한 참조를 나타내는 개체가 있는 바로 가기 만들기 요청입니다.

Name 형식 Description
name

string

바로 가기의 이름입니다.
path

string

"파일" 또는 "테이블"을 포함하여 바로 가기가 만들어지는 전체 경로를 나타내는 문자열입니다.
target

CreatableShortcutTarget

대상 데이터 원본을 포함하는 개체이며 지원되는 대상 중 하나(OneLake, Amazon S3, ADLS Gen2, Google Cloud Storage, S3 호환, Dataverse, Azure Blob Storage 또는 OneDrive SharePoint) 중 하나를 지정해야 합니다.

CsvToDeltaTransform

Object

CSV에서 델타로 변환합니다.

Name 형식 Description
properties

CsvToDeltaTransformProperties

CSV에서 델타로 변환 속성입니다.
type string:

csvToDelta

변환의 형식입니다. 시간이 지남에 따라 추가 변환 형식을 추가할 수 있습니다.

CsvToDeltaTransformProperties

Object

CSV에서 델타 변환에 대한 속성입니다.

Name 형식 Default value Description
delimiter

string

,

CSV 파일의 행 내에서 값을 구분하는 데 사용되는 문자를 지정하고 지원되는 값 ,중 하나(, , , \t|&;, )를 정확히 지정해야 합니다. 기본값은 ,여야 합니다.
skipFilesWithErrors

boolean

True

오류가 있는 파일을 건너뛸지 여부입니다. True - 오류가 있는 파일 건너뛰기, False - 오류가 있는 파일을 건너뛰지 마세요. 기본값은 True입니다.
useFirstRowAsHeader

boolean

True

CSV 파일의 첫 번째 행을 헤더로 사용할지 여부입니다. True - 첫 번째 행을 머리글로 사용합니다. False - 첫 번째 행을 머리글로 사용하지 마세요. 기본값은 True입니다.

Dataverse

Object

대상 Dataverse 데이터 원본의 속성을 포함하는 개체입니다.

Name 형식 Description
connectionId

string (uuid)

바로 가기로 바인딩된 연결을 나타내는 문자열입니다. connectionId는 바로 가기와 대상 데이터 원본 간의 연결을 설정하는 데 사용되는 고유 식별자입니다. 이 연결 ID를 찾으려면 먼저 Dataverse 데이터 위치에 연결할 때 바로 가기에서 사용할 클라우드 연결을 만듭니 다. 클라우드 연결의 설정 보기를 열고 연결 ID를 복사합니다. GUID입니다.
deltaLakeFolder

string

대상 데이터가 저장되는 DeltaLake 폴더 경로를 지정합니다.
environmentDomain

string (uri)

Dataverse 대상 환경의 도메인 이름을 나타내는 URI입니다. URI는 Dataverse 조직의 이름을 나타내는 "https://[orgname].crm[xx].dynamics.com" [orgname] 로 형식이 지정되어야 합니다.
tableName

string

Dataverse에서 대상 테이블의 이름을 지정합니다.

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

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

ExternalDataShareTarget

Object

대상 외부 데이터 공유의 속성을 포함하는 개체입니다.

Name 형식 Description
connectionId

string (uuid)

바로 가기로 바인딩된 연결을 나타내는 문자열입니다. connectionId는 바로 가기와 대상 데이터 원본 간의 연결을 설정하는 데 사용되는 고유 식별자입니다.

GoogleCloudStorage

Object

대상 Google Cloud Storage 데이터 원본의 속성을 포함하는 개체입니다.

Name 형식 Description
connectionId

string (uuid)

바로 가기로 바인딩된 연결을 나타내는 문자열입니다. connectionId는 바로 가기와 대상 데이터 원본 간의 연결을 설정하는 데 사용되는 고유 식별자입니다.
location

string (uri)

GCS에서 대상 버킷을 가리키는 HTTP URL입니다. URL은 [bucket-name] .storage.googleapis.com https:// 형식이어야 합니다. 여기서 [bucket-name]은 가리키려는 버킷의 이름입니다. 예: https://my-gcs-bucket.storage.googleapis.com
subpath

string

GCS 버킷 내의 대상 폴더 또는 하위 폴더를 지정합니다. 예: /folder

OneDriveSharePoint

Object

대상 비즈니스용 OneDrive 또는 SharePoint Online 데이터 원본의 속성을 포함하는 개체입니다.

Name 형식 Description
connectionId

string (uuid)

바로 가기로 바인딩된 연결을 나타내는 문자열입니다. connectionId는 바로 가기와 대상 데이터 원본 간의 연결을 설정하는 데 사용되는 고유 식별자입니다. 이 연결 ID를 찾으려면 먼저 OneDrive SharePoint 데이터 위치에 연결할 때 바로 가기에서 사용할 클라우드 연결을 만듭니 다. 클라우드 연결의 설정 보기를 열고 연결 ID인 GUID를 복사합니다.
location

string (uri)

대상 OneDrive SharePoint 컨테이너의 위치를 지정합니다. URI는 대상 OneDrive SharePoint 계정의 경로인 형식 https://microsoft.sharepoint.com 이어야 합니다.
subpath

string

대상 폴더가 있는 OneDrive SharePoint 계정 내의 컨테이너 및 하위 폴더를 지정합니다. [container]/[subfolder] 형식이어야 합니다. [컨테이너]는 파일 및 폴더를 보유하는 컨테이너의 이름입니다. [하위 폴더]는 컨테이너 내의 하위 폴더 이름이며 선택 사항입니다. 예: /mycontainer/mysubfolder

OneLake

Object

대상 OneLake 데이터 원본의 속성을 포함하는 개체입니다.

Name 형식 Description
connectionId

string (uuid)

바로 가기로 바인딩된 연결을 나타내는 문자열입니다. connectionId는 바로 가기와 대상 데이터 원본 간의 연결을 설정하는 데 사용되는 고유 식별자입니다. 이 연결 ID를 찾으려면 먼저 Amazon S3 데이터 위치에 연결할 때 바로 가기에서 사용할 클라우드 연결을 만듭니 다. 클라우드 연결의 설정 보기를 열고 연결 ID를 복사합니다. GUID입니다.
itemId

string (uuid)

OneLake에 있는 대상의 ID입니다. 대상은 Lakehouse, KQLDatabase 또는 Warehouse의 항목일 수 있습니다.
path

string

Item 내의 대상 폴더에 대한 전체 경로를 나타내는 문자열입니다. 이 경로는 OneLake 디렉터리 구조의 루트를 기준으로 해야 합니다. 예: "Tables/myTablesFolder/someTableSubFolder".
workspaceId

string (uuid)

대상 작업 영역의 ID입니다.

S3Compatible

Object

대상 S3 호환 데이터 원본의 속성을 포함하는 개체입니다.

Name 형식 Description
bucket

string

S3 호환 위치 내의 대상 버킷을 지정합니다.
connectionId

string (uuid)

바로 가기로 바인딩된 연결을 나타내는 문자열입니다. connectionId는 바로 가기와 대상 데이터 원본 간의 연결을 설정하는 데 사용되는 고유 식별자입니다.
location

string (uri)

S3 호환 엔드포인트의 HTTP URL입니다. 이 엔드포인트는 ListBuckets S3 API 호출을 받을 수 있어야 합니다. URL은 버킷이 아닌 특정 형식이어야 합니다. 여기서는 버킷을 지정하지 않아야 합니다. 예: https://s3endpoint.contoso.com
subpath

string

S3 호환 버킷 내의 대상 폴더 또는 하위 폴더를 지정합니다. 예: /folder

Shortcut

Object

OneLake 내부 또는 외부에 있을 수 있는 다른 스토리지 위치를 가리키는 참조를 나타내는 개체입니다. 바로 가기는 이름, 바로 가기가 만들어지는 경로 및 대상 스토리지 위치를 지정하는 대상으로 정의됩니다.

Name 형식 Description
name

string

바로 가기의 이름입니다.
path

string

"파일" 또는 "테이블"을 포함하여 바로 가기가 만들어지는 전체 경로를 나타내는 문자열입니다.
target

Target

대상 데이터 원본을 포함하고 지원되는 대상 중 하나를 정확히 지정해야 하는 개체입니다.
transform Transform:

CsvToDeltaTransform

대상 데이터에 적용할 변환 이름 및 해당 속성을 포함하고 지원되는 변환 중 하나를 정확히 지정해야 하는 개체입니다.

ShortcutConflictPolicy

열거형

제공된 경우 이름과 경로가 같은 바로 가기가 이미 있을 때 수행할 작업을 정의합니다. 기본 동작은 '중단'입니다. 시간에 따라 추가 ShortcutConflictPolicy 형식을 추가할 수 있습니다.

값 Description
Abort

이름과 경로가 같은 바로 가기가 이미 있으면 바로 가기 만들기가 취소됩니다.
GenerateUniqueName

이름과 경로가 같은 바로 가기가 이미 있는 경우 새 고유한 바로 가기 이름을 사용하여 바로 가기 만들기를 계속합니다.
CreateOrOverwrite

이름과 경로가 같은 바로 가기가 이미 있는 경우 바로 가기 만들기는 기존 바로 가기를 덮어씁니다. 없는 경우 바로 가기를 만듭니다.
OverwriteOnly

이름과 경로가 같은 바로 가기가 이미 있는 경우 바로 가기 만들기는 기존 바로 가기를 덮어씁니다.

Target

Object

대상 데이터 원본을 포함하고 아래 표에 설명된 대로 지원되는 대상 중 하나를 정확히 지정해야 하는 개체입니다.

Name 형식 Description
adlsGen2

AdlsGen2

대상 ADLS Gen2 데이터 원본의 속성을 포함하는 개체입니다.
amazonS3

AmazonS3

대상 Amazon S3 데이터 원본의 속성을 포함하는 개체입니다.
azureBlobStorage

AzureBlobStorage

대상 Azure Blob Storage 데이터 원본의 속성을 포함하는 개체입니다.
dataverse

Dataverse

대상 Dataverse 데이터 원본의 속성을 포함하는 개체입니다.
externalDataShare

ExternalDataShareTarget

대상 외부 데이터 공유의 속성을 포함하는 개체입니다.
googleCloudStorage

GoogleCloudStorage

대상 Google Cloud Storage 데이터 원본의 속성을 포함하는 개체입니다.
oneDriveSharePoint

OneDriveSharePoint

대상 비즈니스용 OneDrive 및 SharePoint Online 데이터 원본의 속성을 포함하는 개체입니다.
oneLake

OneLake

대상 OneLake 데이터 원본의 속성을 포함하는 개체입니다.
s3Compatible

S3Compatible

대상 S3 호환 데이터 원본의 속성을 포함하는 개체입니다.
type

Type

형식 개체에는 대상 바로 가기 계정 유형과 같은 속성이 포함됩니다. 시간이 지남에 따라 추가 형식을 추가할 수 있습니다.

Type

열거형

형식 개체에는 대상 바로 가기 계정 유형과 같은 속성이 포함됩니다. 시간이 지남에 따라 추가 형식을 추가할 수 있습니다.

값 Description
OneLake

OneLake
AmazonS3

AmazonS3
AdlsGen2

AdlsGen2
GoogleCloudStorage

GoogleCloudStorage
S3Compatible

S3Compatible
Dataverse

Dataverse
ExternalDataShare

ExternalDataShare
AzureBlobStorage

AzureBlobStorage
OneDriveSharePoint

OneDriveSharePoint