Method: domains.create

Full name:

Creates a Microsoft AD domain.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The resource project name and location using the form: projects/{projectId}/locations/global

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


Query parameters



Required. A domain name, e.g., with the following restrictions: * Must contain only lowercase letters, numbers, periods and hyphens. * Must start with a letter. * Must contain between 2-64 characters. * Must end with a number or a letter. * Must not start with period. * First segment length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project.

Request body

The request body contains an instance of Domain.

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.