Apigee Edge와 Apigee X의 차이점

Apigee Edge 문서입니다.
Apigee X 문서로 이동
정보

이 주제에서는 Apigee X('Apigee'라고도 함)와 Apigee Edge의 차이점을 설명합니다. 이 정보는 Apigee X로 이전하는 것을 고려 중인 기존 Apigee Edge 고객을 위해 제공됩니다.

Apigee X 기능에 관한 자세한 내용은 Apigee X 기능 요약을 참고하세요.

다음 표에서는 이 주제에서 비교한 Apigee API 관리 제품을 보여줍니다.

제품 호스팅된 위치 관리자:
퍼블릭 클라우드용 Apigee Edge Apigee의 클라우드 Apigee
프라이빗 클라우드용 Apigee Edge 고객의 비공개 데이터 센터입니다. 고객
Apigee X Google Cloud Apigee
Apigee Hybrid Google Cloud와 고객의 비공개 데이터 센터 모두 Apigee는 관리 영역을 관리하고 고객은 런타임 영역을 관리합니다.

Apigee Edge와 Apigee X 기능 비교

다음 섹션에서는 Apigee Edge 퍼블릭/프라이빗 클라우드 기능과 Apigee X 및 하이브리드에서 사용할 수 있는 기능을 비교합니다.

또한 Apigee X 한도Apigee Edge 한도와 다릅니다.

현재 기능 차이 요약

다음 표에서는 Apigee X (및 하이브리드)와 퍼블릭 및 프라이빗 클라우드 플랫폼용 Apigee Edge 간의 기능 수준 차이점을 설명합니다.

Apigee Edge 기능 Apigee X 및 하이브리드에서 지원
API 프록시 버전

배포되면 변경할 수 없음

진행 중인 상태 확인 VM을 사용하는 외부 MIG에 지원됩니다. Private Service Connect를 사용하는 경우에는 지원되지 않습니다. 라우팅 유형에 관한 자세한 내용은 라우팅 구성을 참고하세요.
Istio용 Apigee 어댑터 지원 중단됨: Envoy용 Apigee 어댑터를 대신 사용하는 것이 좋습니다.
회사 개발자

유사하지만 동일하지 않은 솔루션을 사용할 수 있습니다. AppGroup을 사용하여 앱 소유권 정리를 참고하세요.

CwC (구성이 포함된 코드)

예정

배포
  • 비동기 배포
  • 배포 상태 가져오기는 런타임 영역이 관리 영역으로 '체크인된' 마지막 시점을 기준으로 함
환경
  • 환경 그룹 지원
  • Apigee UI 및 API를 통한 셀프서비스
  • 더욱 유연한 토폴로지 제공
  • MP pod는 하나의 환경만 지원할 수 있음

자세한 내용은 환경 및 환경 그룹 정보를 참조하세요.

호스팅된 대상

Cloud Run 또는 Cloud Functions를 사용하세요.

HTTP/1.1 헤더 필드 이름 처리 백엔드로 전달될 때 HTTP/1.1 헤더 필드 이름을 소문자로 변환합니다. Apigee Edge에서는 헤더 필드 이름의 대소문자가 보존됩니다.
세분화된 역할 기반 액세스 제어를 위한 IAM 역할

예정

[@.length-x]를 사용하는 JSONPath

JSONPath 표현식에서 [@.length-x] 사용은 Apigee X에서 지원되지 않습니다. JSONPath 사양에 따르면 표현식은 기본 스크립트 언어에 종속됩니다. length-x는 Java가 아닌 JavaScript 구성이며 [@.length-x]는 사양의 일부로 구현되지 않았습니다. Apigee X에서 표현식 [@.length-x]는 색인 생성 스키마 ([-x])로 대체됩니다.

이 예에서는 다음과 같은 작업을 수행합니다.

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

