감사 예약 또는 실행

감사를 통해 지원되는 프레임워크에 따라Google Cloud 조직을 평가하는 데 필요한 증거를 수집할 수 있습니다. 정기적으로 실행되도록 감사를 예약하거나 주문형 감사를 실행할 수 있습니다.

감사는 몇 시간이 걸릴 수 있는 장기 실행 작업입니다. 소요 시간은 감사 범위 내 리소스 수, 즉 이전에 등록한 조직, 프로젝트 또는 폴더 수에 따라 달라집니다.

특정 프레임워크 및 리소스 조합에 대한 활성 또는 일시중지된 일정이 아직 없는 경우에만 해당 조합에 대한 일정을 만들 수 있습니다.

시작하기 전에

• 감사를 실행하거나 예약하는 데 필요한 권한을 얻으려면 관리자에게 다음 Identity and Access Management (IAM) 역할 중 하나를 부여해 달라고 요청하세요.

  • 감사 관리자 관리자(roles/auditmanager.admin)
  • 감사 관리자 감사자(roles/auditmanager.auditor)

• 감사를 위해 조직, 프로젝트 또는 폴더를 등록합니다.

감사 예약 및 실행

반복적으로 감사를 실행하는 일정을 만들거나 주문형 감사를 실행할 수 있습니다.

콘솔

1. Google Cloud 콘솔에서 Audit Manager의 평가 실행 페이지로 이동합니다.

   감사 관리자로 이동

2. 리소스 및 리전 선택 섹션에서 다음을 수행합니다.

   1. 감사할 조직, 폴더 또는 프로젝트를 선택합니다.

   2. 감사 평가를 처리할 위치를 선택합니다. 지원되는 위치 목록은 감사 관리자 위치를 참조하세요.

   3. 다음을 클릭합니다.

3. 규정 선택 섹션에서 리소스를 감사할 프레임워크를 선택한 후 다음을 클릭합니다. 지원되는 프레임워크에 대한 자세한 내용은 지원되는 프레임워크를 참조하세요.

4. 선택사항: 매개변수 구성 섹션이 표시되면 다음을 완료합니다.

   1. 구성 수정을 클릭합니다.

   2. 매개변수 구성 창에서 클라우드 제어에 필요한 매개변수를 추가합니다. 매개변수에 대한 자세한 내용은 규정 준수 관리자 클라우드 제어 참조 및 Assured Workloads 클라우드 제어를 참조하세요.

   3. 저장을 클릭합니다.

5. 선택사항: 평가 계획 보기 섹션에서 선택한 프레임워크에 따라 감사 범위에 대한 정보가 포함된 ODS 파일을 다운로드할 수 있습니다. 파일을 다운로드하려면 링크를 클릭하고 다음을 클릭합니다.

6. 저장소 버킷 선택 섹션에서 감사 보고서와 증거를 저장할 저장소 버킷을 선택한 후 완료를 클릭합니다. 버킷이 목록에 없으면 관리자에게 스토리지 버킷에 리소스를 등록하도록 요청하세요.

7. 선택사항: 일정 섹션에서 다음 중 하나를 설정합니다.

   • 감사를 반복할 빈도 (매일, 매주, 매월, 분기별 또는 매년)입니다.

   • 감사에 포함할 기간입니다. 종료되지 않음을 선택하면 수동으로 중지할 때까지 지정한 시작일부터 감사가 계속 실행됩니다.

8. 감사를 시작하려면 감사 실행 또는 예약된 감사 실행을 클릭합니다.

   평가 보기 페이지에서 주문형 감사 상태를 보거나 감사 관리 페이지의 일정 탭에서 예약된 감사를 볼 수 있습니다.

gcloud

선택사항: 감사 평가 생성

감사를 실행하기 전에 선택한 프레임워크를 기반으로 감사에 대한 자세한 태스크 분류가 포함된 감사 평가 또는 범위를 생성할 수 있습니다.

