Aggiorna modalità dello schema

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

La modalità dello schema definisce se un registro di schemi o un argomento specifico consente modifiche, come la scrittura o la modifica degli schemi.

• I valori supportati per la modalità schema sono Readonly e Readwrite.

• La modalità schema viene gestita come un oggetto JSON contenente coppie chiave-valore. Ad esempio, di seguito è riportato un campione:

  {
    "mode": "READWRITE"
  }
  

• Se non è impostata esplicitamente a livello di registro di schema, la modalità dello schema è impostata per impostazione predefinita su Readwrite.

• Se una modalità dello schema non è specificata esplicitamente a livello di soggetto, eredita il valore dal registro degli schemi.

• Le configurazioni impostate a livello di argomento sostituiscono quelle impostate a livello di registro di schemi.

Per ulteriori informazioni sulla modalità schema, inclusi i relativi valori, vedi Modalità schema.

Ruoli e autorizzazioni richiesti per aggiornare la modalità dello schema

Per ottenere le autorizzazioni necessarie per aggiornare la modalità dello schema per un registro o un argomento di schema, chiedi all'amministratore di concederti il ruolo IAM Editor del registro di schema Managed Kafka (roles/managedkafka.schemaRegistryEditor) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per aggiornare la modalità dello schema per un registro di schema o un argomento. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per aggiornare la modalità dello schema per un registro di schema o un soggetto sono necessarie le seguenti autorizzazioni:

• Concedi la seguente autorizzazione per la risorsa per cui vuoi aggiornare la modalità: managedkafka.mode.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Aggiorna la modalità dello schema per un registro di schemi

Console

Per aggiornare la modalità dello schema per l'intero registro di schemi, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Registri di schemi.

   Vai a Registri di schema

   Viene visualizzato un elenco dei registri di schema nel progetto.

2. Fai clic sul nome del registro dello schema per cui vuoi aggiornare la modalità dello schema.

   Viene visualizzata la pagina Dettagli registro di schemi.

3. Nella sezione principale dei dettagli del registro, individua l'impostazione Modalità schema e fai clic sull'icona Modifica accanto.

   Viene visualizzata la pagina Modalità Modifica schema.

4. Seleziona il valore dal menu a discesa Modalità schema.

   Per ulteriori informazioni su questi valori, vedi Informazioni sulla modalità schema.

5. Fai clic su Salva.

gcloud

Per aggiornare la modalità dello schema per un registro di schemi, utilizza il comando gcloud alpha managed-kafka schema-registries update:

gcloud alpha managed-kafka schema-registries update SCHEMA_REGISTRY_ID \
    --location=LOCATION \
    --mode=MODE_TYPE

• SCHEMA_REGISTRY_ID: l'ID del registro di schemi da aggiornare.
• LOCATION: la regione del registro di schema da aggiornare.
• MODE_TYPE: la nuova modalità dello schema. I valori validi sono:
  • READWRITE
  • READONLY

Esempio:

Per aggiornare la modalità dello schema del registro di schemi test-registry nella regione us-central1 a READONLY, esegui questo comando:

gcloud alpha managed-kafka schema-registries update test-registry \
    --location=us-central1 \
    --mode=READONLY

REST

La richiesta deve essere autenticata con un token di accesso nell'intestazione Authorization. Per ottenere un token di accesso per le Credenziali predefinite dell'applicazione attuali: gcloud auth application-default print-access-token.

Per aggiornare la modalità dello schema, invia una richiesta PUT all'endpoint API REST per il registro degli schemi utilizzando il metodo projects.locations.schemaRegistries.contexts.mode.update.

Aggiornamento della modalità dello schema per il registro di schemi con un contesto predefinito:

PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/mode

Sostituisci i seguenti parametri di percorso:

• PROJECT_ID: il tuo ID progetto Google Cloud.
• LOCATION: la regione in cui esiste il registro degli schemi.
• SCHEMA_REGISTRY_ID: l'ID univoco del registro degli schemi.

Corpo della richiesta:

Includi un oggetto JSON nel corpo della richiesta che specifichi i dettagli della modalità.

{
  "mode": "MODE_TYPE"
}

Sostituisci MODE_TYPE con una delle opzioni di stringa valide per la modalità:

• READWRITE
• READONLY

In caso di esito positivo, l'API restituisce un codice di stato 200 OK e un corpo della risposta contenente la rappresentazione JSON della configurazione della modalità aggiornata.

Per saperne di più, consulta la documentazione dell'API REST.

Aggiornare la modalità dello schema per un soggetto

Console

Per aggiornare la modalità dello schema per un argomento specifico:

1. Nella console Google Cloud , vai alla pagina Registri di schemi.

   Vai a Registri di schema

2. Fai clic sul nome del registro dello schema che contiene l'argomento.

   Viene visualizzata la pagina Dettagli registro di schemi.

