API Monitoring Management API 사용

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

API Monitoring 관리 API를 사용하여 다음 작업을 수행합니다.

작업 추가 정보
API 모니터링 알림 관리
API 모니터링 컬렉션 관리
여러 수준에서 API 모니터링 로그 보기
API 모니터링 측정항목 보기

API 호출 할당량

모든 API Monitoring API는 분당 API를 호출할 수 있는 횟수를 제한하는 할당량을 적용합니다. 예를 들어 Create collections API는 분당 호출 6회로 제한합니다.

모든 API의 할당량 한도가 동일하지는 않습니다. 한도를 확인하려면 각 API의 API 참조 문서를 확인하세요.

curl 사용

이 문서의 API 예시에서는 curl을 사용하여 API를 사용하는 API 모니터링을 사용하는 방법을 보여줍니다. curl은 URL 구문으로 데이터를 전송하는 오픈소스 명령줄 도구이며 HTTP 및 HTTPS와 같은 일반적인 프로토콜을 지원합니다. curl 다운로드 및 사용에 대한 자세한 내용은 https://curl.haxx.se/를 참조하세요.

다음 표에는 예시에 사용된 curl 명령줄 옵션이 요약되어 있습니다.

옵션 설명
-d '{}'

--data @filename

직접 전달되거나 파일 이름을 지정하여 요청 본문을 정의합니다.
-H

--header

요청 헤더를 정의합니다. 요청 헤더에 다음 정보를 전달해야 합니다.
  • OAuth 2.0 액세스 토큰 가져오기에 설명된 대로 Authorization 헤더를 사용한 사용자 인증에 대한 OAuth 2.0 토큰입니다.
  • Accept 헤더를 사용하여 클라이언트에서 지원하는 콘텐츠 유형입니다.
  • Content-Type 헤더를 사용하여 리소스(POST, PATCH, PUT)를 만들거나 업데이트할 때 전송되는 요청 본문의 콘텐츠 유형입니다.
-i 응답에 헤더와 같은 추가 정보를 표시합니다.
-X 요청 유형 (GET, POST 등)을 지정합니다.

OAuth 2.0 액세스 토큰 가져오기

Apigee Edge는 사용자 인증을 위해 OAuth 2.0을 지원합니다. OAuth 2.0을 사용하면 Apigee Edge 사용자 인증 정보를 액세스 토큰 및 갱신 토큰으로 교환하여 Apigee Edge API를 안전하게 호출하는 데 사용할 수 있습니다. 토큰을 받으면 토큰이 만료될 때까지 사용자 인증 정보를 다시 교환할 필요가 없습니다. 갱신 토큰을 사용하면 사용자 인증 정보를 제공하지 않고도 서버에서 '세션'을 더 오랫동안 활성 상태로 유지할 수 있습니다. 액세스 토큰에 대한 자세한 내용은 OAuth2를 사용하여 관리 API에 액세스를 참조하세요.

Apigee Edge 사용자 인증 정보를 사용하면 Apigee의 get_token 유틸리티로 OAuth 2.0 액세스 및 갱신 토큰을 얻어 Apigee Edge 리소스에 액세스할 수 있습니다.

OAuth 2.0 액세스 토큰을 가져오는 방법은 다음과 같습니다.

  1. get_token 유틸리티를 설치합니다. get_token 유틸리티를 설치하는 방법에 대한 자세한 내용은 get_token 사용을 참조하세요.

  2. get_token를 실행하여 OAuth 2.0 액세스 토큰을 가져옵니다.

    명령어를 처음 입력할 때 또는 갱신 토큰이 만료되면 get_token에서 사용자 이름, 비밀번호, 6자리의 2단계 인증 코드를 입력하라는 메시지를 표시합니다. 메시지가 표시되면 각 값을 입력합니다. 2단계 인증을 사용 설정하지 않은 경우 프롬프트에서 Enter 키를 누르기만 하면 됩니다.

  3. OAuth 2.0 토큰을 복사하고 ACCESS_TOKEN과 같은 변수에 저장합니다.

    export ACCESS_TOKEN=eyJhbGciOiJSUzI1NiJ9.eyJqdGkiOiI2NmQ4MTRiMC01YzZkLTQyZWUtYjlmYi05ZGVhODk5MGRiODIiLCJzdWIiOiJlZjc3YmRhMS05ZWIxLTQyZDgtODg5MC0zODQ3ODg0MzM1OWIiLCJzY29wZSI6WyJzY2ltLmVtYWlscy5yZWFkIiwicGFzc3dvcmQud3JpdGUiLCJhcHByb3ZhbHMubWUiLCJzY2ltLm1lIiwic2NpbS5pZHMucmVhZCIsIm9wZW5pZCIsIm9hdXRoLmFwcHJvdmFscyJdLCJjbGllbnRfaWQiOiJlZGdlY2xpIiwiY2lkIjoiZWRnZWNsaSIsImF6cCI6ImVkZ2VjbGkiLCJncmFudF90eXBlIjoicGFzc3dvcmQiLCJ1c2VyX2lkIjoiZWY3N2JkYTEtOWViMS00MmQ4LTg4OTAtMzg0Nzg4NDMzNTliIiwib3JpZ2luIjoidXNlcmdyaWQiLCJ1c2VyX25hbWUiOiJsbHluY2hAYXBpZ2VlLmNvbSIsImVtYWlsIjoibGx5bmNoQGFwaWdlZS5jb20iLCJyZXZfc2lnIjoiZTViZDc3NjIiLCJpYXQiOjE0NzA3NTMyMDksImV4cCI6MTQ3MDc5NjQwOSwiaXNzIjoiaHR0cHM6Ly9sb2dpbi5lMmUuYXBpZ2VlLm5ldC9vYXV0aC90b2tlbiIsInppZCI6InVhYSIsImF1ZCI6WyJzY2ltIiwicGFzc3dvcmQiLCJvcGVuaWQiLCJlZGdlY2xpIiwiYXBwcm92YWxzIiwic2NpbS5lbWFpbHMiLCJzY2ltLmlkcyIsIm9hdXRoIl19.FF3f1i9eHbBqYjnvBmt9nTtTcyNQBQRDDq2tQ3aRUAzUesLAet7qfBB9QVCvE-zVBn4BiPgRU-iturxPxRMAQ2a34-8oLvgff3x-aALBWkSwbc8PJdWTiPP9VYykoFSJtu9UIN5x0FQEQN_hyurO8D2SrS3uQKNwIyjoJPy4Bps7nb3WqJyKRfXAzf8UptdN7XE0TVqTyBcZGT3OQ2Was0VPfe_dr-wIrywvjNf6FczjdktB1lpKJ2oRXx1n8PuK5FhOQ4wE9VeSsNsMHVcGvJ5W6Tvi61fo2h1w1d4AKvGdERzuVf_XWN00mtcgwsUAuXV0r5H_i3vxcMuUym1XOg
    
    

API 모니터링 API를 호출할 때 Authorization 헤더를 사용하여 HTTP 헤더에 OAuth 2.0 액세스 토큰을 전달합니다. 예를 들면 다음과 같습니다.


curl -X GET "https://apimonitoring.enterprise.apigee.com/alerts?org=myorg"
   -H "Authorization: Bearer $ACCESS_TOKEN" 
   ...