API 허브에서 API 게이트웨이 API 보기

이 페이지에서는 Google Cloud 콘솔 또는 API를 사용하여 API 허브에서 API 게이트웨이 API를 보는 방법을 설명합니다. 자세한 내용은 API 리소스 나열을 참고하세요.

아래 설명에 따라 API 허브에서 API 게이트웨이 API를 확인합니다.

Google Cloud 콘솔

API 허브에서 API 게이트웨이 API를 보려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 API 허브의 API 페이지로 이동합니다.
API 허브로 이동
필터 드롭다운에서 게이트웨이: API 게이트웨이를 선택하여 모든 API 게이트웨이 API를 표시합니다.
사용 가능한 모든 API가 표시된 기본 API 카탈로그 페이지가 열립니다.
API를 클릭하여 세부정보를 확인합니다.

다음 표에서는 API 허브 필드를 설명하고 API 게이트웨이 상응 항목에 매핑합니다. 기타 시스템 및 사용자 정의 속성에 관한 자세한 내용은 API 허브 문서의 속성 관리를 참고하세요.

API 허브 필드	API 게이트웨이 필드	설명
개요> 이름	세부정보> 이름	API의 이름입니다.
개요> API ID	해당 사항 없음	API 허브의 API ID입니다.
개요> 최종 수정	세부정보> 업데이트됨	API가 마지막으로 수정된 타임스탬프입니다.
버전> 이름	Configs(구성)> Configuration ID(구성 ID)	API 구성의 ID입니다.
버전> 버전 ID	해당 사항 없음	API 허브의 API 구성 버전 ID입니다.
버전> 최종 수정	구성> 업데이트됨	API 구성이 마지막으로 수정된 타임스탬프입니다.
버전> 작업	OpenAPI 사양 파일의 `paths`	사양 파일에 정의된 작업입니다. 수집된 API 게이트웨이 세부정보에는 다음이 포함됩니다. 경로 사양 파일 메서드 지원 중단된 플래그 최종 수정 타임스탬프
버전> 사양 파일	구성> 전체 리소스 위치	API 구성과 연결된 사양 파일입니다. 수집된 API 게이트웨이 세부정보에는 다음이 포함됩니다. 이름 사양 유형 린트 결과 최종 수정 타임스탬프 참고: 현재 API 허브는 OpenAPI 사양 파일만 인제스트합니다.
배포> 배포 이름	게이트웨이> 게이트웨이 ID	API 게이트웨이 배포는 다음 형식입니다. `LOCATION/GATEWAY_ID`
배포> 배포 유형	해당 사항 없음	배포 유형입니다. API Gateway로 설정합니다.
배포> 최종 수정	게이트웨이> 업데이트됨	API Gateway가 마지막으로 수정된 타임스탬프입니다.
배포> 리소스 URI	게이트웨이> 전체 리소스 이름	API Gateway의 리소스 URI(다음 형식) `projects/RUNTIME_PROJECT_ID/locations/LOCATION/gateways/GATEWAY_ID`
배포> 관리 URL	게이트웨이> 게이트웨이	다음 형식으로 API Gateway 배포를 관리하는 데 사용되는 URL: `https://console.cloud.google.com/api-gateway/gateway/GATEWAY_ID/location/LOCATION?project=RUNTIME_PROJECT_ID`
배포> 소스 프로젝트	게이트웨이> 전체 리소스 이름	배포의 소스 프로젝트입니다.
배포> 엔드포인트	게이트웨이> 게이트웨이 URL	배포 리소스가 API 요청을 수신 대기하는 IP 주소입니다.
통계	참고: 현재 API 게이트웨이 API에는 통계 정보를 사용할 수 없습니다.
보안	참고: 현재 API Gateway API에 대한 보안 정보는 제공되지 않습니다.

REST

API 허브의 모든 API 게이트웨이 API를 나열하려면 API 나열 API를 사용합니다. 플러그인 인스턴스 필터를 추가하면 지정된 API Gateway 플러그인 인스턴스의 API 애셋만 나열할 수 있습니다.

예를 들면 다음과 같습니다.

