카탈로그 개체 업데이트
Catalog 개체의 ID를 PATCH 요청의 경로에 포함하여 개체의 일부를 업데이트할 수 있습니다. 이 문서에서는 카탈로그 객체에 대한 PATCH 작업을 수행하는 두 가지 방법을 다룹니다.
- 필드 사용
- JSON 패치 표기법 사용
필드를 사용하여 업데이트
다음 예제 호출에서는 필드 및 값을 사용하여 개체를 업데이트하는 방법을 보여 줍니다.
API 형식
PATCH /{OBJECT_TYPE}/{OBJECT_ID}
{OBJECT_TYPE}
업데이트할 Catalog 개체의 형식입니다. 유효한 오브젝트는 다음과 같습니다.
batches
dataSets
dataSetFiles
{OBJECT_ID}
요청
다음 요청은 데이터 집합의 name
및 description
필드를 페이로드에 제공된 값으로 업데이트합니다. 업데이트하지 않을 개체 필드는 페이로드에서 제외할 수 있습니다.
curl -X PATCH \
https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name":"Updated Dataset Name",
"description":"Updated description for Sample Dataset"
}'
응답
성공적인 응답은 업데이트된 데이터 세트의 ID가 포함된 배열을 반환합니다. 이 ID는 PATCH 요청에서 전송된 ID와 일치해야 합니다. 이제 이 데이터 집합에 대한 GET 요청을 수행하면 name
및 description
만 업데이트되고 다른 모든 값은 변경되지 않은 상태로 표시됩니다.
[
"@/dataSets/5ba9452f7de80400007fc52a"
]
JSON 패치 표기법을 사용한 업데이트
다음 예제 호출은 RFC-6902에 설명된 대로 JSON 패치를 사용하여 개체를 업데이트하는 방법을 보여 줍니다.
JSON 패치 구문에 대한 자세한 내용은 API 기본 사항 안내서를 참조하십시오.
API 형식
PATCH /{OBJECT_TYPE}/{OBJECT_ID}
{OBJECT_TYPE}
업데이트할 Catalog 개체의 형식입니다. 유효한 오브젝트는 다음과 같습니다.
batches
dataSets
dataSetFiles
{OBJECT_ID}
요청
다음 요청은 데이터 집합의 name
및 description
필드를 각 JSON 패치 개체에 제공된 값으로 업데이트합니다. JSON 패치를 사용하는 경우 Content-Type 헤더도 application/json-patch+json
(으)로 설정해야 합니다.
curl -X PATCH \
https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json-patch+json' \
-d '[
{ "op": "add", "path": "/name", "value": "New Dataset Name" },
{ "op": "add", "path": "/description", "value": "New description for dataset" }
]'
응답
성공한 응답은 업데이트된 개체의 ID가 포함된 배열을 반환합니다. 이 ID는 PATCH 요청에서 전송된 ID와 일치해야 합니다. 이제 이 개체에 대한 GET 요청을 수행하면 name
및 description
만 업데이트되고 다른 모든 값은 변경되지 않은 상태로 표시됩니다.
[
"@/dataSets/5ba9452f7de80400007fc52a"
]