감사 상태 가져오기

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

시작하기 전에

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

콘솔

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

    감사 보기로 이동

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

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

  4. (미리보기) 선택사항: 새 콘솔 환경을 사용하여 감사의 상태를 보려면 다음 단계를 완료하세요.

    1. 새 환경으로 전환을 클릭합니다.

    2. 감사에 대한 자세한 내용을 보려면 감사 이름을 클릭합니다.

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"
  }
}

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

다음 단계