azure-native.apimanagement.GatewayHostnameConfiguration
Explore with Pulumi AI
Gateway hostname configuration details. Azure REST API version: 2022-08-01. Prior API version in Azure Native 1.x: 2020-12-01.
Other available API versions: 2022-09-01-preview, 2023-03-01-preview, 2023-05-01-preview, 2023-09-01-preview, 2024-05-01.
Example Usage
ApiManagementCreateGatewayHostnameConfiguration
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var gatewayHostnameConfiguration = new AzureNative.ApiManagement.GatewayHostnameConfiguration("gatewayHostnameConfiguration", new()
{
CertificateId = "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
GatewayId = "gw1",
HcId = "default",
Hostname = "*",
Http2Enabled = true,
NegotiateClientCertificate = false,
ResourceGroupName = "rg1",
ServiceName = "apimService1",
Tls10Enabled = false,
Tls11Enabled = false,
});
});
package main
import (
apimanagement "github.com/pulumi/pulumi-azure-native-sdk/apimanagement/v2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := apimanagement.NewGatewayHostnameConfiguration(ctx, "gatewayHostnameConfiguration", &apimanagement.GatewayHostnameConfigurationArgs{
CertificateId: pulumi.String("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1"),
GatewayId: pulumi.String("gw1"),
HcId: pulumi.String("default"),
Hostname: pulumi.String("*"),
Http2Enabled: pulumi.Bool(true),
NegotiateClientCertificate: pulumi.Bool(false),
ResourceGroupName: pulumi.String("rg1"),
ServiceName: pulumi.String("apimService1"),
Tls10Enabled: pulumi.Bool(false),
Tls11Enabled: pulumi.Bool(false),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.apimanagement.GatewayHostnameConfiguration;
import com.pulumi.azurenative.apimanagement.GatewayHostnameConfigurationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var gatewayHostnameConfiguration = new GatewayHostnameConfiguration("gatewayHostnameConfiguration", GatewayHostnameConfigurationArgs.builder()
.certificateId("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1")
.gatewayId("gw1")
.hcId("default")
.hostname("*")
.http2Enabled(true)
.negotiateClientCertificate(false)
.resourceGroupName("rg1")
.serviceName("apimService1")
.tls10Enabled(false)
.tls11Enabled(false)
.build());
}
}
import pulumi
import pulumi_azure_native as azure_native
gateway_hostname_configuration = azure_native.apimanagement.GatewayHostnameConfiguration("gatewayHostnameConfiguration",
certificate_id="/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
gateway_id="gw1",
hc_id="default",
hostname="*",
http2_enabled=True,
negotiate_client_certificate=False,
resource_group_name="rg1",
service_name="apimService1",
tls10_enabled=False,
tls11_enabled=False)
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";
const gatewayHostnameConfiguration = new azure_native.apimanagement.GatewayHostnameConfiguration("gatewayHostnameConfiguration", {
certificateId: "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
gatewayId: "gw1",
hcId: "default",
hostname: "*",
http2Enabled: true,
negotiateClientCertificate: false,
resourceGroupName: "rg1",
serviceName: "apimService1",
tls10Enabled: false,
tls11Enabled: false,
});
resources:
gatewayHostnameConfiguration:
type: azure-native:apimanagement:GatewayHostnameConfiguration
properties:
certificateId: /subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1
gatewayId: gw1
hcId: default
hostname: '*'
http2Enabled: true
negotiateClientCertificate: false
resourceGroupName: rg1
serviceName: apimService1
tls10Enabled: false
tls11Enabled: false
Create GatewayHostnameConfiguration Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new GatewayHostnameConfiguration(name: string, args: GatewayHostnameConfigurationArgs, opts?: CustomResourceOptions);
@overload
def GatewayHostnameConfiguration(resource_name: str,
args: GatewayHostnameConfigurationArgs,
opts: Optional[ResourceOptions] = None)
@overload
def GatewayHostnameConfiguration(resource_name: str,
opts: Optional[ResourceOptions] = None,
gateway_id: Optional[str] = None,
resource_group_name: Optional[str] = None,
service_name: Optional[str] = None,
certificate_id: Optional[str] = None,
hc_id: Optional[str] = None,
hostname: Optional[str] = None,
http2_enabled: Optional[bool] = None,
negotiate_client_certificate: Optional[bool] = None,
tls10_enabled: Optional[bool] = None,
tls11_enabled: Optional[bool] = None)
func NewGatewayHostnameConfiguration(ctx *Context, name string, args GatewayHostnameConfigurationArgs, opts ...ResourceOption) (*GatewayHostnameConfiguration, error)
public GatewayHostnameConfiguration(string name, GatewayHostnameConfigurationArgs args, CustomResourceOptions? opts = null)
public GatewayHostnameConfiguration(String name, GatewayHostnameConfigurationArgs args)
public GatewayHostnameConfiguration(String name, GatewayHostnameConfigurationArgs args, CustomResourceOptions options)
type: azure-native:apimanagement:GatewayHostnameConfiguration
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 GatewayHostnameConfigurationArgs
- 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 GatewayHostnameConfigurationArgs
- 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 GatewayHostnameConfigurationArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args GatewayHostnameConfigurationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args GatewayHostnameConfigurationArgs
- 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 gatewayHostnameConfigurationResource = new AzureNative.ApiManagement.GatewayHostnameConfiguration("gatewayHostnameConfigurationResource", new()
{
GatewayId = "string",
ResourceGroupName = "string",
ServiceName = "string",
CertificateId = "string",
HcId = "string",
Hostname = "string",
Http2Enabled = false,
NegotiateClientCertificate = false,
Tls10Enabled = false,
Tls11Enabled = false,
});
example, err := apimanagement.NewGatewayHostnameConfiguration(ctx, "gatewayHostnameConfigurationResource", &apimanagement.GatewayHostnameConfigurationArgs{
GatewayId: pulumi.String("string"),
ResourceGroupName: pulumi.String("string"),
ServiceName: pulumi.String("string"),
CertificateId: pulumi.String("string"),
HcId: pulumi.String("string"),
Hostname: pulumi.String("string"),
Http2Enabled: pulumi.Bool(false),
NegotiateClientCertificate: pulumi.Bool(false),
Tls10Enabled: pulumi.Bool(false),
Tls11Enabled: pulumi.Bool(false),
})
var gatewayHostnameConfigurationResource = new GatewayHostnameConfiguration("gatewayHostnameConfigurationResource", GatewayHostnameConfigurationArgs.builder()
.gatewayId("string")
.resourceGroupName("string")
.serviceName("string")
.certificateId("string")
.hcId("string")
.hostname("string")
.http2Enabled(false)
.negotiateClientCertificate(false)
.tls10Enabled(false)
.tls11Enabled(false)
.build());
gateway_hostname_configuration_resource = azure_native.apimanagement.GatewayHostnameConfiguration("gatewayHostnameConfigurationResource",
gateway_id="string",
resource_group_name="string",
service_name="string",
certificate_id="string",
hc_id="string",
hostname="string",
http2_enabled=False,
negotiate_client_certificate=False,
tls10_enabled=False,
tls11_enabled=False)
const gatewayHostnameConfigurationResource = new azure_native.apimanagement.GatewayHostnameConfiguration("gatewayHostnameConfigurationResource", {
gatewayId: "string",
resourceGroupName: "string",
serviceName: "string",
certificateId: "string",
hcId: "string",
hostname: "string",
http2Enabled: false,
negotiateClientCertificate: false,
tls10Enabled: false,
tls11Enabled: false,
});
type: azure-native:apimanagement:GatewayHostnameConfiguration
properties:
certificateId: string
gatewayId: string
hcId: string
hostname: string
http2Enabled: false
negotiateClientCertificate: false
resourceGroupName: string
serviceName: string
tls10Enabled: false
tls11Enabled: false
GatewayHostnameConfiguration 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 GatewayHostnameConfiguration resource accepts the following input properties:
- Gateway
Id string - Gateway entity identifier. Must be unique in the current API Management service instance. Must not have value 'managed'
- Resource
Group stringName - The name of the resource group. The name is case insensitive.
- Service
Name string - The name of the API Management service.
- Certificate
Id string - Identifier of Certificate entity that will be used for TLS connection establishment
- Hc
Id string - Gateway hostname configuration identifier. Must be unique in the scope of parent Gateway entity.
- Hostname string
- Hostname value. Supports valid domain name, partial or full wildcard
- Http2Enabled bool
- Specifies if HTTP/2.0 is supported
- Negotiate
Client boolCertificate - Determines whether gateway requests client certificate
- Tls10Enabled bool
- Specifies if TLS 1.0 is supported
- Tls11Enabled bool
- Specifies if TLS 1.1 is supported
- Gateway
Id string - Gateway entity identifier. Must be unique in the current API Management service instance. Must not have value 'managed'
- Resource
Group stringName - The name of the resource group. The name is case insensitive.
- Service
Name string - The name of the API Management service.
- Certificate
Id string - Identifier of Certificate entity that will be used for TLS connection establishment
- Hc
Id string - Gateway hostname configuration identifier. Must be unique in the scope of parent Gateway entity.
- Hostname string
- Hostname value. Supports valid domain name, partial or full wildcard
- Http2Enabled bool
- Specifies if HTTP/2.0 is supported
- Negotiate
Client boolCertificate - Determines whether gateway requests client certificate
- Tls10Enabled bool
- Specifies if TLS 1.0 is supported
- Tls11Enabled bool
- Specifies if TLS 1.1 is supported
- gateway
Id String - Gateway entity identifier. Must be unique in the current API Management service instance. Must not have value 'managed'
- resource
Group StringName - The name of the resource group. The name is case insensitive.
- service
Name String - The name of the API Management service.
- certificate
Id String - Identifier of Certificate entity that will be used for TLS connection establishment
- hc
Id String - Gateway hostname configuration identifier. Must be unique in the scope of parent Gateway entity.
- hostname String
- Hostname value. Supports valid domain name, partial or full wildcard
- http2Enabled Boolean
- Specifies if HTTP/2.0 is supported
- negotiate
Client BooleanCertificate - Determines whether gateway requests client certificate
- tls10Enabled Boolean
- Specifies if TLS 1.0 is supported
- tls11Enabled Boolean
- Specifies if TLS 1.1 is supported
- gateway
Id string - Gateway entity identifier. Must be unique in the current API Management service instance. Must not have value 'managed'
- resource
Group stringName - The name of the resource group. The name is case insensitive.
- service
Name string - The name of the API Management service.
- certificate
Id string - Identifier of Certificate entity that will be used for TLS connection establishment
- hc
Id string - Gateway hostname configuration identifier. Must be unique in the scope of parent Gateway entity.
- hostname string
- Hostname value. Supports valid domain name, partial or full wildcard
- http2Enabled boolean
- Specifies if HTTP/2.0 is supported
- negotiate
Client booleanCertificate - Determines whether gateway requests client certificate
- tls10Enabled boolean
- Specifies if TLS 1.0 is supported
- tls11Enabled boolean
- Specifies if TLS 1.1 is supported
- gateway_
id str - Gateway entity identifier. Must be unique in the current API Management service instance. Must not have value 'managed'
- resource_
group_ strname - The name of the resource group. The name is case insensitive.
- service_
name str - The name of the API Management service.
- certificate_
id str - Identifier of Certificate entity that will be used for TLS connection establishment
- hc_
id str - Gateway hostname configuration identifier. Must be unique in the scope of parent Gateway entity.
- hostname str
- Hostname value. Supports valid domain name, partial or full wildcard
- http2_
enabled bool - Specifies if HTTP/2.0 is supported
- negotiate_
client_ boolcertificate - Determines whether gateway requests client certificate
- tls10_
enabled bool - Specifies if TLS 1.0 is supported
- tls11_
enabled bool - Specifies if TLS 1.1 is supported
- gateway
Id String - Gateway entity identifier. Must be unique in the current API Management service instance. Must not have value 'managed'
- resource
Group StringName - The name of the resource group. The name is case insensitive.
- service
Name String - The name of the API Management service.
- certificate
Id String - Identifier of Certificate entity that will be used for TLS connection establishment
- hc
Id String - Gateway hostname configuration identifier. Must be unique in the scope of parent Gateway entity.
- hostname String
- Hostname value. Supports valid domain name, partial or full wildcard
- http2Enabled Boolean
- Specifies if HTTP/2.0 is supported
- negotiate
Client BooleanCertificate - Determines whether gateway requests client certificate
- tls10Enabled Boolean
- Specifies if TLS 1.0 is supported
- tls11Enabled Boolean
- Specifies if TLS 1.1 is supported
Outputs
All input properties are implicitly available as output properties. Additionally, the GatewayHostnameConfiguration resource produces the following output properties:
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:apimanagement:GatewayHostnameConfiguration default /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/hostnameConfigurations/{hcId}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0