Abilitazione della monetizzazione Apigee

Questa pagina si applica a Apigee e Apigee ibrido.

Visualizza la documentazione di Apigee Edge.

Prima di poter utilizzare la monetizzazione Apigee, devi acquistarla e abilitarla nella tua organizzazione.

Acquisto di monetizzazione Apigee

Per acquistare la monetizzazione Apigee per le organizzazioni con abbonamento:

  1. Verifica che la monetizzazione di Apigee sia inclusa nel tuo abbonamento ad Apigee. Consulta la pagina relativa ai diritti di Apigee.
  2. Contatta il team di vendita Apigee per acquistare la monetizzazione Apigee, se necessario.

Abilitare la monetizzazione Apigee nella tua organizzazione

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

https://apigee.googleapis.com/v1/organizations/$ORG:setAddons

Ad esempio: 

curl "https://apigee.googleapis.com/v1/organizations/$ORG: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 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 Utilizzo di curl. Per una descrizione delle variabili di ambiente utilizzate, consulta Impostare le variabili di ambiente per le richieste API Apigee.

Di seguito viene fornito un esempio di risposta che indica che l'operazione è in corso: 

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

Per saperne di più, consulta Configurare l'API dei 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" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Di seguito è riportato un esempio di risposta che indica che la monetizzazione è abilitata. 

{
    "name": $ORG,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": true
    }
  }
}

Disabilitare la monetizzazione Apigee nella tua organizzazione

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

https://apigee.googleapis.com/v1/organizations/$ORG:setAddons

Ad esempio: 

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

Di seguito viene fornito un esempio di risposta che indica che l'operazione è in corso: 

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

Per saperne di più, consulta Configurare l'API dei 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" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Di seguito è riportato un esempio di risposta che indica che la monetizzazione è abilitata. 

{
    "name": $ORG,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": false
    }
  }
}

Risoluzione dei problemi relativi all'abilitazione della monetizzazione di Apigee

Se non hai acquistato la monetizzazione Apigee e cerchi di abilitarla, 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"
  }
}