- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization Scopes
- Try it!
Lists all namespaces.
HTTP request
GET https://servicedirectory.googleapis.com/v1beta1/{parent=projects/*/locations/*}/namespaces
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
parent |
Required. The resource name of the project and location whose namespaces we'd like to list. Authorization requires the following IAM permission on the specified resource
|
Query parameters
Parameters | |
---|---|
pageSize |
Optional. The maximum number of items to return. |
pageToken |
Optional. The nextPageToken value returned from a previous List request, if any. |
filter |
Optional. The filter to list result by. General filter string syntax: Examples of valid filters: * "labels.owner" returns Namespaces that have a label with the key "owner" this is the same as "labels:owner". * "labels.protocol=gRPC" returns Namespaces that have key/value "protocol=gRPC". * "name>projects/my-project/locations/us-east/namespaces/namespace-c" returns Namespaces that have name that is alphabetically later than the string, so "namespace-e" will be returned but "namespace-a" will not be. * "labels.owner!=sd AND labels.foo=bar" returns Namespaces that have "owner" in label key but value is not "sd" AND have key/value foo=bar. * "doesnotexist.foo=bar" returns an empty list. Note that Namespace doesn't have a field called "doesnotexist". Since the filter does not match any Namespaces, it returns no results. |
orderBy |
Optional. The order to list result by. General order by string syntax: |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
The response message for RegistrationService.ListNamespaces
.
JSON representation | |
---|---|
{
"namespaces": [
{
object ( |
Fields | |
---|---|
namespaces[] |
The list of namespaces. |
nextPageToken |
Token to retrieve the next page of results, or empty if there are no more results in the list. |
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.