Administra las solicitudes de cambio con flujos de trabajo de gobernanza

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Los flujos de trabajo de administración en Knowledge Catalog te permiten hacer un seguimiento, evaluar y auditar las solicitudes de cambio, como las solicitudes de acceso a productos de datos, durante todo su ciclo de vida. Como solicitante, responsable de aprobación o administrador de flujos de trabajo, puedes modificar las solicitudes pendientes, aprobar o rechazar el acceso para automatizar el aprovisionamiento y supervisar los registros de aprobación para garantizar el cumplimiento.

Antes de comenzar

Para usar los flujos de trabajo de administración, asegúrate de haber habilitado las APIs necesarias y de que los aprobadores y administradores tengan los roles y permisos de Identity and Access Management (IAM) necesarios.

Habilita la API de Dataplex si aún no está habilitada.

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

Habilitar la API

Roles obligatorios

Para obtener los permisos que necesitas para usar los flujos de trabajo de administración, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

• Buscar productos de datos: Visualizador del catálogo de Dataplex (roles/dataplex.catalogViewer)
• Busca recursos de datos y solicita acceso: Consumidor de productos de datos de Dataplex (roles/dataplex.dataProductsConsumer)
• Acceso de solo lectura para ver las definiciones y los metadatos de los productos de datos: Visualizador de productos de datos de Dataplex (roles/dataplex.dataProductsViewer)
• Aprueba las solicitudes de acceso a productos de datos:
  • Editor de productos de datos de Dataplex (roles/dataplex.dataProductsEditor)
  • Administrador de productos de datos de Dataplex (roles/dataplex.dataProductsAdmin)
  • Responsable de aprobación de flujos de trabajo de Dataplex (roles/dataplex.workflowApprover)
• Administra los flujos de trabajo de administración: Administrador de flujos de trabajo de Dataplex (roles/dataplex.workflowAdmin)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener más información, consulta Roles de IAM de Knowledge Catalog.

Administra solicitudes como solicitante

Como solicitante, inicias solicitudes de cambio, como solicitar acceso a productos de datos. Después de enviar una solicitud, puedes supervisar su progreso, ver sus detalles, editar los detalles de las solicitudes pendientes en el estado NEW o borrar las solicitudes antes de que un responsable de aprobación las aborde.

Ver solicitudes creadas

Para ver una lista de todas las solicitudes que creaste, sigue estos pasos:

Console

1. En la consola de Google Cloud , ve a la página Flujos de trabajo de administración de Knowledge Catalog.

   Ir a Flujos de trabajo de administración

2. Haz clic en la pestaña Mis solicitudes para ver una lista con todas tus solicitudes anteriores y pendientes.

REST

Ver solicitudes creadas

Para obtener una lista de las solicitudes que creaste, sigue estos pasos:

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

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
• LOCATION: Es la región en la que existe el recurso (por ejemplo, us-central1).
• USER_EMAIL: el dirección de correo electrónico

Método HTTP y URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests?filter=author=USER_EMAIL

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI 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 gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests?filter=author=USER_EMAIL"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI 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.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests?filter=author=USER_EMAIL" | Select-Object -Expand Content

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

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/changeRequests/sample-change-request-1",
      "uid": "123e4567-e89b-12d3-a456-426614174000",
      "createTime": "2026-07-20T10:00:00Z",
      "updateTime": "2026-07-20T10:00:00Z",
      "justification": "Proposing a new glossary term definition for business accuracy.",
      "author": "USER_EMAIL",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Cómo ver una solicitud específica

Para ver una solicitud específica, haz lo siguiente:

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

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
• LOCATION: Es la región en la que existe el recurso (por ejemplo, us-central1).
• CHANGE_REQUEST_ID: Es el ID de la solicitud.

Método HTTP y URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI 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 gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI 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.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID",
  "uid": "123e4567-e89b-12d3-a456-426614174000",
  "createTime": "2026-07-20T10:00:00Z",
  "updateTime": "2026-07-20T10:00:00Z",
  "justification": "Proposing a new glossary term definition for business accuracy.",
  "author": "[e-mail]",
  "state": "NEW",
  "resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
  "createGlossaryTerm": {
    "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
    "termId": "sample-term-id",
    "term": {
      "displayName": "Sample term name",
      "description": "Sample term description",
      "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
    }
  }
}

