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

Elenca gli spazi dei nomi Iceberg nel catalogo. Supportiamo solo un livello di nidificazione per gli spazi dei nomi.

Richiesta HTTP


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

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
apiParent

string

Obbligatorio. Il genitore dal percorso della risorsa.

Parametri di query

Parametri
pageToken

string

Facoltativo. Specifica il pageToken restituito nella risposta precedente per recuperare la pagina successiva dei risultati.

pageSize

integer

Facoltativo. Per i server che supportano la paginazione, questo indica un limite superiore del numero di risultati che un client riceverà. Per i server che non supportano la paginazione, i client potrebbero ricevere risultati più grandi del pageSize indicato. Se non è impostato, il valore predefinito è 100.

parent

string

Facoltativo. Uno spazio dei nomi facoltativo in cui elencare gli spazi dei nomi. Se non vengono forniti o sono vuoti, devono essere elencati tutti gli spazi dei nomi di primo livello. Se il genitore è uno spazio dei nomi in più parti, le parti devono essere separate dal byte separatore di unità (0x1F). Non è un genitore reale, quindi ST_NOT_REQUIRED.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

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

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

Rappresentazione JSON
{
  "namespaces": [
    array
  ],
  "next-page-token": string,
  "unreachable": [
    string
  ]
}
Campi
namespaces[]

array (ListValue format)

L'elenco degli spazi dei nomi.

next-page-token

string

Il token di pagina successiva per la paginazione.

unreachable[]

string

Solo output. Un elenco delle località ignorate che non erano 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.