1. Packages
  2. AWS Native
  3. API Docs
  4. apigateway
  5. DomainName

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.103.0 published on Monday, Apr 22, 2024 by Pulumi

aws-native.apigateway.DomainName

Explore with Pulumi AI

aws-native logo

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.103.0 published on Monday, Apr 22, 2024 by Pulumi

    Resource Type definition for AWS::ApiGateway::DomainName.

    Example Usage

    Example

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AwsNative = Pulumi.AwsNative;
    
    return await Deployment.RunAsync(() => 
    {
        var config = new Config();
        var cfnDomainName = config.Require("cfnDomainName");
        var certificateArn = config.Require("certificateArn");
        var type = config.Require("type");
        var myDomainName = new AwsNative.ApiGateway.DomainName("myDomainName", new()
        {
            CertificateArn = certificateArn,
            DomainNameValue = cfnDomainName,
            EndpointConfiguration = new AwsNative.ApiGateway.Inputs.DomainNameEndpointConfigurationArgs
            {
                Types = new[]
                {
                    type,
                },
            },
            RegionalCertificateArn = certificateArn,
        });
    
        return new Dictionary<string, object?>
        {
            ["domainName"] = myDomainName.Id,
        };
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/apigateway"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		cfg := config.New(ctx, "")
    		cfnDomainName := cfg.Require("cfnDomainName")
    		certificateArn := cfg.Require("certificateArn")
    		_type := cfg.Require("type")
    		myDomainName, err := apigateway.NewDomainName(ctx, "myDomainName", &apigateway.DomainNameArgs{
    			CertificateArn: pulumi.String(certificateArn),
    			DomainName:     pulumi.String(cfnDomainName),
    			EndpointConfiguration: &apigateway.DomainNameEndpointConfigurationArgs{
    				Types: pulumi.StringArray{
    					pulumi.String(_type),
    				},
    			},
    			RegionalCertificateArn: pulumi.String(certificateArn),
    		})
    		if err != nil {
    			return err
    		}
    		ctx.Export("domainName", myDomainName.ID())
    		return nil
    	})
    }
    

    Coming soon!

    import pulumi
    import pulumi_aws_native as aws_native
    
    config = pulumi.Config()
    cfn_domain_name = config.require("cfnDomainName")
    certificate_arn = config.require("certificateArn")
    type = config.require("type")
    my_domain_name = aws_native.apigateway.DomainName("myDomainName",
        certificate_arn=certificate_arn,
        domain_name=cfn_domain_name,
        endpoint_configuration=aws_native.apigateway.DomainNameEndpointConfigurationArgs(
            types=[type],
        ),
        regional_certificate_arn=certificate_arn)
    pulumi.export("domainName", my_domain_name.id)
    
    import * as pulumi from "@pulumi/pulumi";
    import * as aws_native from "@pulumi/aws-native";
    
    const config = new pulumi.Config();
    const cfnDomainName = config.require("cfnDomainName");
    const certificateArn = config.require("certificateArn");
    const type = config.require("type");
    const myDomainName = new aws_native.apigateway.DomainName("myDomainName", {
        certificateArn: certificateArn,
        domainName: cfnDomainName,
        endpointConfiguration: {
            types: [type],
        },
        regionalCertificateArn: certificateArn,
    });
    export const domainName = myDomainName.id;
    

    Coming soon!

    Example

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AwsNative = Pulumi.AwsNative;
    
    return await Deployment.RunAsync(() => 
    {
        var config = new Config();
        var cfnDomainName = config.Require("cfnDomainName");
        var certificateArn = config.Require("certificateArn");
        var type = config.Require("type");
        var myDomainName = new AwsNative.ApiGateway.DomainName("myDomainName", new()
        {
            CertificateArn = certificateArn,
            DomainNameValue = cfnDomainName,
            EndpointConfiguration = new AwsNative.ApiGateway.Inputs.DomainNameEndpointConfigurationArgs
            {
                Types = new[]
                {
                    type,
                },
            },
            RegionalCertificateArn = certificateArn,
        });
    
        return new Dictionary<string, object?>
        {
            ["domainName"] = myDomainName.Id,
        };
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/apigateway"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		cfg := config.New(ctx, "")
    		cfnDomainName := cfg.Require("cfnDomainName")
    		certificateArn := cfg.Require("certificateArn")
    		_type := cfg.Require("type")
    		myDomainName, err := apigateway.NewDomainName(ctx, "myDomainName", &apigateway.DomainNameArgs{
    			CertificateArn: pulumi.String(certificateArn),
    			DomainName:     pulumi.String(cfnDomainName),
    			EndpointConfiguration: &apigateway.DomainNameEndpointConfigurationArgs{
    				Types: pulumi.StringArray{
    					pulumi.String(_type),
    				},
    			},
    			RegionalCertificateArn: pulumi.String(certificateArn),
    		})
    		if err != nil {
    			return err
    		}
    		ctx.Export("domainName", myDomainName.ID())
    		return nil
    	})
    }
    

    Coming soon!

    import pulumi
    import pulumi_aws_native as aws_native
    
    config = pulumi.Config()
    cfn_domain_name = config.require("cfnDomainName")
    certificate_arn = config.require("certificateArn")
    type = config.require("type")
    my_domain_name = aws_native.apigateway.DomainName("myDomainName",
        certificate_arn=certificate_arn,
        domain_name=cfn_domain_name,
        endpoint_configuration=aws_native.apigateway.DomainNameEndpointConfigurationArgs(
            types=[type],
        ),
        regional_certificate_arn=certificate_arn)
    pulumi.export("domainName", my_domain_name.id)
    
    import * as pulumi from "@pulumi/pulumi";
    import * as aws_native from "@pulumi/aws-native";
    
    const config = new pulumi.Config();
    const cfnDomainName = config.require("cfnDomainName");
    const certificateArn = config.require("certificateArn");
    const type = config.require("type");
    const myDomainName = new aws_native.apigateway.DomainName("myDomainName", {
        certificateArn: certificateArn,
        domainName: cfnDomainName,
        endpointConfiguration: {
            types: [type],
        },
        regionalCertificateArn: certificateArn,
    });
    export const domainName = myDomainName.id;
    

    Coming soon!

    Create DomainName Resource

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

    Constructor syntax

    new DomainName(name: string, args?: DomainNameArgs, opts?: CustomResourceOptions);
    @overload
    def DomainName(resource_name: str,
                   args: Optional[DomainNameArgs] = None,
                   opts: Optional[ResourceOptions] = None)
    
    @overload
    def DomainName(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   certificate_arn: Optional[str] = None,
                   domain_name: Optional[str] = None,
                   endpoint_configuration: Optional[DomainNameEndpointConfigurationArgs] = None,
                   mutual_tls_authentication: Optional[DomainNameMutualTlsAuthenticationArgs] = None,
                   ownership_verification_certificate_arn: Optional[str] = None,
                   regional_certificate_arn: Optional[str] = None,
                   security_policy: Optional[str] = None,
                   tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewDomainName(ctx *Context, name string, args *DomainNameArgs, opts ...ResourceOption) (*DomainName, error)
    public DomainName(string name, DomainNameArgs? args = null, CustomResourceOptions? opts = null)
    public DomainName(String name, DomainNameArgs args)
    public DomainName(String name, DomainNameArgs args, CustomResourceOptions options)
    
    type: aws-native:apigateway:DomainName
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

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

    Example

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

    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    const domainNameResource = new aws_native.apigateway.DomainName("domainNameResource", {
        certificateArn: "string",
        domainName: "string",
        endpointConfiguration: {
            types: ["string"],
        },
        mutualTlsAuthentication: {
            truststoreUri: "string",
            truststoreVersion: "string",
        },
        ownershipVerificationCertificateArn: "string",
        regionalCertificateArn: "string",
        securityPolicy: "string",
        tags: [{
            key: "string",
            value: "string",
        }],
    });
    
    Coming soon!
    

    DomainName Resource Properties

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

    Inputs

    The DomainName resource accepts the following input properties:

    Outputs

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

    DistributionDomainName string
    DistributionHostedZoneId string
    Id string
    The provider-assigned unique ID for this managed resource.
    RegionalDomainName string
    RegionalHostedZoneId string
    DistributionDomainName string
    DistributionHostedZoneId string
    Id string
    The provider-assigned unique ID for this managed resource.
    RegionalDomainName string
    RegionalHostedZoneId string
    distributionDomainName String
    distributionHostedZoneId String
    id String
    The provider-assigned unique ID for this managed resource.
    regionalDomainName String
    regionalHostedZoneId String
    distributionDomainName string
    distributionHostedZoneId string
    id string
    The provider-assigned unique ID for this managed resource.
    regionalDomainName string
    regionalHostedZoneId string
    distribution_domain_name str
    distribution_hosted_zone_id str
    id str
    The provider-assigned unique ID for this managed resource.
    regional_domain_name str
    regional_hosted_zone_id str
    distributionDomainName String
    distributionHostedZoneId String
    id String
    The provider-assigned unique ID for this managed resource.
    regionalDomainName String
    regionalHostedZoneId String

    Supporting Types

    DomainNameEndpointConfiguration, DomainNameEndpointConfigurationArgs

    Types List<string>
    Types []string
    types List<String>
    types string[]
    types Sequence[str]
    types List<String>

    DomainNameMutualTlsAuthentication, DomainNameMutualTlsAuthenticationArgs

    Tag, TagArgs

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    AWS Native is in preview. AWS Classic is fully supported.

    AWS Native v0.103.0 published on Monday, Apr 22, 2024 by Pulumi