16.09 - Notas da versão do Edge for Private Cloud

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Na segunda-feira, 19 de setembro de 2016, lançamos uma nova versão do Apigee Edge para nuvem privada.

Desde a versão anterior do Edge para nuvem privada, as seguintes versões foram ocorreram e estão incluídos neste Lançamento de Recurso:

• Nuvem: 16/04/13 (UI), 16.04.13 (monetização), 16.04.20 (UI), 16.04.27 (monetização), 16.04.27 (UI), 16/05/04 (UI), 16/05.11 (UI), 16/05.11 (monetização), 16/05.18 (interface), 16/05/25 (monetização), 06/16/08 (monetização), 16/06/15 (UI), 16/06/22 (monetização), 16/06.29 (UI), 16/07/06 (monetização), 16/07.06.02 (monetização), 16/07.13 (interface), 16/07.20.01 (monetização), 16/07.27 (interface), 16.08.17

Consulte Sobre a versão numeração, para entender como descobrir se uma versão específica incluído na sua versão do Edge para nuvem privada.

Visão geral da versão

Nesta versão, o editor de proxy de API clássico foi removido e substituído pelo novo proxy. que estava disponível para uso com o editor clássico. Outras melhorias importantes incluem um comportamento aprimorado dos caminhos de recursos dos produtos de API, melhor tratamento de payloads JSON definidas nas políticas "Atribuir mensagens" e "Aumentar falhas", melhorias nas conversões de XML para JSON, validação de recursos aprimorada, capacidade de definir tempos limite em proxies de API individuais, atualização de proxies SOAP no assistente de proxy da API e um objeto Crypto de alto desempenho para JavaScript.

Os aprimoramentos de monetização incluem novos recursos de notificação com um plano de preços de notificações, uma API que migra os desenvolvedores para monetização e a capacidade de tornar públicos os planos de tarifas ou privados.

O restante deste tópico contém detalhes sobre todos os novos recursos, atualizações e correções de bugs contido na versão.

Suspenso

Serviços da API

Editor de proxy clássico removido (IU do Cloud 16.04.20)

A nova versão do Editor de proxy de API agora é a única versão com suporte. A versão clássica não está mais disponível, e o link para "Acessar a versão clássica do Proxy Editor" foi removida. Se você estava usando a versão clássica, seus proxies de API serão carregados automaticamente no o novo editor. EDGEUI-498

Monetização

Os seguintes recursos descontinuados foram removidos e não têm mais suporte:

• Como definir limites
• Notificações de limite de envio

Como alternativa, você pode configurar as notificações, conforme descrito nas seções a seguir:

• Configurar evento notificações
• Crie um notificação de limite para um plano de tarifação

(DEVRT-2742)

Novos recursos e atualizações

Veja a seguir os novos recursos e melhorias desta versão. Além do seguinte melhorias, essa versão também contém vários recursos de usabilidade, desempenho, segurança e melhorias.

Para mais detalhes e instruções, consulte a documentação do Edge para nuvem privada.

Nuvem privada

Upgrade do Postres para a versão 9.4

Esta versão inclui um upgrade para o Postgres 9.4. Para instruções sobre como atualizar seu sistema, consulte Atualizar o Apigee Edge para 4.16.09.

Suporte a GeoMap na interface do Edge

As agregações geográficas permitem coletar dados de análise para chamadas de API com base na localização atributos como região, continente, país e cidade. Com esses dados de análise, é possível conferir GeoMap na interface do Edge que mostra o local das solicitações de API.

Para mais informações, consulte Como ativar a agregação geográfica e Geo Maps.

BaaS de API

Documentação adicionada sobre:

• Como configurar o BaaS de API para usar TLS. Para mais informações, consulte Como configurar o TLS para o BaaS de API.
• Como configurar todos os nós da pilha de BaaS da API para usar o armazenamento compartilhado de modo que todos os recursos sejam disponível para todos os nós da pilha de BaaS da API. Para mais informações, consulte Como fazer upload de recursos.
• Como criptografar a senha do Cassandra ao configurar os nós da pilha do BaaS. Para mais informações, consulte Como redefinir o Edge Senhas.

