일정 끝점

예약은 하루에 한 번 배치 세분화 작업을 자동으로 실행하는 데 사용할 수 있는 도구입니다. 다음을 사용할 수 있습니다. /config/schedules 일정 목록을 검색하거나, 새 일정을 만들거나, 특정 일정의 세부 정보를 검색하거나, 특정 일정을 업데이트하거나, 특정 일정을 삭제하는 끝점입니다.

시작하기

이 안내서에 사용된 끝점은 Adobe Experience Platform Segmentation Service API. 계속하기 전에 다음을 검토하십시오. 시작 안내서 필수 헤더와 예제 API 호출을 읽는 방법 등 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보입니다.

일정 목록 검색 retrieve-list

에 GET 요청을 하여 조직의 모든 일정 목록을 검색할 수 있습니다. /config/schedules 엔드포인트.

API 형식

다음 /config/schedules 엔드포인트는 결과를 필터링하는 데 도움이 되는 몇 가지 쿼리 매개 변수를 지원합니다. 이러한 매개 변수는 선택 사항이지만 값비싼 오버헤드를 줄이는 데 도움이 되도록 사용하는 것이 좋습니다. 매개 변수 없이 이 끝점을 호출하면 조직에서 사용할 수 있는 모든 일정을 검색합니다. 여러 매개 변수를 포함할 수 있으며 앰퍼샌드(&).

GET /config/schedules
GET /config/schedules?start={START}
GET /config/schedules?limit={LIMIT}
매개변수
설명
{START}
오프셋을 시작할 페이지를 지정합니다. 기본적으로 이 값은 0이 됩니다.
{LIMIT}
반환되는 일정 수를 지정합니다. 기본적으로 이 값은 100이 됩니다.

요청

다음 요청은 조직 내에 게시된 마지막 10개의 일정을 검색합니다.

curl -X GET https://platform.adobe.io/data/core/ups/config/schedules?limit=10 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

성공적인 응답은 지정된 조직에 대한 일정 목록이 JSON인 HTTP 상태 200을 반환합니다.

NOTE
다음 응답은 공간에 대해 잘렸으며, 반환된 첫 번째 예약만 표시합니다.
{
    "_page": {
        "totalCount": 10,
        "pageSize": 1
    },
    "children": [
        {
            "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "name": "Batch Segmentation",
            "state": "active",
            "type": "batch_segmentation",
            "schedule": "0 0 1 * * ?",
            "properties": {
                "segments": []
            },
            "createEpoch": 1573158851,
            "updateEpoch": 1574365202
        }
    ],
    "_links": {
        "next": {}
    }
}
속성
설명
_page.totalCount
반환된 총 일정 수입니다.
_page.pageSize
일정 페이지의 크기입니다.
children.name
문자열로 표시되는 예약의 이름입니다.
children.type
문자열로서의 작업 유형입니다. 지원되는 두 가지 유형은 "batch_segmentation" 및 "export"입니다.
children.properties
일정과 관련된 추가 등록 정보가 포함된 객체입니다.
children.properties.segments
사용 ["*"] 는 모든 세그먼트가 포함되어 있는지 확인합니다.
children.schedule
작업 일정을 포함하는 문자열입니다. 작업은 하루에 한 번만 실행되도록 예약할 수 있습니다. 즉, 24시간 동안 작업을 두 번 이상 실행하도록 예약할 수 없습니다. cron 일정에 대한 자세한 내용은 cron 표현식 형식. 이 예에서 "0 0 1 * *"는 이 일정이 매일 오전 1시에 실행됨을 의미합니다.
children.state
일정 상태를 포함하는 문자열입니다. 지원되는 두 가지 상태는 "활성" 및 "비활성"입니다. 기본적으로 상태는 "비활성"으로 설정됩니다.

새 일정 만들기 create

에 POST 요청을 하여 새 일정을 만들 수 있습니다. /config/schedules 엔드포인트.

API 형식

POST /config/schedules

요청

