이 페이지는 Cloud Translation API를 통해 번역되었습니다.

수익 창출 작업 예약

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

예약된 작업 개요

수익 창출은 작업 스케줄러와 특정 시점에 실행되도록 사전 예약된 작업 세트를 제공합니다. 시간을 절약할 수 있습니다.

아래 표에는 수익 창출에서 제공하는 사전 예약된 작업과 작업 시간이 나와 있습니다. (나열된 모든 시간은 UTC 기준) 각 작업의 트리거도 나열됩니다.

작업	설명	일정(UTC)	트리거
월별 개발자 세율	각 개발자의 세금 엔진에서 세율을 가져와 개발자를 업데이트합니다. 새 세율을 적용합니다.	매월 1일 오전 5시 45분	`MINT.MONTHLY_DEV_TAXRATE@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
구독 갱신	활성 요금제의 반복 수수료 또는 현재 날짜에 시작합니다.	매일 자정 후 5초	`MINT.RENEW_SUBSCRIPTIONS@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
XeFeed 업데이터	지원되는 각 통화에 대해 미국 달러로 환율을 가져옵니다.	매일 자정 후 1초	`MINT.XEFEED@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
개발자 요금제 갱신	요금제의 갱신 날짜를 이월하고 조기 해지 수수료를 계산합니다.	매일 오전 2시 20분	`MINT.RENEW_DEV_RATEPLAN@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
트랜잭션 릴레이 재시도	참고: 이 작업은 지원 중단되었으며 수익을 창출할 수 있습니다.	매일 오전 4시 30분	`MINT.RETRY_TX_RELAY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
트랜잭션 정리 도구	참고: 이 작업은 지원 중단되었으며 수익을 창출할 수 있습니다.	매일 오전 5시 30분	`MINT.TX_CLEANSER@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
개발자 잔액 감사	개발자 계정 잔액을 감사합니다. 현재 사용량 및 선불 데이터를 복사합니다. 후불 크레딧 한도를 감사 표에 추가한 후 사용 잔액을 0으로 되돌립니다.	매월 1일 자정 후 5초	`MINT.DEVELOPER_BALANCE_AUDIT@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
월별 결제 문서	결제 문서를 생성합니다. 참고: Apigee는 더 이상 Apigee Edge 수익 창출에서 청구 문서 생성을 지원하지 않습니다. 중단을 참조하세요.	매월 11일 자정 후 1분	`MINT.MONTLY_BILLING_DOCS@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
개발자 요금제 카운터	참고: 이 작업은 지원 중단되었으며 수익을 창출할 수 있습니다.	매일 자정 후 3초	`MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
일일 청구 금액	모든 시간당 거래 합계를 다시 계산하고 이를 사용하여 있습니다.	매일 오전 1시 20분	`MINT.CHARGE_DAILY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
시간당 요금	매시간 분기마다 모든 트랜잭션 합계를 계산합니다.	매시 15분 전	`MINT.CHARGE_HOURLY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
알림 구성 새로고침	모든 알림 조건의 색인을 다시 생성합니다.	5분마다	`MINT.REFRESH_NOTIFICATION_CONFIG@@@ management-server@@@SYSTEM@@@ management-server@@@SYSTEM`
이메일 알림 보내기	누적된 이메일 알림 전송	1시간마다	`MINT.EMAIL_NOTIFICATION@@@ management-server@@@SYSTEM@@@ management-server@@@SYSTEM`
새로고침 제한	참고: 이 작업은 지원 중단되었으며 수익을 창출할 수 있습니다.	해당 사항 없음 (실행하지 않음)	`MINT.REFRESH_LIMIT@@@ message-processor@@@SYSTEM@@@ message-processor@@@SYSTEM`

위에 나열된 작업 외에도 이벤트를 통해 사용 설정할 수 있는 작업이 있습니다. 알림을 전송합니다. 자세한 내용은 알림 설정하기를 참고하세요.

작업	설명	일정	트리거
새 패키지 알림	새 API 패키지를 사용할 수 있다는 알림을 모든 개발자에게 전송합니다.	한 번 실행 — 작업이 활성화된 당일 오후 9시 참고: 알림은 등록 여부와 관계없이 한 번만 전송됩니다. 작업이 여러 번 실행되게 하는 `cronExpression` 구성 표시됩니다.	`MINT.NEW_PACKAGE_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
새 임시 알림	특정 지역에서 새로운 API 제품을 사용할 수 있다는 알림을 모든 개발자에게 보냅니다. 있습니다.	한 번 실행 — 작업이 활성화된 당일 오후 9시 참고: 알림은 등록 여부와 관계없이 한 번만 전송됩니다. 작업이 여러 번 실행되게 하는 `cronExpression` 구성 표시됩니다.	`MINT.ADHOC_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
신제품 알림	새 API 제품을 사용할 수 있다는 알림을 모든 개발자에게 보냅니다.	한 번 실행 — 작업이 활성화된 당일 오후 9시 참고: 알림은 등록 여부와 관계없이 한 번만 전송됩니다. 작업이 여러 번 실행되게 하는 `cronExpression` 구성 표시됩니다.	`MINT.NEW_PRODUCT_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
새 요금제 알림	영향을 받는 개발자에게 새로운 요금제를 사용할 수 있다는 알림을 전송합니다. 전체 상위 요금제를 구독 중인 개발자는 새 요금제가 활성화됨. 또한 다음 사항도 적용됩니다. 요금제가 기본 요금제인 경우 모든 개발자에게 알림이 전송됩니다. 개발자 카테고리 요금제인 경우 해당 카테고리의 개발자만 있습니다. 개발자 요금제인 경우 해당 개발자만 있습니다.	새 요금제 시작일 오전 4시 30분에 실행됩니다.	`MINT.NEW_RATEPLAN_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
새 Tnc	영향을 받는 개발자에게 신규 또는 개정 이용약관 알림을 보냅니다. 게시되어 있으며 개발자가 아직 수락하지 않았습니다.	신규 또는 수정된 이용약관 시작일로부터 30일, 7일, 1일 전에 실행됩니다. 오후 9시	`MINT.TNC_ACCEPTANCE_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
만료 예정인 요금제	영향을 받는 개발자에게 알림을 보내 요금제가 만료됩니다.	요금제 만료 30, 7, 1일 전 오후 9시에 실행합니다.	`MINT.EXPIRING_RATE_PLAN_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`

