Programa y ejecuta 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 con anterioridad.

Si programas una auditoría, solo puedes crear una programación para un marco de trabajo y un recurso específicos si aún no existe una programación activa o en pausa para la combinación de marco de trabajo y recurso.

Antes de comenzar

  • Asegúrate de tener uno de los siguientes roles de IAM:

    • Administrador de Audit Manager (roles/auditmanager.admin)
    • Auditor del Gestor de auditorías (roles/auditmanager.auditor)

  • Asegúrate de que tu organización, proyecto o carpeta se haya inscrito 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

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

    Ir al Gestor de auditorías

  2. 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 se debe auditar.

    2. Elige la ubicación en la que se debe 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.

  3. En la sección Elige una regulación, selecciona el framework con el que deseas auditar tu recurso y haz clic en Siguiente. Para obtener información sobre los frameworks compatibles, consulta Frameworks compatibles.

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

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

  6. En la sección Elige un bucket de almacenamiento, selecciona un bucket de almacenamiento en el que se deben guardar el informe de auditoría y la evidencia, y haz clic en Listo. Si tu bucket no aparece en la lista, pídele al administrador que registre tu recurso con tu bucket de almacenamiento.

  7. Opcional: En la sección Programación, configura cualquiera de las siguientes opciones:

    • Con qué frecuencia se debe repetir la auditoría (diaria, 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.

  8. Para iniciar la auditoría, haz clic en Ejecutar auditoría o Ejecutar auditoría programada.

    Puedes ver el estado de la auditoría en la página Ver evaluaciones.

gcloud

Opcional: Genera una evaluación de auditoría

Antes de ejecutar una auditoría real, puedes generar una evaluación de auditoría (o alcance) que incluya un desglose detallado de las tareas de la auditoría según el marco de trabajo de cumplimiento que elegiste.

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: 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 de Audit Manager. 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 el Administrador de auditorías.
  • 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: 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 de Audit Manager. 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 el Administrador de auditorías.
  • 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

REST

Opcional: Genera una evaluación de auditoría

Antes de ejecutar una auditoría real, puedes generar una evaluación de auditoría (o alcance) que incluya un desglose detallado de las tareas de la auditoría según el marco de trabajo de cumplimiento que elegiste.

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

  • RESOURCE_TYPE: 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 de Audit Manager. 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 el Administrador de auditorías.
  • 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

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

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 tiene la siguiente información:

    El campo scope_reports_contents es el formato de bytes del contenido, que se debe convertir al formato ODF antes de la revisión.

  • name: Es un identificador de cadena único del recurso aplicable.

Ejecuta una auditoría a pedido

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

  • RESOURCE_TYPE: 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 de Audit Manager. 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 el Administrador de auditorías.
  • 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 tiene la siguiente información:

  • name: Es un identificador de cadena único de la solicitud de operación de evaluación de auditoría. Este identificador se usa para hacer un seguimiento del progreso del proceso de evaluación de la auditoría. Por ejemplo: operation/098234.
  • done: Es una marca booleana que se establece en false y que indica que se activó el proceso. Se establece en true cuando se completa la evaluación de auditoría.

Ejecuta una auditoría programada

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

  • RESOURCE_TYPE: 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 de Audit Manager. 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 el Administrador de auditorías.
  • 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.
  • DISPLAY_NAME: Es un nombre para el programa de auditoría. Por ejemplo: NIST 800-53 Daily Audit.
  • SCHEDULE_START_TIME: Es la marca de tiempo en la que se activa el programa de auditoría. Por ejemplo: 2026-02-25T10:00:00Z.
  • SCHEDULE_END_TIME: Es la marca de tiempo en la que se detiene el programa de auditoría. Por ejemplo: 2027-02-25T10:00:00Z.
  • FREQUENCY: la frecuencia de las ejecuciones de auditoría programadas. Puede ser una de las siguientes opciones: DAILY, WEEKLY, MONTHLY, QUARTERLY o ANNUALLY. Por ejemplo: DAILY.
  • TIME_ZONE: Es la zona horaria de la programación de auditoría en formato IANA. Esta variable se usa para interpretar start_time y end_time. Si no se especifica, el valor predeterminado es UTC. Por ejemplo: America/New_York.
  • SCHEDULE_STATE: Es el estado de la programación de auditoría. Puede ser una de las siguientes opciones: SCHEDULE_STATE_ACTIVE, SCHEDULE_STATE_PAUSED o SCHEDULE_STATE_DELETED. Por ejemplo: SCHEDULE_STATE_ACTIVE.
  • AUDIT_SCHEDULE_ID: Es un identificador único para el programa de auditoría.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud:

{
  "display_name": "DISPLAY_NAME",
  "gcs_uri": "BUCKET_URI",
  "compliance_framework": "FRAMEWORK",
  "report_format": "AUDIT_REPORT_FORMAT",
  "schedule_config": {
    "start_time": "SCHEDULE_START_TIME",
    "end_time": "SCHEDULE_END_TIME",
    "frequency": "FREQUENCY",
    "time_zone": "TIME_ZONE"
  },
  "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 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?audit_schedule_id=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?audit_schedule_id=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",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-02-25T13:27:00Z"
}

Actualiza las auditorías programadas

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

Console

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

  2. En la pestaña Programaciones, busca la auditoría programada que quieres actualizar.

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

REST

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

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

  • RESOURCE_TYPE: 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 de Audit Manager. Por ejemplo: us-central1.
  • AUDIT_SCHEDULE_ID: Es el ID del programa de auditoría que se actualizará. Por ejemplo: my-schedule-id.
  • SCHEDULE_STATE: Es el estado de destino de la programación 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",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_PAUSED",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-09-11T18:15:00Z"
}

¿Qué sigue?