Versão Beta do painel e da ferramenta de monitoramento

Essa versão inclui a versão Beta da nova ferramenta de monitoramento e do painel do Edge. Essa ferramenta permite que você entenda a integridade de vários componentes (roteadores, processadores de mensagens, ZooKeeper, Cassandra) bem como códigos de erro http para várias organizações e ambientes em seu implantação do Google Workspace. Também é possível criar um snapshot dos dados do painel e compartilhá-lo com a Apigee para ajudar você e resolver incidentes de suporte.

A documentação, incluindo as instruções de instalação, está incluída no documento do Edge 4.16.09. na versão 4.18.01.

No entanto, antes de instalar e usar o painel, é preciso concluir a avaliação da Apigee do produto, também disponível na versão 4.18.01, e devolvê-lo à Apigee por enviando um e-mail para orders@apigee.com.

Versão Beta da ferramenta Coletor de análise

Todos os clientes do Edge para nuvem privada precisam enviar para a Apigee as estatísticas sobre APIs o tráfego de proxy. A Apigee recomenda que os clientes façam upload dessas informações uma vez por dia, possivelmente até criar um cron job.

Para ajudar no upload desses dados, a Apigee oferece a versão Beta da linha de comando apigee-analytics-collector. utilitário. Esse utilitário envia o relatório de volume de chamadas de API de volta à Apigee. Todas as bordas da A instalação da nuvem privada pode usar esse utilitário para recuperar e relatar dados de tráfego para a Apigee.

Para mais informações, consulte Como fazer upload de API Tráfego de dados para a Apigee - Versão Beta.

Serviços da API

Payloads JSON em "Atribuir mensagem" e "Gerar falha" (Cloud 16.08.17)

Com essa melhoria, nenhuma solução alternativa é necessária para garantir a formatação correta das mensagens JSON. as variáveis podem ser especificadas entre chaves sem criar um JSON inválido. Por exemplo, o a seguir, insere o valor de message.content na mensagem JSON:

<Payload contentType="application/json">{"Message: " : "{message.content}"}</Payload>

Se você usou uma solução alternativa, seu código continuará funcionando. Você também pode usar "variablePrefix" e "variablelimitado" em vez de chaves para indicar variáveis.

Consulte o <Set><Payload> na política Atribuir mensagem e Informar a política de falhas documentos de referência. APIRT-1160

Melhorias nas políticas de XML para JSON (Cloud 16.08.17)

A política XML para JSON foi aprimorada com os recursos a seguir. É possível configurar a política para:

• Trate alguns elementos XML como matrizes durante a conversão, o que coloca os valores em quadrados colchetes '[ ]' no documento JSON.
• Retire ou elimine níveis da hierarquia do documento XML no documento JSON final.

Para mais informações, consulte XML à política JSON. APIRT-1144

Vários caracteres curinga nos caminhos de recursos de produtos de API (Cloud 16.08.17)