curl -X POST https://platform.adobe.io/data/core/ups/config/schedules \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
{
    "name":"profile-default",
    "type":"batch_segmentation",
    "properties":{
        "segments":[
            "*"
        ]
    },
    "schedule":"0 0 1 * * ?",
    "state":"inactive"
}'
속성
설명
name
필수. 문자열로 표시되는 예약의 이름입니다.
type
필수. 문자열로서의 작업 유형입니다. 지원되는 두 가지 유형은 "batch_segmentation" 및 "export"입니다.
properties
필수. 일정과 관련된 추가 등록 정보가 포함된 객체입니다.
properties.segments
필요한 경우 type 은 "batch_segmentation"과 같습니다. 사용 ["*"] 는 모든 세그먼트가 포함되어 있는지 확인합니다.
schedule
선택 사항입니다. 작업 일정을 포함하는 문자열입니다. 작업은 하루에 한 번만 실행되도록 예약할 수 있습니다. 즉, 24시간 동안 작업을 두 번 이상 실행하도록 예약할 수 없습니다. cron 일정에 대한 자세한 내용은 cron 표현식 형식. 이 예에서 "0 0 1 * *"는 이 일정이 매일 오전 1시에 실행됨을 의미합니다.

이 문자열을 제공하지 않으면 시스템에서 생성한 일정이 자동으로 생성됩니다.
state
선택 사항입니다. 일정 상태를 포함하는 문자열입니다. 지원되는 두 가지 상태는 "활성" 및 "비활성"입니다. 기본적으로 상태는 "비활성"으로 설정됩니다.

응답

성공한 응답은 새로 만든 일정의 세부 정보와 함께 HTTP 상태 200을 반환합니다.

{
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "e7e17720-c5bb-11e9-aafb-87c71c35cac8",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "{SCHEDULE_NAME}",
    "state": "inactive",
    "type": "batch_segmentation",
    "schedule": "0 0 1 * * ?",
    "properties": {
        "segments": [
            "*"
        ]
    },
    "createEpoch": 1568267948,
    "updateEpoch": 1568267948
}

특정 일정 검색 get

에 GET 요청을 하여 특정 일정에 대한 자세한 정보를 검색할 수 있습니다. /config/schedules 엔드포인트 및 요청 경로에서 검색할 예약의 ID를 제공합니다.

API 형식

GET /config/schedules/{SCHEDULE_ID}
매개변수
설명
{SCHEDULE_ID}
다음 id 검색할 일정의 값입니다.

요청

curl -X GET https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

성공한 응답은 지정된 일정에 대한 자세한 정보와 함께 HTTP 상태 200을 반환합니다.

{
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "e7e17720-c5bb-11e9-aafb-87c71c35cac8",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "{SCHEDULE_NAME}",
    "state": "inactive",
    "type": "batch_segmentation",
    "schedule": "0 0 1 * * ?",
    "properties": {
        "segments": [
            "*"
        ]
    },
    "createEpoch": 1568267948,
    "updateEpoch": 1568267948
}
속성
설명
name
문자열로 표시되는 예약의 이름입니다.
type
문자열로서의 작업 유형입니다. 지원되는 두 가지 유형은 다음과 같습니다 batch_segmentationexport.
properties
일정과 관련된 추가 등록 정보가 포함된 객체입니다.
properties.segments
사용 ["*"] 는 모든 세그먼트가 포함되어 있는지 확인합니다.
schedule
작업 일정을 포함하는 문자열입니다. 작업은 하루에 한 번만 실행되도록 예약할 수 있습니다. 즉, 24시간 동안 작업을 두 번 이상 실행하도록 예약할 수 없습니다. cron 일정에 대한 자세한 내용은 cron 표현식 형식. 이 예에서 "0 0 1 * *"는 이 일정이 매일 오전 1시에 실행됨을 의미합니다.
state
일정 상태를 포함하는 문자열입니다. 지원되는 두 가지 상태는 다음과 같습니다 activeinactive. 기본적으로 상태는 로 설정됩니다. inactive.

특정 일정에 대한 세부 정보 업데이트 update

에 PATCH 요청을 하여 특정 일정을 업데이트할 수 있습니다. /config/schedules 엔드포인트 및 요청 경로에서 업데이트하려는 예약의 ID를 제공합니다.

PATCH 요청을 사용하면 다음 중 하나를 업데이트할 수 있습니다. 상태 또는 cron 일정 개별 일정에 대해.

일정 상태 업데이트 update-state

JSON 패치 작업을 사용하여 스케줄의 상태를 업데이트할 수 있습니다. 상태를 업데이트하려면 다음을 선언합니다. path 다음으로 속성: /state 및 설정 value 다음 중 하나로 active 또는 inactive. JSON 패치에 대한 자세한 내용은 JSON 패치 설명서를 참조하십시오.

