A partire dal 10 aprile 2026, Dataplex Universal Catalog si chiama Knowledge Catalog. I nomi di API, libreria client, CLI e IAM rimangono invariati. Per ulteriori informazioni, consulta Presentazione di Google Cloud Knowledge Catalog.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Gestire le richieste di modifica con i flussi di lavoro di governance

Questo documento descrive in che modo i richiedenti, gli approvatori e gli amministratori del flusso di lavoro gestiscono le richieste di governance in Knowledge Catalog.

Prima di iniziare

Per utilizzare i flussi di lavoro di governance, assicurati di aver attivato le API richieste e che gli approvatori e gli amministratori dispongano dei ruoli e delle autorizzazioni IAM (Identity and Access Management) necessari.

Abilitare l'API Dataplex.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

Abilitare l'API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare i flussi di lavoro di governance, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

Cerca prodotti di dati: Dataplex Catalog Viewer (roles/dataplex.catalogViewer)
Cerca asset di dati e richiedi l'accesso: Dataplex Data Products Consumer (roles/dataplex.dataProductsConsumer)
Accesso di sola lettura per visualizzare le definizioni e i metadati dei prodotti di dati: Dataplex Data Products Viewer (roles/dataplex.dataProductsViewer)
Approva le richieste di accesso al prodotto di dati:
- Dataplex Data Products Editor (roles/dataplex.dataProductsEditor)
- Amministratore Dataplex Data Products (roles/dataplex.dataProductsAdmin)
- Dataplex Workflow Approver (roles/dataplex.workflowApprover)
Amministrare i workflow di governance: Dataplex Workflow Admin (roles/dataplex.workflowAdmin)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più, consulta Ruoli IAM di Knowledge Catalog.

Gestire le richieste come richiedente

In qualità di richiedente, avvii le richieste di modifica, ad esempio la richiesta di accesso ai prodotti di dati. Dopo aver inviato una richiesta, puoi monitorarne l'avanzamento, visualizzare i dettagli, modificare quelli delle richieste in attesa nello stato NEW o eliminare le richieste prima che vengano esaminate da un approvatore.

Visualizzare le richieste create

Per elencare tutte le richieste che hai creato:

Console

Nella console Google Cloud , vai alla pagina Workflow di governance di Knowledge Catalog.

Vai a Workflow di governance
Fai clic sulla scheda Le mie richieste per visualizzare un elenco di tutte le tue richieste passate e in attesa.

REST

Visualizzare le richieste create

Per visualizzare un elenco delle richieste che hai creato:

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l'ID del tuo Google Cloud progetto.
LOCATION: la regione in cui esiste la risorsa (ad esempio us-central1).
USER_EMAIL: il tuo indirizzo email.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo 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: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Visualizzare una richiesta specifica

Per visualizzare una richiesta specifica:

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l'ID del tuo Google Cloud progetto.
LOCATION: la regione in cui esiste la risorsa (ad esempio us-central1).
CHANGE_REQUEST_ID: l'ID della richiesta.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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/CHANGE_REQUEST_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/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": "user@example.com",
  "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"
    }
  }
}

Modificare una richiesta

Puoi aggiornare i dettagli di una richiesta in attesa esistente nello stato NEW. Ad esempio, puoi modificare la motivazione fornita nella richiesta.

REST

Per modificare una richiesta, invia una richiesta PATCH contenente il campo modificato:

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l'ID del tuo Google Cloud progetto.
LOCATION: la regione in cui esiste la risorsa (ad esempio us-central1).
CHANGE_REQUEST_ID: l'ID univoco della richiesta di modifica.
NEW_JUSTIFICATION: la motivazione aggiornata per la richiesta di modifica.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "justification": "NEW_JUSTIFICATION"
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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/LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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/LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.

Eliminare una richiesta

Puoi eliminare solo le richieste nello stato NEW. Per eliminare una richiesta:

Console

Nella console Google Cloud , vai alla pagina Workflow di governance di Knowledge Catalog.

Vai a Workflow di governance
Fai clic sulla scheda Le mie richieste.
Individua la riga contenente la richiesta di targeting. Se necessario, applica un filtro per isolare la voce.
Fai clic su Azioni e poi su Elimina.

REST

Per eliminare una richiesta, invia una richiesta DELETE che includa l'ID richiesta:

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l'ID del tuo Google Cloud progetto.
LOCATION: la regione in cui esiste la risorsa (ad esempio us-central1).
CHANGE_REQUEST_ID: l'ID della richiesta che vuoi eliminare.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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/LOCATION/changeRequests/CHANGE_REQUEST_ID" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.

Gestire le richieste come approvatore

In qualità di approvatore, esamini, valuti e agisci in base alle richieste di governance in attesa inviate per le tue risorse di dati. Quando approvi o rifiuti una richiesta, il sistema elabora automaticamente la decisione e invia una notifica via email al richiedente contenente i dettagli della decisione e la tua motivazione.

Elenca le richieste in attesa

Per elencare le richieste in attesa di revisione:

Console

Nella console Google Cloud , vai alla pagina Workflow di governance di Knowledge Catalog.

Vai a Workflow di governance
Fai clic sulla scheda Approvazioni in attesa per visualizzare le richieste in attesa di revisione. Puoi filtrare le richieste per tipo di risorsa, tipo di richiesta o data.

REST

Per elencare le richieste di accesso in attesa di revisione all'interno di un progetto e di una località specifici, invia una richiesta GET:

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l'ID del tuo Google Cloud progetto.
LOCATION: la regione in cui esiste la risorsa. Ad esempio, us-central1.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo comando:

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

Invoke-WebRequest `
    -Method GET `

Gestire le richieste di modifica con i flussi di lavoro di governance Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Ruoli obbligatori

Gestire le richieste come richiedente

Visualizzare le richieste create

Console

REST

Visualizzare le richieste create

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Visualizzare una richiesta specifica

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Modificare una richiesta

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Eliminare una richiesta

Console

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Gestire le richieste come approvatore

Elenca le richieste in attesa

Console

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Gestire le richieste di modifica con i flussi di lavoro di governance