Vous consultez la documentation Apigee Edge.
Accédez à la
documentation**Apigee X**. info
Introduction
Une fois qu'un plan tarifaire existant est publié, la seule propriété que vous pouvez modifier est sa date de fin. Toutefois, vous pouvez créer une version du plan qui inclut des propriétés modifiées, telles que des tarifs différents. Vous pouvez configurer la révision pour qu'elle prenne effet à une date ultérieure. Le plan tarifaire d'origine prend fin lorsque la révision entre en vigueur.
Par exemple, supposons que vous ayez créé un plan tarifaire standard qui expire le 31 décembre 2019 et que vous souhaitiez le remplacer par un autre plan qui entrera en vigueur le 1er janvier 2020. Pour ce faire, créez un plan tarifaire futur et configurez-le pour qu'il entre en vigueur le 1er janvier 2020.
Si aucune date de fin n'est définie pour le plan tarifaire actuel, vous pouvez remplacer un plan tarifaire existant par un plan tarifaire futur qui commence dès aujourd'hui. Vous devrez faire expirer le plan tarifaire actuel, comme décrit dans la section Faire expirer un plan tarifaire publié.
Les développeurs sont informés du plan tarifaire révisé. Ceux qui acceptent le plan tarifaire d'origine sont automatiquement inscrits à la révision (mais ont la possibilité de la refuser ).
Vous pouvez créer un plan tarifaire futur à l'aide de l'interface utilisateur de gestion ou de l'API de monétisation, comme décrit dans les sections suivantes.
Créer un plan tarifaire futur à l'aide de l'interface utilisateur
Créez un plan tarifaire futur, comme décrit ci-dessous.
Edge
Pour créer une version future d'un plan tarifaire qui commence à une date ultérieure à l'aide de l'interface utilisateur Edge, procédez comme suit.
- Sur la page Plans tarifaires,
placez le curseur dans la ligne associée au plan tarifaire pour lequel vous souhaitez créer un plan tarifaire futur.
Le plan tarifaire doit avoir une date de fin. - Cliquez sur +Futur.
- Dans la section Plan tarifaire futur, sélectionnez l'une des options suivantes :
- Redémarrer la période contractuelle complète à la nouvelle date d'entrée en vigueur : le plan tarifaire futur entre en vigueur à la date d'entrée en vigueur. La période de renouvellement du plan tarifaire futur est la même que celle du plan tarifaire actuel.
- Déduire le temps passé sur le contrat précédent de la nouvelle période, à la date d'entrée en vigueur : Le plan tarifaire futur entre en vigueur à la date d'entrée en vigueur. Le temps passé à utiliser le plan tarifaire actuel est déduit de la période de renouvellement du plan tarifaire futur. Cela signifie que si un développeur utilise le plan actuel pendant trois mois, la période de renouvellement est réduite de trois mois.
- Configurez les champs suivants dans le panneau supérieur :
Remarque : Les autres champs sont en lecture seule.Champ Description Par défaut Obligatoire Nom du plan tarifaire Nom de votre plan tarifaire.
Remarque : Le nom ne doit pas nécessairement correspondre au nom du plan tarifaire d'origine.
Nom du plan existant Oui Date de début Date d'entrée en vigueur du plan tarifaire. Saisissez une date de début ou sélectionnez-en une à l'aide du calendrier. Aujourd'hui Non Date de fin Date de fin du plan tarifaire. Pour spécifier une date de fin, activez le bouton bascule A une date de fin,puis saisissez une date de fin ou sélectionnez-en une à l'aide du calendrier. Remarque : Le plan tarifaire sera en vigueur jusqu'à la fin de la journée à la date spécifiée. Si vous souhaitez faire expirer un plan tarifaire le 1er décembre 2018, par exemple, vous devez définir la valeur endDate sur 2018-11-30. Dans ce cas, le plan tarifaire expirera à la fin de la journée du 30 novembre 2018. Toutes les requêtes du 1er décembre 2018 seront bloquées.
Aucun Non Visible sur les portails Définissez si le plan tarifaire est public ou privé. Consultez la section Plans tarifaires publics et privés. Activé Non - Configurez les frais pour le plan tarifaire. Consultez la section Configurer les frais.
Remarque : Ne s'applique pas aux plans de notification ajustables. - Si vous sélectionnez un pack de produits contenant plusieurs produits d'API, définissez les préférences suivantes dans la section Plan tarifaire spécifique ou générique :
Remarque : Cette étape ne s'applique pas aux plans de notification ajustables.
Champ Description Par défaut Configurer chaque produit individuellement Indicateur qui spécifie s'il faut configurer un plan tarifaire individuel pour chaque produit d'API. Désactivé Configurer individuellement l'offre freemium de chaque produit Indicateur qui spécifie s'il faut configurer un plan freemium pour chaque produit d'API. Désactivé Sélectionner un produit Si vous activez l'un des indicateurs ou les deux, vous devez sélectionner chaque produit individuellement dans la liste déroulante et configurer les détails de son plan tarifaire. Remarque : Assurez-vous de configurer tous les produits du pack de produits.
N/A - Configurez les détails du plan tarifaire en fonction du type de plan tarifaire sélectionné :
- Cliquez sur l'un des boutons suivants :
Bouton Description Modifier un brouillon Enregistrez le plan tarifaire en tant que brouillon. Le plan tarifaire ne sera pas visible par les développeurs d'applications tant que vous ne l'aurez pas publié. Vous pouvez modifier n'importe quel champ d'un plan tarifaire brouillon.
Publier le brouillon Publiez le plan. Remarque : Une fois que vous avez publié un plan tarifaire, vous ne pouvez modifier la date de fin que si elle n'est pas déjà définie. Vous ne pouvez pas supprimer un plan tarifaire après sa publication, mais vous pouvez le faire expirer et le remplacer par un plan tarifaire futur, comme décrit dans la section Faire expirer un plan tarifaire publié.
Classic Edge (Private Cloud)
Pour créer une version future d'un plan tarifaire qui commence à une date ultérieure à l'aide de l'interface utilisateur Classic Edge, procédez comme suit.
- Dans le catalogue de packages, cliquez sur +Futur dans la colonne "Brouillon/Futur" pour le
plan tarifaire que vous souhaitez remplacer.
Une fenêtre "Plan tarifaire futur" s'ouvre.
La principale différence entre une fenêtre de plan tarifaire futur et une fenêtre de plan tarifaire actuel est l'ajout d'une section "Abonnés existants".
- Comme pour n'importe quel plan tarifaire :
- Saisissez un nom pour le plan dans le champ "Nom du plan tarifaire". Le nom ne doit pas nécessairement correspondre le nom du plan tarifaire d'origine.
- Configuration des frais pour un plan tarifaire (facultatif).
- Configurez les détails du plan tarifaire en fonction du type de plan tarifaire sélectionné :
- Spécifiez une date d'entrée en vigueur pour le plan futur (consultez la section Publier des plans tarifaires), et une date de fin (vous pouvez également sélectionner "Aucune date de fin" si vous ne souhaitez pas que le plan tarifaire futur se termine à une date spécifique). Si une date de fin est définie pour le plan actuel, la date d'entrée en vigueur du plan futur doit être postérieure à la date de fin du plan actuel.
- Dans la section "Abonnés existants", sélectionnez l'une des options suivantes :
- Redémarrez la période contractuelle complète à la nouvelle date d'entrée en vigueur. Le plan tarifaire futur entre en vigueur à la date d'entrée en vigueur. La période de renouvellement du plan tarifaire futur est la même que celle du plan tarifaire actuel.
- Déduisez le temps passé sur le contrat précédent de la nouvelle période, à la date d'entrée en vigueur. Le plan tarifaire futur entre en vigueur à la date d'entrée en vigueur. Le temps passé à utiliser le plan tarifaire actuel est déduit de la période de renouvellement du plan tarifaire futur. Cela signifie que si un développeur utilise le plan actuel pendant trois mois, la période de renouvellement est réduite de trois mois.
- Dans le champ "Date d'entrée en vigueur", saisissez une date de début postérieure à la date de fin du plan tarifaire existant.
Créer un plan tarifaire futur à l'aide de l'API
Vous pouvez créer un plan tarifaire futur à l'aide de l'API en envoyant une requête POST à
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision.
Où :
{org_id}est le nom de l'organisation.{package_id}est l'identification du package d'API.{plan_Id}est l'identification du plan tarifaire.
parentRatePlanspécifie l'ID du plan tarifaire d'origine.startDatespécifie la date d'entrée en vigueur du nouveau plan.
Le nom du plan tarifaire futur ne doit pas correspondre au nom du plan d'origine. Il doit également être
unique parmi tous vos plans tarifaires. Si vous souhaitez conserver la date de début d'origine enregistrée pour
les développeurs, définissez l'indicateur keepOriginalStartDate sur true. Cet indicateur
est défini par défaut sur false.
Pour en savoir plus sur les paramètres de configuration, consultez la section Paramètres de configuration des plans tarifaires.
Par exemple, la requête suivante crée un plan tarifaire futur :
$ 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