Show Menu
화제×

리소스 목록

단일 GET 요청을 수행하여 컨테이너 내에 특정 유형(클래스, 믹싱, 스키마, 데이터 유형 또는 설명자)의 모든 스키마 레지스트리 리소스 목록을 볼 수 있습니다.
리소스를 나열할 때 스키마 레지스트리는 결과 세트를 300개 항목으로 제한합니다. 이 제한을 넘는 리소스를 반환하려면 페이징 매개 변수를 사용해야 합니다 . 쿼리 매개 변수를 사용하여 결과를 필터링하고 반환된 리소스 수를 줄이는 것도 좋습니다.
API 형식
GET /{CONTAINER_ID}/{RESOURCE_TYPE}
GET /{CONTAINER_ID}/{RESOURCE_TYPE}?{QUERY_PARAMS}

매개 변수
설명
{CONTAINER_ID}
리소스가 있는 컨테이너("전역" 또는 "테넌트").
{RESOURCE_TYPE}
스키마 라이브러리에서 검색할 리소스 유형입니다. 유효한 유형은 classes , mixins``schemas , datatypes descriptors 입니다.
{QUERY_PARAMS }
결과를 필터링하는 선택적 쿼리 매개 변수입니다. 자세한 내용은 쿼리 매개 변수 섹션을 참조하십시오.
요청
curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/global/classes&limit=2 \
  -H 'Accept: application/vnd.adobe.xed-id+json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

응답 형식은 요청에서 전송된 수락 헤더에 따라 다릅니다. 리소스를 나열하는 경우 다음 승인 헤더를 사용할 수 있습니다.
헤더 수락
설명
application/vnd.adobe.xed-id+json
각 리소스에 대한 간단한 요약을 반환합니다. 리소스를 나열하는 데 권장되는 헤더입니다. (제한: 300)
application/vnd.adobe.xed+json
원본 및 포함된 각 리소스에 대한 전체 JSON 스키마 $ref allOf 반환합니다. (제한: 300)
application/vnd.adobe.xdm-v2+json
끝점을 사용할 때 /descriptors 페이징 기능을 활용하려면 이 승인 헤더를 사용해야 합니다.
응답
위의 요청에는 application/vnd.adobe.xed-id+json 수락 헤더가 사용되므로 응답에는 각 리소스 title , $id 및 속성만 포함됩니다 meta:altId``version . 수락 헤더 full 로 대체하면 각 리소스의 모든 속성이 반환됩니다. 응답에 필요한 정보에 따라 적절한 수락 헤더를 선택합니다.
{
  "results": [
    {
        "title": "XDM ExperienceEvent",
        "$id": "https://ns.adobe.com/xdm/context/experienceevent",
        "meta:altId": "_xdm.context.experienceevent",
        "version": "1"
    },
    {
        "title": "XDM Individual Profile",
        "$id": "https://ns.adobe.com/xdm/context/profile",
        "meta:altId": "_xdm.context.profile",
        "version": "1"
    }
  ]
}

쿼리 매개 변수 사용

스키마 레지스트리는 리소스를 나열할 때 쿼리 매개 변수를 페이지에 사용하고 결과를 필터링하는 것을 지원합니다.
여러 쿼리 매개 변수를 결합할 때는 앰퍼샌드(앰퍼샌드)로 구분해야 & 합니다.

페이징

페이징 시 가장 일반적인 쿼리 매개 변수는 다음과 같습니다.
매개 변수
설명
start
나열된 결과가 시작되는 위치를 지정합니다. 이 값은 목록 응답의 _page.next 속성에서 얻을 수 있으며 다음 결과 페이지에 액세스하는 데 사용할 수 있습니다. 값이 _page.next null이면 사용할 수 있는 추가 페이지가 없습니다.
limit
반환된 리소스 수를 제한합니다. 예: limit=5 5개의 리소스 목록을 반환합니다.
orderby
특정 속성별로 결과를 정렬합니다. 예: orderby=title 결과를 제목별로 오름차순(A-Z)으로 정렬합니다. 제목 - 앞에 항목을 추가하면( orderby=-title Z-A) 제목이 내림차순으로 항목을 정렬합니다.

필터링

검색된 리소스 내의 지정된 JSON 속성에 대해 특정 연산자를 적용하는 데 사용되는 매개 변수를 사용하여 결과를 필터링할 수 있습니다. property 지원되는 연산자는 다음과 같습니다.
연산자
설명
==
속성이 제공된 값과 같은지 여부를 기준으로 필터링합니다.
property=title==test
!=
속성이 제공된 값과 동일하지 않은지 여부를 기준으로 필터링합니다.
property=title!=test
<
속성이 제공된 값보다 작은지 여부를 기준으로 필터링합니다.
property=version<5
>
속성이 제공된 값보다 큰지 여부를 기준으로 필터링합니다.
property=version>5
<=
속성이 제공된 값보다 작거나 같은지 여부를 기준으로 필터링합니다.
property=version<=5
>=
속성이 제공된 값보다 크거나 같은지 여부를 필터링합니다.
property=version>=5
~
속성이 제공된 정규 표현식과 일치하는지 여부를 기준으로 필터링합니다.
property=title~test$
(없음)
속성 이름만 지정하면 속성이 있는 항목만 반환됩니다.
property=title
매개 변수를 사용하여 호환 클래스에 따라 믹스를 필터링할 수 property 있습니다. 예를 들어 XDM 개별 프로필 클래스와 호환되는 혼합만 property=meta:intendedToExtend==https://ns.adobe.com/xdm/context/profile 반환합니다.