您可以使用PUT请 Catalog 求覆盖对象的内容,其中整个资源将替换为请求有效负荷。
如果您只需要更新对象中的几个特定字 Catalog 段,使用PATCH请求可能会更高效。
API格式
PUT /{OBJECT_TYPE}/{OBJECT_ID}
参数 | 描述 |
---|---|
{OBJECT_TYPE} |
要替换 Catalog 的对象类型。 有效对象有:
|
{OBJECT_ID} |
要更新的特定对象的标识符。 |
请求
以下请求使用有效负荷中提供的值覆盖数据集。
curl -X PUT \
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: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name": "New Dataset Name",
"description": "New description for dataset",
"state": "DRAFT",
"tags": {
"adobe/pqs/table": [
"sample_dataset"
]
},
"files": "@/dataSets/5ba9452f7de80400007fc52a/views/5ba9452f7de80400007fc52b/files"
}'
响应
成功的响应会返回包含被覆盖对象ID的数组。 此ID应与在PUT请求中发送的ID匹配。 现在,为此对象执行GET请求时会显示其详细信息已替换为之前PUT请求的有效负荷中提供的详细信息。
[
"@/dataSets/5ba9452f7de80400007fc52a"
]