curl 'https://apihub.googleapis.com/v1/projects/HUB_PROJECT_ID/locations/HUB_LOCATION/apis?filter=source_metadata.plugin_instance_action_source.plugin_instance="projects/HUB_PROJECT_ID/locations/HUB_LOCATION/plugins/PLUGIN_TYPE/instances/PLUGIN_INSTANCE_ID"' \
  -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"

다음을 바꿉니다.

HUB_PROJECT_ID: API 허브 호스트 프로젝트의 이름입니다. 이 호스트 프로젝트는 API 허브가 프로비저닝되었을 때 선택되었습니다.
HUB_LOCATION: 호스트 프로젝트의 위치입니다. 이 위치는 API 허브가 프로비저닝되었을 때 선택되었습니다.
PLUGIN_TYPE: 플러그인 유형입니다. system-api-gateway로 설정합니다.
PLUGIN_INSTANCE_ID: API Gateway 플러그인 인스턴스의 ID입니다. list plugin instances API를 사용하여 플러그인 인스턴스 ID를 가져옵니다.

다음은 응답의 예시입니다.

{
  "apis": [
    {
      "name": "projects/myproject/locations/us-west1/apis/4fc95784-16b0-4b6e-8b7f-a08607febf78",
      "displayName": "test-api-1",
      "versions": [
        "projects/myproject/locations/us-west1/apis/4fc95784-16b0-4b6e-8b7f-a08607febf78/versions/843a7e72-c5d2-4af8-95b0-162fa5d5ea10",
        "projects/myproject/locations/us-west1/apis/4fc95784-16b0-4b6e-8b7f-a08607febf78/versions/b6af2674-4a0e-410e-990d-d90ccbe6867e"
      ],
      "createTime": "2025-12-12T18:55:54.445487Z",
      "updateTime": "2025-12-12T18:55:54.445487Z",
      "apiStyle": {
        "attribute": "projects/myproject/locations/us-west1/attributes/system-api-style",
        "enumValues": {
          "values": [
            {
              "id": "rest",
              "displayName": "REST",
              "description": "REST",
              "immutable": true
            }
          ]
        }
      },
      "fingerprint": "test-api-1",
      "sourceMetadata": [
        {
          "pluginInstanceActionSource": {
            "pluginInstance": "projects/myproject/locations/us-west1/plugins/system-api-gateway/instances/90b21a65-38b4-4159-8e9d-07a8b6cecab0",
            "actionId": "sync-metadata"
          },
          "sourceType": "PLUGIN",
          "originalResourceId": "projects/runtimeproject/locations/global/apis/test-api-1",
          "originalResourceCreateTime": "2025-12-11T01:57:54.841944920Z",
          "originalResourceUpdateTime": "0001-01-01T00:00:00Z"
        }
      ]
    }
  ]
}

다음 표에서는 응답에서 API Gateway의 API 메타데이터로 채워지는 필드를 설명합니다. 기타 시스템 및 사용자 정의 속성에 관한 자세한 내용은 API 허브 문서의 속성 관리를 참고하세요.

API 필드	설명
`name`	API 허브에 있는 API의 ID입니다. 형식은 `projects/HUB_PROJECT_ID/locations/HUB_LOCATION/apis/API_ID`입니다. 참고: `API_ID`는 값이 고유하도록 리소스 이름에 사용됩니다.
`displayName`	API의 표시 이름입니다.
`createTime`	API가 생성된 타임스탬프입니다.
`updateTime`	API가 생성된 타임스탬프입니다.
`fingerprint`	API의 고유 ID입니다 (일반적으로 표시 이름으로 설정됨).
`sourceMetadata`	다음을 포함한 API 게이트웨이 플러그인 인스턴스 정보 플러그인 인스턴스 ID(형식: `projects/HUB_PROJECT_ID/locations/HUB_LOCATION/plugins/system-api-gateway/instances/PLUGIN_INSTANCE_ID`) 다음 형식의 원래 API Gateway 리소스 이름: `projects/RUNTIME_PROJECT_ID/locations/LOCATION/apis/API_ID`