Abilitare la monetizzazione Apigee

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Prima di poter utilizzare la monetizzazione Apigee, devi acquistarla e attivarla nella tua organizzazione. La monetizzazione Apigee è supportata per gli ambienti Apigee e Apigee hybrid.

Nota:consulta Problema noto 355714868 per un problema relativo ai dati di monetizzazione ricorrente, configurazione e ricarica di Apigee in ambienti ibridi.

Acquistare la monetizzazione Apigee

Per acquistare la monetizzazione Apigee per le organizzazioni con abbonamento, contatta Apigee Sales, quindi attiva la monetizzazione Apigee nella tua organizzazione.

La monetizzazione Apigee non è disponibile per le organizzazioni con pagamento a consumo.

Le organizzazioni di valutazione Apigee includono automaticamente una prova della monetizzazione Apigee per il periodo di prova. Non devi contattare il team di vendita di Apigee per aggiungere la monetizzazione. Vai ad Attivare la monetizzazione Apigee nella tua organizzazione.

Abilitare la monetizzazione Apigee nella tua organizzazione

Per abilitare la monetizzazione Apigee in un'organizzazione esistente, invia una richiesta POST alla seguente API, trasmettendo la configurazione del componente aggiuntivo nel corpo della richiesta:

https://apigee.googleapis.com/v1/organizations/ORG_NAME:setAddons

Attenzione: La configurazione del componente aggiuntivo che trasmetti nel corpo della richiesta sovrascriverà la configurazione esistente del componente aggiuntivo. Visualizza la configurazione del componente aggiuntivo esistente nel profilo dell'organizzazione Apigee e assicurati di includerla nel payload della richiesta.

Ad esempio:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "monetizationConfig": {
          "enabled": "true"
      }
      <Include existing add-on configuration>
    }
  }'

Dove $TOKEN è impostato sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl utilizzate in questo esempio, consulta la sezione Utilizzare curl. Per una descrizione delle variabili di ambiente che puoi utilizzare, consulta Impostazione delle variabili di ambiente per le richieste API Apigee.

Di seguito è riportato un esempio di risposta che mostra che l'operazione è in corso:

{
  "name": "organizations/ORG_NAME/operations/1ae3ed56-b38f-4cc1-ba33-e7d89557075d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/ORG_NAME",
    "state": "IN_PROGRESS"
  }
}

Per saperne di più, consulta la pagina Configurare l'API per i componenti aggiuntivi dell'organizzazione.

Visualizza il profilo dell'organizzazione per verificare che la monetizzazione sia stata attivata. Ad esempio:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Di seguito è riportato un esempio di risposta che mostra che la monetizzazione è attivata.

{
    "name": ORG_NAME,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": true
    }
  }
}

Disabilitare la monetizzazione Apigee nella tua organizzazione

Per disattivare la monetizzazione Apigee nella tua organizzazione, invia una richiesta POST alla seguente API, passando la configurazione del componente aggiuntivo nel corpo della richiesta:

https://apigee.googleapis.com/v1/organizations/ORG_NAME:setAddons

Attenzione: la configurazione del componente aggiuntivo che trasmetti nel corpo della richiesta sovrascriverà quella esistente. Visualizza la configurazione del componente aggiuntivo esistente nel profilo dell'organizzazione Apigee e assicurati di includerla nel payload della richiesta.

Ad esempio:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "monetizationConfig": {
          "enabled": "false"
      }
     <Include existing add-on configuration>
    }
  }'

Di seguito è riportato un esempio di risposta che mostra che l'operazione è in corso:

{
  "name": "organizations/ORG_NAME/operations/06274ffb-8940-41da-836d-781cba190437",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/ORG_NAME",
    "state": "IN_PROGRESS"
  }
}

Per saperne di più, consulta la pagina Configurare l'API per i componenti aggiuntivi dell'organizzazione.

Visualizza il profilo dell'organizzazione per verificare che la monetizzazione sia stata disattivata. Ad esempio:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Di seguito è riportato un esempio di risposta che mostra che la monetizzazione è attivata.

{
    "name": ORG_NAME,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": false
    }
  }
}

Risolvere i problemi relativi all'abilitazione della monetizzazione Apigee

Se non hai acquistato la monetizzazione Apigee e tenti di attivarla, viene restituito il seguente errore:

{
  "error": {
    "code": 400,
    "message": "failed to validate addons config: [Apigee Monetization] addon(s) are not entitled to the subscription",
    "status": "FAILED_PRECONDITION"
  }
}