Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Cómo programar o ejecutar una auditoría

Las auditorías te permiten recopilar la evidencia que necesitas para evaluar tu organización deGoogle Cloud en relación con los frameworks admitidos. Puedes programar una auditoría para que se ejecute en un intervalo regular o ejecutar una auditoría a pedido.

Una auditoría es una operación de larga duración que puede tardar algunas horas. La duración depende de la cantidad de recursos dentro del alcance de la auditoría, que es la organización, el proyecto o la carpeta que inscribiste anteriormente.

Puedes crear un programa para una combinación específica de marco de trabajo y recurso solo si no existe un programa activo o en pausa para esa combinación.

Antes de comenzar

Para obtener los permisos que necesitas para ejecutar o programar una auditoría, pídele a tu administrador que te otorgue uno de los siguientes roles de Identity and Access Management (IAM):
- Administrador de Audit Manager (roles/auditmanager.admin)
- Auditor del gestor de auditorías (roles/auditmanager.auditor)
Inscribe tu organización, proyecto o carpeta para la auditoría.

Programa y ejecuta una auditoría

Puedes crear una programación para ejecutar una auditoría de forma recurrente o ejecutar una auditoría a pedido.

Console

En la consola de Google Cloud , ve a la página Ejecutar evaluación en Audit Manager.

Ir al Gestor de auditorías
En la sección Elige el recurso y la región, haz lo siguiente:
1. Selecciona la organización, la carpeta o el proyecto que deseas auditar.
2. Selecciona la ubicación en la que deseas procesar la evaluación de auditoría. Para obtener la lista de ubicaciones admitidas, consulta Ubicaciones del Administrador de auditorías.
3. Haz clic en Siguiente.
En la sección Elige una regulación, selecciona el framework con el que deseas auditar tu recurso y, luego, haz clic en Siguiente. Para obtener información sobre los frameworks compatibles, consulta Frameworks compatibles.
Opcional: Si aparece la sección Configurar parámetros, completa lo siguiente:
1. Haz clic en Modificar configuración.
2. En la ventana Configurar parámetros, agrega los parámetros necesarios para los controles de Cloud. Para obtener más información sobre los parámetros, consulta la referencia de controles de la nube del Administrador de cumplimiento y los controles de la nube de Assured Workloads.
3. Haz clic en Guardar.
Opcional: En la sección Ver plan de evaluación, puedes descargar un archivo ODS que contiene información sobre el alcance de la auditoría según el framework que seleccionaste. Para descargar el archivo, haz clic en el vínculo y, luego, en Siguiente.
En la sección Elige un bucket de almacenamiento, selecciona el bucket de almacenamiento en el que quieres guardar el informe de auditoría y la evidencia y, luego, haz clic en Listo. Si tu bucket no aparece en la lista, pídele al administrador que inscriba tu recurso con tu bucket de almacenamiento.
Opcional: En la sección Programa, configura cualquiera de las siguientes opciones:
- Con qué frecuencia se debe repetir la auditoría (diaria, semanal, mensual, trimestral o anual).
- Es el período que se incluirá en la auditoría. Si eliges Sin finalización, la auditoría se seguirá ejecutando desde la fecha de inicio que especifiques hasta que la detengas de forma manual.
Para iniciar la auditoría, haz clic en Ejecutar auditoría o Ejecutar auditoría programada.

Puedes ver el estado de una auditoría on demand en la página Ver evaluaciones o ver tus auditorías programadas en la pestaña Programaciones de la página Administración de auditorías.

gcloud

Opcional: Genera una evaluación de auditoría

Antes de ejecutar una auditoría, puedes generar una evaluación o un alcance de la auditoría, que incluya un desglose detallado de las tareas de la auditoría según el framework que elijas.