gcloud audit-manager audit-scopes generate 명령어는 감사 범위를 생성합니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organization, folder, project입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 Google Cloud 콘솔의 평가 보기 페이지를 참조하세요.
• AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF
• OUTPUT_DIRECTORY: 출력이 저장되어야 하는 디렉터리입니다. 예를 들면 reports입니다.
• OUTPUT_FILENAME: 출력 파일의 이름입니다. 파일 이름에 파일 확장자를 포함하지 마세요. 예를 들면 scopeReport입니다.

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-scopes generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --output-directory=OUTPUT_DIRECTORY \
    --output-file-name=OUTPUT_FILENAME

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-scopes generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --output-directory=OUTPUT_DIRECTORY `
    --output-file-name=OUTPUT_FILENAME

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-scopes generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --output-directory=OUTPUT_DIRECTORY ^
    --output-file-name=OUTPUT_FILENAME

주문형 감사 실행

gcloud audit-manager audit-reports generate 명령어는 감사를 실행합니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organization, folder, project입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 Google Cloud 콘솔의 평가 보기 페이지를 참조하세요.
• BUCKET_URI: Cloud Storage 버킷의 URI입니다. 예를 들면 gs://testbucketauditmanager입니다.
• AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-reports generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-reports generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-reports generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI

다음과 비슷한 응답이 표시됩니다.

done: false
name: projects/10398413/locations/987234/operations/operation-1726842525305-6228ddb4dca96-78a6db59-f9dd9a24

감사 예약

gcloud audit-manager audit-schedules create 명령어는 감사 일정을 만듭니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organization, folder, project입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• AUDIT_SCHEDULE_ID: 감사 일정의 ID입니다. 예를 들면 my-schedule-id입니다. 기존 일정의 ID를 찾으려면 Google Cloud 콘솔의 감사 관리 페이지를 참조하세요.
• FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 Google Cloud 콘솔의 평가 보기 페이지를 참조하세요.
• AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. OpenDocument 형식 (ODF)만 지원됩니다. odf
• BUCKET_URI: Cloud Storage 버킷의 URI입니다. 예를 들면 gs://testbucketauditmanager입니다.
• FREQUENCY: 예약된 감사 실행 빈도입니다. 유효한 값은 daily, weekly, monthly, quarterly, annually입니다. 예를 들면 weekly입니다.
• SCHEDULE_START_TIME: 첫 번째 감사 실행이 시작되는 날짜 및 시간(RFC 3339 형식)입니다. 예를 들면 2026-10-25T10:00:00Z입니다.
• DISPLAY_NAME: 선택사항입니다. 감사 일정의 표시 이름입니다. 예를 들면 NIST 800-53 Weekly Audit입니다.
• SCHEDULE_END_TIME: 선택사항. 감사 일정이 중지되는 날짜 및 시간(RFC 3339 형식)입니다. 예를 들면 2027-10-25T10:00:00Z입니다.
• TIME_ZONE: 선택사항입니다. IANA 형식의 감사 일정 시간대입니다. 감사 관리자는 이 값을 사용하여 시작 시간과 종료 시간을 해석합니다. 지정하지 않으면 기본값은 UTC입니다. 예를 들면 America/New_York입니다.

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules create \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --audit-schedule-id=AUDIT_SCHEDULE_ID \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI \
    --start-time=SCHEDULE_START_TIME \
    --frequency=FREQUENCY \
    --display-name="DISPLAY_NAME" \
    --end-time=SCHEDULE_END_TIME \
    --time-zone=TIME_ZONE

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules create `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --audit-schedule-id=AUDIT_SCHEDULE_ID `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI `
    --start-time=SCHEDULE_START_TIME `
    --frequency=FREQUENCY `
    --display-name="DISPLAY_NAME" `
    --end-time=SCHEDULE_END_TIME `
    --time-zone=TIME_ZONE

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules create ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --audit-schedule-id=AUDIT_SCHEDULE_ID ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI ^
    --start-time=SCHEDULE_START_TIME ^
    --frequency=FREQUENCY ^
    --display-name="DISPLAY_NAME" ^
    --end-time=SCHEDULE_END_TIME ^
    --time-zone=TIME_ZONE

다음과 비슷한 응답이 표시됩니다.

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: weekly
  startTime: '2026-10-25T10:00:00Z'
state: SCHEDULE_STATE_ACTIVE

