16.08.17 - 퍼블릭 클라우드용 Apigee Edge 출시 노트

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

2016년 8월 30일 화요일에 Apigee Edge for Public Cloud의 새 버전이 출시되었습니다.

새로운 기능 및 업데이트

다음은 이번 출시의 새로운 기능과 업데이트입니다.

메시지 할당 및 오류 발생의 JSON 페이로드

이 개선사항을 사용하면 올바른 JSON 메시지 형식을 보장하기 위해 해결 방법이 필요하지 않으며 잘못된 JSON을 만들지 않고 중괄호를 사용하여 변수를 지정할 수 있습니다. 예를 들어 다음은 JSON 메시지에 message.content 값을 삽입합니다.

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

해결 방법을 사용한 경우 코드는 그대로 계속 작동합니다. 중괄호 대신 variablePrefix 및 variableSuffix를 사용하여 변수를 나타낼 수도 있습니다.

메시지 할당 정책 및 오류 발생 정책 참조 문서에서 <Set><Payload> 요소를 참조하세요. (APIRT-1160)

XML to JSON 정책 개선사항

XML to JSON 정책이 다음과 같은 기능으로 개선되었습니다. 정책을 다음과 같이 구성할 수 있습니다.

• 변환 중에 일부 XML 요소를 배열로 처리하여 JSON 문서의 대괄호 '[ ]' 안에 값을 넣습니다.
• 최종 JSON 문서에서 XML 문서 계층 구조의 수준을 삭제하거나 제거합니다.

자세한 내용은 XML to JSON 정책을 참조하세요. (APIRT-1144)

API 제품 리소스 경로의 여러 와일드 카드

API 제품에서 리소스 경로를 정의할 때 리소스 경로의 여러 위치에 와일드 카드를 포함할 수 있습니다. 예를 들어 /team/*/invoices/**는 /team 뒤에 하나의 값이 있는 API 호출과 invoices/ 뒤에 리소스 경로를 허용합니다. API 호출에서 허용되는 URI는 proxyBasePath/team/finance/invoices/company/a입니다.

이 출시 후 기존 API 제품 리소스 경로가 예상대로 작동하지 않으면 조직에서 다음 속성을 설정하여 이전 동작으로 되돌립니다. features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

JavaScript의 암호화 함수

다음 해시 객체(MD5, SHA-1, SHA256, SHA512)를 만들고 가져오고 업데이트하는 데 사용할 수 있는 고성능 JavaScript crypto 함수가 새로 제공됩니다. 암호화 객체를 사용하면 다양한 형식으로 날짜를 가져올 수도 있습니다. 자세한 내용은 JavaScript 객체 모델을 참조하세요. (APIRT-2886)

Java 콜아웃 JAR 버전 확인

Java JAR 리소스를 API 프록시에 업로드할 때 Java 리소스 버전이 지원되는 소프트웨어 및 지원되는 버전에 나열된 Edge 지원 Java 버전과 호환되지 않으면 HTTP 500 대신 HTTP 400 상태 코드가 반환됩니다. 지원되는 소프트웨어 및 지원되는 버전에 나열된 Edge 지원 Java 버전과 호환되지 않으면 HTTP 500 대신 HTTP 400 상태 코드가 반환됩니다. (MGMT-3420)

API 프록시 리소스 유효성 검사

환경 또는 조직 범위에 저장된 API 프록시 리소스 파일 (예: JavaScript 또는 Java JAR)이 있는 경우 유효성 검사 프레임워크에서 유효성 검사를 통과하기 위해 가져오기용 프록시 번들의 API 프록시 수준에 이러한 리소스를 포함하도록 더 이상 요구하지 않습니다. 이제 리소스 유효성 검사는 가져오기 시간이 아닌 배포 시간에 발생합니다. (MGMT-1430)

개별 API 프록시의 시간 제한 구성

지정된 시간 (504 게이트웨이 시간 제한 상태)이 지나면 타임아웃되도록 API 프록시를 구성할 수 있습니다. 기본 사용 사례는 실행하는 데 시간이 오래 걸리는 API 프록시가 있는 프라이빗 클라우드 고객을 위한 것입니다. 예를 들어 특정 프록시를 3분에 타임아웃해야 한다고 가정해 보겠습니다. API 프록시 구성에서 새 api.timeout 속성을 사용할 수 있습니다. 3분 예시를 사용하여 이 작업을 수행하는 방법은 다음과 같습니다.

1. 먼저 3분 후 부하 분산기, 라우터, 메시지 프로세서가 시간 초과되도록 구성해야 합니다.
2. 그런 다음 3분 후에 타임아웃되도록 관련 프록시를 구성합니다. 값을 밀리초 단위로 지정하세요. 예를 들면 다음과 같습니다.

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

3. 그러나 시스템 시간 제한을 늘리면 api.timeout 설정이 없는 모든 프록시가 새로운 상위 부하 분산기, 라우터, 메시지 프로세서 시간 제한을 사용하므로 성능 문제가 발생할 수 있습니다. 따라서 더 짧은 시간 제한을 사용하기 위해 더 이상 시간 제한이 필요 없는 다른 API 프록시를 구성합니다. 예를 들어 다음은 1 분 후 API 프록시가 시간 초과되도록 설정합니다.
   <Property name="api.timeout">60000</Property>

Edge 시간 제한을 수정할 수 없는 클라우드 고객은 표준 Edge 메시지 프로세서 제한 시간인 57 초보다 짧은 경우 API 프록시 시간 제한도 구성할 수 있습니다.

변수로 값을 채울 수는 없습니다. 이 속성은 엔드포인트 속성 참조에 설명되어 있습니다. (APIRT-1778)

메시지 로깅 정책의 TLS/SSL

<KeyStore> 및 <TrustStore>는 로깅 서비스와 함께 단방향 및 양방향 TLS/SSL을 사용할 수 있도록 SSLInfo 구성의 메시지 로깅 정책에서 설정할 수 있습니다. 프록시 TargetEndpoint에서와 마찬가지로 메시지 로깅 정책에서 SSLInfo를 구성합니다. 그러나 메시지 로깅 TLS/SSL은 TCP 프로토콜만 지원합니다. (APIRT-1858)

수정된 버그

다음은 이번 출시 버전에서 수정된 버그입니다. 이 목록은 주로 자신의 지원 티켓에서 제기한 문제가 수정되었는지 확인하는 사용자를 위한 것입니다. 모든 사용자에게 자세한 정보를 제공하기 위한 목적은 아닙니다.