API를 사용하여 수익 창출 작업 일정 관리

다음 섹션에서는 API를 사용하여 수익 창출 작업 일정을 관리하는 방법을 설명합니다.

트리거 구성
크론 표현식 빌드
API를 사용하여 예약된 작업 보기
API를 사용하여 예약된 작업 업데이트
예약된 작업을 사용 중지했다가 다시 사용 설정하려면 API

이 섹션에 설명된 API에 대한 자세한 내용은 API의 예약된 작업을 참조하세요. 참조

트리거 구성

스케줄러는 트리거를 사용하여 작업을 실행합니다. 예약된 작업은 트리거가 실행됩니다 트리거의 속성은 작업 실행을 구성하며, 이러한 속성의 값을 지정하여 작업 실행의 특성을 제어할 수 있습니다. 예를 들어 작업이 실행할 수도 있습니다

가장 일반적인 트리거 유형 두 가지는 크론 트리거와 단순 트리거 트리거를 사용합니다. 크론 트리거에는 cronExpression 속성이 있어 실행할 수 있습니다 단순 트리거에는 cronExpression 속성이 없습니다. 나 startTime를 지정하여 트리거가 적용되는 시점을 나타냅니다. 선택적으로 endTime.

트리거 속성은 다음과 같습니다 (나열된 모든 시간은 UTC 기준).

