이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.
Apigee Edge 문서 보기
다음은 Apigee에서 고유한 의미를 갖는 일반적인 개념입니다.
A
- API 기본 경로 및 리소스
- API는 기본 경로와 리소스 집합(리소스 경로라고도 함)으로 구성됩니다. API마다 단일 기준 URL(기본 경로라고도 함) 및 여러 리소스 경로를 정의합니다. API는 단순히 공통 기본 경로를 공유하는 URI의 집합이라고 생각하면 됩니다. API를 보다 쉽게 관리할 수 있도록 Apigee에서는 이러한 원시 URI를 표시 이름 및 설명으로 보강합니다.
- API 사용자
- 앱 개발자와 동의어로서 API 제공업체가 만든 API를 사용합니다.
- API 개발자
- API 제공업체 조직에서 API를 빌드하는 소프트웨어 엔지니어입니다. 이러한 API는 앱 개발자(API 사용자)가 앱을 빌드하는 데 사용됩니다.
- API 제품
- 서비스 요금제와 결합되고 개발자에게 번들로 제공되는 API 리소스(URI) 모음입니다. API 제품은 모니터링 또는 분석을 위해 비즈니스와 관련된 일부 메타데이터도 포함할 수 있습니다. 리소스 하나 이상을 API 제품에 포함해 수익을 창출할 수 있으며 이 API 제품을 수익 창출을 위한 API 패키지에 번들로 포함할 수 있습니다.
- API 공급업체
- API 제공업체는 API 소비자(앱 개발자)가 사용할 API(Apigee 사용)를 빌드합니다.
- API 프록시
- 기존 API의 퍼사드 역할을 하는 작동하는 프록시입니다. 개발자는 기존 API를 호출하는 대신 Apigee에서 생성한 새 API를 호출하기 시작합니다. 이 퍼사드는 백엔드 API와 공개 인터페이스를 분리하여 개발자가 백엔드 변경을 방지하면서 내부 개발팀에 영향을 주지 않고 에지에서 혁신을 달성할 수 있도록 합니다. 개발자가 백엔드를 변경하면 개발자는 동일한 API를 중단 없이 계속 호출합니다. 고급 시나리오에서는 Apigee를 사용하면 동일한 API에 여러 인터페이스를 노출할 수 있으므로 다양한 개발자의 역할 요구 사항을 동시에 충족할 수 있도록 API 서명을 맞춤설정할 수 있습니다.
- Apigee API
- 환경, 조직, API 프록시, 기타 하이브리드 서비스를 구성하는 데 사용할 수 있는 엔드포인트입니다.
- 앱 개발자
- Edge에서 앱 개발자는 API 제공업체로 앱을 등록합니다. 이 방법으로 앱 개발자는 제공업체의 API 프록시를 호출하는 데 필요한 API 키를 가져옵니다.
- 앱
- 개발자는 앱을 사용하여 API 제품의 리소스에 액세스합니다. 앱을 만들 때 포함할 API 제품을 선택하면 Apigee에서 키를 생성합니다. 각 앱에는 여러 API 제품에 대한 액세스를 제공하는 단일 키가 있습니다. 앱에서는 리소스에 액세스할 수 있는 사용자를 제어할 수 있습니다. 앱의 키를 취소하고 새로고침하여 API 제품에 액세스할 수 있는 사용자를 제어할 수 있습니다. 또한 앱의 제품 액세스 권한을 취소하거나 삭제하여 리소스 번들에 대한 액세스를 제어할 수 있습니다.
B
- 잔액 세부정보
- 선불 개발자의 경우 개발자 계정의 잔액입니다.
C
- Cassandra
(Apigee Hybrid만 해당) 게이트웨이에서 실행되는 애플리케이션의 애플리케이션 구성, 분산 할당량 카운터, API 키, OAuth 토큰을 저장하는 런타임 데이터 저장소입니다.
이는 리소스가 많이 필요한 StatefulSet이며 메시지 프로세서와는 별도의 워커 노드에 있어야 합니다.
자세한 내용은 런타임 영역 정보를 참조하세요.
- 중앙 관리 인프라 (또는 영역)
- 관리 영역을 참조하세요.
- 컨테이너[형] 이미지
- 이미지를 참조하세요.
- 제어 영역
- 관리 영역을 참조하세요.
D
- 배포
Apigee에서는 네트워크 구성에 따라 인터넷의 애플리케이션 클라이언트가 공개적으로 또는 비공개로 액세스할 수 있도록 하는 환경에 대한 API 프록시를 배포합니다.
- 개발자
- 개발자는 Apigee 사용자가 수행할 수 있는 역할을 참조합니다.
Apigee에는 다음과 같은 두 가지 유형의 개발자가 있습니다.
- API 프록시 개발자 - API 프록시를 만들고 정책을 적용합니다.
- 애플리케이션 개발자 - API 프록시를 사용하는 애플리케이션을 만듭니다.
- 개발자 카테고리 요금제
- 특정 카테고리의 모든 개발자에게 적용되며 해당 카테고리의 모든 개발자가 구매할 수 있는 요금제입니다.
- 개발자 요금제
- 특정 개발자에게 적용되며 해당 개발자만 구매할 수 있는 요금제입니다.
E
- 환경
Apigee 환경은 API 프록시를 배포하는 조직 내의 격리된 소프트웨어 환경입니다. 환경은 배포된 프록시의 요구를 충족시킬 수 있도록 확장될 수 있습니다. 한 조직에 환경을 여러 개 만들 수 있습니다.
- 환경 그룹
-
환경 그룹은 호스트 이름이 한 개 이상 있는 Apigee 환경 그룹입니다. 호스트 이름은 환경 그룹의 모든 환경에 배포된 API 프록시를 호출하는 데 사용되는 URL의 일부입니다.
- 명시적 한도
- 커스텀 한도를 참조하세요.
G
- GCR
- Google Container Repository
- GKE
- Google Kubernetes Engine Kubernetes에 컨테이너식 애플리케이션을 배포하기 위한 프로덕션에 즉시 사용할 수 있는 Google 관리 환경입니다. Kubernetes Engine을 사용하면 자체 Kubernetes 클러스터를 설치, 관리, 운영할 필요성이 완전히 사라져 Kubernetes를 즉시 실행할 수 있습니다.
I
- 이미지 저장소
- 공유 컨테이너 이미지 그룹.
- 암시적 한도
- 수익 창출에서 설정한 한도(예: 개발자 선불 잔액 한도)입니다.
- 인그레스/인그레스 컨트롤러
- 클러스터 외부의 트래픽을 클러스터 내부의 서비스로 라우팅하는 컨테이너형 앱입니다.
K
- KMS
- 키 관리 서비스 트래픽 암호화 및 복호화에 사용되는 키와 OAuth 토큰을 저장, 유지보수, 제공합니다. Apigee KMS는 앱, 개발자, API 제품의 키를 관리합니다.
- KVM
- 키 값 맵 암호화되거나 암호화되지 않은 키-값 문자열 쌍의 커스텀 컬렉션입니다. 자세한 내용은 키 값 맵 사용을 참조하세요.
- Kubernetes 관리 머신
- Kubernetes 클러스터에 명령어를 실행하기 위해 사용되는 로컬 머신입니다. 이 머신은 일반적으로 Kubernetes VM에 액세스할 수 있는 데스크톱 머신입니다.
M
- 관리 영역
- 서비스 계정을 통해 런타임 영역과 통신하는 Google 호스팅 중앙 서비스
- MART
런타임 데이터용 API는 로컬 런타임 Datastore(Cassandra)와 상호작용합니다. 런타임 데이터에 액세스하고 관리하는 공개 Apigee API의 API 제공업체 역할을 합니다.
MART는 메시지 프로세서와 같은 스테이트리스(Stateless) 애플리케이션입니다. Kubernetes 컨테이너화 앱입니다.
자세한 내용은 런타임 영역 정보를 참조하세요.
- 마스터 노드
- apiserver, cloud-controller-manager(CCM), 스케줄러, kube-controller-manager가 포함된 노드의 Kubernetes 용어입니다.
- 메시지 프로세서
-
(Apigee Hybrid 전용) 메시지 프로세서는 수신하는 요청을 평가하고 모든 Apigee 정책을 실행하고 백엔드 시스템 및 기타 시스템을 호출하여 데이터를 검색합니다. 이러한 응답을 받으면 메시지 프로세서가 응답을 포맷하고 클라이언트에 반환합니다.
MP는 Kubernetes 배포입니다. 동기화 담당자가 데이터를 제공하는 공유 파일 시스템 내에서 범위가 지정된 하위 디렉터리를 가리키는 단일 Apigee 환경을 위해 구성됩니다.
MP는 리소스가 많이 필요하며 Cassandra와 별도의 작업자 노드에 있어야 합니다.
자세한 내용은 런타임 영역 정보를 참조하세요.
- 수익 창출
- 사용하기 쉽고 유연한 API 제품 수익 창출 방법을 제공하는 Apigee 구성요소입니다.
- 사용된 월별 납부액
- 설정 수수료 + 트랜잭션 수수료 + 반복 수수료가 포함된 개발자의 특정 월 총 사용량입니다.
- 월별 결제
- 구매한 요금제에 따라 개발자가 수행하는 반복 결제입니다. 요금제에는 사용량에 관계없이 개발자에게 매달 청구되는 반복 요금이 발생할 수 있습니다.
N
- 네임스페이스
- 클러스터 리소스를 분할하는 데 사용되는 가상 클러스터 네임스페이스는 많은 사용자가 포함된 대규모 클러스터용입니다. 사용자가 많지 않은 소규모 클러스터에는 일반적으로 네임스페이스가 필요하지 않습니다.
O
- 미해결 조정
- 게시된 결제 문서에 아직 적용되지 않은 조정입니다.
- 미해결된 청구 월
- 최종' 결제 문서가 게시되지 않은 전체 캘린더 월입니다.
- 오픈소스 Kubernetes
- Kubernetes의 참조 구현입니다. Kubernetes를 참조하세요. Apigee Hybrid 런타임은 오픈소스 Kubernetes와 CNCF를 준수하는 오픈소스 기반의 Kubernetes 버전을 실행합니다.
- 조직
API 프록시, API 제품, API 패키지, 앱, 개발자를 포함한 Apigee 계정의 모든 항목 컨테이너입니다. 이 문서에서는 Apigee 조직 또는 하이브리드 지원 조직이라는 용어를 서로 바꿔서 사용합니다.
Apigee 또는 Apigee Hybrid를 설치하고 사용하려면 Google Cloud 프로젝트에 결합된 Apigee 조직이 있어야 합니다. 이 작업은 프로비저닝이라고 하는 프로세스에서 조직을 만들 때 수행합니다.
Apigee 조직은 Google Cloud 조직과 다릅니다. 모호성을 가질 수 있는 경우 이 문서에서는 조직이 Apigee 조직임을 지정해야 합니다.
자세한 내용은 조직 유형을 참조하세요.
P
- 포드
- pod는 Kubernetes의 기본 구성 요소입니다. 사용자가 만들거나 배포하는 Kubernetes 객체 모델에서 가장 작고 간단한 단위입니다. 포드는 클러스터에서 실행되는 프로세스를 나타냅니다.
- 선불 잔액
- 선불 개발자가 API 패키지 요금을 미리 지불할 수 있는 금액입니다.
- 선불 개발자
- API 제품 사용 비용을 미리 지불하는 개발자입니다. API 제품이 사용되면 선불 개발자의 잔액에서 금액이 차감됩니다. 개발자는 API 제품을 구매할 수 있는 충분한 선불 잔액을 유지해야 합니다. API 제공업체가 개발자에게 선불 또는 후불 상태를 할당합니다.
- 정책
- API 흐름 내에서 재사용 가능한 원자적 논리 단위로 실행되는 처리 단계입니다. 일반적인 정책에는 적절한 엔드포인트로 요청 라우팅, 메시지 형식 변환, 액세스 제어 적용, 추가 정보를 위한 원격 서비스 호출, 외부 사용자의 민감한 정보 차단, 잠재적인 위협에 대한 메시지 콘텐츠 검사, 성능 향상을 위한 일반적인 응답 캐싱 등이 포함됩니다. 정책은 요청 또는 응답 메시지의 내용이나 컨텍스트에 따라 조건부로 실행될 수 있습니다. 예를 들어 스마트폰에서 요청 메시지가 전송된 경우 변환 정책을 실행하여 응답 형식을 맞춤설정할 수 있습니다.
- 후불 개발자
- API 제품 사용 요금을 월 단위로 결제하는 개발자입니다. 개발자는 요금제에서 설정한 결제 약관에 따라 API 제품 사용 비용을 지불합니다. 개발자에게는 API 제공업체에서 후불 또는 선불 상태를 할당합니다.
- proxy
- 또한 API 프록시입니다. API 프록시는 백엔드 서비스 API를 전면에 내세우고 보안, 비율 제한, 할당량, 분석 등과 같은 부가 가치 기능을 제공하는 추상화 레이어입니다.
- 프록시 엔드포인트
- 프록시 엔드포인트는 API 프록시가 클라이언트 애플리케이션과 상호작용하는 방식을 정의합니다. API 프록시가 응답하는 URL의 일부인 기본 경로로 프록시 엔드포인트를 구성합니다.
URL의 형식은
https://hostname/basepath/pathsuffixes
입니다. API 프록시 만들기를 참조하세요.
R
- 요금제
- 수익 창출 API 패키지에서 제공하는 API 제품 사용에 관한 수수료, 기타 요금, 수익 배분의 사양입니다.
- 복제 컨트롤러
- 포드를 다시 예약하고 포드의 자체 복구를 처리합니다.
- 리소스, 리소스 경로
- RESTful 개념, 리소스 경로는 주어진 리소스의 네트워크 경로를 식별하는 동일한 리소스 식별자(URI)입니다.
- 버전
- 구성 및 정책의 숫자가 매겨진 버전 제어 패키지이며, API 프록시에 번들로 포함됩니다. 이 용어는 개발자용 API 인터페이스인 버전과 구분됩니다. 아래에서 '버전'을 참조하세요.
- 런타임 영역
자체 Kubernetes 클러스터에서 관리하는 Apigee Hybrid 서비스는 런타임 영역 내에 존재합니다. 이러한 서비스는 관리 영역과 함께 서비스 계정을 통해 통신합니다.
MART, Synchronizer, 메시지 프로세서, Cassandra, 기타 구성요소를 포함합니다.
자세한 내용은 런타임 영역 정보를 참조하세요.
- 런타임 인스턴스
- Apigee는 지리적 리전당 하나씩 여러 런타임 인스턴스로 구성할 수 있습니다. 하나 이상의 환경을 런타임 인스턴스에 연결할 수 있으므로 리전 간 API 프록시에 고가용성을 제공합니다.
- 서비스
런타임 영역의 Kubernetes 클러스터에서 실행되는 컨테이너형 앱의 일반적인 용어입니다. 이러한 서비스에는 MART, 동기화 담당자, 메시지 프로세서, Cassandra가 포함됩니다.
자세한 내용은 런타임 영역 정보를 참조하세요.
- 스테이트풀(Stateful) 노드
- 상태 유지를 위해 영구 스토리지가 필요한 클러스터 노드입니다. 전용 노드 풀 구성을 참조하세요.
- 스테이트리스(Stateless) 노드
- 영구 스토리지가 필요하지 않은 클러스터 노드입니다. 전용 노드 풀 구성을 참조하세요.
- 동기화 담당자
각 환경의 배포 구성과 이벤트를 위한 관리 영역을 폴링하는 런타임 영역 서비스입니다. 배포된 프록시, 프록시 구성 파일 등에 대한 필수 메타데이터를 런타임 영역에 다운로드합니다.
동기화 담당자는 메시지 프로세서가 읽는 공유 파일 시스템에 정보를 저장합니다. 이는 DaemonSet 애플리케이션으로 실행됩니다. 런타임 API 트래픽이 없으며 단일 프로세스/Kubernetes 포드에서 여러 환경의 데이터를 동기화할 수 있습니다.
자세한 내용은 런타임 영역 정보를 참조하세요.
- 대상 엔드포인트
대상 엔드포인트는 API 프록시가 백엔드 서비스와 상호작용하는 방식을 정의합니다. 보안 설정, HTTP 또는 HTTPS 프로토콜, 기타 연결 정보를 정의하는 등의 요청을 적절한 백엔드 서비스로 전달하도록 대상 엔드포인트를 구성합니다. 대상 엔드포인트 변경을 참조하세요.
- 잔액 충전
- 선불 개발자가 선불 잔액을 충전하는 작업입니다.
- transaction_success_def" id="transaction_success_def">transaction success
- 수익 창출 변수는 사용되는 경우 API 트랜잭션으로 수익이 창출되는지 여부를 나타냅니다. 이 변수는 HTTP 상태 코드를 기반으로 하는 기본 동작을 재정의하는 데 사용할 수 있습니다. 수익 창출 변수를 참조하세요.
- UAP
통합 애널리틱스 플랫폼 수신되는 애널리틱스, 디버그, 배포 상태 데이터를 처리하고 Apigee Hybrid UI 또는 Apigee API를 통해 사용할 수 있도록 하는 관리 영역의 Apigee 서비스입니다.
자세한 내용은 디버그, 애널리틱스, 배포 상태 데이터 수집을 참조하세요.
- UDCA
범용 데이터 수집 에이전트는 애널리틱스, 디버그, 배포 상태 데이터를 추출하여 UAP에 보내는 런타임 영역의 데이터 수집 포드 내에서 실행되는 서비스입니다.
자세한 내용은 디버그, 애널리틱스, 배포 상태 데이터 수집을 참조하세요.