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

Enumera los espacios de nombres de Iceberg en el catálogo. Solo admitimos un nivel de anidamiento para los espacios de nombres.

Solicitud HTTP


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

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
apiParent

string

Obligatorio. Es el elemento superior de la ruta de acceso al recurso.

Parámetros de consulta

Parámetros
pageToken

string

Es opcional. Especifica el pageToken que se devolvió en la respuesta anterior para recuperar la siguiente página de resultados.

pageSize

integer

Es opcional. En el caso de los servidores que admiten la paginación, esto indica un límite superior de la cantidad de resultados que recibirá un cliente. En el caso de los servidores que no admiten la paginación, es posible que los clientes reciban resultados más grandes que el pageSize indicado. El valor predeterminado es 100 si no se establece.

parent

string

Es opcional. Es un espacio de nombres opcional debajo del cual se enumeran los espacios de nombres. Si no se proporciona o está vacío, se deben enumerar todos los espacios de nombres de nivel superior. Si el elemento superior es un espacio de nombres de varias partes, estas deben estar separadas por el byte de separador de unidades (0x1F). No es un elemento superior real, por lo que es ST_NOT_REQUIRED.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para la API de namespaces.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "namespaces": [
    array
  ],
  "next-page-token": string,
  "unreachable": [
    string
  ]
}
Campos
namespaces[]

array (ListValue format)

Es la lista de espacios de nombres.

next-page-token

string

Es el token de página siguiente para la paginación.

unreachable[]

string

Solo salida. Es una lista de las ubicaciones omitidas a las que no se pudo acceder. Si no está vacío, es posible que el conjunto de resultados esté incompleto.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.