입력: $.books[@.length-1]는 Apigee Edge에서 {“name”: “B”}를 반환하고 Apigee X에서 [{“name”: “B”}]를 반환합니다.

키 저장소/트러스트 저장소

Kubernetes 보안 비밀로 관리되는 상위 연결

KVM
  • Apigee UI에서 암호화된 환경 범위의 KVM을 만들 수 있습니다. KVM은 항상 암호화됩니다. UI에서 KVM 항목을 추가, 업데이트 또는 볼 수 없습니다.
  • 디버그(Trace) 세션에서 KVM 정보를 숨기려면 GET 명령어를 사용하여 KVM에 액세스할 때 모든 변수가 있는 private. 속성을 사용하세요. private. 속성을 사용하지 않으면 KVM이 여전히 암호화됩니다. 그러나 KVM 정보는 디버그(Trace) 세션에 복호화되어 표시되며 예외가 발생하지 않습니다.
  • keyvaluemaps.entries API 또는 KeyValueMapOperations 정책을 사용하여 KVM 항목을 관리할 수 있습니다.
  • KVM과 동일한 사용 사례에 속성 집합을 사용할 수 있습니다. 속성 세트 사용을 참조하세요.
  • <MapName> 요소를 사용하면 KeyValueMapOperations 정책에서 런타임 시 동적으로 사용할 KVM을 식별할 수 있습니다.

UI에서 KVM을 만드는 방법에 대한 자세한 내용은 키-값 맵 사용을 참조하세요. 올바른 데이터 지속성 메커니즘을 선택하는 방법은 구성 데이터 액세스를 참조하세요.

Microgateway 대신 Envoy용 Apigee 어댑터를 사용하는 것이 좋습니다.
수익 창출 수익 창출과의 차이점을 참고하세요.
Node.js
  • Node.js API 프록시는 지원되지 않습니다.
  • Apigee에서는 Node.js 애플리케이션을 Kubernetes에서 별도의 컨테이너(동일한 클러스터 또는 다른 클러스터)로 호스팅하는 것을 권장합니다.
노스바운드 mTLS Google Cloud 부하 분산기를 통해 지원됩니다. 외부 애플리케이션 부하 분산기를 사용하는 Apigee X Northbound 상호 TLS를 참고하세요.
OAuth RevokeOAuthv2 정책이 최종 사용자 ID, 앱 ID 또는 둘 다에 의해 취소됩니다. 이 정책은 Apigee Edge API를 대체하여 OAuth2 토큰을 취소합니다.
정책
  • 새 정책:
    • AssertCondition 정책: 요청 또는 응답 흐름에서 런타임으로 조건부 문을 평가합니다.
    • CORS 정책: 웹페이지에서 실행되는 자바스크립트 XMLHttpRequest(XHR) 호출이 출처가 다른 도메인의 리소스와 상호작용할 수 있도록 허용합니다.
    • DataCapture 정책: StatisticsCollector 정책을 바꿉니다.
    • ExternalCallout 정책: Apigee 정책으로 지원되지 않는 커스텀 동작을 구현하기 이해 gRPC 요청을 gRPC 서버로 전송합니다.
    • GraphQL 정책: GraphQL 페이로드를 메시지 흐름 변수로 파싱하거나 스키마에 대해 GraphQL 요청을 확인하거나 둘 다 수행합니다.
    • PublishMessages 정책: API 프록시 흐름 정보를 Google Cloud Pub/Sub 주제에 게시합니다.
    • RevokeOAuthv2 정책: 사용자 ID, 앱 ID 또는 둘 다에 의해 취소됩니다.
    • TraceCapture 정책: 추가 변수를 Apigee 런타임의 trace 데이터에 추가합니다.
  • 지원되지 않는 정책:
    • StatisticsCollector 정책(새 DataCapture 정책으로 대체됨)
  • 변경된 정책:
