Data Sources - Create

서비스:: Search Service

API 버전:: 2026-04-01

새 데이터 원본을 만듭니다.

POST {endpoint}/datasources?api-version=2026-04-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (uri)	검색 서비스의 엔드포인트 URL입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 헤더

Name	필수	형식	Description
Accept		Accept	Accept 헤더입니다.
x-ms-client-request-id		string (uuid)	요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다.

요청 본문

Name	필수	형식	Description
container	True	SearchIndexerDataContainer	데이터 원본의 데이터 컨테이너입니다.
name	True	string	데이터 원본의 이름입니다.
type	True	SearchIndexerDataSourceType	데이터 원본의 형식입니다.
@odata.etag		string	데이터 원본의 ETag입니다.
credentials.connectionString		string	데이터 원본에 대한 연결 문자열입니다. 연결 문자열을 업데이트하지 않으려면 (대괄호 포함)으로 `<unchanged>` 설정합니다. 데이터 원본에서 연결 문자열 값을 제거하려는 경우 로 `<redacted>` 설정합니다.
dataChangeDetectionPolicy		DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	데이터 원본에 대한 데이터 변경 검색 정책입니다.
dataDeletionDetectionPolicy		DataDeletionDetectionPolicy: NativeBlobSoftDeleteDeletionDetectionPolicy SoftDeleteColumnDeletionDetectionPolicy	데이터 원본에 대한 데이터 삭제 검색 정책입니다.
description		string	데이터 원본에 대한 설명입니다.
encryptionKey		SearchResourceEncryptionKey	Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 Microsoft를 포함한 누구도 데이터 원본 정의의 암호를 해독할 수 없다는 완전한 보증을 원하는 경우 데이터 원본 정의에 대한 추가 수준의 미사용 암호화를 제공하는 데 사용됩니다. 데이터 원본 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전하려는 경우 필요에 따라 이 속성을 변경할 수 있습니다. 데이터 원본 정의는 영향을 받지 않습니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.
identity		SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	이 데이터 원본에 사용할 명시적 관리 ID입니다. 지정하지 않고 연결 문자열이 관리 ID인 경우 시스템 할당 관리 ID가 사용됩니다. 지정하지 않으면 값이 변경되지 않은 상태로 유지됩니다. "none"을 지정하면 이 속성의 값이 지워집니다.

응답

Name	형식	Description
201 Created	SearchIndexerDataSource	요청이 성공했고 결과적으로 새 리소스가 생성되었습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

api-key

형식: apiKey
In(다음 안에): header

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

범위

Name	Description
https://search.azure.com/.default

예제

SearchServiceCreateDataSource

샘플 요청

HTTP

POST https://exampleservice.search.windows.net/datasources?api-version=2026-04-01


{
  "name": "tempdatasource",
  "description": "My Azure Blob data source.",
  "type": "azureblob",
  "credentials": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net "
  },
  "container": {
    "name": "doc-extraction-skillset",
    "query": "E2E_Dsat"
  },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataNoneIdentity"
  },
  "dataChangeDetectionPolicy": {
    "highWaterMarkColumnName": "metadata_storage_last_modified",
    "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy"
  },
  "dataDeletionDetectionPolicy": {
    "softDeleteColumnName": "isDeleted",
    "softDeleteMarkerValue": "true",
    "@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy"
  },
  "@odata.etag": "0x1234568AE7E58A1"
}

샘플 응답

상태 코드:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "tempdatasource",
  "description": "My Azure Blob data source.",
  "type": "azureblob",
  "credentials": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net "
  },
  "container": {
    "name": "doc-extraction-skillset",
    "query": "E2E_Dsat"
  },
  "dataChangeDetectionPolicy": {
    "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
    "highWaterMarkColumnName": "metadata_storage_last_modified"
  },
  "dataDeletionDetectionPolicy": {
    "@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
    "softDeleteColumnName": "isDeleted",
    "softDeleteMarkerValue": "true"
  },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataNoneIdentity"
  }
}

정의

