4.16.09 - Private Cloud용 Edge 출시 노트

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

2016년 9월 19일 월요일, 프라이빗 클라우드용 Apigee Edge 새 버전이 출시되었습니다.

이전 Edge Private Cloud 기능 출시 이후 다음 출시에서 이 기능 출시에 포함되어 있습니다.

• 클라우드: 16.04.13 (UI), 16.04.13 (수익 창출), 2020년 4월 16일 (UI), 2027년 4월 16일 (수익 창출), 2027년 4월 16일 (사용자 인터페이스), 4월 16일 5월 16일 (UI), 2011년 5월 16일 (UI), 5월 11일 16일 (수익 창출), 2018년 5월 16일 (UI), 2025년 5월 16일 (수익 창출), 6월 16일 (수익 창출), 6월 16일 15 (UI), 2022년 6월 16일 (수익 창출), 6월 16일 (UI), 6월 16일 7월 16일 (수익 창출), 2016년 7월 6일 (수익 창출), 16.07.13 (UI), 2020년 1월 16일 (수익 창출), 16.07.27 (UI), 16.08.17

출시 정보 번호 매기기를 사용하여 특정 클라우드 릴리스가 프라이빗 클라우드용 Edge 버전에 포함되어 있습니다.

출시 개요

이번 출시에서는 기존 API 프록시 편집기가 삭제되고 새 프록시로 대체되었습니다. 이전 버전의 편집기와 함께 사용할 수 있었습니다. 기타 주목할 만한 개선사항 API 제품 리소스 경로의 동작이 향상되고 JSON 페이로드 처리가 개선되었습니다. 메시지 할당 및 오류 발생 정책, XML에서 JSON으로의 변환 개선, 리소스 유효성 검사 개선, 개별 API 프록시에 제한 시간 설정 기능, 업데이트됨 SOAP 프록시의 생성을 지원하는 시스템, 그리고 SOAP 프록시 서버를 위한 고성능 암호화 객체를 있습니다.

수익 창출 개선사항에는 알림 요금제가 포함된 새로운 알림 기능, 개발자를 수익 창출로 이전하는 API 및 요금제를 공개하거나 비공개입니다.

이 주제의 나머지 부분에서는 모든 새로운 기능, 업데이트, 버그 수정에 대한 세부정보를 다룹니다. 확인할 수 있습니다

지원 중단됨

API 서비스

기본 프록시 편집기 삭제됨 (Cloud 16.04.20 UI)

이제 API 프록시 편집기의 새 버전이 유일하게 지원됩니다. 기본 버전 더 이상 사용할 수 없으며 "프록시 편집기의 기본 버전에 액세스"에 대한 링크가 이었습니다 삭제되었습니다. 기존 버전을 사용 중이었다면 API 프록시가 다음 위치에 자동으로 로드됩니다. 하겠습니다. (EDGEUI-498)

수익 창출

다음과 같은 지원 중단된 기능이 삭제되었으며 더 이상 지원되지 않습니다.

• 한도 설정
• 전송 한도 알림

또는 다음 섹션에 설명된 대로 알림을 설정할 수 있습니다.

• 이벤트 설정 알림
• 요금제 한도 알림

(DEVRT-2742)

새로운 기능 및 업데이트

다음은 이번 버전의 새로운 기능과 개선사항입니다. 다음 사항 외에도 개선사항, 이 릴리스에는 다양한 사용성, 성능, 보안 및 안정성이 포함되어 있습니다. 향상되었습니다.

자세한 내용 및 안내는 프라이빗 클라우드용 Edge 문서를 참조하세요.

프라이빗 클라우드

Postr를 버전 9.4로 업그레이드

이 출시 버전에는 Postgres 9.4로의 업그레이드가 포함되어 있습니다. 시스템 업데이트에 대한 안내를 보려면 Apigee Edge를 4.16.09.

Edge UI의 GeoMap 지원

지역 집계를 사용하면 지리적 위치를 기반으로 API 호출에 대한 분석 데이터를 수집할 수 있습니다. 지역, 대륙, 국가, 도시와 같은 속성이 포함됩니다. 이 분석 데이터를 통해 API 요청의 위치를 보여주는 Edge UI의 GeoMap

자세한 내용은 지역 집계 사용 설정 및 지역 지도.

