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 è simile a 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, evitandoti di dover creare e gestire il codice autonomamente. Non sei limitato all'insieme di tipi di criteri forniti 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 oltre le 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 norma, potrebbe essere necessario creare una risorsa, come descritto in Gestire le risorse. Consulta anche Gestire cartelle e file in uno spazio di lavoro Apigee.

Creazione di un criterio

Per creare un criterio utilizzando Apigee in Cloud Code:

  1. Nella tua area 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 criterio Apigee e seleziona Crea criterio:
      • 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 Icona Crea flusso condiviso e seleziona Crea criterio:
      • 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 Icona Crea flusso condiviso.

Viene visualizzata la procedura guidata Crea criterio.

  1. Seleziona la categoria del criterio che vuoi creare dall'elenco. Per una descrizione delle categorie di criteri, consulta la Panoramica di riferimento dei criteri.

  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, se necessario, e seleziona File > Salva o ⌘S per salvare le modifiche. Per ulteriori informazioni sulla configurazione del criterio, consulta la Panoramica del riferimento ai criteri.

  4. Crea le risorse, se richieste dal tipo di criterio, come descritto in Gestire le risorse.

Collegamento di un criterio a un flusso

Le norme non vengono eseguite finché non vengono associate a un flusso. Puoi collegare un criterio a un flusso aggiungendo l'elemento <Step> all'elemento del 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 determinato 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>