El comando gcloud audit-manager audit-scopes generate genera un permiso de auditoría.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organization, folder y project.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
FRAMEWORK: Es el ID del framework con el que se realizará la auditoría. Por ejemplo: builtin-cis-v8. Para encontrar el ID de un framework, consulta la página Ver evaluaciones en la consola de Google Cloud .
AUDIT_REPORT_FORMAT: Es el formato del informe de auditoría de salida. Solo se admite el formato ODF: AUDIT_REPORT_FORMAT_ODF.
OUTPUT_DIRECTORY: Es el directorio en el que se debe almacenar el resultado. Por ejemplo: reports.
OUTPUT_FILENAME: Es el nombre del archivo de salida. No incluyas la extensión de archivo en el nombre del archivo. Por ejemplo: scopeReport.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

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

Ejecuta una auditoría a pedido

El comando gcloud audit-manager audit-reports generate ejecuta una auditoría.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organization, folder y project.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
FRAMEWORK: Es el ID del framework con el que se realizará la auditoría. Por ejemplo: builtin-cis-v8. Para encontrar el ID de un framework, consulta la página Ver evaluaciones en la consola de Google Cloud .
BUCKET_URI: Es el URI del bucket de Cloud Storage. Por ejemplo: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: Es el formato del informe de auditoría de salida. Solo se admite el formato ODF: AUDIT_REPORT_FORMAT_ODF.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

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 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 audit-manager audit-reports generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI

Deberías recibir una respuesta similar a la que figura a continuación:

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

Programa una auditoría

El comando gcloud audit-manager audit-schedules create crea un programa de auditoría.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organization, folder y project.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
AUDIT_SCHEDULE_ID: Es el ID del programa de auditoría. Por ejemplo: my-schedule-id. Para encontrar el ID de un programa existente, consulta la página Administración de auditorías en la consola de Google Cloud .
FRAMEWORK: Es el ID del framework con el que se realizará la auditoría. Por ejemplo: builtin-cis-v8. Para encontrar el ID de un framework, consulta la página Ver evaluaciones en la consola de Google Cloud .
AUDIT_REPORT_FORMAT: Es el formato del informe de auditoría de salida. Solo se admite el formato OpenDocument (ODF): odf.
BUCKET_URI: Es el URI del bucket de Cloud Storage. Por ejemplo: gs://testbucketauditmanager.
FREQUENCY: Es la frecuencia de las ejecuciones de auditoría programadas. Los valores válidos son daily, weekly, monthly, quarterly y annually. Por ejemplo: weekly.
SCHEDULE_START_TIME: Es la fecha y hora en que comienza la primera ejecución de auditoría, en formato RFC 3339. Por ejemplo: 2026-10-25T10:00:00Z.
DISPLAY_NAME: es opcional. Un nombre visible para el programa de auditoría. Por ejemplo: NIST 800-53 Weekly Audit
SCHEDULE_END_TIME: Opcional. Es la fecha y hora en que se detiene el programa de auditoría, en formato RFC 3339. Por ejemplo: 2027-10-25T10:00:00Z.
TIME_ZONE: es opcional. Es la zona horaria de la programación de auditoría en formato IANA. El Administrador de auditorías usa este valor para interpretar la hora de inicio y la hora de finalización. Si no se especifica, el valor predeterminado es UTC. Por ejemplo: America/New_York.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

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

Deberías recibir una respuesta similar a la que figura a continuación:

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

Opcional: Genera una evaluación de auditoría

