내의 모든 리소스 Schema Library Adobe Experience Platform 내의 특정 샌드박스에 포함됩니다. 경우에 따라 샌드박스와 조직 간에 XDM(Experience Data Model) 리소스를 공유할 수 있습니다. 다음 /rpc/export
의 엔드포인트 Schema Registry API를 사용하면 의 스키마, 스키마 필드 그룹 또는 데이터 유형에 대한 내보내기 페이로드를 생성할 수 있습니다. Schema Library을(를) 만든 다음 해당 페이로드를 사용하여 해당 리소스(및 모든 종속 리소스)를 /rpc/import
엔드포인트.
다음 /rpc/export
끝점이 의 일부임 Schema Registry API. 계속하기 전에 다음을 검토하십시오. 시작 안내서 관련 설명서에 대한 링크, 이 문서의 샘플 API 호출 읽기에 대한 안내서 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요 정보입니다.
다음 /rpc/export
끝점은 이 지원하는 원격 프로시저 호출(RPC)의 일부입니다. Schema Registry. 의 다른 끝점과 달리 Schema Registry API, RPC 끝점에는 다음과 같은 추가 헤더가 필요하지 않습니다. Accept
또는 Content-Type
, 및 를 사용하지 않음 CONTAINER_ID
. 대신 /rpc
아래 API 호출에 나와 있는 대로 네임스페이스.
의 기존 스키마, 필드 그룹 또는 데이터 유형에 대해 Schema Library에 GET 요청을 하여 내보내기 페이로드를 생성할 수 있습니다. /export
경로에 리소스 ID를 제공하는 종단점입니다.
API 형식
GET /rpc/export/{RESOURCE_ID}
매개변수 | 설명 |
---|---|
{RESOURCE_ID} |
다음 meta:altId 또는 URL로 인코딩 $id 내보내려는 XDM 리소스. |
요청
다음 요청은 다음에 대한 내보내기 페이로드를 검색합니다. Restaurant
필드 그룹입니다.
curl -X GET \
https://platform.adobe.io/data/foundation/schemaregistry/rpc/export/_{TENANT_ID}.mixins.922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9 \
-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 'Accept: application/vnd.adobe.xdm-link+json'
응답
성공적인 응답은 대상 XDM 리소스 및 모든 종속 리소스를 나타내는 오브젝트 배열을 반환합니다. 이 예에서 배열의 첫 번째 객체는 테넌트가 생성한 객체입니다 Property
이(가) Restaurant
필드 그룹은 를 사용하는 반면 두 번째 개체는 입니다. Restaurant
필드 그룹 자체. 그런 다음 이 페이로드를 사용하여 다음을 수행할 수 있습니다. 리소스 가져오기 다른 샌드박스 또는 조직에 연결합니다.
리소스 테넌트 ID의 모든 인스턴스는 로 대체됩니다. <XDM_TENANTID_PLACEHOLDER>
. 그러면 스키마 레지스트리는 후속 가져오기 호출에서 보낸 위치에 따라 리소스에 올바른 테넌트 ID를 자동으로 적용할 수 있습니다.
[
{
"$id": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/datatypes/fc07162ee7ca8d18e074a3bb50c3938c76160bf6040e8495",
"meta:altId": "_<XDM_TENANTID_PLACEHOLDER>.datatypes.fc07162ee7ca8d18e074a3bb50c3938c76160bf6040e8495",
"meta:resourceType": "datatypes",
"version": "1.0",
"title": "Property",
"type": "object",
"description": "",
"definitions": {
"customFields": {
"properties": {
"propertyId": {
"title": "Property ID",
"description": "ID for a company-owned property.",
"type": "string",
"isRequired": false,
"meta:ui": {
"ref": [
"schema://5fbc29ec292534000055dd55",
"#/definitions/customFields"
],
"path": "{}._<XDM_TENANTID_PLACEHOLDER>{}.property{}.propertyId",
"editable": true,
"generateDate": 1606168175975
},
"meta:xdmType": "string"
},
"jurisdiction": {
"title": "Jurisdiction",
"description": "",
"type": "string",
"isRequired": false,
"enum": [
"NA",
"UK",
"EU"
],
"meta:enum": {
"NA": "North America",
"UK": "United Kingdom",
"EU": "European Union"
},
"meta:ui": {
"ref": [
"schema://5fbc29ec292534000055dd55",
"#/definitions/customFields"
],
"path": "{}._<XDM_TENANTID_PLACEHOLDER>{}.property{}.jurisdiction",
"editable": true,
"generateDate": 1606168175975
},
"meta:xdmType": "string"
}
}
}
},
"allOf": [
{
"$ref": "#/definitions/customFields",
"type": "object",
"meta:xdmType": "object"
}
],
"meta:extensible": true,
"meta:abstract": true,
"meta:xdmType": "object",
"meta:sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
"meta:sandboxType": "production"
},
{
"$id": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/mixins/922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
"meta:altId": "_<XDM_TENANTID_PLACEHOLDER>.mixins.922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
"meta:resourceType": "mixins",
"version": "1.0",
"title": "Restaurant",
"type": "object",
"description": "",
"definitions": {
"customFields": {
"type": "object",
"properties": {
"_<XDM_TENANTID_PLACEHOLDER>": {
"type": "object",
"properties": {
"capacity": {
"title": "Capacity",
"description": "Restaurant capacity",
"type": "string",
"isRequired": false,
"meta:xdmType": "string"
},
"kitchen": {
"title": "Kitchen Style",
"description": "Style of kitchen",
"type": "string",
"isRequired": false,
"meta:xdmType": "string"
},
"rating": {
"title": "Rating",
"description": "",
"type": "integer",
"isRequired": false,
"meta:xdmType": "int"
},
"property": {
"title": "Property",
"description": "",
"$ref": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/datatypes/fc07162ee7ca8d18e074a3bb50c3938c76160bf6040e8495",
"type": "object",
"meta:xdmType": "object"
}
},
"meta:xdmType": "object"
}
},
"meta:xdmType": "object"
}
},
"allOf": [
{
"$ref": "#/definitions/customFields",
"type": "object",
"meta:xdmType": "object"
}
],
"meta:extensible": true,
"meta:abstract": true,
"meta:intendedToExtend": [],
"meta:xdmType": "object",
"meta:sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
"meta:sandboxType": "production"
}
]
CSV 파일에서 내보내기 페이로드를 생성한 후 해당 페이로드를 로 전송할 수 있습니다. /rpc/import
스키마를 생성할 끝점입니다.
다음을 참조하십시오. 끝점 가져오기 안내서 내보내기 페이로드에서 스키마를 생성하는 방법에 대한 자세한 내용