REST

선택사항: 감사 평가 생성

감사를 실행하기 전에 선택한 프레임워크를 기반으로 감사에 대한 자세한 태스크 분류가 포함된 감사 평가 또는 범위를 생성할 수 있습니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 Google Cloud 콘솔의 평가 보기 페이지를 참조하세요.
• AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF

HTTP 메서드 및 URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate

JSON 요청 본문:

{
  "compliance_framework" : "FRAMEWORK",
  "report_format" : "AUDIT_REPORT_FORMAT"
}

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

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate"

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{

  "scope_report_contents": "980u43nrf090834uhbkfehf......",
  "name" : "folders/8767234/locations/us-west"
}

응답에는 다음 정보가 포함됩니다.

• scope_report_contents: 보고서 콘텐츠의 바이트 형식이며 검토 전에 OpenDocument 형식 (ODF)으로 변환해야 합니다.
• name: 해당 리소스의 고유한 문자열 식별자입니다.

주문형 감사 실행

주문형 감사를 실행하려면 POST 요청을 auditReport:generate 엔드포인트에 보냅니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 Google Cloud 콘솔의 평가 보기 페이지를 참조하세요.
• BUCKET_URI: Cloud Storage 버킷의 URI입니다. 예를 들면 gs://testbucketauditmanager입니다.
• AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF

HTTP 메서드 및 URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate

JSON 요청 본문:

{
  "destination" : {
    "gcs_uri" : "BUCKET_URI"
  },
  "compliance_framework" : "FRAMEWORK",
  "report_format" : "AUDIT_REPORT_FORMAT"
}

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

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate"

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "organizations/834/projects/10398413/locations/987234/operations/098234",
  "done": false
}

응답에는 다음 정보가 포함됩니다.

• name: 감사 평가 작업 요청의 고유 문자열 식별자입니다. 이 식별자를 사용하여 감사 평가 진행 상황을 추적합니다. 예를 들면 projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID입니다.
• done: 감사 평가가 완료되었는지 여부를 나타내는 불리언 플래그입니다. 이 플래그는 프로세스가 시작될 때 false로 설정되고 감사 평가가 완료되면 true로 변경됩니다.

감사 예약

반복 감사를 예약하려면 auditSchedules 엔드포인트에 POST 요청을 보냅니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• AUDIT_SCHEDULE_ID: 감사 일정의 ID입니다. 예를 들면 my-schedule-id입니다. 기존 일정의 ID를 찾으려면 Google Cloud 콘솔의 감사 관리 페이지를 참조하세요.
• FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 Google Cloud 콘솔의 평가 보기 페이지를 참조하세요.
• BUCKET_URI: Cloud Storage 버킷의 URI입니다. 예를 들면 gs://testbucketauditmanager입니다.
• AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF
• FREQUENCY: 예약된 감사 실행 빈도입니다. 유효한 값은 DAILY, WEEKLY, MONTHLY, QUARTERLY, ANNUALLY입니다. 예를 들면 WEEKLY입니다.
• SCHEDULE_START_TIME: 첫 번째 감사 실행이 시작되는 날짜 및 시간(RFC 3339 형식)입니다. 예를 들면 2026-10-25T10:00:00Z입니다.
• DISPLAY_NAME: 선택사항입니다. 감사 일정의 표시 이름입니다. 예를 들면 NIST 800-53 Weekly Audit입니다.
• SCHEDULE_END_TIME: 선택사항. 감사 일정이 중지되는 날짜 및 시간(RFC 3339 형식)입니다. 예를 들면 2027-10-25T10:00:00Z입니다.
• TIME_ZONE: 선택사항입니다. IANA 형식의 감사 일정 시간대입니다. 감사 관리자는 이 값을 사용하여 시작 시간과 종료 시간을 해석합니다. 지정하지 않으면 기본값은 UTC입니다. 예를 들면 America/New_York입니다.

HTTP 메서드 및 URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID

JSON 요청 본문:

{
  "displayName": "DISPLAY_NAME",
  "gcsUri": "BUCKET_URI",
  "complianceFramework": "FRAMEWORK",
  "reportFormat": "AUDIT_REPORT_FORMAT",
  "scheduleConfig": {
    "startTime": "SCHEDULE_START_TIME",
    "endTime": "SCHEDULE_END_TIME",
    "frequency": "FREQUENCY",
    "timeZone": "TIME_ZONE"
  }
}

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

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID"

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-10-25T10:00:00Z",
    "endTime": "2027-10-25T10:00:00Z",
    "frequency": "WEEKLY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "createTime": "2026-10-25T13:27:00Z",
  "updateTime": "2026-10-25T13:27:00Z"
}

예약된 감사 보기

범위, 프레임워크, 일정 구성을 포함하여 예약된 감사에 대한 세부정보를 볼 수 있습니다.

콘솔

1. Google Cloud 콘솔에서 감사 관리자의 감사 관리 페이지로 이동합니다.

   감사 관리자로 이동

2. 일정 탭에서 예약된 감사 목록을 확인합니다.

gcloud

예약된 감사 목록 보기

예약된 감사 목록을 보려면 gcloud audit-manager audit-schedules list 명령어를 실행합니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organization, folder, project입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules list \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules list `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules list ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

다음과 비슷한 응답이 표시됩니다.

┌────────────┬────────────┬──────────────┬────────────┬────────────┬───────────────┬─────────────────┬─────────────┬─────────────┬───────────────┬───────────────────┬───────────────┐
│     ID     │ FRAMEWORK  │ DISPLAY_NAME │   STATE    │  GCS_URI   │ REPORT_FORMAT │ SCHEDULE_CONFIG │ CREATE_TIME │ UPDATE_TIME │ NEXT_RUN_TIME │ LAST_TRIGGER_TIME │ ERROR_MESSAGE │
├────────────┼────────────┼──────────────┼────────────┼────────────┼───────────────┼─────────────────┼─────────────┼─────────────┼───────────────┼───────────────────┼───────────────┤
│ my-schedul │ builtin-ci │ My first aud │ SCHEDULE_S │ gs://my-bu │ AUDIT_REPORT_ │ {'frequency':   │ 2026-10-25T │ 2026-10-25T │               │                   │               │
│ e-id       │ s-v8       │ it schedule  │ TATE_ACTIV │ cket       │ FORMAT_ODF    │ 'weekly',       │ 13:27:00Z   │ 13:27:00Z   │               │                   │               │
│            │            │              │ E          │            │               │ 'startTime':    │             │             │               │                   │               │
│            │            │              │            │            │               │ '2026-10-25T10: │             │             │               │                   │               │
│            │            │              │            │            │               │ 00:00Z'}        │             │             │               │                   │               │
└────────────┴────────────┴──────────────┴────────────┴────────────┴───────────────┴─────────────────┴─────────────┴─────────────┴───────────────┴───────────────────┴───────────────┘

예약된 감사에 관한 세부정보 보기

특정 예약된 감사에 대한 세부정보를 보려면 gcloud audit-manager audit-schedules describe 명령어를 실행합니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• AUDIT_SCHEDULE_ID: 감사 일정의 ID입니다. 예를 들면 my-schedule-id입니다. 기존 일정의 ID를 찾으려면 Google Cloud 콘솔의 감사 관리 페이지를 참조하세요.

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules describe \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules describe `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules describe ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

다음과 비슷한 응답이 표시됩니다.

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: weekly
  startTime: '2026-10-25T10:00:00Z'
state: SCHEDULE_STATE_ACTIVE

REST

예약된 감사 목록 보기

예약된 감사 목록을 보려면 auditSchedules 엔드포인트에 GET 요청을 보냅니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.

HTTP 메서드 및 URL:

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

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

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

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

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

$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/auditSchedules" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "auditSchedules": [
    {
      "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
      "displayName": "My first audit schedule",
      "gcsUri": "gs://my-bucket",
      "complianceFramework": "builtin-cis-v8",
      "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
      "scheduleConfig": {
        "startTime": "2026-10-25T10:00:00Z",
        "endTime": "2027-10-25T10:00:00Z",
        "frequency": "WEEKLY",
        "timeZone": "America/New_York"
      },
      "state": "SCHEDULE_STATE_ACTIVE",
      "createTime": "2026-10-25T13:27:00Z",
      "updateTime": "2026-10-25T13:27:00Z"
    }
  ]
}