reasonPhrase 지원되지 않음.
리소스 조직 수준의 리소스를 사용할 수 없습니다.
역할 및 권한
  • Google Cloud 콘솔의 IAM 서비스를 통해 관리됩니다.
  • 즉시 선별된 일부 역할은 사용 가능합니다.
  • 다른 Google Cloud 권한을 포함할 수 있는 커스텀 역할을 만들 수 있습니다.

자세한 내용은 사용자 및 역할을 참조하세요.

Sense 고급 API 보안을 사용하세요.
프록시 빌드 마법사의 SOAP 서비스 지원되지 않음 Apigee와 함께 사용할 SOAP 유틸리티를 제공하는 오픈소스 프로젝트인 wsdl2apigee를 참조하세요.
Trace/디버그 세션 Trace와의 차이점을 참조하세요.
가상 호스트

Apigee Hybrid의 경우:

  • 인그레스는 Anthos Service Mesh를 통해 구현됩니다.
  • 키와 인증서는 Kubernetes에 직접 배포됩니다.

Apigee X:

  • 각 인스턴스는 자체 서명된 인증서를 통해 HTTPS 엔드포인트를 노출합니다. 조직을 쿼리하면 인증서의 CA를 다운로드할 수 있습니다.

Trace와의 차이점

다음 표에서는 Apigee X 및 하이브리드의 Trace 작동 방식과 Apigee Edge Cloud의 Trace 작동 방식을 비교합니다.

기능 Apigee Edge Cloud Apigee X 및 하이브리드
시의성 실시간: 동기 약간의 지연: 비동기
세션 이름/ID 사용자의 세션 이름 수락 사용자의 세션 이름을 수락하지 않음
필터 헤더 및 쿼리 매개변수 필터링과 같은 기본 필터 지원 AND 및 OR 논리 연산을 포함한 복잡한 필터링 로직을 지원합니다. 흐름 변수 참조에 언급된 흐름 변수에 대한 액세스입니다. 구문은 조건 참조에 표시된 것처럼 조건부에 사용되는 것과 동일합니다.
세션 제한 시간

디버그 세션의 길이와 데이터 보관 기간을 정의합니다.

기본값은 API 호출을 통해 시작 시 20분, UI에서 시작 시 10분입니다.

디버그 세션의 길이만 정의합니다. 시작점은 메시지 프로세서가 디버그 모드에서 실행 요청을 받을 때입니다.

기본값은 세션이 API로 시작될 시 5분, UI에서 시작될 시 10분입니다.

하이브리드에서 자동으로 삭제하기 전에 데이터가 24시간 동안 유지됩니다.

세션 유효성

세션 생성 요청이 유효한 기간입니다. 이 시간 내에 디버그 세션이 시작되지 않는 경우 동기화 담당자는 세션 생성 요청을 무시할 수 있습니다. 기본 요건에 설명된 대로 동기화 담당자의 시계를 동기화된 상태로 유지해야 합니다.
Trace 요청 수 메시지 프로세서당 최대 20개 기본값은 메시지 프로세서당 10개이며 최댓값은 15개입니다.
API Apigee Edge Cloud Apigee X
Apigee X는 Debug Session APIDebug Session Data API를 노출하지만 Apigee X API를 통해 다음을 지원하지 않습니다.
디버그 세션 중지

특정 거래 삭제

수익 창출과의 차이점

다음 표에서는 Apigee Edge 수익 창출과 Apigee X 수익 창출 간의 주요 기능을 비교하여 보여줍니다.

