By default, only basic information about a namespace is returned (e.g. name). When NAMESPACE_VIEW_FULL is specified, additional information associated with a namespace gets returned (e.g. IAM policy set on the namespace)
Request body
The request body must be empty.
Response body
List namespaces response.
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-20 UTC."],[[["\u003cp\u003eThis page details how to list namespaces within a specified Data Fusion instance using a \u003ccode\u003eGET\u003c/code\u003e HTTP request to the provided URL.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003eparent\u003c/code\u003e path parameter, which specifies the instance, as well as optional \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003eview\u003c/code\u003e query parameters for controlling the results.\u003c/p\u003e\n"],["\u003cp\u003eA successful response will return a JSON body containing a list of namespace objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for paginated results, if there are any.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eview\u003c/code\u003e query parameter allows you to select between basic or full namespace metadata, and there is an authorization scope is required for this operation.\u003c/p\u003e\n"],["\u003cp\u003eEach namespace object contains its name and any associated IAM policy.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.instances.namespaces.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListNamespacesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [NamespaceView](#NamespaceView)\n- [Namespace](#Namespace)\n - [JSON representation](#Namespace.SCHEMA_REPRESENTATION)\n- [IAMPolicy](#IAMPolicy)\n - [JSON representation](#IAMPolicy.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nList namespaces in a given instance\n\n### HTTP request\n\n`GET https://datafusion.googleapis.com/v1beta1/{parent=projects/*/locations/*/instances/*}/namespaces`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nList namespaces response.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\nNamespaceView\n-------------\n\nA view for Namespace\n\nNamespace\n---------\n\nRepresents the information of a namespace\n\nIAMPolicy\n---------\n\nIAMPolicy encapsulates the IAM policy name, definition and status of policy fetching."]]