Aggiunta di funzionalità tramite i criteri

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Apigee ti consente di programmare il comportamento delle API senza scrivere codice utilizzando i criteri. Un criterio è come un modulo che implementa una funzione di gestione specifica e limitata. I criteri sono progettati per consentirti di aggiungere in modo efficiente e affidabile tipi comuni di funzionalità di gestione a un'API.

I criteri forniscono funzionalità come sicurezza, limitazione di frequenza, trasformazione e mediazione, evitando di dover creare e gestire il codice autonomamente. Non sei limitato al set di tipi di norme fornito da Apigee. Puoi anche scrivere codice e script personalizzati (ad esempio applicazioni JavaScript) che estendono la funzionalità del proxy API e ti consentono di innovare al di sopra delle funzionalità di gestione di base supportate dai criteri Apigee.

Crea e collega i criteri ai proxy API e ai flussi condivisi utilizzando Apigee in Cloud Code, come descritto nelle sezioni seguenti. A seconda del tipo di policy, potrebbe essere necessario creare una risorsa, come descritto in Gestione delle risorse. Vedi anche Gestione di cartelle e file in uno spazio di lavoro Apigee.

Creazione di un criterio

Per creare un criterio utilizzando Apigee in Cloud Code:

  1. Nello spazio di lavoro Apigee, esegui una delle seguenti azioni in base a dove vuoi allegare il criterio:

    Collega a Azione
    proxy API Esegui una delle seguenti azioni:
    • Posiziona il cursore del mouse su una delle seguenti cartelle, fai clic su Icona Crea policy Apigee e seleziona Crea norma:
      • apiproxy-name proxy bundle
      • apiproxy-name/apiproxy
    • Posiziona il cursore sulla cartella apiproxy-name/apiproxy/policies per il proxy API e fai clic su Icona Crea proxy API.
    Flusso condiviso Esegui una delle seguenti azioni:
    • Posiziona il cursore del mouse su una delle seguenti cartelle, fai clic su Creare l'icona del flusso condiviso e seleziona Crea norma:
      • sharedflow-name bundle di flussi condivisi
      • sharedflow-name/sharedflowbundle
    • Posiziona il cursore sulla cartella sharedflow-name/sharedflowbundle/policies per il flusso condiviso e fai clic su Creare l'icona del flusso condiviso.

Si apre la procedura guidata Crea policy.

  1. Seleziona dall'elenco la categoria delle norme che vuoi creare. Per una descrizione delle categorie di norme, vedi Panoramica del riferimento alle norme.

  2. Inserisci un nome univoco per il criterio e premi Invio. Il criterio viene aggiunto alla cartella /policies per il proxy API o il flusso condiviso nella sezione Apigee e aperto nell'editor.

  3. Modifica il file in base alle esigenze e seleziona File > Salva o ⌘S per salvare le modifiche. Per ulteriori informazioni sulla configurazione della policy, consulta la panoramica del riferimento alle policy.

  4. Crea risorse, se richieste dal tipo di policy, come descritto in Gestione delle risorse.

Collegamento di un criterio a un flusso

Le policy non vengono eseguite finché non vengono associate a un flusso. Puoi collegare un criterio a un flusso aggiungendo l'elemento <Step> all'elemento di flusso di richiesta o risposta appropriato in una configurazione ProxyEndpoint o TargetEndpoint, come descritto nei seguenti argomenti:

Ad esempio, la seguente configurazione associa un QuotaPolicy a <PreFlow> di ProxyEndpoint per configurare il numero di messaggi di richiesta consentiti da un proxy API in un periodo di tempo.

<ProxyEndpoint name="default">
  <PreFlow>
    <Request>
      <Step><Name>QuotaPolicy</Name></Step>
    </Request>
  </PreFlow>
  <HTTPProxyConnection>
    <BasePath>/weather</BasePath>
  </HTTPProxyConnection>
  <RouteRule name="default">
    <TargetEndpoint>default</TargetEndpoint>
  </RouteRule>
</ProxyEndpoint>