3. Nella tabella Soggetti in questo registro di schema, fai clic sul nome del soggetto per cui vuoi aggiornare la modalità dello schema.
4. Trova l'impostazione Modalità schema per l'argomento e fai clic sull'icona Modifica accanto.

   Viene visualizzata la pagina Modalità Modifica schema.

5. Seleziona il valore dal menu a discesa Modalità schema. La scelta di un valore qui sostituisce l'impostazione a livello di registro per questo soggetto specifico.

   Per saperne di più su questi valori, vedi Informazioni sulla modalità schema.

6. Fai clic su Salva.

gcloud

Per aggiornare la modalità dello schema per un argomento, utilizza il comando gcloud alpha managed-kafka schema-registries subject update:

gcloud alpha managed-kafka schema-registries subject update SUBJECT_NAME \
    --schema-registry=SCHEMA_REGISTRY_ID \
    --location=LOCATION \
    --mode=MODE_TYPE

• SUBJECT_NAME: il nome dell'argomento da aggiornare.
• SCHEMA_REGISTRY_ID: l'ID del registro di schema che contiene l'argomento.
• LOCATION: la regione del registro di schema che contiene l'argomento.
• MODE_TYPE: la nuova modalità dello schema. I valori validi sono:
  • READWRITE
  • READONLY

Esempio:

Per aggiornare la modalità dello schema dell'argomento test-subject nel registro di schema test-registry nella regione us-central1 a READONLY, esegui questo comando:

gcloud alpha managed-kafka schema-registries subject update test-subject \
    --schema-registry=test-registry \
    --location=us-central1 \
    --mode=READONLY

REST

La richiesta deve essere autenticata con un token di accesso nell'intestazione Authorization. Per ottenere un token di accesso per le Credenziali predefinite dell'applicazione attuali: gcloud auth application-default print-access-token.

Per aggiornare la modalità schema per un argomento, invia una richiesta PUT all'endpoint API REST per un argomento specifico utilizzando il metodo projects.locations.schemaRegistries.contexts.mode.update.

Aggiornamento della modalità dello schema per un soggetto nel contesto predefinito:

PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/mode/SUBJECT_NAME

Sostituisci i seguenti parametri di percorso:

• PROJECT_ID: il tuo ID progetto Google Cloud.
• LOCATION: la regione in cui esiste il registro degli schemi.
• SCHEMA_REGISTRY_ID: l'ID univoco del registro degli schemi.
• SUBJECT_NAME: il nome del soggetto.

Corpo della richiesta:

Includi un oggetto JSON nel corpo della richiesta che specifichi i dettagli della modalità.

{
  "mode": "MODE_TYPE"
}

Sostituisci MODE_TYPE con una delle opzioni di stringa valide per la modalità:

• READWRITE
• READONLY

Esempio: imposta la modalità dello schema dell'oggetto user_events su Readonly nel contesto predefinito:

Richiesta a PUT https://managedkafka.googleapis.com/v1main/projects/test-gcp-project/locations/us-east1/schemaRegistries/main_registry/mode/user_events

Con corpo:

{
  "mode": "READONLY"
}

In caso di esito positivo, l'API restituisce un codice di stato 200 OK e un corpo della risposta contenente la rappresentazione JSON della risorsa contesto o soggetto aggiornata che riflette questa modifica.

Aggiornamento della modalità dello schema per un soggetto in un contesto specifico:

PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/contexts/CONTEXT_NAME/mode/SUBJECT_NAME

Sostituisci i seguenti parametri di percorso:

• PROJECT_ID: il tuo ID progetto Google Cloud.
• LOCATION: la regione in cui esiste il registro degli schemi.
• SCHEMA_REGISTRY_ID: l'ID univoco del registro degli schemi.
• CONTEXT_NAME: il nome del contesto.
• SUBJECT_NAME: il nome del soggetto.

Corpo della richiesta:

Includi un oggetto JSON nel corpo della richiesta che specifichi i dettagli della modalità.

{
  "mode": "MODE_TYPE"
}

Sostituisci MODE_TYPE con una delle opzioni di stringa valide per la modalità:

• READWRITE
• READONLY

Esempio: imposta la modalità dello schema del soggetto user_events su Readonly nel contesto test_context:

Richiesta a PUT https://managedkafka.googleapis.com/v1main/projects/test-gcp-project/locations/us-east1/schemaRegistries/main_registry/contexts/test_context/mode/user_events

Con corpo:

{
  "mode": "READONLY"
}

In caso di esito positivo, l'API restituisce un codice di stato 200 OK e un corpo della risposta contenente la rappresentazione JSON della risorsa contesto o soggetto aggiornata che riflette questa modifica.

Per saperne di più, consulta la documentazione dell'API REST.

Passaggi successivi

• Aggiornare il tipo di compatibilità

• Creare un argomento e registrare gli schemi

• Visualizzare i dettagli di un registro di schemi

• Elencare i soggetti in un registro di schema

Apache Kafka® è un marchio registrato di Apache Software Foundation o dei suoi affiliati negli Stati Uniti e/o in altri paesi.