Method: projects.locations.scopes.namespaces.create

Creates a fleet namespace.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent (project and location) where the Namespace will be created. Specified in the format projects/*/locations/*/scopes/*.

Authorization requires the following IAM permission on the specified resource parent:

  • gkehub.namespaces.create

Query parameters



Required. Client chosen ID for the Namespace. namespaceId must be a valid RFC 1123 compliant DNS label:

  1. At most 63 characters in length
  2. It must consist of lower case alphanumeric characters or -
  3. It must start and end with an alphanumeric character

Which can be expressed as the regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, with a maximum length of 63 characters.

Request body

The request body contains an instance of Namespace.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.