Cómo editar una solicitud

Puedes actualizar los detalles de una solicitud pendiente existente en el estado NEW. Por ejemplo, puedes cambiar la justificación que se proporciona en la solicitud.

REST

Para editar una solicitud, envía una solicitud PATCH que contenga el campo modificado:

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

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
• LOCATION: Es la región en la que existe el recurso (por ejemplo, us-central1).
• CHANGE_REQUEST_ID: Es el ID único de la solicitud de cambio.
• NEW_JUSTIFICATION: Es la justificación actualizada de la solicitud de cambio.

Método HTTP y URL:

PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification

Cuerpo JSON de la solicitud:

{
  "justification": "NEW_JUSTIFICATION"
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI 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 gcloud CLI . 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 PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI 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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification" | Select-Object -Expand Content

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Borra una solicitud

Solo puedes borrar las solicitudes que se encuentren en el estado NEW. Para borrar una solicitud, sigue estos pasos:

Console

1. En la consola de Google Cloud , ve a la página Flujos de trabajo de administración de Knowledge Catalog.

   Ir a Flujos de trabajo de administración

2. Haz clic en la pestaña Mis solicitudes.

3. Busca la fila que contiene la solicitud de destino. Si es necesario, aplica un filtro para aislar la entrada.

4. Haz clic en Acciones y, luego, en Borrar.

REST

Para borrar una solicitud, envía una solicitud DELETE que incluya el ID de la solicitud:

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

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
• LOCATION: Es la región en la que existe el recurso (por ejemplo, us-central1).
• CHANGE_REQUEST_ID: Es el ID de la solicitud que deseas borrar.

Método HTTP y URL:

DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI 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 gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI 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.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID" | Select-Object -Expand Content

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Administra solicitudes como responsable de aprobación

Como aprobador, revisas, evalúas y actúas en función de las solicitudes de administración pendientes que se envían para tus recursos de datos. Cuando apruebas o rechazas una solicitud, el sistema procesa automáticamente la decisión y envía una notificación por correo electrónico al solicitante con los detalles de la decisión y tu justificación.

Enumera las solicitudes pendientes

Para enumerar las solicitudes pendientes de revisión, sigue estos pasos:

Console

1. En la consola de Google Cloud , ve a la página Flujos de trabajo de administración de Knowledge Catalog.

   Ir a Flujos de trabajo de administración

2. Haz clic en la pestaña Aprobaciones pendientes para ver las solicitudes que están pendientes de revisión. Puedes filtrar las solicitudes por tipo de recurso, tipo de solicitud o fecha.

REST

Para enumerar las solicitudes de acceso pendientes de revisión dentro de un proyecto y una ubicación específicos, envía una solicitud GET:

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

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
• LOCATION: Es la región en la que existe el recurso. Por ejemplo, us-central1

Método HTTP y URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI 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 gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI 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.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests" | Select-Object -Expand Content

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

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/sample-change-request-1",
      "uid": "123e4567-e89b-12d3-a456-426614174000",
      "createTime": "2026-07-20T10:00:00Z",
      "updateTime": "2026-07-20T10:00:00Z",
      "justification": "Proposing a new glossary term definition for business accuracy.",
      "author": "[e-mail]",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Cómo aprobar una solicitud

Para aprobar una solicitud, sigue estos pasos:

Console

1. En la consola de Google Cloud , ve a la página Flujos de trabajo de administración de Knowledge Catalog.

   Ir a Flujos de trabajo de administración

2. Haz clic en la pestaña Aprobaciones pendientes.

3. Busca la fila que contiene la solicitud que quieres aprobar.

4. Haz clic en Acciones y, luego, en Aprobar.

REST

Para aprobar una solicitud, envía una solicitud POST al método personalizado :approve:

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

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
• LOCATION: Es la región en la que existe el recurso (por ejemplo, us-central1).
• CHANGE_REQUEST_ID: Es el ID único de la solicitud de cambio que deseas aprobar.

Método HTTP y URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:approve

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI 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 gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:approve"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI 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.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:approve" | Select-Object -Expand Content

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Una vez que se procese, el estado de la solicitud se actualizará automáticamente y la entrada se moverá a la pestaña Registro de aprobaciones.

Cómo rechazar una solicitud

Para rechazar una solicitud, sigue estos pasos:

Console

1. En la consola de Google Cloud , ve a la página Flujos de trabajo de administración de Knowledge Catalog.

   Ir a Flujos de trabajo de administración

2. Haz clic en la pestaña Aprobaciones pendientes.

3. Busca la fila que contiene la solicitud que deseas rechazar.

4. Haz clic en Acciones y, luego, en Rechazar.

5. En el cuadro de diálogo, ingresa una justificación para el rechazo.

6. Haz clic en Rechazar para confirmar.

REST

Para rechazar una solicitud, envía una solicitud POST al método personalizado :reject junto con una carga útil de justificación:

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

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
• LOCATION: Es la región en la que existe el recurso (por ejemplo, us-central1).
• CHANGE_REQUEST_ID: Es el ID único de la solicitud de cambio que deseas rechazar.
• REJECTION_REASON: Es la justificación del rechazo.

Método HTTP y URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:reject

Cuerpo JSON de la solicitud:

{
  "comment": "REJECTION_REASON"
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI 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 gcloud CLI . 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://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:reject"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI 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://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:reject" | Select-Object -Expand Content

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Proporcionar un comentario de rechazo claro ayuda a los solicitantes a comprender la decisión y definir mejor sus justificaciones de acceso antes de volver a enviar la solicitud.

Administra solicitudes como administrador de flujos de trabajo

Como administrador de flujos de trabajo, supervisas todas las solicitudes de administración en tu organización, supervisas el historial de aprobaciones y garantizas el cumplimiento. Puedes enumerar todas las solicitudes activas y del historial, hacer un seguimiento de los registros de auditoría en todos los estados de las solicitudes (NEW, APPROVED, REJECTED, DELETED) y borrar cualquier solicitud, independientemente de su estado actual.

Ver todas las solicitudes

Para enumerar todas las solicitudes dentro de un proyecto y una ubicación específicos, sigue estos pasos:

REST

Para enumerar todas las solicitudes de acceso dentro de un proyecto y una ubicación específicos, envía una solicitud GET:

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

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
• LOCATION: Es la región en la que existe el recurso. Por ejemplo, us-central1

Método HTTP y URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI 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 gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI 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.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests" | Select-Object -Expand Content

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

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/sample-change-request-1",
      "uid": "123e4567-e89b-12d3-a456-426614174000",
      "createTime": "2026-07-20T10:00:00Z",
      "updateTime": "2026-07-20T10:00:00Z",
      "justification": "Proposing a new glossary term definition for business accuracy.",
      "author": "[e-mail]",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Cómo hacer un seguimiento del historial de aprobaciones

El registro de aprobaciones proporciona visibilidad de auditoría de extremo a extremo para las solicitudes de acceso a productos de datos, lo que permite que los administradores y los equipos de cumplimiento realicen un seguimiento de los cambios y el acceso en todos los estados.

Console

1. En la consola de Google Cloud , ve a la página Flujos de trabajo de administración.

   Ir a Flujos de trabajo de administración

2. Ve a la pestaña Registro de aprobaciones para ver las aprobaciones, los rechazos y los registros de auditoría históricos completados.

REST

Para enumerar todas las solicitudes de un proyecto específico, envía una solicitud GET:

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

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
• LOCATION: Es la región en la que existe el recurso. Por ejemplo, us-central1

Método HTTP y URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI 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 gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI 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.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests" | Select-Object -Expand Content

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

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/sample-change-request-1",
      "uid": "123e4567-e89b-12d3-a456-426614174000",
      "createTime": "2026-07-20T10:00:00Z",
      "updateTime": "2026-07-20T10:00:00Z",
      "justification": "Proposing a new glossary term definition for business accuracy.",
      "author": "[e-mail]",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

¿Qué sigue?

• Obtén más información sobre los flujos de trabajo de administración