Apigee Edge 수익 창출 Apigee X/하이브리드 수익 창출
여러 API 제품에 연결할 수 있는 API 제품 번들과 연결되는 요금제 API 제품과 일대일 관계로 연결되는 요금제
요금제를 구매하는 앱 개발자 API 제품을 구매하는 앱 개발자
API 프록시 수준에서 관리되는 할당량 API 제품 수준(비즈니스 수준)에서 관리되는 할당량
게시된 요금제는 만료되기만 하며 수정하거나 삭제할 수 없음 게시된 요금제는 만료, 수정, 초안으로 이동 또는 삭제될 수 있음
복잡한 구성(마법사 또는 미리보기 도구 없음) 마법사 및 미리보기 도구를 사용한 간편한 요금제 구성
앱 개발자가 구독을 구매하지 않은 경우 첫 번째 API 호출이 처리된 후 액세스를 차단하는 MonetizationLimitsCheck 정책 앱 개발자가 구독을 구매하지 않았거나 할당량을 초과한 경우 즉시 액세스를 차단하는 MonetizationLimitsCheck 정책
트랜잭션의 수익 창출 데이터는 트랜잭션 레코딩 정책에서 커스텀 변수를 사용하여 캡처될 수 있습니다. Apigee는 자동으로 수익 창출 데이터를 캡처하며 DataCapture 정책을 사용하여 트랜잭션의 수익 창출 데이터를 재정의할 수 있습니다. 자세한 내용은 수익 창출 데이터 캡처를 참고하세요.
선불 및 후불 계정은 개발자 및 요금제 모두에 대해 구성될 수 있습니다. 선불 및 후불 계정은 개발자에 대해서만 구성될 수 있습니다.

Apigee X에서 지원되지 않는 Apigee Edge 기능은 무엇인가요?

Google은 다음 기능을 지원하지 않을 예정입니다.

  • Apigee Edge 확장 프로그램
  • OpenAPI 사양 저장소
  • 토큰이 해시되므로 OAuth 액세스 토큰을 검색하거나 취소하는 API
  • OAuth v1 또는 OAuth OAuthv1.0a 정책
  • Trireme(2019년 10월 10일에 지원 종료)
  • 접두사가 'X-Apigee-'인 헤더는 Apigee X에서 지원되지 않으며 대상 및 클라이언트로 전송하기 전에 요청 및 응답에서 제거됩니다.

API 비교

일반적으로 대부분의 Apigee Edge API는 Apigee API와 상응합니다. 이 섹션에서는 다음을 제공합니다.

API 사용으로 인한 변경사항 요약

다음은 Apigee Edge API와 비교하여 모든 Apigee X API의 동작 변경사항을 보여줍니다.

동작 Apigee Edge API Apigee X API
기본 도메인 api.enterprise.apigee.com apigee.googleapis.com
미디어 유형 application/json
application/xml
application/json
인증 OAuth2, SAML, 기본 OAuth2
키의 타임스탬프 int64 형식
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
String 형식
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
expand=false 쿼리 매개변수의 구조
[
        "helloworld",
        "weather"
      ]
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
밑줄로 프리픽스가 붙은 쿼리 매개변수 지원됨(_optimal=true) 지원되지 않음(optimal=true)
페이로드의 속성:
  • created_by
  • modified_by
  • self
지원됨 지원되지 않음
페이로드의 기본값 포함됨 미포함
오류 처리 구조
{
        "code": "...",
        "message": "..",
        "contexts": []
      }
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
캐시 삭제 응답 반환: 200 OK 및 캐시 세부정보 반환: 204 No Content
Cache API 작업 나열, 만들기, 가져오기, 업데이트, 삭제, 모두 지우기, 지우기 옵션이 있습니다. 나열삭제만 가능합니다. API 프록시 배포 시 단기 L1 캐시가 자동으로 생성됩니다. 자세한 내용은 캐시 내부를 참조하세요.

Apigee Edge와 Apigee X 측정항목 API의 차이점

API를 사용한 변경사항 요약에는 Apigee Edge API와 Apigee X API의 일반적인 차이점이 나와 있습니다. 다음 표에는 측정항목 API의 구체적인 차이점이 나와 있습니다.

