Method: apps.domainMappings.create

Maps a ___domain to an application. A user must be authorized to administer a ___domain in order to map it to an application. For a list of available authorized domains, see AuthorizedDomains.ListAuthorizedDomains.

HTTP request

POST https://appengine.googleapis.com/v1beta/{parent=apps/*}/domainMappings

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Name of the parent Application resource. Example: apps/myapp.

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

  • appengine.applications.update

Query parameters

Parameters
overrideStrategy

enum (DomainOverrideStrategy)

Whether the ___domain creation should override any existing mappings for this ___domain. By default, overrides are rejected.

Request body

The request body contains an instance of DomainMapping.

Response body

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

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

DomainOverrideStrategy

Override strategy for mutating an existing mapping.

Enums
UNSPECIFIED_DOMAIN_OVERRIDE_STRATEGY Strategy unspecified. Defaults to STRICT.
STRICT Overrides not allowed. If a mapping already exists for the specified ___domain, the request will return an ALREADY_EXISTS (409).
OVERRIDE Overrides allowed. If a mapping already exists for the specified ___domain, the request will overwrite it. Note that this might stop another Google product from serving. For example, if the ___domain is mapped to another App Engine application, that app will no longer serve from that ___domain.