Solicita cambios en los metadatos con flujos de trabajo de administración

En este documento, se describe cómo proponer cambios de un solo recurso en las categorías y los términos del glosario empresarial, así como en las entradas de Knowledge Catalog (anteriormente, Dataplex Universal Catalog), con flujos de trabajo de administración.

Antes de comenzar

Para usar los flujos de trabajo de administración para los cambios de metadatos, asegúrate de haber habilitado las APIs requeridas y de tener los roles y permisos necesarios de Identity and Access Management (IAM).

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 más información para otorgar roles.

Habilitar la API

Roles obligatorios

Para obtener los permisos que necesitas para solicitar cambios en los metadatos, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto, glosario o grupo de entradas:

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 sobre los roles y los permisos, consulta Roles de IAM de Knowledge Catalog.

Solicita cambios para una categoría del glosario

Si no tienes acceso de escritura directo para crear, actualizar o borrar una categoría de glosario, puedes solicitar ese cambio con los flujos de trabajo de administración. Después de que se envía una solicitud de cambio de metadatos, los solicitantes, los aprobadores y los administradores del flujo de trabajo pueden supervisar y administrar la solicitud durante todo su ciclo de vida.

Crea una categoría

Console

Sigue estos pasos para solicitar una categoría:

  1. En la consola de Google Cloud , ve a la página Glosarios de Knowledge Catalog.

    Ir a Glosarios

  2. Selecciona el glosario en el que deseas crear una categoría y, luego, haz clic en Crear categoría.

  3. Ingresa un Nombre visible para la categoría.

  4. Opcional: En la sección Etiquetas, agrega etiquetas para el glosario.

  5. Opcional: En la sección Justificación, proporciona al responsable de aprobación un motivo para el cambio.

  6. En la sección Configuración avanzada, puedes editar el ID de categoría si quieres cambiar el ID generado de forma automática.

  7. Haz clic en Enviar para revisión.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar la creación de una categoría, usa el método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createCategoryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "categoryId": "sample-category-id",
      "category": {
        "displayName": "Sample category name",
        "description": "Sample category description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el glosario, como us-central1.
  • GLOSSARY_ID: Es el ID del glosario superior.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Cómo actualizar una categoría

Console

Sigue estos pasos para sugerir cambios en una categoría:

  1. En la consola de Google Cloud , ve a la página Glosarios de Knowledge Catalog.

    Ir a Glosarios

  2. Selecciona el glosario que incluye la categoría que quieres actualizar.

  3. Haz clic en el nombre de la categoría para abrir el panel Detalles de la categoría.

  4. Para agregar o actualizar los detalles de la categoría, haz clic en Agregar o Editar junto a la sección que deseas actualizar.

  5. Haz clic en Enviar para revisión. Es posible que algunos elementos requieran una justificación adicional para el cambio. Proporciona la justificación y haz clic en Continuar para enviar los cambios.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar una actualización del nombre visible y la descripción de una categoría, usa el método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateCategoryRequest": {
      "category": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el glosario, como us-central1.
  • GLOSSARY_ID: Es el ID del glosario superior.
  • CATEGORY_ID: Es el ID de la categoría de destino que deseas actualizar.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Borrar una categoría

Console

Sigue estos pasos para solicitar que se borre una categoría:

  1. En la consola de Google Cloud , ve a la página Glosarios de Knowledge Catalog.

    Ir a Glosarios

  2. Expande el glosario y haz clic en la categoría que quieres borrar.

  3. En el panel Detalles de la categoría, selecciona Borrar en el menú.

  4. Opcional: En la sección Justificación, proporciona al aprobador el motivo del cambio.

  5. Haz clic en Enviar para revisión.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar que se borre una categoría, usa el método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteCategoryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el glosario, como us-central1.
  • GLOSSARY_ID: Es el ID del glosario superior.
  • CATEGORY_ID: Es el ID de la categoría de destino que deseas borrar.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Solicita cambios para un término del glosario

Si no tienes acceso de escritura directo para crear, actualizar o borrar un término del glosario, puedes solicitar ese cambio con los flujos de trabajo de administración.

Crea un término del glosario

Console

Sigue estos pasos para solicitar la creación de un término del glosario:

  1. En la consola de Google Cloud , ve a la página Glosarios de Knowledge Catalog.

    Ir a Glosarios

  2. Selecciona el glosario o la categoría en la que deseas crear un término para abrir el panel de detalles.

    • Si creas un término desde la página de detalles del glosario, selecciona Crear término en el menú.
    • Si creas un término desde la página de detalles de la categoría, selecciona Agregar término en el menú.

  3. Ingresa un Nombre visible para la categoría.

  4. Opcional: En la sección Etiquetas, agrega etiquetas para el término.

  5. Opcional: En la sección Justificación, proporciona al responsable de aprobación un motivo para el cambio.

  6. En la sección Configuración avanzada, puedes editar el ID del término si quieres cambiar el ID generado de forma automática.

  7. Haz clic en Enviar para revisión.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar la creación de un término del glosario, usa el método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createTermRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "termId": "sample-term-id",
      "term": {
        "displayName": "Sample term name",
        "description": "Sample term description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el glosario, como us-central1.
  • GLOSSARY_ID: Es el ID del glosario superior.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Actualiza un término del glosario

Console

Sigue estos pasos para solicitar cambios en un término del glosario:

  1. En la consola de Google Cloud , ve a la página Glosarios de Knowledge Catalog.

    Ir a Glosarios

  2. Selecciona el glosario que incluye el término que quieres actualizar.

  3. Haz clic en el nombre del término para abrir el panel Detalles del término.

  4. Para agregar o actualizar los detalles de las condiciones, haz clic en Agregar o Editar junto a la sección que quieras actualizar.

  5. Haz clic en Enviar para revisión. Es posible que algunas secciones requieran que proporciones una justificación adicional antes de enviar la solicitud. Proporciona la justificación y haz clic en Continuar para enviar los cambios.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar una actualización del nombre visible y la descripción de un término del glosario, usa el método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateTermRequest": {
      "term": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el glosario, como us-central1.
  • GLOSSARY_ID: Es el ID del glosario superior.
  • TERM_ID: Es el ID del término de destino que deseas actualizar.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Borra un término del glosario

Console

Sigue estos pasos para solicitar que se borre un término:

  1. En la consola de Google Cloud , ve a la página Glosarios de Knowledge Catalog.

    Ir a Glosarios

  2. Selecciona el glosario que incluye el término que quieres borrar.

  3. Haz clic en el nombre del término para abrir el panel Detalles del término.

  4. Haz clic en Borrar.

  5. Haz clic en Enviar para revisión. Es posible que algunas secciones requieran que proporciones una justificación adicional antes de enviar la solicitud. Proporciona la justificación y haz clic en Continuar para enviar los cambios.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar que se borre un término del glosario, usa el método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteTermRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el glosario, como us-central1.
  • GLOSSARY_ID: Es el ID del glosario superior.
  • TERM_ID: Es el ID del término de destino que deseas borrar.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve un RequestGlossaryChangeResponse que contiene el nombre del recurso de ChangeRequest.El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Solicita cambios para una entrada

Si no tienes acceso de escritura directo para crear, modificar o borrar una entrada de Knowledge Catalog, puedes solicitar ese cambio con los flujos de trabajo de administración.

Crea una entrada

Console

Sigue estos pasos para solicitar la creación de una entrada:

  1. En la consola de Google Cloud , ve a la página Tipos de metadatos de Knowledge Catalog.

    Ir a Tipos de metadatos

  2. Haz clic en la pestaña Grupos de entrada.

  3. Selecciona el grupo de entradas en el que deseas crear una entrada y, luego, haz clic en Crear entrada.

  4. Ingresa un ID y un nombre visible para la entrada.

  5. Selecciona un tipo de entrada.

  6. Opcional: Proporciona detalles del aspecto o agrega una descripción.

  7. Haz clic en Enviar para revisión. Es posible que algunas secciones requieran que proporciones una justificación adicional antes de enviar la solicitud. Proporciona la justificación y haz clic en Continuar para enviar los cambios.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar la creación de una entrada, usa el método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryId": "sample-entry-id",
      "entry": {
        "entryType": "projects/PROJECT_ID/locations/LOCATION/entryTypes/ENTRY_TYPE_ID",
        "entrySource": {
          "displayName": "Sample entry name",
          "description": "Sample entry description"
        }
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el grupo de entradas, como us-central1.
  • ENTRY_GROUP_ID: Es el ID del grupo de entradas superior.
  • ENTRY_TYPE_ID: Es el ID del tipo de entrada.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Actualiza una entrada

Console

Sigue estos pasos para solicitar actualizaciones de una entrada:

  1. En la consola de Google Cloud , ve a la página Búsqueda o Catálogo de Knowledge Catalog.

Ir a Búsqueda

  1. Busca y selecciona la entrada que quieras actualizar.
  2. Haz clic en la entrada para abrir la página Detalles de la entrada.
  3. Haz clic en Agregar junto a la sección que quieras actualizar.
  4. Actualiza la sección.
  5. Haz clic en Enviar para revisión. Es posible que algunas secciones requieran que proporciones una justificación adicional antes de enviar la solicitud. Proporciona la justificación y haz clic en Continuar para enviar los cambios.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar una actualización del nombre visible y la descripción de una fuente de entrada, usa el método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "entrySource": {
          "displayName": "Sample new name",
          "description": "Sample new description"
        }
      },
      "updateMask": {
        "paths": [
          "entry_source.display_name",
          "entry_source.description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el grupo de entradas, como us-central1.
  • ENTRY_GROUP_ID: Es el ID del grupo de entradas superior.
  • ENTRY_ID: Es el ID de la entrada de destino.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Borra una entrada

Console

Sigue estos pasos para solicitar que se borre una entrada:

  1. En la consola de Google Cloud , ve a la página Búsqueda o Catálogo de Knowledge Catalog.

Ir a Búsqueda

  1. Busca y selecciona la entrada que quieras borrar.
  2. Haz clic en la entrada para abrir la página Detalles de la entrada.
  3. Haz clic en Borrar.
  4. Haz clic en Enviar para revisión. Es posible que algunas secciones requieran que proporciones una justificación adicional antes de enviar la solicitud. Proporciona la justificación y haz clic en Continuar para enviar los cambios.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar que se borre una entrada, usa el método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el grupo de entradas, como us-central1.
  • ENTRY_GROUP_ID: Es el ID del grupo de entradas superior.
  • ENTRY_ID: Es el ID de la entrada de destino que deseas borrar.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Actualiza un aspecto

Console

Sigue estos pasos para solicitar actualizaciones de un aspecto:

  1. En la consola de Google Cloud , ve a la página Búsqueda de Knowledge Catalog.

Ir a Búsqueda

  1. Busca y selecciona la entrada para la que quieres solicitar el cambio.
  2. Haz clic en la entrada para abrir la página Detalles de la entrada.
  3. Ve a la sección Aspectos y haz clic en Agregar.
  4. Proporciona detalles del aspecto.
  5. Opcional: Proporciona la justificación del cambio.
  6. Haz clic en Enviar para revisión.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar que se adjunte o actualice un aspecto de Contactos en una entrada, usa el método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "aspects": {
          "dataplex-types.global.contacts": {
            "data": {
              "identities": [
                {
                  "role": "Data Steward",
                  "name": "Dana",
                  "id": "dana@example.com"
                }
              ]
            }
          }
        }
      },
      "updateMask": {
        "paths": [
          "aspects"
        ]
      },
      "aspectKeys": [
        "dataplex-types.global.contacts"
      ]
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el grupo de entradas, como us-central1.
  • ENTRY_GROUP_ID: Es el ID del grupo de entradas superior.
  • ENTRY_ID: Es el ID de la entrada de destino.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Crea un vínculo de entrada

Console

Sigue estos pasos para solicitar la creación de un vínculo de entrada, por ejemplo, para adjuntar un término del glosario:

  1. En la consola de Google Cloud , ve a la página Búsqueda de Knowledge Catalog.

    Ir a Búsqueda

  2. Busca y selecciona la entrada del recurso de datos a la que deseas vincular un término.

  3. En la página de detalles de la entrada, realiza una de las siguientes acciones:

    • Para vincular un término a la entrada, en la pestaña Detalles, en la sección Términos del glosario, haz clic en Agregar.
    • Para vincular un término a una columna, en la pestaña Esquema, selecciona la columna y haz clic en Agregar término empresarial.

  4. Busca y selecciona el término que quieras vincular.

  5. Opcional: Proporciona una justificación para el cambio.

  6. Haz clic en Enviar para revisión.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar la creación de un vínculo de definición entre un término del glosario y una entrada de recurso de datos, usa el método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryLinkRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryLinkId": "sample-definition-link",
      "entryLink": {
        "entryLinkType": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
        "entryReferences": [
          {
            "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
            "type": "SOURCE"
          },
          {
            "name": "projects/PROJECT_ID/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_ID/locations/global/glossaries/GLOSSARY_ID/terms/TERM_ID",
            "type": "TARGET"
          }
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el grupo de entradas, como us-central1.
  • ENTRY_GROUP_ID: Es el ID del grupo de entradas superior.
  • ENTRY_ID: Es el ID de la entrada de destino.
  • GLOSSARY_ID: Es el ID del glosario que contiene el término.
  • TERM_ID: Es el ID del término del glosario.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

Borra un vínculo de entrada

Console

Sigue estos pasos para solicitar que se borre un vínculo de entrada, por ejemplo, para quitar un término del glosario adjunto:

  1. En la consola de Google Cloud , ve a la página Búsqueda de Knowledge Catalog.

    Ir a Búsqueda

  2. Busca y selecciona la entrada del recurso de datos de la que deseas quitar un término vinculado.

  3. En la página de detalles de la entrada, realiza una de las siguientes acciones:

    • Para quitar un término de la entrada, en la pestaña Detalles, en la sección Términos del glosario, haz clic en el término y, luego, en Quitar.
    • Para quitar un término de una columna, en la pestaña Esquema, haz clic en Quitar junto al término.

  4. Opcional: Proporciona una justificación para el cambio.

  5. Haz clic en Enviar para revisión.

El sistema registra una nueva solicitud de cambio y notifica al aprobador. Puedes hacer un seguimiento del progreso de la solicitud en la página Flujos de trabajo de administración, en la pestaña Mis solicitudes.

REST

Para solicitar que se borre un vínculo de entrada entre un término del glosario y una entrada de recurso de datos, usa el método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryLinkRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que existe el grupo de entradas, como us-central1.
  • ENTRY_GROUP_ID: Es el ID del grupo de entradas superior.
  • ENTRY_LINK_ID: Es el ID del vínculo de entrada de destino que deseas borrar.
  • JUSTIFICATION: Es una explicación de por qué propones el cambio.

El servicio devuelve una respuesta que contiene el nombre del recurso de la solicitud de cambio. El sistema registra una nueva solicitud de cambio y notifica al aprobador.

¿Qué sigue?