Aggiungere 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. Le policy sono progettate per consentire di aggiungere in modo efficiente e affidabile le funzionalità di gestione più comuni 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 policy 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 al di sopra delle funzionalità di gestione di base supportate dai criteri Apigee.

Crea e collega policy 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 Gestire le risorse. Vedi anche Gestire cartelle e file in uno spazio di lavoro Apigee.

Crea un criterio

Per creare una policy utilizzando Apigee in Cloud Code:

  1. Nel tuo spazio di lavoro Apigee, esegui una delle seguenti azioni a seconda di dove desideri associare la policy:

    Collega a Azione
    Proxy API Eseguire una delle seguenti azioni:
    • Posiziona il cursore su una delle seguenti cartelle, fai clic su Icona Crea policy Apigee e seleziona Crea policy:
      • apiproxy-name proxy bundle
      • apiproxy-name/apiproxy
    • Posiziona il cursore sopraapiproxy-name/apiproxy/policies cartella per il proxy API e fai clicIcona Crea proxy API.
    Flusso condiviso Eseguire una delle seguenti azioni:
    • Posiziona il cursore su una delle seguenti cartelle, fai clic su Crea icona del flusso condiviso e seleziona Crea policy:
      • sharedflow-name pacchetto di flusso condiviso
      • sharedflow-name/sharedflowbundle
    • Posiziona il cursore soprasharedflow-name/sharedflowbundle/policies cartella per il flusso condiviso e fai clicCrea icona del flusso condiviso.

Si apre la procedura guidata per la creazione dei criteri.

  1. Seleziona dalla lista la categoria di polizza che desideri creare. Per una descrizione delle categorie di policy, vedere Panoramica di riferimento delle policy.

  2. Inserisci un nome univoco per la policy e premi Invio. La policy viene aggiunta alla cartella /policies per il proxy API o il flusso condiviso nella sezione Apigee e aperta nell'editor.

  3. Modifica il file, se necessario, e seleziona File > Salva oppure ⌘S per salvare le modifiche. Per saperne di più sulla configurazione della policy, consulta la panoramica del riferimento alle policy.

  4. Creare le risorse se richiesto dal tipo di policy, come descritto in Gestisci risorse.

Allega una policy a un flusso

Le policy non vengono eseguite finché non vengono associate a un flusso. È possibile associare una policy a un flusso aggiungendola<Passaggio> elemento all'elemento di flusso di richiesta o risposta appropriato in una configurazione ProxyEndpoint o TargetEndpoint, come descritto negli argomenti seguenti:

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>