Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Google Cloud Native
  3. API Docs
  4. appengine
  5. appengine/v1alpha
  6. DomainMapping

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
pulumi/pulumi-google-native

google-native.appengine/v1alpha.DomainMapping

Explore with Pulumi AI

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
pulumi/pulumi-google-native

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. Auto-naming is currently not supported for this resource.

Create DomainMapping Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new DomainMapping(name: string, args: DomainMappingArgs, opts?: CustomResourceOptions);
@overload
def DomainMapping(resource_name: str,
                  args: DomainMappingArgs,
                  opts: Optional[ResourceOptions] = None)

@overload
def DomainMapping(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  app_id: Optional[str] = None,
                  id: Optional[str] = None,
                  no_managed_certificate: Optional[bool] = None,
                  override_strategy: Optional[str] = None,
                  ssl_settings: Optional[SslSettingsArgs] = None)
func NewDomainMapping(ctx *Context, name string, args DomainMappingArgs, opts ...ResourceOption) (*DomainMapping, error)
public DomainMapping(string name, DomainMappingArgs args, CustomResourceOptions? opts = null)
public DomainMapping(String name, DomainMappingArgs args)
public DomainMapping(String name, DomainMappingArgs args, CustomResourceOptions options)

type: google-native:appengine/v1alpha:DomainMapping
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. DomainMappingArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. DomainMappingArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. DomainMappingArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. DomainMappingArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. DomainMappingArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var google_nativeDomainMappingResource = new GoogleNative.AppEngine.V1Alpha.DomainMapping("google-nativeDomainMappingResource", new()
{
    AppId = "string",
    Id = "string",
    NoManagedCertificate = false,
    OverrideStrategy = "string",
    SslSettings = new GoogleNative.AppEngine.V1Alpha.Inputs.SslSettingsArgs
    {
        CertificateId = "string",
    },
});
Copy
example, err := appenginev1alpha.NewDomainMapping(ctx, "google-nativeDomainMappingResource", &appenginev1alpha.DomainMappingArgs{
	AppId:                pulumi.String("string"),
	Id:                   pulumi.String("string"),
	NoManagedCertificate: pulumi.Bool(false),
	OverrideStrategy:     pulumi.String("string"),
	SslSettings: &appengine.SslSettingsArgs{
		CertificateId: pulumi.String("string"),
	},
})
Copy
var google_nativeDomainMappingResource = new com.pulumi.googlenative.appengine_v1alpha.DomainMapping("google-nativeDomainMappingResource", com.pulumi.googlenative.appengine_v1alpha.DomainMappingArgs.builder()
    .appId("string")
    .id("string")
    .noManagedCertificate(false)
    .overrideStrategy("string")
    .sslSettings(SslSettingsArgs.builder()
        .certificateId("string")
        .build())
    .build());
Copy
google_native_domain_mapping_resource = google_native.appengine.v1alpha.DomainMapping("google-nativeDomainMappingResource",
    app_id="string",
    id="string",
    no_managed_certificate=False,
    override_strategy="string",
    ssl_settings={
        "certificate_id": "string",
    })
Copy
const google_nativeDomainMappingResource = new google_native.appengine.v1alpha.DomainMapping("google-nativeDomainMappingResource", {
    appId: "string",
    id: "string",
    noManagedCertificate: false,
    overrideStrategy: "string",
    sslSettings: {
        certificateId: "string",
    },
});
Copy
type: google-native:appengine/v1alpha:DomainMapping
properties:
    appId: string
    id: string
    noManagedCertificate: false
    overrideStrategy: string
    sslSettings:
        certificateId: string
Copy

DomainMapping Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The DomainMapping resource accepts the following input properties:

