Method: iceberg.v1.restcatalog.extensions.projects.catalogs.list

Elenca i cataloghi REST Iceberg.

Richiesta HTTP


GET https://biglake.googleapis.com/iceberg/v1/restcatalog/extensions/{parent=projects/*}/catalogs

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
parent

string

Obbligatorio. La risorsa padre in cui verrà creato questo catalogo. Formato: projects/{projectId}

Parametri di query

Parametri
view

enum (CatalogView)

Facoltativo. La visualizzazione del catalogo da restituire.

page-size

integer

Facoltativo. Il numero massimo di cataloghi da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore.

page-token

string

Facoltativo. Il token di pagina, ricevuto da una chiamata catalogs.list precedente. Fornisci questo valore per recuperare la pagina successiva.

filter

string

Facoltativo. L'espressione di filtro. L'unico parametro attualmente supportato è il filtro basato sul campo IcebergCatalog.catalog_type.

Esempi: * catalogType = CATALOG_TYPE_BIGLAKE * catalogType != CATALOG_TYPE_GCS_BUCKET * catalogType = CATALOG_TYPE_BIGLAKE OR catalogType = CATALOG_TYPE_GCS_BUCKET * NOT catalogType = CATALOG_TYPE_GCS_BUCKET

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Il messaggio di risposta per l'API catalogs.list.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "iceberg-catalogs": [
    {
      object (IcebergCatalog)
    }
  ],
  "next-page-token": string,
  "unreachable": [
    string
  ]
}
Campi
iceberg-catalogs[]

object (IcebergCatalog)

Solo output. L'elenco dei cataloghi Iceberg.

next-page-token

string

Solo output. Il token di pagina successiva per l'impaginazione.

unreachable[]

string

Solo output. L'elenco delle regioni cloud non raggiungibili. Se non è vuoto, il set di risultati potrebbe essere incompleto.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.

CatalogView

L'enumerazione delle visualizzazioni che possono essere restituite.

Enum
CATALOG_VIEW_UNSPECIFIED Valore predefinito/non impostato. Questo valore viene trattato allo stesso modo di CATALOG_VIEW_BASIC.
CATALOG_VIEW_BASIC Includi solo il nome e il tipo di catalogo.
CATALOG_VIEW_FULL Includi tutti i campi del catalogo. replicationStatus viene compilato solo quando viene specificato region e fa riferimento a una regione di replica secondaria del catalogo.