API BaaS

다음에 관한 문서가 추가되었습니다.

• TLS를 사용하도록 API BaaS를 구성하는 방법 자세한 내용은 API BaaS용 TLS 구성을 참고하세요.
• 모든 애셋이 공유 스토리지를 사용하도록 모든 API BaaS 스택 노드를 구성하는 방법 모든 API BaaS 스택 노드에서 사용할 수 있습니다. 자세한 내용은 애셋 업로드하기를 참고하세요.
• BaaS 스택 노드를 구성할 때 Cassandra 비밀번호를 암호화하는 방법 자세한 내용은 자세한 내용은 Edge 재설정 비밀번호.

모니터링 도구 및 대시보드의 베타 출시

이 출시 버전에는 새로운 Edge용 모니터링 도구 및 대시보드의 베타 버전이 포함되어 있습니다. 이 도구를 사용하면 다양한 구성요소 (라우터, 메시지 프로세서, 동물원_키퍼, Cassandra)의 다양한 조직 및 환경에 대한 HTTP 오류 코드와 함께 배포할 수 있습니다 또한 대시보드 데이터의 스냅샷을 생성하고 이를 Apigee와 공유하여 해결할 수 있습니다

설치 안내가 포함된 문서는 Edge 4.16.09 문서에 포함되어 있습니다. 버전 4.18.01

하지만 대시보드를 설치하고 사용하려면 먼저 Apigee 평가를 완료해야 합니다. 버전 4.18.01에서도 이용할 수 있으며 다음 기한까지 Apigee에 반환합니다. Orders@apigee.com으로 이메일을 보내주세요

애널리틱스 수집기 도구의 베타 출시

모든 프라이빗 클라우드용 Edge 고객은 API에 대한 통계를 Apigee에 제출해야 합니다. 사용할 수 있습니다 Apigee는 이러한 정보를 하루에 한 번(가능한 경우 1회 업로드) 업로드할 것을 권장합니다. 크론 작업을 만듭니다

이러한 데이터의 업로드를 지원하기 위해 Apigee는 apigee-analytics-collector 명령줄의 베타 출시 버전을 제공합니다. 유틸리티입니다 이 유틸리티는 API 호출량 보고서를 다시 Apigee로 전송합니다. 모든 엣지 프라이빗 클라우드 설치는 이 유틸리티를 사용하여 Apigee를 사용하세요

자세한 내용은 업로드 API를 참조하세요. Apigee로의 트래픽 데이터 - 베타 출시 버전

API 서비스

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

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

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

해결 방법을 사용했다면 코드는 그대로 작동합니다. 또한 변수를 나타내는 중괄호 대신 varPrefix 및 varSuffix를 사용합니다.

자세한 내용은 <Set><Payload> 메시지 할당 정책에 있는 요소 및 결함 정책 제출 참조 문서 (APIRT-1160)

XML에서 JSON으로의 정책 개선 (Cloud 16.08.17)

XML-JSON 정책이 다음 기능을 통해 향상되었습니다. 사용자는 정책을 다음과 같이 변경합니다.

• 변환 중에 일부 XML 요소를 배열로 취급하여 값이 정사각형으로 표시됩니다. 대괄호 '[ ]' JSON 문서에서 확인할 수 있습니다
• 최종 JSON 문서에서 XML 문서 계층 구조의 레벨을 제거하거나 제거합니다.

자세한 내용은 XML JSON 정책으로 변경합니다. (APIRT-1144)

API 제품 리소스 경로에 여러 와일드 카드 (Cloud 16.08.17)