Antes de ejecutar una auditoría, puedes generar una evaluación o un alcance de la auditoría, que incluya un desglose detallado de las tareas de la auditoría según el framework que elijas.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organizations, folders y projects.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
FRAMEWORK: Es el ID del framework con el que se realizará la auditoría. Por ejemplo: builtin-cis-v8. Para encontrar el ID de un framework, consulta la página Ver evaluaciones en la consola de Google Cloud .
AUDIT_REPORT_FORMAT: Es el formato del informe de auditoría de salida. Solo se admite el formato ODF: AUDIT_REPORT_FORMAT_ODF.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:


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

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{

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

La respuesta incluye la siguiente información:

scope_report_contents: Es el formato de bytes del contenido del informe, que debes convertir al formato OpenDocument (ODF) antes de revisarlo.
name: Es un identificador de cadena único del recurso aplicable.

Ejecuta una auditoría a pedido

Para ejecutar una auditoría a pedido, envía una solicitud POST al extremo auditReport:generate.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organizations, folders y projects.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
FRAMEWORK: Es el ID del framework con el que se realizará la auditoría. Por ejemplo: builtin-cis-v8. Para encontrar el ID de un framework, consulta la página Ver evaluaciones en la consola de Google Cloud .
BUCKET_URI: Es el URI del bucket de Cloud Storage. Por ejemplo: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: Es el formato del informe de auditoría de salida. Solo se admite el formato ODF: AUDIT_REPORT_FORMAT_ODF.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:


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

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

La respuesta incluye la siguiente información:

name: Es un identificador de cadena único para la solicitud de operación de evaluación de auditoría. Usa este identificador para hacer un seguimiento del progreso de la evaluación de auditoría. Por ejemplo: projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID
done: Es una marca booleana que indica si se completó la evaluación de la auditoría. Esta marca se establece en false cuando se inicia el proceso y cambia a true cuando se completa la evaluación de la auditoría.

Programa una auditoría

Para programar una auditoría recurrente, envía una solicitud POST al extremo auditSchedules.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organizations, folders y projects.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
AUDIT_SCHEDULE_ID: Es el ID del programa de auditoría. Por ejemplo: my-schedule-id. Para encontrar el ID de un programa existente, consulta la página Administración de auditorías en la consola de Google Cloud .
FRAMEWORK: Es el ID del framework con el que se realizará la auditoría. Por ejemplo: builtin-cis-v8. Para encontrar el ID de un framework, consulta la página Ver evaluaciones en la consola de Google Cloud .
BUCKET_URI: Es el URI del bucket de Cloud Storage. Por ejemplo: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: Es el formato del informe de auditoría de salida. Solo se admite el formato ODF: AUDIT_REPORT_FORMAT_ODF.
FREQUENCY: Es la frecuencia de las ejecuciones de auditoría programadas. Los valores válidos son DAILY, WEEKLY, MONTHLY, QUARTERLY y ANNUALLY. Por ejemplo: WEEKLY.
SCHEDULE_START_TIME: Es la fecha y hora en que comienza la primera ejecución de auditoría, en formato RFC 3339. Por ejemplo: 2026-10-25T10:00:00Z.
DISPLAY_NAME: es opcional. Un nombre visible para el programa de auditoría. Por ejemplo: NIST 800-53 Weekly Audit
SCHEDULE_END_TIME: Opcional. Es la fecha y hora en que se detiene el programa de auditoría, en formato RFC 3339. Por ejemplo: 2027-10-25T10:00:00Z.
TIME_ZONE: es opcional. Es la zona horaria de la programación de auditoría en formato IANA. El Administrador de auditorías usa este valor para interpretar la hora de inicio y la hora de finalización. Si no se especifica, el valor predeterminado es UTC. Por ejemplo: America/New_York.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Cómo ver las auditorías programadas

Puedes ver detalles sobre tus auditorías programadas, incluidos el alcance, el framework y la configuración de la programación.

Console

En la consola de Google Cloud , ve a la página Administración de auditorías en Audit Manager.

Ir al Gestor de auditorías
En la pestaña Programaciones, consulta la lista de auditorías programadas.

gcloud

Visualiza una lista de auditorías programadas

Para ver una lista de las auditorías programadas, ejecuta el comando gcloud audit-manager audit-schedules list.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organization, folder y project.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Deberías recibir una respuesta similar a la que figura a continuación:

┌────────────┬────────────┬──────────────┬────────────┬────────────┬───────────────┬─────────────────┬─────────────┬─────────────┬───────────────┬───────────────────┬───────────────┐
│     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'}        │             │             │               │                   │               │
└────────────┴────────────┴──────────────┴────────────┴────────────┴───────────────┴─────────────────┴─────────────┴─────────────┴───────────────┴───────────────────┴───────────────┘

Consulta los detalles de una auditoría programada

Para ver los detalles de una auditoría programada específica, ejecuta el comando gcloud audit-manager audit-schedules describe.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organizations, folders y projects.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
AUDIT_SCHEDULE_ID: Es el ID del programa de auditoría. Por ejemplo: my-schedule-id. Para encontrar el ID de un programa existente, consulta la página Administración de auditorías en la consola de Google Cloud .

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Deberías recibir una respuesta similar a la que figura a continuación:

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

Visualiza una lista de auditorías programadas

Para ver una lista de las auditorías programadas, envía una solicitud GET al extremo auditSchedules.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organizations, folders y projects.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

PowerShell

Ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Consulta los detalles de una auditoría programada

Para ver los detalles de una auditoría programada específica, envía una solicitud GET al extremo auditSchedules y especifica el ID de la programación.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organizations, folders y projects.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
AUDIT_SCHEDULE_ID: Es el ID del programa de auditoría. Por ejemplo: my-schedule-id. Para encontrar el ID de un programa existente, consulta la página Administración de auditorías en la consola de Google Cloud .

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

Ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Actualiza las auditorías programadas

Puedes pausar, reanudar y detener las auditorías recurrentes. Para cambiar un programa, debes borrar la auditoría programada existente y, luego, crear una nueva.

Console

En la consola de Google Cloud , ve a la página Administración de auditorías en Audit Manager.

Ir al Gestor de auditorías
En la pestaña Programaciones, busca la auditoría programada que quieres actualizar.
Realiza una de las siguientes acciones:
- Para pausar un programa de auditoría, haz clic en Pausar programa.
- Para reiniciar una auditoría que pausaste, haz clic en Reanudar programa.
- Para borrar una auditoría programada, haz clic en Detener programa.

gcloud

Para pausar, reanudar o borrar un programa de auditoría, ejecuta el comando gcloud audit-manager audit-schedules update para actualizar el estado del programa.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organizations, folders y projects.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
AUDIT_SCHEDULE_ID: Es el ID del programa de auditoría. Por ejemplo: my-schedule-id. Para encontrar el ID de un programa existente, consulta la página Administración de auditorías en la consola de Google Cloud .
SCHEDULE_STATE: Es el estado de destino para el programa de auditoría. Configúralo con uno de los siguientes valores:
- paused: para pausar un programa activo.
- active: para reanudar un programa en pausa.
- deleted: para detener y borrar un programa.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Deberías recibir una respuesta similar a la que figura a continuación:

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

Para pausar, reanudar o borrar un programa de auditoría, envía una solicitud PATCH para actualizar el campo state del programa de auditoría.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

RESOURCE_TYPE: Es el tipo de recurso. Los valores válidos son organizations, folders y projects.
RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones del Administrador de auditorías. Por ejemplo: us-central1.
AUDIT_SCHEDULE_ID: Es el ID del programa de auditoría. Por ejemplo: my-schedule-id. Para encontrar el ID de un programa existente, consulta la página Administración de auditorías en la consola de Google Cloud .
SCHEDULE_STATE: Es el estado de destino para el programa de auditoría. Configúralo con uno de los siguientes valores:
- SCHEDULE_STATE_PAUSED: para pausar un programa activo.
- SCHEDULE_STATE_ACTIVE: para reanudar un programa en pausa.
- SCHEDULE_STATE_DELETED: para detener y borrar un programa.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "state": "SCHEDULE_STATE"
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Cómo programar o ejecutar una auditoría Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Programa y ejecuta una auditoría

Console

gcloud

Opcional: Genera una evaluación de auditoría

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Ejecuta una auditoría a pedido

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Programa una auditoría

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

Opcional: Genera una evaluación de auditoría

curl

PowerShell

Ejecuta una auditoría a pedido

curl

PowerShell

Programa una auditoría

curl

PowerShell

Cómo ver las auditorías programadas

Console

gcloud

Visualiza una lista de auditorías programadas

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Consulta los detalles de una auditoría programada

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

Visualiza una lista de auditorías programadas

curl

PowerShell

Consulta los detalles de una auditoría programada

curl

PowerShell

Actualiza las auditorías programadas

Console

gcloud

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

¿Qué sigue?

Cómo programar o ejecutar una auditoría