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.

Acquisto della monetizzazione Apigee

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

1. Verifica che la monetizzazione Apigee sia inclusa nel tuo abbonamento Apigee. Consulta i diritti Apigee.
2. Contatta il team di vendita Apigee per acquistare la monetizzazione Apigee, se necessario.
Nota: le organizzazioni di prova di Apigee includono automaticamente una prova della monetizzazione di Apigee per il periodo di prova. Non è necessario contattare il team di vendita Apigee per aggiungere la monetizzazione. Salta questo passaggio e vai a Abilitare la monetizzazione di Apigee nella tua organizzazione.

La monetizzazione non è ancora disponibile come componente aggiuntivo per le organizzazioni con pagamento a consumo di Apigee.

Abilitazione della monetizzazione di Apigee nella tua organizzazione

Per abilitare 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

Attenzione: la configurazione del componente aggiuntivo che passi 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: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 Utilizzare curl. Per una descrizione delle variabili di ambiente utilizzate, consulta Impostazione delle variabili di ambiente per le richieste API Apigee.

Di seguito è riportato un esempio della 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 ulteriori informazioni, consulta la sezione 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" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Di seguito è riportato un esempio della risposta che indica che la monetizzazione è attivata.

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

Disabilitazione della monetizzazione di Apigee nella tua organizzazione

Per disabilitare 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

Attenzione: la configurazione del componente aggiuntivo che passi 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: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 della 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 ulteriori informazioni, consulta la sezione 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" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Di seguito è riportato un esempio della risposta che indica che la monetizzazione è attivata.

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

Risoluzione dei problemi relativi all'abilitazione della monetizzazione di Apigee

Se non hai acquistato la monetizzazione Apigee e tenti 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"
  }
}