AppId
This property is required.
Changes to this property will trigger replacement.
string
Id string
Relative name of the domain serving the application. Example: example.com.
NoManagedCertificate bool
Whether a managed certificate should be provided by App Engine. If true, a certificate ID must be manaually set in the DomainMapping resource to configure SSL for this domain. If false, a managed certificate will be provisioned and a certificate ID will be automatically populated.
OverrideStrategy string
Whether the domain creation should override any existing mappings for this domain. By default, overrides are rejected.
SslSettings Pulumi.GoogleNative.AppEngine.V1Alpha.Inputs.SslSettings
SSL configuration for this domain. If unconfigured, this domain will not serve with SSL.
AppId
This property is required.
Changes to this property will trigger replacement.
string
Id string
Relative name of the domain serving the application. Example: example.com.
NoManagedCertificate bool
Whether a managed certificate should be provided by App Engine. If true, a certificate ID must be manaually set in the DomainMapping resource to configure SSL for this domain. If false, a managed certificate will be provisioned and a certificate ID will be automatically populated.
OverrideStrategy string
Whether the domain creation should override any existing mappings for this domain. By default, overrides are rejected.
SslSettings SslSettingsArgs
SSL configuration for this domain. If unconfigured, this domain will not serve with SSL.
appId
This property is required.
Changes to this property will trigger replacement.
String
id String
Relative name of the domain serving the application. Example: example.com.
noManagedCertificate Boolean
Whether a managed certificate should be provided by App Engine. If true, a certificate ID must be manaually set in the DomainMapping resource to configure SSL for this domain. If false, a managed certificate will be provisioned and a certificate ID will be automatically populated.
overrideStrategy String
Whether the domain creation should override any existing mappings for this domain. By default, overrides are rejected.
sslSettings SslSettings
SSL configuration for this domain. If unconfigured, this domain will not serve with SSL.
appId
This property is required.
Changes to this property will trigger replacement.
string
id string
Relative name of the domain serving the application. Example: example.com.
noManagedCertificate boolean
Whether a managed certificate should be provided by App Engine. If true, a certificate ID must be manaually set in the DomainMapping resource to configure SSL for this domain. If false, a managed certificate will be provisioned and a certificate ID will be automatically populated.
overrideStrategy string
Whether the domain creation should override any existing mappings for this domain. By default, overrides are rejected.
sslSettings SslSettings
SSL configuration for this domain. If unconfigured, this domain will not serve with SSL.
app_id
This property is required.
Changes to this property will trigger replacement.
str
id str
Relative name of the domain serving the application. Example: example.com.
no_managed_certificate bool
Whether a managed certificate should be provided by App Engine. If true, a certificate ID must be manaually set in the DomainMapping resource to configure SSL for this domain. If false, a managed certificate will be provisioned and a certificate ID will be automatically populated.
override_strategy str
Whether the domain creation should override any existing mappings for this domain. By default, overrides are rejected.
ssl_settings SslSettingsArgs
SSL configuration for this domain. If unconfigured, this domain will not serve with SSL.
appId
This property is required.
Changes to this property will trigger replacement.
String
id String
Relative name of the domain serving the application. Example: example.com.
noManagedCertificate Boolean
Whether a managed certificate should be provided by App Engine. If true, a certificate ID must be manaually set in the DomainMapping resource to configure SSL for this domain. If false, a managed certificate will be provisioned and a certificate ID will be automatically populated.
overrideStrategy String
Whether the domain creation should override any existing mappings for this domain. By default, overrides are rejected.
sslSettings Property Map
SSL configuration for this domain. If unconfigured, this domain will not serve with SSL.

Outputs

All input properties are implicitly available as output properties. Additionally, the DomainMapping resource produces the following output properties:

Id string
The provider-assigned unique ID for this managed resource.
Name string
Full path to the DomainMapping resource in the API. Example: apps/myapp/domainMapping/example.com.
ResourceRecords List<Pulumi.GoogleNative.AppEngine.V1Alpha.Outputs.ResourceRecordResponse>
The resource records required to configure this domain mapping. These records must be added to the domain's DNS configuration in order to serve the application via this domain mapping.
Id string
The provider-assigned unique ID for this managed resource.
Name string
Full path to the DomainMapping resource in the API. Example: apps/myapp/domainMapping/example.com.
ResourceRecords []ResourceRecordResponse
The resource records required to configure this domain mapping. These records must be added to the domain's DNS configuration in order to serve the application via this domain mapping.
id String
The provider-assigned unique ID for this managed resource.
name String
Full path to the DomainMapping resource in the API. Example: apps/myapp/domainMapping/example.com.
resourceRecords List<ResourceRecordResponse>
The resource records required to configure this domain mapping. These records must be added to the domain's DNS configuration in order to serve the application via this domain mapping.
id string
The provider-assigned unique ID for this managed resource.
name string
Full path to the DomainMapping resource in the API. Example: apps/myapp/domainMapping/example.com.
resourceRecords ResourceRecordResponse[]
The resource records required to configure this domain mapping. These records must be added to the domain's DNS configuration in order to serve the application via this domain mapping.
id str
The provider-assigned unique ID for this managed resource.
name str
Full path to the DomainMapping resource in the API. Example: apps/myapp/domainMapping/example.com.
resource_records Sequence[ResourceRecordResponse]
The resource records required to configure this domain mapping. These records must be added to the domain's DNS configuration in order to serve the application via this domain mapping.
id String
The provider-assigned unique ID for this managed resource.
name String
Full path to the DomainMapping resource in the API. Example: apps/myapp/domainMapping/example.com.
resourceRecords List<Property Map>
The resource records required to configure this domain mapping. These records must be added to the domain's DNS configuration in order to serve the application via this domain mapping.

