Apigee Edge 문서입니다.
Go to the
Apigee X 문서로 이동합니다. info
소개
기존 요금제가 게시된 후에는 종료일만 변경할 수 있습니다. 하지만 변경된 요금제 요금과 같은 변경된 속성이 포함된 새 버전의 요금제를 만들 수 있습니다. 향후 날짜에 개정사항이 적용되도록 설정할 수 있습니다. 개정사항이 적용되면 원래 요금제가 종료됩니다.
예를 들어 2019년 12월 31일에 만료되는 표준 요금제를 만들었고 2020년 1월 1일에 적용되는 다른 요금제로 대체하려는 경우 미래 요금제를 만들고 2020년 1월 1일에 적용되도록 설정합니다.
현재 요금제에 종료일이 설정되어 있지 않은 경우 기존 요금제를 오늘부터 시작되는 미래 요금제로 대체할 수 있습니다. 게시된 요금제 만료에 설명된 대로 현재 요금제를 만료해야 합니다.
개발자에게 개정된 요금제가 알림으로 전송됩니다. 원래 요금제를 수락한 개발자는 개정사항에 자동으로 등록되지만 개정사항을 거부할 수 있습니다.
다음 섹션에 설명된 대로 관리 UI 또는 수익 창출 API를 사용하여 미래 요금제를 만들 수 있습니다.
UI를 사용하여 미래 요금제 만들기
아래 설명된 대로 미래 요금제를 만듭니다.
에지
Edge UI를 사용하여 오늘 이후에 시작되는 요금제의 미래 버전을 만들려면 다음 단계를 수행합니다.
- 요금제 페이지에서 미래 요금제를 만들려는 요금제와 연결된 행 내에 커서를 놓습니다.
요금제에 종료일이 있어야 합니다. - +미래 를 클릭합니다.
- 미래 요금제 섹션에서 다음 중 하나를 선택합니다.
- 새 시행일에 전체 계약 기간 다시 시작: 미래 요금제가 시행일에 적용됩니다. 미래 요금제의 갱신 기간은 현재 요금제와 동일합니다.
- 시행일에 새 기간에서 이전 계약에 사용된 시간 차감: 미래 요금제가 시행일에 적용됩니다. 현재 요금제를 사용하는 데 사용된 시간이 미래 요금제의 갱신 기간에서 차감됩니다. 즉, 개발자가 현재 요금제를 3개월 동안 사용하면 갱신 기간이 3 개월 단축됩니다.
- 상단 패널에서 다음 필드를 구성합니다.
참고: 다른 필드는 읽기 전용입니다.필드 설명 기본값 필수 요금제 이름 요금제 이름입니다.
참고: 이름은 원래 요금제 이름과 일치하지 않아도 됩니다.
기존 요금제 이름 예 시작일 요금제가 적용되는 날짜입니다. 시작일을 입력하거나 캘린더를 사용하여 날짜를 선택합니다. 오늘 아니요 종료일 요금제가 종료되는 날짜입니다. 종료일을 지정하려면 종료일 있음 전환 스위치를 사용 설정하고 종료일을 입력하거나 캘린더를 사용하여 날짜를 선택합니다. 참고: 요금제는 지정된 날짜의 하루가 끝날 때 까지 적용됩니다. 예를 들어 2018년 12월 1일에 요금제를 만료하려면 endDate 값을 2018-11-30으로 설정해야 합니다. 이 경우 요금제는 2018년 11월 30일 하루가 끝날 때 만료되며 2018년 12월 1일의 모든 요청이 차단됩니다.
없음 아니요 포털에 표시 요금제가 공개인지 비공개인지 설정합니다. 공개 요금제와 특별 요금제 비교를 참고하세요. 사용 설정됨 아니요 - 요금제의 요금을 구성합니다. 요금 구성을 참고하세요.
참고: 조정 가능한 알림 요금제에는 적용되지 않습니다. - API 제품이 두 개 이상 포함된 제품 번들을 선택하는 경우 특정 또는 일반 요금제 섹션에서 다음 환경설정을 설정합니다.
참고: 이 단계는 조정 가능한 알림 요금제에는 적용되지 않습니다.
필드 설명 기본값 각 제품을 개별적으로 구성 각 API 제품에 대해 개별 요금제를 구성할지 여부를 지정하는 플래그입니다. 사용 중지됨 각 제품의 부분 유료화 오퍼를 개별적으로 구성 각 API 제품에 대해 부분 유료화 요금제를 구성할지 여부를 지정하는 플래그입니다. 사용 중지됨 제품 선택 플래그 중 하나 또는 둘 다 사용 설정하는 경우 드롭다운 목록에서 각 제품을 개별적으로 선택하고 요금제 세부정보를 구성해야 합니다. 참고: 제품 번들의 모든 제품을 구성해야 합니다.
해당 사항 없음 - 선택한 요금제 유형에 따라 요금제 세부정보를 구성합니다.
- 다음 중 하나를 클릭합니다.
버튼 설명 초안 업데이트 요금제를 초안으로 저장합니다. 요금제는 게시하기 전에는 앱 개발자에게 표시되지 않습니다. 초안 요금제의 모든 필드를 수정할 수 있습니다.
초안 게시 요금제를 게시합니다. 참고: 요금제를 게시한 후에는 종료일이 아직 설정되지 않은 경우에만 수정할 수 있습니다. 요금제를 게시한 후에는 삭제할 수 없지만 게시된 요금제 만료에 설명된 대로 요금제를 만료하고 미래 요금제로 대체할 수 있습니다.
기존 Edge (Private Cloud)
기존 Edge UI를 사용하여 오늘 이후에 시작되는 요금제의 미래 버전을 만들려면 다음 단계를 수행합니다.
- 패키지 카탈로그에서 대체하려는 요금제의 초안/미래 열에서 +미래 를 클릭합니다.
그러면 미래 요금제 창이 열립니다.
미래 요금제 창과 현재 요금제 창의 주요 차이점은 기존 구독자 섹션이 추가되었다는 것입니다.
- 모든 요금제와 마찬가지로 다음을 수행합니다.
- 기존 구독자 섹션에서 다음 중 하나를 선택합니다.
- 새 시행일에 전체 계약 기간 다시 시작. 미래 요금제가 시행일에 적용됩니다. 미래 요금제의 갱신 기간은 현재 요금제와 동일합니다.
- 시행일에 새 기간에서 이전 계약에 사용된 시간 차감. 미래 요금제가 시행일에 적용됩니다. 현재 요금제를 사용하는 데 사용된 시간이 미래 요금제의 갱신 기간에서 차감됩니다. 즉, 개발자가 현재 요금제를 3개월 동안 사용하면 갱신 기간이 3 개월 단축됩니다.
- 시행일 필드에 기존 요금제의 종료일 이후의 시작일을 입력합니다.
API를 사용하여 미래 요금제 만들기
API를 사용하여 미래 요금제를 만들려면 POST 요청을
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision에 실행합니다.
각 항목의 의미는 다음과 같습니다.
{org_id}는 조직의 이름입니다.{package_id}는 API 패키지의 식별자입니다.{plan_Id}는 요금제의 식별자입니다.
parentRatePlan은 원래 요금제의 ID를 지정합니다.startDate는 새 요금제가 적용되는 날짜를 지정합니다.
미래 요금제의 이름은 원래 요금제의 이름과 일치하지 않아야 합니다. 또한 모든 요금제 중에서 고유해야 합니다. 개발자를 위해 기록된 원래 시작일을 유지하려면 keepOriginalStartDate 플래그를 true로 설정합니다. 이 플래그
의 기본값은 false입니다.
구성 설정에 관한 자세한 내용은 요금제의 구성 설정을 참고하세요.
예를 들어 다음 요청은 미래 요금제를 만듭니다.
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"parentRatePlan": {
"id": "monetization_package_flat_rate_card_plan_1379513833409"
},
"name": "Flat rate card plan",
"developer":null,
"developerCategory":null,
"advance": "false",
"currency": {
"id" : "usd"
},
"description": "Flat rate card plan",
"displayName" : "Flat rate card plan",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"paymentDueDays": "30",
"meteringType": "UNIT",
"organization": {
"id": "myorg"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.05",
"startUnit": "0"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2014-01-01 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \
-u email:password