1. Packages
  2. Formal Provider
  3. API Docs
  4. ConnectorHostname
Formal v1.0.3 published on Monday, Aug 18, 2025 by Formal

formal.ConnectorHostname

Explore with Pulumi AI

formal logo
Formal v1.0.3 published on Monday, Aug 18, 2025 by Formal

    Registering a Connector Hostname with Formal.

    Create ConnectorHostname Resource

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

    Constructor syntax

    new ConnectorHostname(name: string, args: ConnectorHostnameArgs, opts?: CustomResourceOptions);
    @overload
    def ConnectorHostname(resource_name: str,
                          args: ConnectorHostnameArgs,
                          opts: Optional[ResourceOptions] = None)
    
    @overload
    def ConnectorHostname(resource_name: str,
                          opts: Optional[ResourceOptions] = None,
                          connector_id: Optional[str] = None,
                          hostname: Optional[str] = None,
                          dns_record: Optional[str] = None,
                          managed_tls: Optional[bool] = None,
                          termination_protection: Optional[bool] = None)
    func NewConnectorHostname(ctx *Context, name string, args ConnectorHostnameArgs, opts ...ResourceOption) (*ConnectorHostname, error)
    public ConnectorHostname(string name, ConnectorHostnameArgs args, CustomResourceOptions? opts = null)
    public ConnectorHostname(String name, ConnectorHostnameArgs args)
    public ConnectorHostname(String name, ConnectorHostnameArgs args, CustomResourceOptions options)
    
    type: formal:ConnectorHostname
    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 ConnectorHostnameArgs
    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 ConnectorHostnameArgs
    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 ConnectorHostnameArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ConnectorHostnameArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ConnectorHostnameArgs
    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 connectorHostnameResource = new Pulumi.ConnectorHostname("connectorHostnameResource", new()
    {
        ConnectorId = "string",
        Hostname = "string",
        DnsRecord = "string",
        TerminationProtection = false,
    });
    
    example, err := formal.NewConnectorHostname(ctx, "connectorHostnameResource", &formal.ConnectorHostnameArgs{
    	ConnectorId:           pulumi.String("string"),
    	Hostname:              pulumi.String("string"),
    	DnsRecord:             pulumi.String("string"),
    	TerminationProtection: pulumi.Bool(false),
    })
    
    var connectorHostnameResource = new ConnectorHostname("connectorHostnameResource", ConnectorHostnameArgs.builder()
        .connectorId("string")
        .hostname("string")
        .dnsRecord("string")
        .terminationProtection(false)
        .build());
    
    connector_hostname_resource = formal.ConnectorHostname("connectorHostnameResource",
        connector_id="string",
        hostname="string",
        dns_record="string",
        termination_protection=False)
    
    const connectorHostnameResource = new formal.ConnectorHostname("connectorHostnameResource", {
        connectorId: "string",
        hostname: "string",
        dnsRecord: "string",
        terminationProtection: false,
    });
    
    type: formal:ConnectorHostname
    properties:
        connectorId: string
        dnsRecord: string
        hostname: string
        terminationProtection: false
    

    ConnectorHostname 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 ConnectorHostname resource accepts the following input properties:

    ConnectorId string
    The ID of the Connector this hostname is linked to.
    Hostname string
    The hostname for this Connector hostname.
    DnsRecord string
    The DNS record for this hostname.
    ManagedTls bool
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    TerminationProtection bool
    If set to true, this connector hostname cannot be deleted.
    ConnectorId string
    The ID of the Connector this hostname is linked to.
    Hostname string
    The hostname for this Connector hostname.
    DnsRecord string
    The DNS record for this hostname.
    ManagedTls bool
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    TerminationProtection bool
    If set to true, this connector hostname cannot be deleted.
    connectorId String
    The ID of the Connector this hostname is linked to.
    hostname String
    The hostname for this Connector hostname.
    dnsRecord String
    The DNS record for this hostname.
    managedTls Boolean
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    terminationProtection Boolean
    If set to true, this connector hostname cannot be deleted.
    connectorId string
    The ID of the Connector this hostname is linked to.
    hostname string
    The hostname for this Connector hostname.
    dnsRecord string
    The DNS record for this hostname.
    managedTls boolean
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    terminationProtection boolean
    If set to true, this connector hostname cannot be deleted.
    connector_id str
    The ID of the Connector this hostname is linked to.
    hostname str
    The hostname for this Connector hostname.
    dns_record str
    The DNS record for this hostname.
    managed_tls bool
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    termination_protection bool
    If set to true, this connector hostname cannot be deleted.
    connectorId String
    The ID of the Connector this hostname is linked to.
    hostname String
    The hostname for this Connector hostname.
    dnsRecord String
    The DNS record for this hostname.
    managedTls Boolean
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    terminationProtection Boolean
    If set to true, this connector hostname cannot be deleted.

    Outputs

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

    DnsRecordStatus string
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    Id string
    The provider-assigned unique ID for this managed resource.
    TlsCertificateStatus string
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    DnsRecordStatus string
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    Id string
    The provider-assigned unique ID for this managed resource.
    TlsCertificateStatus string
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    dnsRecordStatus String
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    id String
    The provider-assigned unique ID for this managed resource.
    tlsCertificateStatus String
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    dnsRecordStatus string
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    id string
    The provider-assigned unique ID for this managed resource.
    tlsCertificateStatus string
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    dns_record_status str
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    id str
    The provider-assigned unique ID for this managed resource.
    tls_certificate_status str
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    dnsRecordStatus String
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    id String
    The provider-assigned unique ID for this managed resource.
    tlsCertificateStatus String
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.

    Look up Existing ConnectorHostname Resource

    Get an existing ConnectorHostname resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ConnectorHostnameState, opts?: CustomResourceOptions): ConnectorHostname
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            connector_id: Optional[str] = None,
            dns_record: Optional[str] = None,
            dns_record_status: Optional[str] = None,
            hostname: Optional[str] = None,
            managed_tls: Optional[bool] = None,
            termination_protection: Optional[bool] = None,
            tls_certificate_status: Optional[str] = None) -> ConnectorHostname
    func GetConnectorHostname(ctx *Context, name string, id IDInput, state *ConnectorHostnameState, opts ...ResourceOption) (*ConnectorHostname, error)
    public static ConnectorHostname Get(string name, Input<string> id, ConnectorHostnameState? state, CustomResourceOptions? opts = null)
    public static ConnectorHostname get(String name, Output<String> id, ConnectorHostnameState state, CustomResourceOptions options)
    resources:  _:    type: formal:ConnectorHostname    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    ConnectorId string
    The ID of the Connector this hostname is linked to.
    DnsRecord string
    The DNS record for this hostname.
    DnsRecordStatus string
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    Hostname string
    The hostname for this Connector hostname.
    ManagedTls bool
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    TerminationProtection bool
    If set to true, this connector hostname cannot be deleted.
    TlsCertificateStatus string
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    ConnectorId string
    The ID of the Connector this hostname is linked to.
    DnsRecord string
    The DNS record for this hostname.
    DnsRecordStatus string
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    Hostname string
    The hostname for this Connector hostname.
    ManagedTls bool
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    TerminationProtection bool
    If set to true, this connector hostname cannot be deleted.
    TlsCertificateStatus string
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    connectorId String
    The ID of the Connector this hostname is linked to.
    dnsRecord String
    The DNS record for this hostname.
    dnsRecordStatus String
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    hostname String
    The hostname for this Connector hostname.
    managedTls Boolean
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    terminationProtection Boolean
    If set to true, this connector hostname cannot be deleted.
    tlsCertificateStatus String
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    connectorId string
    The ID of the Connector this hostname is linked to.
    dnsRecord string
    The DNS record for this hostname.
    dnsRecordStatus string
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    hostname string
    The hostname for this Connector hostname.
    managedTls boolean
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    terminationProtection boolean
    If set to true, this connector hostname cannot be deleted.
    tlsCertificateStatus string
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    connector_id str
    The ID of the Connector this hostname is linked to.
    dns_record str
    The DNS record for this hostname.
    dns_record_status str
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    hostname str
    The hostname for this Connector hostname.
    managed_tls bool
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    termination_protection bool
    If set to true, this connector hostname cannot be deleted.
    tls_certificate_status str
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.
    connectorId String
    The ID of the Connector this hostname is linked to.
    dnsRecord String
    The DNS record for this hostname.
    dnsRecordStatus String
    The status of the DNS record for this hostname. Accepted values are none, pending, success and failed.
    hostname String
    The hostname for this Connector hostname.
    managedTls Boolean
    Deprecated: If set to true, Formal will manage the TLS certificate for this hostname.

    Deprecated: This field is deprecated and has no effect. It will be removed in a future release.

    terminationProtection Boolean
    If set to true, this connector hostname cannot be deleted.
    tlsCertificateStatus String
    The status of the TLS certificate for this hostname. Accepted values are none, issuing, and issued.

    Package Details

    Repository
    formal formalco/pulumi-formal
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the formal Terraform Provider.
    formal logo
    Formal v1.0.3 published on Monday, Aug 18, 2025 by Formal
      AI Agentic Workflows: Register now