Supporting Types

ResourceRecordResponse
, ResourceRecordResponseArgs

Name This property is required. string
Relative name of the object affected by this record. Only applicable for CNAME records. Example: 'www'.
Rrdata This property is required. string
Data for this record. Values vary by record type, as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).
Type This property is required. string
Resource record type. Example: AAAA.
Name This property is required. string
Relative name of the object affected by this record. Only applicable for CNAME records. Example: 'www'.
Rrdata This property is required. string
Data for this record. Values vary by record type, as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).
Type This property is required. string
Resource record type. Example: AAAA.
name This property is required. String
Relative name of the object affected by this record. Only applicable for CNAME records. Example: 'www'.
rrdata This property is required. String
Data for this record. Values vary by record type, as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).
type This property is required. String
Resource record type. Example: AAAA.
name This property is required. string
Relative name of the object affected by this record. Only applicable for CNAME records. Example: 'www'.
rrdata This property is required. string
Data for this record. Values vary by record type, as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).
type This property is required. string
Resource record type. Example: AAAA.
name This property is required. str
Relative name of the object affected by this record. Only applicable for CNAME records. Example: 'www'.
rrdata This property is required. str
Data for this record. Values vary by record type, as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).
type This property is required. str
Resource record type. Example: AAAA.
name This property is required. String
Relative name of the object affected by this record. Only applicable for CNAME records. Example: 'www'.
rrdata This property is required. String
Data for this record. Values vary by record type, as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).
type This property is required. String
Resource record type. Example: AAAA.

SslSettings
, SslSettingsArgs

CertificateId string
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
CertificateId string
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
certificateId String
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
certificateId string
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
certificate_id str
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
certificateId String
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.

SslSettingsResponse
, SslSettingsResponseArgs

CertificateId This property is required. string
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
IsManagedCertificate This property is required. bool
Whether the mapped certificate is an App Engine managed certificate. Managed certificates are created by default with a domain mapping. To opt out, specify no_managed_certificate on a CREATE or UPDATE request.
CertificateId This property is required. string
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
IsManagedCertificate This property is required. bool
Whether the mapped certificate is an App Engine managed certificate. Managed certificates are created by default with a domain mapping. To opt out, specify no_managed_certificate on a CREATE or UPDATE request.
certificateId This property is required. String
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
isManagedCertificate This property is required. Boolean
Whether the mapped certificate is an App Engine managed certificate. Managed certificates are created by default with a domain mapping. To opt out, specify no_managed_certificate on a CREATE or UPDATE request.
certificateId This property is required. string
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
isManagedCertificate This property is required. boolean
Whether the mapped certificate is an App Engine managed certificate. Managed certificates are created by default with a domain mapping. To opt out, specify no_managed_certificate on a CREATE or UPDATE request.
certificate_id This property is required. str
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
is_managed_certificate This property is required. bool
Whether the mapped certificate is an App Engine managed certificate. Managed certificates are created by default with a domain mapping. To opt out, specify no_managed_certificate on a CREATE or UPDATE request.
certificateId This property is required. String
ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.
isManagedCertificate This property is required. Boolean
Whether the mapped certificate is an App Engine managed certificate. Managed certificates are created by default with a domain mapping. To opt out, specify no_managed_certificate on a CREATE or UPDATE request.

Package Details

Repository
Google Cloud Native pulumi/pulumi-google-native
License
Apache-2.0

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
pulumi/pulumi-google-native