Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요. info
기존 Apigee Edge 고객은 새로운 기능이나 다른 지역 가용성을 활용하기 위해 설치를 Apigee X로 이전할 수 있습니다.
이 페이지에서는 Apigee X로 마이그레이션하기 전에 해결해야 하는 구성의 안티패턴과 마이그레이션하기 전에 알아야 하는 기타 동작 변경사항을 설명합니다.
Apigee Edge 안티패턴의 더 광범위한 목록에는 어떤 경우에도 피해야 하는 사용 사례가 설명되어 있습니다. 이 페이지에서는 마이그레이션을 차단하는 권장되지 않는 특정 사용 사례를 설명합니다. Apigee X로 마이그레이션할 때 문제가 발생하지 않도록 지금 해결하세요.
API 제품이 없는 앱 | ||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
API 제품이 없는 앱이 있습니다. Apigee Edge와 Apigee X의 차이점:
|
아니요. |
해결 방법: API 제품이 없는 앱모든 앱 사용자 인증 정보를 하나 이상의 API 제품과 연결합니다. 이 작업을 실행하는 방법에 관한 자세한 내용은 앱 등록 및 API 키 관리를 참고하세요. 간단한 방법은 각 앱에 모든 API 제품에 대한 액세스 권한을 할당하는 것입니다. 이는 Apigee Edge에서 가능한 것과 동일합니다. '최소 권한' 접근 방식을 따르려면 각 앱 사용자 인증 정보가 액세스해야 하는 최소 API 제품 목록을 결정해야 합니다. 클라이언트 ID를 기반으로 Apigee Edge 분석 보고서를 사용하여 이를 분석할 수 있습니다. |
||||||||||||||||||||||
만료 시간이 없는 캐시 | ||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
캐시에는 만료 시간이 없습니다. Apigee Edge와 Apigee X의 차이점:
|
아니요 |
해결 방법: 만료 시간이 없는 캐시모든 캐시의 만료 시간을 설정합니다. |
||||||||||||||||||||||
명확하지 않은 경로의 JSONPath 필터 표현식 | ||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
명확하지 않은 경로의 경우 필터 표현식의 결과를 쿼리하는 것은 JSONPath 사양에 포함되지 않습니다. https://goessner.net/articles/JsonPath/를 참고하세요. Apigee Edge와 Apigee X의 차이점: 이 예시 구조를 탐색할 때 {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
}
|
예 |
해결: 비확정 경로의 JSONPath 필터 표현식영향을 받는 쿼리를 찾아 바꾸세요. |
||||||||||||||||||||||
존재하지 않는 색인의 JSONPath 표현식 | ||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
인덱스가 없는 JSONPath 표현식은 Apigee X와 Apigee Edge에서 동작이 다릅니다. 경로를 찾을 수 없는 경우 Apigee X는 Apigee Edge와 Apigee X의 차이점: 이 예시 구조를 탐색할 때 {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
}
|
예 |
해결 방법: 존재하지 않는 색인의 JSONPath 표현식영향을 받는 쿼리를 찾아 바꾸세요. |
||||||||||||||||||||||
배열 객체를 반환하지 않는 배열 색인이 있는 JSONPath 표현식 | ||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
배열 색인 또는 슬라이스가 있는 JSONPath 표현식은 Apigee X에서 배열 객체를 반환합니다. Apigee Edge와 Apigee X의 차이점: 이 예시 구조를 탐색할 때 {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
}
|
예 |
해결 방법: 배열 객체를 반환하지 않는 배열 색인이 있는 JSONPath 표현식업그레이드 후 결과가 달라질 수 있는 표현식을 찾아 바꾸세요. |
||||||||||||||||||||||
키 저장소 이름 제한사항 |
||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
Apigee X 키 저장소 이름에는 문자, 숫자, 하이픈만 포함할 수 있습니다. 에지 키 저장소 이름에는 이러한 제한이 적용되지 않습니다. |
아니요 |
해결 방법: 키 저장소 이름 제한키 저장소 이름을 확인하고 필요한 경우 지원되지 않는 문자를 삭제하도록 이름을 업데이트합니다. |
||||||||||||||||||||||
API 프록시에 배포된 여러 기본 경로 |
||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
API 프록시의 여러 버전이 환경에 배포되어 있으며 각 버전의 기본 경로가 서로 다릅니다. Apigee Edge와 Apigee X의 차이점:
|
아니요 |
해결 방법: API 프록시에 여러 기본 경로가 배포됨기본 경로와 관계없이 번들의 하나의 버전만 환경에 배포되도록 모든 번들을 업데이트합니다. |
||||||||||||||||||||||
규정을 준수하지 않는 HTTP 메시지 |
||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
클라이언트 또는 API 프록시가 HTTP 표준을 준수하지 않는 메시지 (요청 또는 응답)를 전송합니다. 예를 들어 잘못된 헤더 이름, 일부 제한된 헤더의 중복 등이 있습니다. API 실행에 다음 오류가 하나 이상 있는 경우 Apigee X로 이전할 수 없습니다.
|
예, 가능합니다. |
해결 방법: 정책을 준수하지 않는 HTTP 메시지Apigee X로 이전하기 전에 HTTP 프로토콜의 오류를 수정해야 합니다. 오류가 클라이언트 애플리케이션에서 발생한 경우 클라이언트 앱 개발자에게 문제를 수정하도록 요청해야 합니다. |
||||||||||||||||||||||
OAuth 2.0 토큰 만료 시간이 잘못됨 |
||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
OAuth 2.0 토큰 만료 제한이 규정된 범위를 벗어납니다. Apigee Edge와 Apigee X의 차이점:
|
아니요 |
해결 방법: OAuth 2.0 토큰 만료 시간이 유효하지 않음
OAuthV2 정책을 사용하고 |
||||||||||||||||||||||
제품 한도 초과 |
||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
Apigee Edge 구성이 정의된 제품 한도를 준수하지 않습니다. 문서화되었지만 Apigee Edge에 적용되지 않는 일부 제품 한도는 Apigee X에 적용됩니다. |
아니요 |
해결 방법: 제품 한도 초과Apigee X로 이전하기 전에 제품 한도를 초과하는 사용량을 수정하세요. |
||||||||||||||||||||||
엔드포인트와 경로 대상 연결 지정자가 모두 있는 ServiceCallout 정책 |
||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
ServiceCallout 정책에서
Apigee Edge에서는 이 요구사항을 문서화하지만 적용하지는 않습니다. Apigee X는 두 구성이 모두 있는 |
아니요 |
해결 방법: 엔드포인트와 경로 대상 연결 지정자가 모두 있는 ServiceCallout 정책
ServiceCallout 정책 구성을 확인하고 규정을 준수하지 않는 |
||||||||||||||||||||||
타겟 서버 이름 제한사항 |
||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
Apigee X 타겟 서버 이름에는 문자, 숫자, 하이픈, 마침표만 포함할 수 있습니다. 에지 타겟 서버 이름에는 이러한 제한이 적용되지 않습니다. |
아니요 |
해결 방법: 대상 서버 이름 제한타겟 서버 이름을 확인하고 필요한 경우 지원되지 않는 문자를 삭제하도록 이름을 업데이트합니다. |
||||||||||||||||||||||
가상 호스트의 체험 인증서 |
||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
하나 이상의 가상 호스트가 Apigee에서 제공하는 '무료 체험' 인증서를 사용합니다. 이로 인해 가상 호스트가 Apigee Edge와 Apigee X의 차이점:
|
예 |
해결 방법: 가상 호스트의 평가판 인증서자체 도메인을 구성하고 인증서를 적절하게 프로비저닝해야 합니다.
|
||||||||||||||||||||||
해결되지 않은 DNS |
||||||||||||||||||||||||
| 요약 | 클라이언트 측 변경이 필요한가요? | 해결 방법 | ||||||||||||||||||||||
|
타겟 엔드포인트에 해결되지 않은 도메인 이름이 있습니다. Apigee Edge와 Apigee X의 차이점:
|
아니요 |
해결 방법: 해결되지 않은 DNS유효한 도메인 이름으로 타겟 엔드포인트를 업데이트합니다. |
||||||||||||||||||||||