API 형식

PATCH /config/schedules/{SCHEDULE_ID}
매개변수
설명
{SCHEDULE_ID}
다음 id 업데이트할 일정의 값입니다.

요청

curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
[
    {
        "op": "add",
        "path": "/state",
        "value": "active"
    }
]'
속성
설명
path
패치할 값의 경로입니다. 이 경우 일정의 상태를 업데이트하고 있으므로 값을 설정해야 합니다. path to "/state".
value
일정 상태의 업데이트된 값. 이 값은 일정을 활성화하거나 비활성화하기 위해 "활성" 또는 "비활성"으로 설정할 수 있습니다. 다음을 참고하십시오. 할 수 없음 조직이 스트리밍을 사용할 수 있도록 설정된 경우 일정을 비활성화합니다.

응답

성공적인 응답은 HTTP 상태 204(콘텐츠 없음)를 반환합니다.

cron 일정 업데이트 update-schedule

JSON 패치 작업을 사용하여 cron 일정을 업데이트할 수 있습니다. 일정을 업데이트하려면 다음을 선언합니다. path 다음으로 속성: /schedule 및 설정 value 유효한 cron 일정에 따라. JSON 패치에 대한 자세한 내용은 JSON 패치 설명서를 참조하십시오. cron 일정에 대한 자세한 내용은 cron 표현식 형식.

API 형식

PATCH /config/schedules/{SCHEDULE_ID}
매개변수
설명
{SCHEDULE_ID}
다음 id 업데이트할 일정의 값입니다.

요청

curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
[
    {
        "op":"add",
        "path":"/schedule",
        "value":"0 0 2 * * ?"
    }
]'
속성
설명
path
업데이트할 값의 경로입니다. 이 경우 cron 스케줄을 업데이트하므로 값을 로 설정해야 합니다. path/schedule.
value
cron schedule의 업데이트된 값. 이 값은 cron schedule 형식이어야 합니다. 이 예에서는 일정이 매월 2일에 실행됩니다.

응답

성공적인 응답은 HTTP 상태 204(콘텐츠 없음)를 반환합니다.

특정 일정 삭제

에 DELETE 요청을 하여 특정 일정을 삭제하도록 요청할 수 있습니다. /config/schedules 엔드포인트 및 요청 경로에서 삭제하려는 예약의 ID를 제공합니다.

API 형식

DELETE /config/schedules/{SCHEDULE_ID}
매개변수
설명
{SCHEDULE_ID}
다음 id 삭제할 일정의 값입니다.

요청

curl -X DELETE https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

성공적인 응답은 HTTP 상태 204(콘텐츠 없음)를 반환합니다.

다음 단계

이 안내서를 읽고 나면 이제 일정이 어떻게 돌아가는지에 대해 더 잘 이해할 수 있습니다.

부록 appendix

다음 부록에서는 일정에 사용되는 cron 표현식의 형식을 설명합니다.

형식

cron 표현식은 6개 또는 7개의 필드로 구성된 문자열입니다. 표현식은 다음과 유사합니다.

0 0 12 * * ?

cron 표현식 문자열에서 첫 번째 필드는 초를 나타내고, 두 번째 필드는 분을 나타내고, 세 번째 필드는 시간을 나타내고, 네 번째 필드는 요일을 나타내고, 다섯 번째 필드는 월을 나타내고, 여섯 번째 필드는 요일을 나타냅니다. 연도를 나타내는 일곱 번째 필드를 선택적으로 포함할 수도 있습니다.

필드 이름
필수 여부
가능한 값
허용되는 특수 문자
0-59
, - * /
0-59
, - * /
시간
0-23
, - * /
날짜(월 기준)
1-31
, - * ? / L W
1-12, 1-12
, - * /
요일
1-7, 순토
, - * ? / L #
아니요
비어 있음, 1970-2099
, - * /
NOTE
월 이름과 요일 이름은 다음과 같습니다 아님 대/소문자를 구분합니다. 따라서 SUN 는 을 사용하는 것과 같습니다 sun.

허용되는 특수 문자는 다음 의미를 나타냅니다.

