Adicionar funcionalidades através de políticas

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

O Apigee permite-lhe programar o comportamento da API sem escrever código através de políticas. Uma política é como um módulo que implementa uma função de gestão específica e limitada. As políticas foram concebidas para lhe permitir adicionar de forma eficiente e fiável tipos comuns de capacidades de gestão a uma API.

As políticas oferecem funcionalidades como segurança, limitação de taxa, transformação e capacidades de mediação, o que lhe permite não ter de criar e manter o código por si. Não está limitado ao conjunto de tipos de políticas fornecidos pelo Apigee. Também pode escrever scripts e código personalizados (como aplicações JavaScript) que expandem a funcionalidade do proxy de API e lhe permitem inovar com base nas capacidades de gestão básicas suportadas pelas políticas do Apigee.

Crie e anexe políticas a proxies de API e fluxos partilhados através do Apigee no Cloud Code, conforme descrito nas secções seguintes. Consoante o tipo de política, pode ter de criar um recurso, conforme descrito no artigo Gerir recursos. Consulte também o artigo Gerir pastas e ficheiros num espaço de trabalho do Apigee.

Antes de começar: familiarize-se com os conceitos descritos nos seguintes tópicos:

• O que é uma política?
• Vista geral da referência de políticas
• Política de textos destacados de fluxo

Criar uma política

Para criar uma política através do Apigee no Cloud Code:

1. No seu espaço de trabalho do Apigee, execute uma das seguintes ações com base no local onde quer anexar a política:

   Anexar a	Ação
   proxy de API	Realize uma das seguintes ações: Posicione o cursor sobre uma das seguintes pastas, clique em e selecione Criar política: apiproxy-name pacote de proxy apiproxy-name/apiproxy Posicione o cursor sobre a pasta apiproxy-name/apiproxy/policies do proxy da API e clique em .
   Fluxo partilhado	Realize uma das seguintes ações: Posicione o cursor sobre uma das seguintes pastas, clique em e selecione Criar política: sharedflow-name pacote de fluxo partilhado sharedflow-name/sharedflowbundle Posicione o cursor sobre a pasta sharedflow-name/sharedflowbundle/policies para o fluxo partilhado e clique em .

É aberto o assistente Criar política.

1. Selecione a categoria da política que quer criar na lista. Para uma descrição das categorias de políticas, consulte a vista geral de referência de políticas.

2. Introduza um nome exclusivo para a política e prima Enter. A política é adicionada à pasta /policies do proxy de API ou do fluxo partilhado na secção Apigee e é aberta no editor.

3. Edite o ficheiro conforme necessário e selecione Ficheiro > Guardar ou ⌘S para guardar as edições. Para mais informações sobre a configuração da política, consulte o Resumo da referência de políticas.

4. Crie recursos, se necessário, de acordo com o tipo de política, conforme descrito no artigo Gerir recursos.

Anexar uma política a um fluxo

As políticas não são executadas até serem anexadas a um fluxo. Pode anexar uma política a um fluxo adicionando o elemento <Step> ao elemento de fluxo de pedido ou resposta adequado numa configuração de ProxyEndpoint ou TargetEndpoint, conforme descrito nos seguintes tópicos:

• Anexar uma política a um fluxo ProxyEndpoint ou TargetEndpoint
• Política de textos destacados de fluxo

Por exemplo, a configuração seguinte anexa uma QuotaPolicy ao <PreFlow> do ProxyEndpoint para configurar o número de mensagens de pedidos que um proxy de API permite durante um período.

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