속성	설명
`cronExpression`	트리거에 대한 실행 일정을 만드는 크론 표현식(예: 'At 8:00 A.M. 매주 월요일부터 금요일까지 또는 '오전 1시 30분 매월 마지막 금요일' 자세한 내용은 자세한 내용은 크론 표현식 빌드를 참조하세요. 이 속성을 지정하면 트리거가 크론 트리거로 정의됩니다. 참고: `cronExpression` 및 `startTime`/`endTime`가 지정됨, `cronExpression` 우선 적용됩니다
`enabled`	트리거를 실행할 수 있는지 여부를 나타내는 플래그입니다. 값은 다음 중 하나일 수 있습니다. 다음과 같습니다. <ph type="x-smartling-placeholder"> </ph> `true` 트리거가 실행되도록 사용 설정되었습니다. `false`. 트리거가 사용 중지되었으며 실행되지 않습니다.
`endTime`	트리거 일정이 더 이상 적용되지 않는 에포크 형식의 시간입니다.
`group`	트리거가 실행될 서버의 유형입니다. 예를 들어 트리거가 실행하려는 경우 값은 `management-server` 트리거가 메시지에서 실행되어야 하는지 여부 값을 `message-processor`로 설정해야 합니다.
`id`	트리거 식별
`jobId`	실행할 작업의 ID입니다.
`name`	트리거를 식별하는 데 사용되는 고유한 이름입니다.
`priority`	여러 트리거의 실행이 예약된 경우 해당 트리거의 상대적 실행 우선순위 할 수 있습니다. 값이 작을수록 우선순위가 높아집니다. 예를 들어 두 개의 트리거가 동시에 실행되도록 예약되었으며 한 트리거의 우선순위가 1이고 우선순위가 2인 트리거가 먼저 실행됩니다. 이 속성은 여러 트리거의 실행이 정확히 동일한 경우에만 적용됩니다. 있습니다.
`startTime`	단순 트리거에만 적용됩니다. 트리거 일정이 적용되는 에포크 형식의 시간입니다. 참고: `cronExpression` 및 `startTime`/`endTime` 모두 지정하면 `cronExpression`가 우선합니다.
`suiteId`	알림 부분이 시스템 수준인지 기본 수준인지를 지정하는 플래그 알림 제품군입니다. 유효한 값은 `DEFAULT` 또는 `SYSTEM`입니다. 고유한 도구 모음 이름을 지정할 수 있습니다.
`triggerDataMap`	여러 서버가 실행되지 못하도록 하는 잠금 키(`custom_lock_key`) 동시에 사용할 수 있습니다

크론 표현식 빌드

크론 표현식은 공백으로 구분된 6개 또는 7개의 필드로 구성된 문자열입니다. 이 표현식은 시간 집합을 나타내며 일반적으로 루틴을 실행하기 위한 일정으로 나타냅니다. 크론 트리거의 cronExpression 속성에 지정된 표현식이 사용됩니다. 해당 트리거의 실행을 예약합니다

크론 표현식의 형식은

s
  m h dm m dw y

입니다.

각 항목의 의미는 다음과 같습니다.

필드	설명	필수	허용되는 값	허용되는 특수문자
`s`	초	예	0-59	, - * /
`m`	분	예	0-59	, - * /
`h`	시간	예	0-23	, - * /
`dm`	날짜	예	0-31	, - * ? / L W
`m`	월	예	1~12일 또는 1월~12월	, - * /
`dw`	요일	예	1~7 또는 SUN-SAT	, - * ? / 왼쪽 번호
`y`	연도	아니요	비어 있거나 1970-2099	, - * /

특수문자는 다음과 같이 정의됩니다.

특수문자	설명
*	필드 내의 모든 값을 선택하는 데 사용됩니다. 예를 들어 분 필드에 * 표시는 매분입니다.
?	문자가 허용되는 두 필드 중 하나에서 무언가를 지정하는 데 사용됩니다. 다른 한쪽은 그렇지 않습니다. 예를 들어 특정 날짜에 트리거를 실행하려는 경우 요일을 정하지 않으면 월 필드 및 ? 입력될 수 있습니다.
-	범위를 지정하는 데 사용됩니다. 예를 들어, 시간 필드에서 10-12는 시간 10, 11 및 12.
,	추가 값을 지정하는 데 사용됩니다. 예를 들어 요일 필드에 MON, WED, FRI를 입력합니다. 는 월요일, 수요일, 금요일을 의미합니다.
/	증분을 지정하는 데 사용됩니다. 예를 들어, 초 필드의 0/15는 초 0을 의미하며, 15, 30, 45입니다. 그리고 초 필드의 5/15는 5, 20, 35, 50초를 의미합니다. 다음과 같은 작업을 할 수 있습니다. ' 있습니다. 이는 / 앞에 0을 넣는 것과 같습니다. 일 필드에 1/3을 지정하면 첫 번째 날부터 3일마다 실행됩니다. 날짜입니다.
L	허용되는 두 필드의 각각 다른 의미를 지닙니다. 당일 L 월 필드는 그 달의 마지막 날, 즉 1월의 경우 31일, 1월의 경우 28일을 의미합니다. 윤년이 아닌 2월. 요일 필드에서 L은 마지막 날을 의미하며, 7 또는 SAT입니다. 그러나 다른 값 뒤에 요일 필드에서 사용할 경우 해당 월의 마지막 xxx일 예를 들어 6L은 월의 마지막 금요일을 의미합니다. 참고: L 및 W 문자는 월별 필드를 사용하여 LW를 산출하며, 이는 그달의 마지막 평일로 변환됩니다.
W	지정된 날짜에 가장 가까운 평일 (월요일~금요일)을 지정하는 데 사용됩니다. 예를 들어 일 필드에 15W를 지정하면 해당 날짜의 15일에서 가장 가까운 요일을 월 따라서 15일이 토요일이면 트리거는 14일 금요일에 실행됩니다. 만약 15일은 일요일이며 트리거는 16일 월요일에 실행됩니다. 15일이 화요일인 경우 15일 화요일에 실행됩니다. 그러나 날짜에 1W를 지정하면 첫 번째가 토요일이고 트리거가 3일째 월요일에 실행됩니다. "점프" 월 일 경계에 도달하게 됩니다. W 문자는 날짜 범위는 날짜 범위나 목록이 아니라 하루입니다. 참고: L 및 W 문자는 월별 필드를 사용하여 LW를 산출하며, 이는 그달의 마지막 평일로 변환됩니다.
#	매월 n번째 XXX일을 지정하는 데 사용됩니다. 예를 들어, 주별 필드는 해당 월의 세 번째 금요일을 의미합니다 (6일차 = 금요일, #3 = 3번째 금요일 = 월). 다른 예: 2#1 = 월의 첫 번째 월요일, 4#5 = 다섯 번째 매월 수요일입니다. 참고: #5를 지정하고 해당 월의 요일이 지정된 경우 해당 월에 실행이 발생하지 않습니다.

다음은 크론 표현식의 몇 가지 예입니다 (나열된 모든 시간은 UTC 기준).

크론 표현식	실행 일정
0 0 12 * * ?	오후 12시 정오가 될 수 있습니다.
0 15 10 * * ? 2013	오전 10시 15분 2013년 동안 매일
0 10,44 14 ? 3수	오후 2시 10분 2:44 3월의 매주 수요일입니다.
0 15 10 ? * 2013~2015년 6L	오전 10시 15분 2013년, 2014년 동안 매월 마지막 금요일 2015년.
0 15 10 ? * 6#3	오전 10시 15분 매월 세 번째 금요일

API를 사용하여 예약된 작업 보기

GET 요청을 실행하여 현재 예약된 모든 작업을 /triggers?orgid={org_name}

예를 들면 다음과 같습니다.

$ curl -H "Accept:application/json" -X GET \ "http://localhost:8080/v1/mint/triggers?orgid={org_name}" \ -u email:password

다음은 응답의 예시입니다.

[ {
  "createdDate" : 1457924378176,
  "cronExpression" : "3 0 0 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server",
  "name" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.resetdeveloperrateplancounter@@@management"
  },
  "updatedDate" : 1457924378176
}, {
  "createdDate" : 1457924378014,
  "cronExpression" : "",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.ADHOC_NOTIFY@@@management-server",
  "name" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT",
  "priority" : "4",
  "startTime" : "1372916749000",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.adhocnotify@@@management"
  },
  "updatedDate" : 1457924378014
}, {
  "createdDate" : 1457924377877,
  "cronExpression" : "0 20 1 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.CHARGE_DAILY@@@management-server",
  "name" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.chargedaily@@@management"
  },
  "updatedDate" : 1457924377877
},
...
]