특수 문자
설명
*
이 값은 다음을 선택하는 데 사용됩니다. 모두 필드에 있는 값입니다. 예: 퍼팅 * 시간 필드에서 는 다음을 의미합니다 시간.
?
이 값은 특정 값이 필요하지 않음을 의미합니다. 일반적으로 한 필드에 문자가 허용되는 항목을 지정하고 다른 필드에는 지정하지 않는 데 사용됩니다. 예를 들어, 매월 3일에 이벤트가 트리거되도록 하고 싶지만, 그 요일에 대해서는 신경 쓰지 않는다면 을 입력하면 됩니다 3 날짜 필드 및 ? (요일 필드)을 참조하십시오.
-
이 값은 다음을 지정하는 데 사용됩니다. 포괄 필드에 대한 범위입니다. 예를 들어 9-15 시간 필드에서 시간은 9, 10, 11, 12, 13, 14 및 15를 의미합니다.
,
이 값은 추가 값을 지정하는 데 사용됩니다. 예를 들어 MON, FRI, SAT 요일 필드에서 요일은 월요일, 금요일 및 토요일을 의미합니다.
/
이 값은 증분을 지정하는 데 사용됩니다. 앞에 배치된 값 / 에서 증가하는 위치를 결정하지만 값은 뒤에 배치됩니다. / 증분의 양을 결정합니다. 예를 들어 1/7 분 필드에서 분은 1, 8, 15, 22, 29, 36, 43, 50 및 57을 포함합니다.
L
이 값은 다음을 지정하는 데 사용됩니다. Last는 사용되는 필드에 따라 다른 의미를 갖습니다. 날짜 필드와 함께 사용하는 경우 해당 월의 마지막 날을 나타냅니다. 요일 필드와 함께 단독으로 사용하는 경우 해당 주의 마지막 날인 토요일(SAT). 다른 값과 함께 요일 필드를 사용하는 경우 해당 월의 해당 유형의 마지막 날을 나타냅니다. 예를 들어 5L 요일 필드에서는 전용 해당 월의 마지막 금요일을 포함합니다.
W
이 값은 지정된 날짜와 가장 가까운 요일을 지정하는 데 사용됩니다. 예를 들어 18W 날짜 필드는 해당 월의 18일이 토요일인 경우 가장 가까운 평일인 17일 금요일에 트리거됩니다. 만약 그달 18일이 일요일이었다면 월요일과 평일이 가장 가까운 19일에 트리거됩니다. 다음을 넣으면 주의하십시오. 1W 날짜 필드에서 가장 가까운 요일이 이전 달에 있는 경우에도 이벤트는 가장 가까운 요일에 트리거됩니다. 현재 월.

또한 결합할 수 있습니다 LW 제작 LW: 해당 월의 마지막 요일을 지정합니다.
#
이 값은 한 달에 n번째 요일을 지정하는 데 사용됩니다. 앞에 배치된 값 # 은 요일을 나타내고, 값은 다음 뒤에 배치됩니다. # 해당 월의 발생 횟수를 나타냅니다. 예를 들어 1#3, 이벤트는 그 달의 세 번째 일요일에 트리거됩니다. 다음을 넣으면 주의하십시오. X#5 그리고 그 달에는 그 주의 그 날에 다섯 번째 발생하는 일이 없습니다. 아님 트리거됩니다. 예를 들어 1#5, 그리고 그 달에는 다섯 번째 일요일이 없습니다. 이 이벤트는 아님 트리거됩니다.

예시

다음 표에서는 샘플 cron 표현식 문자열을 보여 주고 그 의미를 설명합니다.

표현식
설명
0 0 13 * * ?
그 행사는 매일 오후 1시에 시작될 것이다.
0 30 9 * * ? 2022
이 행사는 2022년에 매일 오전 9시 30분에 시작될 예정입니다.
0 * 18 * * ?
행사는 매일 오후 6시부터 시작해 오후 6시 59분에 종료되는 등 매 분마다 불이 붙는다.
0 0/10 17 * * ?
이 행사는 매일 오후 5시부터 오후 6시까지 10분 간격으로 시작됩니다.
0 13,38 5 ? 6 WED
이 행사는 6월 매주 수요일 오전 5시 13분과 5시 38분에 발사된다.
0 30 12 ? * 4#3
행사는 매월 셋째 주 수요일 낮 12시 30분에 발사가 진행된다.
0 30 12 ? * 6L
행사는 매월 마지막 주 금요일 낮 12시 30분에 발사가 진행된다.
0 45 11 ? * MON-THU
이벤트는 매주 월, 화, 수, 목요일 오전 11시 45분에 발사됩니다.
recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871