기능 Apigee Edge API Apigee X API
API 엔드포인트 api.enterprise.apigee.com apigee.googleapis.com
일일 분석 이메일 지원되는 API 없음
비동기 쿼리 목록 API 비동기 분석 쿼리 목록 가져오기 userId 속성은 응답에서 생략됩니다. 메서드: organizations.environments.queries.list를 참조하세요.
커스텀 보고서 API Reports API createdBylastModifiedBy 속성이 응답에서 삭제되었습니다. Reports API를 참조하세요.

지원되지 않는 Apigee Edge API

다음 표에는 지원되지 않는 Apigee Edge API(Apigee X API에 해당하지 않음)가 나열되어 있습니다.

API 카테고리 지원되지 않는 Apigee Edge API
API 모니터링 지원되는 API 없음
API 프록시
  • API 프록시 강제 배포 취소
  • npm 종속 항목 가져오기
  • npm 모듈 관리
감사 Stackdriver Logging API 사용
캐시된 로그 지원되는 API 없음
회사 지원되는 API 없음
회사 앱 지원되는 API 없음
회사 앱 계열 지원되는 API 없음
회사 앱 키 지원되는 API 없음
디버그 세션
  • trace 세션을 중지할 수 없음
  • 개별 거래를 삭제할 수 없음

자세한 내용은 Trace와의 차이점을 참조하세요.

개발자 앱 API 리소스 수 가져오기
개발자 앱 계열 지원되는 API 없음
확장 프로그램 지원되는 API 없음
키 저장소: 트러스트 저장소 키 저장소 또는 트러스트 저장소 테스트
LDAP 지원되는 API 없음
수익 창출 지원되는 API 없음
OAuth V2 지원되는 API 없음
정책 지원되는 API 없음
리소스 파일
  • API 프록시 버전 범위
  • 조직 범위
Sense 지원되는 API 없음
사용자 및 사용자 역할 API를 사용하여 사용자, 역할, 권한 관리에 설명된 대로 Google Identity and Access Management(IAM) 관련 API를 사용합니다.
가상 호스트 지원되는 API 없음

프라이빗 클라우드용 Apigee Edge와 Apigee Hybrid 비교

다음 표에서는 프라이빗 클라우드용 Apigee Edge와 Apigee Hybrid를 비교합니다.

서비스 Apigee 제품 또는 기능 영역
Private Cloud용 Apigee Edge Apigee Hybrid
애널리틱스 Qpid 및 Postgres 서버 런타임 영역의 데이터 수집 pod는 fluentdUDCA(범용 데이터 수집 에이전트)를 사용하여 분석을 수집하고 관리 영역의 UAP(통합 분석 플랫폼)로 데이터를 제공합니다.
API 프록시 게이트웨이 메시지 프로세서 메시지 프로세서(MP)는 수신되는 요청을 처리합니다. MP는 런타임 영역에서 하나 이상의 컨테이너화된 앱으로 구현됩니다.
지속성 Cassandra 노드 또는 링 Cassandra는 KMS, KVM, 할당량, 캐시 기능에 대한 지속성을 제공합니다.
배포 ZooKeeper 동기화 담당자는 API 프록시 구성, 환경 정보, 기타 데이터를 관리 영역과 런타임 영역 간에 최신 상태로 유지합니다.
관리 사용자 인터페이스 Apigee Edge UI가 관리 서버에서 호스팅됨 Apigee UI는 관리 영역에서 호스팅됩니다.
부하 분산 라우터 Istio 인그레스 컨트롤러는 런타임 영역의 메시지 프로세서 (MP) 컨테이너화된 앱에 요청을 전달합니다.
API 관리 서버 Apigee X API관리 서버MART를 통해 액세스됩니다. MART는 로컬 Cassandra Datastore와 상호작용하고 Apigee X API가 런타임 데이터 항목에 액세스하고 관리할 수 있도록 API 제공업체 역할을 합니다.
측정항목 JMX로 구성된 각 구성요소 모든 서비스에 대해 클러스터당 단일 Prometheus 서버가 관리합니다.