프로젝트 내의 모든 보고서 구성을 나열하여 App Optimize API 보고서를 효과적으로 관리합니다. Google Cloud 이렇게 하면 데이터를 읽을 특정 보고서를 식별하거나 더 이상 필요하지 않은 경우 만료일 전에 삭제할 수 있습니다.
목록 작업은 각 보고서의 리소스 이름, 범위, 측정기준, 측정항목, 만료 시간을 비롯한 보고서 메타데이터를 반환합니다. 요청된 비용 및 사용량 정보를 다운로드하려면 보고서의 데이터를 읽어야 합니다.
시작하기 전에
- 계정에 로그인합니다. Google Cloud 를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. Google Cloud신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
-
Google Cloud CLI를 설치합니다.
-
외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
-
gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다.
gcloud init -
Google Cloud CLI를 설치합니다.
-
외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
-
gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다.
gcloud init
필요한 역할
프로젝트의 보고서 리소스를 나열하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 App Optimize 뷰어 (roles/appoptimize.viewer) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
보고서 나열
REST API를 사용하여 프로젝트의 보고서를 나열하려면 보고서 컬렉션 엔드포인트로 HTTP GET 요청을 전송합니다.
다음 curl 명령어를 사용하여 프로젝트의 보고서
를 나열합니다.
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports?pageSize=PAGE_SIZE"
다음을 바꿉니다.
PROJECT_ID: 나열할 보고서 리소스를 소유한 프로젝트의 ID입니다. Google CloudPAGE_SIZE: 페이지당 반환할 보고서의 최대 개수입니다. 생략하면 API에서 기본값을 사용합니다. 서버에서 요청된 것보다 적은 보고서를 반환할 수 있습니다.
요청이 성공하면 API는 보고서 리소스 목록이 포함된 JSON 응답을 반환합니다. 다음은 성공적인 호출 응답의 예입니다.
{
"reports": [
{
"name": "projects/PROJECT_ID/locations/global/reports/my-first-report",
"dimensions": [
"location",
"product_display_name",
"project",
"sku"
],
"scopes": [
{
"project": "projects/PROJECT_ID"
}
],
"filter": "hour \u003e= now - duration(\"168h\")",
"expireTime": "2026-02-05T18:30:39.907639266Z",
"metrics": [
"cost"
]
},
{
"name": "projects/PROJECT_ID/locations/global/reports/my-second-report",
"dimensions": [
"location",
"product_display_name",
"project",
"resource",
"resource_type"
],
"scopes": [
{
"project": "projects/PROJECT_ID"
}
],
"filter": "hour \u003e= now - duration(\"168h\")",
"expireTime": "2026-02-05T18:50:25.273833857Z",
"metrics": [
"cost",
"cpu_mean_utilization"
]
}
]
}
reports 배열에는 각 보고서의 메타데이터가 포함됩니다. 요청이 실패하면 API에서 반환된 오류 메시지를 검토합니다.
응답에 nextPageToken 문자열이 포함되어 있으면 가져올 보고서가 더 있다는 의미입니다.
응답에서 nextPageToken 필드를 확인합니다. 토큰이 있으면 pageToken 쿼리 매개변수를 포함하여 다음 페이지를 가져오기 위해 다음 curl 요청을 실행합니다. pageSize 매개변수를 계속 사용할 수 있습니다.
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports?pageToken=NEXT_PAGE_TOKEN&pageSize=PAGE_SIZE"
다음을 바꿉니다.
NEXT_PAGE_TOKEN: 이전 응답에서 수신된nextPageToken의 값입니다.PAGE_SIZE: 이 요청에 원하는 페이지 크기입니다.
응답에 더 이상 nextPageToken이 포함되지 않을 때까지 이 프로세스를 반복합니다. 이는 모든 보고서를 가져왔음을 나타냅니다.