Abilitazione della 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 abilitarla nella tua organizzazione. Tieni presente che la monetizzazione di Apigee non è attualmente supportata per gli ambienti ibridi.

Acquistare la monetizzazione Apigee

Per acquistare la monetizzazione Apigee per le organizzazioni basate su abbonamento:

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

Abilitazione della monetizzazione Apigee nella tua organizzazione

Per attivare la monetizzazione di Apigee in un'organizzazione esistente, invia una richiesta POST alla seguente API, 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 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 Utilizzare curl. Per una descrizione delle variabili di ambiente utilizzate, consulta Impostazione delle variabili di ambiente per le richieste dell'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 mostra che la monetizzazione è attivata. 

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

Disattivare la monetizzazione Apigee nella tua organizzazione

Per disattivare la monetizzazione di 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: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 è riportato un esempio di risposta che mostra 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 ulteriori informazioni, consulta l'API Configure organization add-ons.

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 provi ad 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"
  }
}