Ao definir caminhos de recursos no produto da API, é possível incluir caracteres curinga em vários locais em uma caminho do recurso. Por exemplo, /team/*/invoices/** permite chamadas de API com um valor após /team e qualquer caminho de recurso após invoices/. Um URI permitido em uma chamada de API ser proxyBasePath/team/finance/invoices/company/a.

Se, após esta versão, os caminhos dos recursos de produtos de API deixarem de funcionar como esperado, defina a seguinte propriedade na sua organização para reverter para a versão anterior comportamento: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Funções de criptografia em JavaScript (Cloud 16.08.17)

Um novo conjunto de funções crypto JavaScript de alto desempenho está disponível para criar, receber e atualizar os objetos a seguir: MD5, SHA-1, SHA256, SHA512. O objeto crypto também permite receber em vários formatos. Para mais informações, consulte o modelo de objeto JavaScript. APIRT-2886

Verificação de versão JAR do Java Frase de destaque (Cloud 16.08.17)

Ao fazer o upload de um recurso Java JAR para um proxy de API, um código de status HTTP 400 é retornado (em vez de 500) se a versão do recurso Java for incompatível com o Edge compatível do Java, listada na seção Softwares e ferramentas compatíveis com suporte. (MGMT-3420)

Validação de recursos de proxy de API (Cloud 16.08.17)

Quando você tem arquivos de recurso de proxy de API (como JavaScript ou Java JARs) armazenados no do ambiente de execução ou da organização, o framework de validação não exige mais que você também Inclua esses recursos no nível do proxy da API em um pacote de proxy para que a importação passe na validação. A validação de recursos agora ocorre no momento da implantação, não no momento da importação. (MGMT-1430)

Configurar o tempo limite para proxies de API individuais (Cloud 16.08.17)

É possível configurar proxies de API para expirarem após um período especificado (com tempo limite do gateway 504) status). O caso de uso principal é para clientes da nuvem privada que têm proxies de API que usam mais tempo para ser executado. Por exemplo, digamos que você precise de proxies específicos para expirar em 3 minutos. Você pode Usar uma nova propriedade api.timeout na configuração de um proxy de API. Saiba como você faria isso com o exemplo de 3 minutos:

1. Primeiro, configure o balanceador de carga, o roteador e o processador de mensagens para atingir o tempo limite após 3 minutos.
2. Em seguida, configure os proxies relevantes para expirar em três minutos. Especifique o valor em milésimos de segundo. Exemplo:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath> 
       <Properties> 
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...
   

3. Observe, no entanto, que aumentar os tempos limite do sistema pode resultar em problemas de desempenho, porque todos os proxies sem uma configuração api.timeout usam o novo balanceador de carga maior, roteador e processador de mensagens. Portanto, configure outros proxies de API que não para usar tempos limite menores. Por exemplo, o comando a seguir define o tempo limite de um proxy de API. após 1 minuto:
   <Property name="api.timeout">60000</Property>

Os clientes do Cloud, que não podem modificar os tempos limite do Edge, também podem configurar um tempo limite do proxy de API, contanto que o tempo limite seja menor que o tempo limite padrão de 57 do processador de mensagens do Edge segundos.

Não é possível preencher o valor com uma variável. Essa propriedade é abordada nas propriedades do endpoint como referência. APIRT-1778

Comportamento do proxy SOAP ao usar o assistente de proxy (IU do Cloud 16.07.27)

Ao criar um proxy baseado em SOAP a partir de um WSDL usando o assistente de proxy, há duas opções para criação de proxy:

• SOB de passagem, em que o proxy simplesmente passa por uma solicitação de SOAP payload no estado em que se encontra.
• REST para SOAP para REST, em que o proxy converte um payload recebido, como JSON em um payload de SOAP e, em seguida, converte a resposta de SOAP novamente para o formato que o autor da chamada espera.

Esta versão inclui as seguintes atualizações sobre o comportamento dessas opções. As diferenças entre o comportamento antigo e o novo estão nas políticas e configurações que são automaticamente gerado pelo assistente de proxy.

SOAP de passagem

• Todas as operações WSDL agora são enviadas para o caminho base do proxy "/" em vez de recursos de proxy (como "/citypredictionbyzip"). Os nomes das operações são passados para o SOAP de destino serviço. Esse comportamento corresponde à especificação de SOAP.

• O proxy gerado não é mais compatível com JSON na solicitação. Ele é compatível apenas com XML. O proxy garante que as solicitações de SOAP tenham um Envelope, um Corpo e um namespace.

REST a SOAP para REST

• O WSDL 2.0 não é compatível.
• O novo comportamento não foi testado com o WS-Policy.
• O proxy permite POST de dados JSON em vez de FormParams.
• Quando você adiciona suporte ao CORS (Compartilhamento de recursos entre origens) ao proxy usando o proxy Builder, vai encontrar as seguintes melhorias:
  • Cabeçalho Access-Control-Allow-Headers: além de os cabeçalhos Origin, x-requested-with e Accept, os O cabeçalho Access-Control-Allow-Headers também inclui Content-Type, Accept-Encoding, Accept-Language, Host, Pragma, Referrer, User-Agent e Cache-Control.
  • Cabeçalho Access-Control-Allow-Methods: além de GET, PUT, POST e DELETE, esse cabeçalho também inclui o verbos PATCH e OPTIONS.
• Ao gerar um proxy de API para uma WSDL, o Edge lê todos os ComplexTypes definidos como na WSDL e reconhece de maneira adequada todos os tipos de instância baseados na tipos

Utilitário de linha de comando de código aberto wsdl2apigee

A Apigee também oferece um utilitário de linha de comando de código aberto para gerar proxies de API REST-to-soap de WSDLs. Consulte https://github.com/apigee/wsdl2apigee.

EDGEUI-614

Padrão de validade/atualização na política de operações de mapa de chave-valor (IU do Cloud 16.06.15)

A política de operações de mapeamento de chave-valor permite determinar por quanto tempo os valores são mantidos antes de que está sendo atualizado. O intervalo de atualização é definido com o elemento <ExpiryTimeInSecs>. Se uma operação GET é executada o intervalo de expiração for excedido, o valor será atualizado e a política receberá a . Quando você adiciona essa política a um proxy de API, o tempo de validade padrão é de 300 segundos. O o padrão anterior era -1, o que significa que os valores nunca são atualizados. EDGEUI-579

Monetização

Plano de taxa de notificação ajustável (interface do Cloud 16.04.20, monetização do Cloud 16.04.13)

Um novo plano de taxa de notificação ajustável na monetização do Edge permite que um provedor de API ajuste a número desejado de transações para cada desenvolvedor de apps. Você pode configurar se e quando as notificações são enviados com base na porcentagem do número alvo que foi alcançado, como 90%, 100% ou 150%. Este recurso está disponível por meio da interface de gerenciamento e da API de gerenciamento (disponível em uma versão anterior). Para mais informações, consulte Especificar detalhes do plano de notificação ajustável. (DEVRT-2375, DEVRT-2370)

Notificações de webhook para planos de taxa de notificação ajustáveis (Cloud 16.04.27) monetização)

Para planos de taxa de notificação ajustável, é possível criar webhooks que enviam notificações ao o URL que você especificar. Você também pode controlar as notificações para que ocorram em intervalos específicos (porcentagens). até atingir o limite de transações. As notificações de webhook oferecem uma experiência alternativa ao uso dos modelos de notificação existentes. Consulte Configurar notificações usando webhooks. (DEVRT-2393, DEVRT-2394)

Notificação ajustável com plano de taxa de atributo personalizado (interface do Cloud 16.05.18)

Na monetização do Edge, uma nova "Notificação ajustável com atributo personalizado" plano de tarifas permite que você adicionar à contagem de transações de um desenvolvedor usando o valor de um atributo personalizado. Com o padrão Plano de taxa de notificações ajustável, cada chamada de API bem-sucedida adiciona 1 à transação de um desenvolvedor contagem. Porém, com o plano de taxa de notificação ajustável com atributo personalizado, o valor da atributo personalizado é adicionado à contagem de transações do desenvolvedor. Por exemplo, se o atributo personalizado "pequena" tiver um valor de 0,1 na resposta, a contagem de transações será incrementada em 0,1; ou se atributo personalizado "addressTotal" tiver um valor de 50, a contagem será incrementada em 50. Para mais informações, consulte Especificar plano de tarifação com detalhes de atributos personalizados. (DEVRT-2504)

Configurar notificações com base em totais combinados de transações de uma empresa e dos desenvolvedores dela (Monetização do Cloud 16/06/22)

Normalmente, os totais de transações são rastreados automaticamente para todos os desenvolvedores de uma empresa quando os desenvolvedores usam o app da empresa para acessar as APIs. E se você tiver desenvolvedores ativos usando os próprios apps de desenvolvedor para acessar APIs, e você precisa rastrear as transações combinadas sem qualquer interrupção no tráfego? Você pode adicionar os desenvolvedores a uma empresa e configurar o envio de notificações quando os limites forem atingidos com base na combinação de transações para a empresa e seus desenvolvedores. Para mais informações, consulte Definir notificações com base nos totais combinados de transações de uma empresa e dos desenvolvedores dela. (DEVRT-2643)

Visualizar e reprocessar notificações (monetização do Cloud 16.06.08)

Como parte do pacote de testes de monetização, é possível acessar e reprocessar notificações antes enviados usando a API de gerenciamento. Para mais informações, consulte Como visualizar e de reprocessamento de notificações. (DEVRT-2643)

Testar a monetização (monetização do Cloud 16.05.25)

A monetização fornece um conjunto de APIs que podem ser usadas para testar a execução de webhooks para garantir que as notificações sejam enviadas. Para mais detalhes, consulte Testar a configuração de notificações. (DEVRT-2625)

Como migrar desenvolvedores para a monetização (monetização do Cloud 16.05.11)

Uma nova API está disponível para facilitar a migração de desenvolvedores para monetização. Você pode transferir o uso de transações e cobrar configurações personalizadas e taxas recorrentes. Além disso, quando aceitar um plano de tarifa publicado, é possível renunciar às taxas de configuração, caso elas já tenham sido cobradas. Para mais informações, consulte Migrar desenvolvedores para monetização. (DEVRT-2446)

Planos de tarifas públicas e privadas para o portal do desenvolvedor (monetização do Cloud 16/04/27)

Você pode definir planos de tarifas como "Públicos" ou "Particular". Os planos de tarifas públicos aparecem no console do desenvolvedor portal; Os planos de tarifas exclusivas não têm. O padrão para um plano de tarifação é Público. Para mais informações, consulte http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans. (DEVRT-2445)

Cancelar suspensão dos desenvolvedores (monetização do Cloud 16.06.08)

A monetização fornece um conjunto de APIs que podem ser usadas para cancelar a suspensão de um desenvolvedor que foi suspensa anteriormente. Um desenvolvedor poderá ser suspenso se um limite configurado for atingido. Para exemplo, o número de transações atingiu o limite máximo ou o saldo de uma conta pré-paga foi esgotado. Para mais informações, consulte Cancelar suspensão para desenvolvedores. (DEVRT-2641)

Ver o status das transações (monetização do Cloud 16.06.08)

Como parte do pacote de testes de monetização, é possível conferir o status das transações ocorreram durante um período específico usando a API de gerenciamento. Para mais informações, consulte Como visualizar o status transações. (DEVRT-2640)

Inclusão de atributos personalizados do desenvolvedor nos relatórios de receita (monetização do Cloud 16/05/25)

Para relatórios de receita, é possível incluir atributos personalizados, é definido para o desenvolvedor. Para mais informações, consulte Como incluir atributos nos relatórios de receita usando a API. (DEVRT-2447)

Política de gravação de transações e consistência de recursos do produto da API (IU do Cloud 16.05.18)

Se os caminhos dos recursos em uma política de gravação de transações de monetização não corresponderem aos recursos caminhos definidos no produto de API (por exemplo, se você alterar os caminhos de recurso do produto da API), o O ícone da política de registro de transações na página "Produtos" mostra um símbolo de aviso. Quando você clica no botão para visualizar a Política de registro de transações, um aviso será exibido na parte superior da página. Quando você corrigir os caminhos de recursos na política de registro de transações, os indicadores de aviso desaparecerão. (DEVRT-2240)

Bugs corrigidos

Os bugs a seguir foram corrigidos nesta versão. Esta lista é principalmente para usuários que verificam se os tíquetes de suporte foram corrigidos. Ela não foi projetada para fornecer informações detalhadas a todos os usuários.

Edge para nuvem privada

16.08.17

16.07.27 (interface)

16.07.20.01 (monetização)

Esta versão inclui pequenas alterações no esquema de banco de dados. Não há outras atualizações de software nesta lançamento.

16.07.13 (interface)

16.07.06.02 (monetização)

16.07.06 (monetização)

16.06.29 (interface)

06/16/22 (monetização)

Nenhum

16.06.15 (interface)

16.06.08 (monetização)

Nenhum

16.05.25 (monetização)

16.05.18 (interface)

16.05.11 (monetização)

16.05.11 (interface)

16.05.04 (interface)

16.04.27 (interface)

04/16/27 (monetização)

Nenhum

16.04.20 (interface)

16.04.13 (monetização)

Nenhum

16.04.13 (interface)

Problemas conhecidos

Esta versão tem os seguintes problemas conhecidos: