Sign in

v1

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

Links a new domain to a backend.

post/v1/{+parent}/domains

Path parameters

parentstring required

Required. The parent backend in the format: projects/{project}/locations/{locationId}/backends/{backendId}.

Query parameters

domainIdstring

Required. Id of the domain to create. Must be a valid domain name.

requestIdstring

Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

validateOnlyboolean

Optional. Indicates that the request should be validated and default values populated, without persisting the request or creating any resources.

Request body

displayNamestring

Optional. Mutable human-readable name for the domain. 63 character limit. e.g. prod domain.

type'TYPE_UNSPECIFIED' | 'DEFAULT' | 'CUSTOM'

Output only. The type of the domain.

createTimestring google-datetime

Output only. Time at which the domain was created.

updateTimestring google-datetime

Output only. Time at which the domain was last updated.

annotationsobject

Optional. Annotations as key value pairs.

etagstring

Output only. Server-computed checksum based on other values; may be sent on update or delete to ensure operation is done on expected resource.

deleteTimestring google-datetime

Output only. Time at which the domain was deleted.

reconcilingboolean

Output only. A field that, if true, indicates that the build has an ongoing LRO.

labelsobject

Optional. Labels as key value pairs.

uidstring

Output only. System-assigned, unique identifier.

disabledboolean

Optional. Whether the domain is disabled. Defaults to false.

namestring

Identifier. The resource name of the domain, e.g. /projects/p/locations/l/backends/b/domains/foo.com

Response

Successful response