Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-132862102.5 KB
projects

Creates a Microsoft AD domain.

post/v1/{+parent}/domains

Path parameters

parentstring required

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

Query parameters

domainNamestring

Required. The fully qualified domain name. e.g. mydomain.myorganization.com, 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 for example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project.

Request body

authorizedNetworksstring[]

Optional. The full names of the Google Compute Engine networks the domain instance is connected to. Networks can be added using UpdateDomain. The domain is only available on networks listed in authorized_networks. If CIDR subnets overlap between networks, domain creation will fail.

adminstring

Optional. The name of delegated administrator account used to perform Active Directory operations. If not specified, setupadmin will be used.

locationsstring[]

Required. Locations where domain needs to be provisioned. The locations can be specified according to https://cloud.google.com/compute/docs/regions-zones, such as us-west1 or us-east4. Each domain supports up to 4 locations, separated by commas. Each location will use a /26 block.

updateTimestring google-datetime

Output only. The last update time.

reservedIpRangestring

Required. The CIDR range of internal addresses that are reserved for this domain. Reserved networks must be /24 or larger. Ranges must be unique and non-overlapping with existing subnets in [Domain].[authorized_networks].

namestring

Required. The unique name of the domain using the form: projects/{project_id}/locations/global/domains/{domain_name}.

createTimestring google-datetime

Output only. The time the instance was created.

state'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'UPDATING' | 'DELETING' | 'REPAIRING' | 'PERFORMING_MAINTENANCE' | 'UNAVAILABLE'

Output only. The current state of this domain.

labelsobject

Optional. Resource labels that can contain user-provided metadata.

fqdnstring

Output only. The fully-qualified domain name of the exposed domain used by clients to connect to the service. Similar to what would be chosen for an Active Directory set up on an internal network.

auditLogsEnabledboolean

Optional. Configuration for audit logs. True if audit logs are enabled, else false. Default is audit logs disabled.

statusMessagestring

Output only. Additional information about the current status of this domain, if available.

Response

Successful response