Utilizzare l’API di limitazione di utilizzo

L’API di limitazione di utilizzo consente di creare, configurare e monitorare le configurazioni di limitazione di utilizzo.

Descrizione API di limitazione

Quando viene creata o aggiornata una configurazione, viene eseguito automaticamente un controllo per garantire la sintassi e l’integrità del payload.
Se si verificano alcuni problemi, l’operazione restituisce un avviso o degli errori per facilitare la correzione della configurazione.

Configurazione endpoint

Di seguito è riportata la struttura di base di una configurazione di endpoint:

{
    "url": "<endpoint URL>",  //wildcards are allowed in the endpoint URL
    "methods": [ "<HTTP method such as GET, POST, >, ...],
    "services": {
        "<service name>": { . //must be "action" or "dataSource"
            "maxHttpConnections": <max connections count to the endpoint (optional)>
            "rating": {
                "maxCallsCount": <max calls to be performed in the period defined by period/timeUnit>,
                "periodInMs": <integer value greater than 0>
            }
        },
        ...
    }
}

Esempio:

`{
  "url": "https://api.example.org/data/2.5/*",
  "methods": [
    "GET"
  ],
  "services": {
    "dataSource": {
      "maxHttpConnections": 50,
      "rating": {
        "maxCallsCount": 500,
        "periodInMs": 1000
      }
    }
  },
  "orgId": "<IMS Org Id>"
}

Avvertenze ed errori

Quando un canDeploy viene chiamato, il processo convalida la configurazione e restituisce lo stato di convalida identificato dal relativo ID univoco:

"ok" or "error"

I potenziali errori sono:

• ERR_ENDPOINTCONFIG_100: configurazione limite: url mancante o non valido
• ERR_ENDPOINTCONFIG_101: configurazione limite: url non valido
• ERR_ENDPOINTCONFIG_102: configurazione di limitazione: url non valido: wildchar nell’url non consentito in host:port
• ERR_ENDPOINTCONFIG_103: configurazione limite: metodi HTTP mancanti
• ERR_ENDPOINTCONFIG_104: configurazione limite: nessuna classificazione di chiamata definita
• ERR_ENDPOINTCONFIG_107: configurazione limite: numero massimo di chiamate non valido (maxCallsCount)
• ERR_ENDPOINTCONFIG_108: configurazione limite: numero massimo di chiamate non valido (periodInMs)
• ERR_ENDPOINTCONFIG_111: configurazione limite: impossibile creare la configurazione endpoint: payload non valido
• ERR_ENDPOINTCONFIG_112: configurazione limite: impossibile creare la configurazione endpoint: previsto un payload JSON
• ERR_AUTHORING_ENDPOINTCONFIG_1: nome di servizio non valido <!--<given value>-->: deve essere "dataSource" o "action"

Il potenziale avviso è:

ERR_ENDPOINTCONFIG_106: limite configurazione: numero massimo connessioni HTTP non definito: nessuna limitazione per impostazione predefinita

Casi d’uso

In questa sezione trovi i cinque casi d’uso principali che puoi eseguire per gestire la configurazione dei limiti in Journey Orchestration.

Per facilitare i test e la configurazione, qui è disponibile una raccolta Postman.

Questa raccolta Postman è stata configurata per condividere la raccolta di variabili Postman generata tramite Integrazioni della console di Adobe I/O > Prova > Scarica per Postman, che genera un file di ambiente Postman con i valori delle integrazioni selezionate.

Una volta scaricata e caricata in Postman, è necessario aggiungere tre variabili: {JO_HOST},{BASE_PATH} e {SANDBOX_NAME}.

• {JO_HOST} : Journey Orchestration URL gateway
• {BASE_PATH} : punto di ingresso per l’API. Il valore è “/authoring”
• {SANDBOX_NAME}: l’intestazione x-sandbox-name (ad esempio, “prod”) corrispondente al nome della sandbox in cui si svolgeranno le operazioni API. Per ulteriori informazioni, consulta la panoramica delle sandbox.

Nella sezione seguente, è disponibile un elenco ordinato delle chiamate API REST per eseguire il caso d’uso.

Caso d’uso n. 1: Creazione e distribuzione di una nuova configurazione dei limiti

1. list
2. create
3. candeploy
4. deploy

Caso d’uso n. 2: Aggiornare e distribuire una configurazione di limitazione di utilizzo non ancora distribuita

1. list
2. get
3. update
4. candeploy
5. deploy

Caso d’uso n. 3: Annullare la distribuzione ed eliminare una configurazione di limitazione distribuita

1. list
2. undeploy
3. delete

Caso d’uso n. 4: Elimina una configurazione di limite distribuita.

È possibile annullare la distribuzione ed eliminare la configurazione in una sola chiamata API utilizzando il parametro forceDelete.

1. list
2. eliminare, con il parametro forceDelete

Caso d’uso n. 5: Aggiornare una configurazione di limite già distribuita

1. list
2. get
3. update
4. undeploy
5. candeploy
6. deploy

Risorse Business.Adobe.com