API 제품에서 리소스 경로를 정의할 때 리소스 경로를 지정해야 합니다 예를 들어 /team/*/invoices/**는 /team 및 모든 리소스 경로 뒤에 값 1개 invoices/ 이후 API 호출에 허용된 URI는 proxyBasePath/team/finance/invoices/company/a이어야 합니다.

이번 출시 후에 기존 API 제품 리소스 경로가 예상대로 작동하지 않는 경우 다음을 설정하세요. 조직의 다음 속성을 이전 상태로 되돌리기 동작: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

JavaScript의 암호화 함수 (Cloud 16.08.17)

새로운 고성능 JavaScript crypto 함수 집합을 사용할 수 있습니다. MD5, SHA-1, SHA256, SHA512 객체가 있습니다. 또한 crypto 객체를 사용하면 날짜 형식일 수 있습니다. 자세한 내용은 JavaScript 객체 모델을 참조하세요. (APIRT-2886)

Java 콜아웃 JAR 버전 확인 (Cloud 16.08.17)

Java JAR 리소스를 API 프록시에 업로드하면 HTTP 400 상태 코드가 반환됩니다. (500 대신) Java 리소스 버전이 지원되는 Edge 버전과 호환되지 않는 경우 지원되는 소프트웨어 및 지원되는 버전을 참조하세요. (MGMT-3420)

API 프록시 리소스 유효성 검사 (Cloud 16.08.17)

API 프록시 리소스 파일 (예: JavaScript 또는 Java JAR)이 보안성 검증 프레임워크가 실행되기 때문에 유효성 검사를 통과하려면 가져올 수 있도록 프록시 번들의 API 프록시 수준에서 해당 리소스를 포함해야 합니다. 리소스 유효성 검사는 이제 가져오기 시간이 아니라 배포 시간에 수행됩니다. (MGMT-1430)

개별 API 프록시의 제한 시간 구성 (Cloud 16.08.17)

지정된 시간 (504 게이트웨이 시간 제한)이 지나면 타임아웃되도록 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 프록시를 더 짧은 시간 제한을 사용하려면 더 긴 시간 제한을 설정해야 합니다. 예를 들어 다음은 타임아웃되도록 API 프록시를 설정합니다. 1분 후:
   <Property name="api.timeout">60000</Property>

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

값을 변수로 채울 수 없습니다. 이 속성은 엔드포인트 속성에서 다룹니다. 참조 (APIRT-1778)

프록시 마법사 사용 시 SOAP 프록시 동작 (Cloud 16.07.27 UI)

프록시 마법사를 사용하여 WSDL에서 SOAP 기반 프록시를 만들 때 프록시 생성:

• 패스 스루 SOAP: 프록시가 단순히 SOAP 요청을 통과합니다. 그대로 둡니다
• REST에서 SOAP로, REST에서 REST로, 여기서 프록시는 수신 페이로드, JSON을 SOAP 페이로드로 변환한 다음 SOAP 응답을 호출자의 형식으로 다시 변환합니다. 있습니다

이번 릴리스에서는 이러한 옵션의 작동 방식이 다음과 같이 업데이트되었습니다. 차이점 자동으로 적용되는 정책과 구성에 있는 생성할 수 있습니다.

패스스루 SOAP

• 이제 모든 WSDL 작업이 프록시 기본 경로 "/"로 전송됩니다. Google Cloud로 리소스를 (예: '/cityforecastbyzip') 작업 이름이 대상 SOAP로 전달됨 있습니다. 이 동작은 SOAP 사양과 일치합니다.

• 생성된 프록시는 더 이상 요청에서 JSON을 지원하지 않습니다. XML만 지원합니다. 프록시 SOAP 요청에 봉투, 본문 및 네임스페이스가 있는지 확인합니다.

REST에서 SOAP로, 그리고 REST에서 REST로

• WSDL 2.0은 지원되지 않습니다.
• 새로운 동작은 WS-Policy로 테스트되지 않았습니다.
• 프록시를 사용하면 FormParams 대신 JSON 데이터를 POST할 수 있습니다.
• 프록시를 사용하여 프록시에 CORS (교차 출처 리소스 공유) 지원을 추가하는 경우 다음과 같은 개선사항을 확인할 수 있습니다. <ph type="x-smartling-placeholder">
  </ph>
  • Access-Control-Allow-Headers 헤더: Origin, x-requested-with, Accept 헤더, Access-Control-Allow-Headers 헤더에는 Content-Type, Accept-Encoding, Accept-Language, Host Pragma, Referrer, User-Agent 및 Cache-Control.
  • Access-Control-Allow-Methods 헤더: GET 외에도 PUT, POST, DELETE를 사용하는 경우 이 헤더에는 PATCH 및 OPTIONS 동사
• WSDL에 대한 API 프록시를 생성할 때 Edge는 추상 클래스이며 추상 추상화를 기반으로 하는 모든 인스턴스 유형을 올바르게 인식합니다. 있습니다.

wsdl2apigee 오픈소스 명령줄 유틸리티

Apigee는 오픈소스 명령줄 유틸리티를 제공하여 WSDL에서 REST-to-soap API 프록시를 사용합니다. https://github.com/apigee/wsdl2apigee를 참조하세요.

(EDGEUI-614)

키-값 맵 작업 정책의 만료/새로고침 기본값 (Cloud 16.06.15 UI)

키-값 맵 작업 정책을 통해 데이터가 저장되기 전에 값이 유지되는 기간을 결정할 수 있습니다. 있습니다. 새로고침 간격은 <ExpiryTimeInSecs> 요소 GET 작업이 실행되고 만료 간격이 초과되면 값이 새로고침되고 정책이 값으로 사용됩니다. 이 정책을 API 프록시에 추가하면 이제 기본 만료 시간이 300초로 설정됩니다. ( 이전 기본값은 -1이며, 이는 값이 새로고침되지 않음을 의미합니다.) (EDGEUI-579)

수익 창출

조정 가능한 알림 요금제 (Cloud 16.04.20 UI, Cloud 16.04.13 수익 창출)

Edge 수익 창출의 조정 가능한 새로운 알림 요금제를 통해 API 제공업체가 각 앱 개발자의 목표 거래 건수입니다. 알림의 여부와 알림을 설정할 수 있습니다. 90%, 100% 또는 150%를 탭합니다. 이 기능은 관리 API 외에도 관리 UI를 통해 사용할 수 있습니다. (이전 출시에서 제공되었음). 자세한 내용은 조정 가능한 알림 계획 세부정보를 참조하세요. (DEVRT-2375, DEVRT-2370)

조정 가능한 알림 요금제용 웹훅 알림 (Cloud 16.04.27) 수익 창출)

조정 가능한 알림 요금제의 경우 지정할 수 있습니다. 알림이 특정 간격 (백분율)에 따라 발생하도록 제어할 수도 있습니다. 최대 30%가 지급됩니다. 웹훅 알림을 사용하면 사용할 수 있습니다. 다음을 사용하여 알림 설정 웹훅을 설정할 수도 있습니다. (DEVRT-2393, DEVRT-2394)

맞춤 속성 요금제가 포함된 조정 가능한 알림 (Cloud 16.05.18 UI)

Edge 수익 창출의 새로운 '커스텀 속성이 있는 조정 가능한 알림' 요금제를 사용하면 맞춤 속성 값을 사용하여 개발자의 거래 수에 추가합니다. 표준 조정 가능한 알림 요율 계획. API 호출이 성공할 때마다 개발자 거래에 1이 추가됨 있습니다. 하지만 맞춤 속성 요금제가 포함된 조정 가능 알림을 사용하면 맞춤 속성이 개발자의 거래 수에 추가됩니다. 예를 들어 맞춤 속성이 '작은' 응답에 0.1 값이 있으면 트랜잭션 수가 0.1씩 증가합니다. 또는 맞춤 속성 'addressTotal' 값이 50이면 개수가 50씩 증가합니다. 자세한 내용은 자세한 내용은 요금제 지정 맞춤 속성 세부정보 사용을 참조하세요. (DEVRT-2504)

회사와 개발자의 거래 총액을 합산하여 알림을 설정합니다. (Cloud 16.06.22 수익 창출)

일반적으로 회사 내 모든 개발자의 거래 총액은 다음과 같은 경우 자동으로 추적됩니다. 개발자가 회사 앱을 사용하여 API에 액세스합니다. 만약 개발자가 자체 개발자 앱을 사용하여 API에 액세스하고, 이들의 통합 거래를 추적해야 합니다. 트래픽 중단 없이 총계를 계산할 수 있나요? 개발자를 회사에 추가하고 통합된 거래를 기준으로 기준점에 도달하면 전송되는 알림 회사와 개발자의 총액입니다. 자세한 내용은 설정 회사와 개발자의 거래 총액을 합산하여 알림 설정 (DEVRT-2643)

알림 보기 및 다시 처리 (Cloud 16.06.08 수익 창출)

수익 창출 테스트 모음의 일환으로 이전에 알림을 확인하고 다시 처리할 수 있습니다. 관리 API를 사용하여 전송됩니다. 자세한 내용은 보기 및 알림 재처리를 참조하세요. (DEVRT-2643)

수익 창출 테스트 (Cloud 16.05.25 수익 창출)

수익 창출은 웹훅 실행을 테스트하는 데 사용할 수 있는 API 집합을 제공합니다. 알림이 전송되고 있는지 확인합니다 자세한 내용은 알림 설정 테스트를 참고하세요. (DEVRT-2625)

개발자를 수익 창출로 마이그레이션 (Cloud 16.05.11 수익 창출)

개발자가 수익 창출로 쉽게 이전할 수 있도록 새로운 API를 사용할 수 있습니다. 다음과 같은 작업을 할 수 있습니다. 거래 사용 내역을 전송하고 맞춤 설정 및 반복 수수료를 청구할 수 있습니다. 또한 게시된 요금제를 수락하면 이미 청구된 경우 설정 수수료를 면제받을 수 있습니다. 자세한 내용은 개발자를 수익 창출에 대해 자세히 알아보세요. (DEVRT-2446)

개발자 포털의 공개 및 비공개 요금제 (Cloud 16.04.27 수익 창출)

요금제를 '공개'로 설정할 수 있습니다. 또는 '비공개'입니다. 개발자에게 표시되는 공개 요금제 portal; 특별 요금제는 포함되지 않습니다. 요금제의 기본값은 공개입니다. 자세한 내용은 http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans를 참조하세요. (DEVRT-2445)

개발자 정지 해제 (Cloud 16.06.08 수익 창출)

수익 창출은 개발자의 계정 정지를 해제하는 데 사용할 수 있는 API 집합을 제공합니다. 서비스 계정을 만들 수 있습니다 구성된 한도에 도달하면 개발자가 정지될 수 있습니다. 대상 예: 거래 수가 최대 한도에 도달했거나 선불 계정 잔액이 결제되었습니다. 소진되었습니다. 자세한 내용은 개발자 정지 해제를 참고하세요. (DEVRT-2641)

거래 상태 보기 (Cloud 16.06.08 수익 창출)

수익 창출 테스트 모음의 일환으로 관리 API를 사용하여 지정된 기간 동안 발생한 시간 자세한 내용은 자세한 내용은 거래를 참조하세요. (DEVRT-2640)

수익 보고서에 개발자 맞춤 속성 포함 (Cloud 16.05.25 수익 창출)

수익 보고서에 한해 보고서에 맞춤 속성을 포함할 수 있습니다. 속성이 개발자에 대해 정의된 것입니다. 자세한 내용은 개발자 맞춤 항목 포함을 참조하세요. 속성 보기 (DEVRT-2447)

트랜잭션 기록 정책 및 API 제품 리소스 일관성 (Cloud 16.05.18 UI)

수익 창출 거래 기록 정책의 리소스 경로가 리소스와 일치하지 않는 경우 API 제품에 정의된 경로 (예: API 제품 리소스 경로를 변경하는 경우) 제품 페이지의 거래 기록 정책 아이콘에 경고 기호가 표시되어 있습니다. 왼쪽 탐색창에서 아이콘을 클릭하여 Transaction Recording Policy를 확인하면 페이지 상단에 경고가 표시됩니다. Transaction Recording Policy에서 리소스 경로를 수정하면 경고 표시가 사라집니다. (DEVRT-2240)

수정된 버그

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

프라이빗 클라우드용 에지

16.08.17

2016년 7월 16일 (사용자 인터페이스)

16.07.20.01 (수익 창출)

이 버전에는 사소한 DB 스키마 변경사항이 포함되어 있습니다. 이 버전에는 다른 소프트웨어 업데이트가 없습니다. 있습니다.

16.07.13 (UI)

16.07.06.02 (수익 창출)

16.07.06 (수익 창출)

16.06.29 (UI)

16.06.22 (수익 창출)

없음

16.06.15 (UI)

16.06.08 (수익 창출)

없음

16.05.25 (수익 창출)

16.05.18 (UI)

16.05.11 (수익 창출)

16.05.11 (UI)

16.05.04 (UI)

16.04.27 (UI)

16.04.27 (수익 창출)

없음

2020년 4월 16일 (UI)

16.04.13 (수익 창출)

없음

16.04.13 (UI)

알려진 문제

이 릴리스에는 다음과 같은 알려진 문제가 있습니다.