또한 GET 요청을 실행하여 /triggers/{trig_id}, 여기서 {trig_id}는 작업 ID입니다. 예약된 작업 개요에 설명된 대로 트리거가 트리거됩니다. 예를 들면 다음과 같습니다.

$ curl -X GET \ "http://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT" \ -u email:password

다음은 응답의 예시입니다.

{
    "createdDate" : 1457924377925,
    "cronExpression" : "0 20 2 * * ?",
    "enabled" : true,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
    "updatedDate" : 1457924377925
}

API를 사용하여 예약된 작업 업데이트

트리거의 속성을 변경하여 예약된 작업을 업데이트할 수 있습니다. 예를 들어 트리거의 실행 일정을 변경해야 할 수도 있습니다

크론 트리거 작업 (크론 표현식 값이 포함된 작업)의 경우 cronExpression 및 사용 설정된 속성의 값을 변경합니다. 기타 변경사항은 무시됩니다. 크론 표현식 값을 지정하지 않는 작업의 경우 다른 속성을 변경할 수 있습니다. startTime 또는 priority 등).

예약된 작업을 업데이트하려면 /triggers/{trig_id}에 PUT 요청을 실행합니다. 여기서, {trig_id}는 예약된 작업 개요에 설명된 작업 트리거를 식별합니다. 업데이트할 때 업데이트된 설정 및 트리거의 ID를 반환합니다.

예를 들어 다음 요청은 새 개발자 요금제의 크론 표현식을 업데이트합니다. 매일 오전 5시에 실행되도록 갱신 작업 UTC:

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : true,
    "group" : "management-server", 
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

API를 사용하여 예약된 작업 사용 중지 및 다시 사용 설정

예약된 작업을 사용 중지하려면 트리거의 enabled 속성 값을 다음으로 설정합니다. false입니다. 예를 들면 다음과 같습니다.

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : false,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

사용 중지된 작업을 다시 사용 설정하려면 트리거의 enabled 속성 값을 다음으로 설정합니다. true를 반환합니다.

다음 단계

조직의 수익 창출 정보 및 에지 API 서비스를 사용하여 만든 개발자, 애플리케이션, 제품에 대한 기본 정보를 제공합니다. 자세히 알아보기: 동기화 Apigee Edge 데이터 및 수익 창출