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

Listet Iceberg-Namespaces im Katalog auf. Wir unterstützen nur eine Verschachtelungsebene für Namespaces.

HTTP-Anfrage

:


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

Für die URLs wird die Syntax der gRPC-Transcodierung verwendet.

Pfadparameter

Parameter
apiParent

string

Erforderlich. Die übergeordnete Ressource aus dem Ressourcenpfad.

Suchparameter

Parameter
pageToken

string

Optional. Geben Sie das in der vorherigen Antwort zurückgegebene „pageToken“ an, um die nächste Ergebnisseite abzurufen.

pageSize

integer

Optional. Für Server, die die Paginierung unterstützen, wird damit eine Obergrenze für die Anzahl der Ergebnisse festgelegt, die ein Client empfängt. Bei Servern, die keine Paginierung unterstützen, können Clients Ergebnisse erhalten, die größer als die angegebene pageSize sind. Wird kein Wert festgelegt, beträgt die Standardeinstellung 100.

parent

string

Optional. Ein optionaler Namespace, unter dem Namespaces aufgeführt werden sollen. Wenn nicht angegeben oder leer, sollten alle Namespaces der obersten Ebene aufgeführt werden. Wenn „parent“ ein mehrteiliger Namespace ist, müssen die Teile durch das Byte für das Trennzeichen für Einheiten (0x1F) getrennt werden. Kein echter Elternteil, daher ST_NOT_REQUIRED.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwortnachricht für die namespaces.list API.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

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

array (ListValue format)

Die Liste der Namespaces.

next-page-token

string

Das Token für die nächste Seite für die Paginierung.

unreachable[]

string

Nur Ausgabe. Eine Liste der übersprungenen Standorte, die nicht erreichbar waren. Wenn der Wert nicht leer ist, ist das Ergebnisset möglicherweise unvollständig.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.