Name	Description
Accept	Accept 헤더입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
HighWaterMarkChangeDetectionPolicy	높은 워터 마크 열의 값에 따라 변경 내용을 캡처하는 데이터 변경 검색 정책을 정의합니다.
NativeBlobSoftDeleteDeletionDetectionPolicy	삭제 검색을 위해 Azure Blob Storage의 네이티브 일시 삭제 기능을 활용하는 데이터 삭제 검색 정책을 정의합니다.
SearchIndexerDataContainer	인덱싱할 엔터티(예: Azure SQL 테이블 또는 CosmosDB 컬렉션)에 대한 정보를 나타냅니다.
SearchIndexerDataNoneIdentity	데이터 원본의 ID 속성을 지웁니다.
SearchIndexerDataSource	인덱서 구성에 사용할 수 있는 데이터 원본 정의를 나타냅니다.
SearchIndexerDataSourceType	데이터 원본의 형식을 정의합니다.
SearchIndexerDataUserAssignedIdentity	사용할 데이터 원본의 ID를 지정합니다.
SearchResourceEncryptionKey	Azure Key Vault의 고객 관리형 암호화 키입니다. 만들고 관리하는 키를 사용하여 인덱스 및 동의어 맵과 같은 미사용 데이터를 암호화하거나 복호화할 수 있습니다.
SoftDeleteColumnDeletionDetectionPolicy	일시 삭제 전략을 구현하는 데이터 삭제 검색 정책을 정의합니다. 지정된 '일시 삭제' 열의 값에 따라 항목을 삭제해야 하는지 여부를 결정합니다.
SqlIntegratedChangeTrackingPolicy	Azure SQL Database의 통합 변경 내용 추적 기능을 사용하여 변경 내용을 캡처하는 데이터 변경 검색 정책을 정의합니다.

Accept

열거형

Accept 헤더입니다.

값	Description
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info		추가 정보.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

HighWaterMarkChangeDetectionPolicy

Object

높은 워터 마크 열의 값에 따라 변경 내용을 캡처하는 데이터 변경 검색 정책을 정의합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy	파생 형식에 대한 판별자입니다.
highWaterMarkColumnName	string	상위 워터 마크 열의 이름입니다.

NativeBlobSoftDeleteDeletionDetectionPolicy

Object

삭제 검색을 위해 Azure Blob Storage의 네이티브 일시 삭제 기능을 활용하는 데이터 삭제 검색 정책을 정의합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Azure.Search.NativeBlobSoftDeleteDeletionDetectionPolicy	파생 형식에 대한 판별자입니다.

SearchIndexerDataContainer

Object

인덱싱할 엔터티(예: Azure SQL 테이블 또는 CosmosDB 컬렉션)에 대한 정보를 나타냅니다.

Name	형식	Description
name	string	인덱싱될 테이블 또는 뷰(Azure SQL 데이터 원본의 경우) 또는 컬렉션(CosmosDB 데이터 원본의 경우)의 이름입니다.
query	string	이 데이터 컨테이너에 적용되는 쿼리입니다. 이 매개변수의 구문과 의미는 데이터 소스에 따라 다릅니다. Azure SQL 데이터 원본에서 지원되지 않습니다.

SearchIndexerDataNoneIdentity

Object

데이터 원본의 ID 속성을 지웁니다.

Name	형식	Description
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	ID 유형을 지정하는 URI 조각입니다.

SearchIndexerDataSource

Object

인덱서 구성에 사용할 수 있는 데이터 원본 정의를 나타냅니다.

Name	형식	Description
@odata.etag	string	데이터 원본의 ETag입니다.
container	SearchIndexerDataContainer	데이터 원본의 데이터 컨테이너입니다.
credentials.connectionString	string	데이터 원본에 대한 연결 문자열입니다. 연결 문자열을 업데이트하지 않으려면 (대괄호 포함)으로 `<unchanged>` 설정합니다. 데이터 원본에서 연결 문자열 값을 제거하려는 경우 로 `<redacted>` 설정합니다.
dataChangeDetectionPolicy	DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	데이터 원본에 대한 데이터 변경 검색 정책입니다.
dataDeletionDetectionPolicy	DataDeletionDetectionPolicy: NativeBlobSoftDeleteDeletionDetectionPolicy SoftDeleteColumnDeletionDetectionPolicy	데이터 원본에 대한 데이터 삭제 검색 정책입니다.
description	string	데이터 원본에 대한 설명입니다.
encryptionKey	SearchResourceEncryptionKey	Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 Microsoft를 포함한 누구도 데이터 원본 정의의 암호를 해독할 수 없다는 완전한 보증을 원하는 경우 데이터 원본 정의에 대한 추가 수준의 미사용 암호화를 제공하는 데 사용됩니다. 데이터 원본 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전하려는 경우 필요에 따라 이 속성을 변경할 수 있습니다. 데이터 원본 정의는 영향을 받지 않습니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	이 데이터 원본에 사용할 명시적 관리 ID입니다. 지정하지 않고 연결 문자열이 관리 ID인 경우 시스템 할당 관리 ID가 사용됩니다. 지정하지 않으면 값이 변경되지 않은 상태로 유지됩니다. "none"을 지정하면 이 속성의 값이 지워집니다.
name	string	데이터 원본의 이름입니다.
type	SearchIndexerDataSourceType	데이터 원본의 형식입니다.

