감사 상태 가져오기

이 페이지에서는 감사 관리자 또는 규정 준수 관리자를 사용하여 시작한 진행 중인 감사의 상태를 가져오는 방법을 설명합니다. 감사는 장기 실행 작업이며 작업이 실행되는 동안 감사의 상태를 가져오는 것이 유용할 수 있습니다.

시작하기 전에

진행 중인 감사의 상태 가져오기

콘솔

  1. 콘솔에서 감사 보기 페이지로 이동합니다. Google Cloud

    감사 보기로 이동

  2. 평가 보기 페이지에서 진행 중인 감사의 현재 상태를 보거나 완료된 감사에 대한 자세한 정보를 확인할 수 있습니다.

  3. 감사에 대한 자세한 내용을 보려면 상태 열에서 링크를 클릭합니다.

gcloud

gcloud audit-manager operations describe 명령어는 감사 작업을 설명합니다.

아래의 명령어 데이터를 사용하기 전에, 다음을 바꿉니다.

  • RESOURCE_TYPE: 리소스 유형(프로젝트 또는 폴더) 예: folders 또는 projects
  • RESOURCE_ID: 프로젝트 또는 폴더의 리소스 ID 예: 8767234
  • LOCATION: 감사 관리자 API 엔드포인트의 위치 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예: us-central1
  • AUDIT_OPERATION_ID: 감사를 실행했을 때 응답 본문에 포함된 진행 중인 작업의 고유 ID입니다. 예: 098234

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud audit-manager operations describe AUDIT_OPERATION_ID \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

Windows(PowerShell)

gcloud audit-manager operations describe AUDIT_OPERATION_ID `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows(cmd.exe)

gcloud audit-manager operations describe AUDIT_OPERATION_ID ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

성공적인 응답에는 다음 실행 상태 유형 중 하나가 포함됩니다.

상태 유형 설명
OPERATION_STATE_UNSPECIFIED 잘못된 상태입니다.
OPERATION_STATE_NOT_STARTED 감사 보고서 생성 프로세스가 아직 시작되지 않았습니다.
OPERATION_STATE_EVALUATION_IN_PROGRESS 감사 관리자가 규정 준수 제어를 기준으로 리소스를 평가하는 중입니다.
OPERATION_STATE_EVALUATION_DONE 감사 관리자가 규정 준수 평가를 완료했습니다.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS 감사 관리자가 평가된 데이터에서 감사 보고서를 만드는 중입니다.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE 감사 관리자가 감사 보고서 생성을 완료했습니다.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS 감사 관리자가 감사 보고서 및 증거를 대상에 업로드하는 중입니다.
OPERATION_STATE_DONE 감사 보고서 생성 프로세스가 완료되었습니다.
OPERATION_STATE_FAILED 감사 보고서 생성 프로세스가 실패했습니다.

각 실행 상태 유형은 해당하는 경우 다음 추가 정보를 제공할 수 있습니다.

추가 상태 설명
failure_reason 감사 평가가 실패하면 이 필드에 실패 이유가 표시됩니다.
evaluation_percent_complete 평가가 시작된 경우 이 필드에 진행률이 백분율로 표시됩니다. 프로세스가 아직 시작되지 않은 경우 필드는 0으로 시작합니다. 프로세스가 완료되면 필드가 100으로 설정됩니다.
report_generation_percent_complete 보고서 생성이 시작된 경우 이 필드에 진행률이 백분율로 표시됩니다. 프로세스가 아직 시작되지 않은 경우 필드는 0으로 시작합니다. 프로세스가 완료되면 필드가 100으로 설정됩니다.
report_uploading_percent_complete 보고서 업로드가 시작된 경우 이 필드에 진행률이 백분율로 표시됩니다. 프로세스가 아직 시작되지 않은 경우 필드는 0으로 시작합니다. 프로세스가 완료되면 필드가 100으로 설정됩니다.

성공적인 gcloud 응답은 다음과 유사합니다.

done: true
name: projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID
response:
  '@type': type.googleapis.com/google.cloud.auditmanager.v1.AuditReport
  gcsUri: gs://testbucketauditmanager

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 리소스 유형(프로젝트 또는 폴더) 예: folders 또는 projects
  • RESOURCE_ID: 프로젝트 또는 폴더의 리소스 ID 예: 8767234
  • LOCATION: 감사 관리자 API 엔드포인트의 위치 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예: us-central1
  • AUDIT_OPERATION_ID: 감사를 실행했을 때 응답 본문에 포함된 진행 중인 작업의 고유 ID입니다. 예: 098234

HTTP 메서드 및 URL: 

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다. 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID"

PowerShell

다음 명령어를 실행합니다. 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID" | Select-Object -Expand Content

성공적인 응답에는 다음 실행 상태 유형 중 하나가 포함됩니다.

상태 유형 설명
OPERATION_STATE_UNSPECIFIED 잘못된 상태입니다.
OPERATION_STATE_NOT_STARTED 감사 보고서 생성 프로세스가 아직 시작되지 않았습니다.
OPERATION_STATE_EVALUATION_IN_PROGRESS 감사 관리자가 규정 준수 제어를 기준으로 리소스를 평가하는 중입니다.
OPERATION_STATE_EVALUATION_DONE 감사 관리자가 규정 준수 평가를 완료했습니다.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS 감사 관리자가 평가된 데이터에서 감사 보고서를 만드는 중입니다.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE 감사 관리자가 감사 보고서 생성을 완료했습니다.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS 감사 관리자가 감사 보고서 및 증거를 대상에 업로드하는 중입니다.
OPERATION_STATE_DONE 감사 보고서 생성 프로세스가 완료되었습니다.
OPERATION_STATE_FAILED 감사 보고서 생성 프로세스가 실패했습니다.

각 실행 상태 유형은 해당하는 경우 다음 추가 정보를 제공할 수 있습니다.

추가 상태 설명
failure_reason 감사 평가가 실패하면 이 필드에 실패 이유가 표시됩니다.
evaluation_percent_complete 평가가 시작된 경우 이 필드에 진행률이 백분율로 표시됩니다. 프로세스가 아직 시작되지 않은 경우 필드는 0으로 시작합니다. 프로세스가 완료되면 필드가 100으로 설정됩니다.
report_generation_percent_complete 보고서 생성이 시작된 경우 이 필드에 진행률이 백분율로 표시됩니다. 프로세스가 아직 시작되지 않은 경우 필드는 0으로 시작합니다. 프로세스가 완료되면 필드가 100으로 설정됩니다.
report_uploading_percent_complete 보고서 업로드가 시작된 경우 이 필드에 진행률이 백분율로 표시됩니다. 프로세스가 아직 시작되지 않은 경우 필드는 0으로 시작합니다. 프로세스가 완료되면 필드가 100으로 설정됩니다.

성공적인 REST 응답은 다음과 유사합니다.

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.auditmanager.v1.AuditReport",
    "gcsUri": "gs://testbucketauditmanager"
  }
}

감사 보고서가 완료되고 업로드되면 보고서 링크가 반환됩니다.

다음 단계