예약된 감사에 관한 세부정보 보기

예약된 특정 감사에 대한 세부정보를 보려면 GET 요청을 auditSchedules 엔드포인트로 전송하고 일정 ID를 지정합니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• AUDIT_SCHEDULE_ID: 감사 일정의 ID입니다. 예를 들면 my-schedule-id입니다. 기존 일정의 ID를 찾으려면 Google Cloud 콘솔의 감사 관리 페이지를 참조하세요.

HTTP 메서드 및 URL:

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

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

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

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

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

$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/auditSchedules/AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-10-25T10:00:00Z",
    "endTime": "2027-10-25T10:00:00Z",
    "frequency": "WEEKLY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "createTime": "2026-10-25T13:27:00Z",
  "updateTime": "2026-10-25T13:27:00Z"
}

예약된 감사 업데이트

반복 감사를 일시중지, 재개, 중지할 수 있습니다. 일정을 변경하려면 기존 예약된 감사를 삭제한 후 새 예약된 감사를 만들어야 합니다.

콘솔

1. Google Cloud 콘솔에서 감사 관리자의 감사 관리 페이지로 이동합니다.

   감사 관리자로 이동

2. 예약 탭에서 업데이트할 예약된 감사를 찾습니다.

3. 다음 중 하나를 수행합니다.

   • 감사 일정을 일시중지하려면 일정 일시중지를 클릭합니다.

   • 일시중지한 감사를 다시 시작하려면 일정 재개를 클릭합니다.

   • 예약된 감사를 삭제하려면 일정 중지를 클릭합니다.

gcloud

감사 일정을 일시중지, 재개 또는 삭제하려면 gcloud audit-manager audit-schedules update 명령어를 실행하여 일정 상태를 업데이트합니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• AUDIT_SCHEDULE_ID: 감사 일정의 ID입니다. 예를 들면 my-schedule-id입니다. 기존 일정의 ID를 찾으려면 Google Cloud 콘솔의 감사 관리 페이지를 참조하세요.
• SCHEDULE_STATE: 감사 일정의 타겟 상태입니다. 다음 중 하나로 설정합니다.
  • paused: 활성 일정을 일시중지합니다.
  • active: 일시중지된 일정을 재개합니다.
  • deleted: 일정을 중지하고 삭제합니다.

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules update \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID \
    --state=SCHEDULE_STATE

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules update `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID `
    --state=SCHEDULE_STATE

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud audit-manager audit-schedules update ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID ^
    --state=SCHEDULE_STATE

다음과 비슷한 응답이 표시됩니다.

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: daily
  startTime: '2026-02-25T10:00:00Z'
state: SCHEDULE_STATE_PAUSED

REST

감사 일정을 일시중지, 재개 또는 삭제하려면 PATCH 요청을 전송하여 감사 일정의 state 필드를 업데이트합니다.

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

• RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
• RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
• LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
• AUDIT_SCHEDULE_ID: 감사 일정의 ID입니다. 예를 들면 my-schedule-id입니다. 기존 일정의 ID를 찾으려면 Google Cloud 콘솔의 감사 관리 페이지를 참조하세요.
• SCHEDULE_STATE: 감사 일정의 타겟 상태입니다. 다음 중 하나로 설정합니다.
  • SCHEDULE_STATE_PAUSED: 활성 일정을 일시중지합니다.
  • SCHEDULE_STATE_ACTIVE: 일시중지된 일정을 재개합니다.
  • SCHEDULE_STATE_DELETED: 일정을 중지하고 삭제합니다.

HTTP 메서드 및 URL:

PATCH https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state

JSON 요청 본문:

{
  "state": "SCHEDULE_STATE"
}

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

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state"

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-02-25T10:00:00Z",
    "endTime": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_PAUSED",
  "createTime": "2026-02-25T13:27:00Z",
  "updateTime": "2026-09-11T18:15:00Z"
}

다음 단계

• 감사 상태 가져오기
• 실행 감사 문제 해결