SearchIndexerDataSourceType

열거형

데이터 원본의 형식을 정의합니다.

값	Description
azuresql	Azure SQL 데이터 원본을 나타냅니다.
cosmosdb	CosmosDB 데이터 원본을 나타냅니다.
azureblob	Azure Blob 데이터 원본을 나타냅니다.
azuretable	Azure 테이블 데이터 원본을 나타냅니다.
mysql	MySQL 데이터 소스를 나타냅니다.
adlsgen2	ADLS Gen2 데이터 원본을 나타냅니다.
onelake	Microsoft Fabric OneLake 데이터 원본을 나타냅니다.
sharepoint	SharePoint 데이터 원본을 나타냅니다.

SearchIndexerDataUserAssignedIdentity

Object

사용할 데이터 원본의 ID를 지정합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	ID 유형을 지정하는 URI 조각입니다.
userAssignedIdentity	string	일반적으로 검색 서비스에 할당되어야 하는 "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" 형식으로 사용자 할당 관리 ID의 정규화된 Azure 리소스 ID입니다.

SearchResourceEncryptionKey

Object

Azure Key Vault의 고객 관리형 암호화 키입니다. 만들고 관리하는 키를 사용하여 인덱스 및 동의어 맵과 같은 미사용 데이터를 암호화하거나 복호화할 수 있습니다.

Name	형식	Description
accessCredentials.applicationId	string	미사용 데이터를 암호화할 때 사용할 Azure Key Vault에 필요한 액세스 권한이 부여된 AAD 애플리케이션 ID입니다. 애플리케이션 ID는 AAD 애플리케이션의 개체 ID와 혼동해서는 안 됩니다.
accessCredentials.applicationSecret	string	지정된 AAD 애플리케이션의 인증 키입니다.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	이 암호화 키에 사용할 명시적 관리 ID입니다. 지정하지 않고 액세스 자격 증명 속성이 null이면 시스템 할당 관리 ID가 사용됩니다. 리소스 업데이트 시 명시적 ID가 지정되지 않은 경우 변경되지 않은 상태로 유지됩니다. "none"을 지정하면 이 속성의 값이 지워집니다.
keyVaultKeyName	string	미사용 데이터를 암호화하는 데 사용할 Azure Key Vault 키의 이름입니다.
keyVaultKeyVersion	string	미사용 데이터를 암호화하는 데 사용할 Azure Key Vault 키의 버전입니다.
keyVaultUri	string	미사용 데이터를 암호화하는 데 사용할 키를 포함하는 DNS 이름이라고도 하는 Azure Key Vault의 URI입니다. 예제 URI는 `https://my-keyvault-name.vault.azure.net`수 있습니다.

SoftDeleteColumnDeletionDetectionPolicy

Object

일시 삭제 전략을 구현하는 데이터 삭제 검색 정책을 정의합니다. 지정된 '일시 삭제' 열의 값에 따라 항목을 삭제해야 하는지 여부를 결정합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy	파생 형식에 대한 판별자입니다.
softDeleteColumnName	string	일시 삭제 검색에 사용할 열의 이름입니다.
softDeleteMarkerValue	string	항목을 삭제된 것으로 식별하는 표식 값입니다.

SqlIntegratedChangeTrackingPolicy

Object

Azure SQL Database의 통합 변경 내용 추적 기능을 사용하여 변경 내용을 캡처하는 데이터 변경 검색 정책을 정의합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Azure.Search.SqlIntegratedChangeTrackingPolicy	파생 형식에 대한 판별자입니다.