import * as pulumi from "@pulumi/pulumi"; /** * Manages an App Service Virtual Network Association for [Regional VNet Integration](https://docs.microsoft.com/azure/app-service/web-sites-integrate-with-vnet#regional-vnet-integration). * * This resource can be used for both App Services and Function Apps. * * > **Note:** The following resources support associating the vNet for Regional vNet Integration directly on the resource and via the `azure.appservice.VirtualNetworkSwiftConnection` resource. You can't use both simultaneously. * * - azure.appservice.LinuxFunctionApp * - azure.appservice.LinuxFunctionAppSlot * - azure.appservice.LinuxWebApp * - azure.appservice.LinuxWebAppSlot * - azure.logicapps.Standard * - azure.appservice.WindowsFunctionApp * - azure.appservice.WindowsFunctionAppSlot * - azure.appservice.WindowsWebApp * - azure.appservice.WindowsWebAppSlot * * This resource requires the `Microsoft.Network/virtualNetworks/subnets/write` permission scope on the subnet. * * The resource specific vNet integration requires the `Microsoft.Network/virtualNetworks/subnets/join/action` permission scope. * * There is a hard limit of [one VNet integration per App Service Plan](https://docs.microsoft.com/azure/app-service/web-sites-integrate-with-vnet#regional-vnet-integration). * Multiple apps in the same App Service plan can use the same VNet. * * ## Example Usage * * ### With App Service) * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as azure from "@pulumi/azure"; * * const example = new azure.core.ResourceGroup("example", { * name: "example-resources", * location: "West Europe", * }); * const exampleVirtualNetwork = new azure.network.VirtualNetwork("example", { * name: "example-virtual-network", * addressSpaces: ["10.0.0.0/16"], * location: example.location, * resourceGroupName: example.name, * }); * const exampleSubnet = new azure.network.Subnet("example", { * name: "example-subnet", * resourceGroupName: example.name, * virtualNetworkName: exampleVirtualNetwork.name, * addressPrefixes: ["10.0.1.0/24"], * delegations: [{ * name: "example-delegation", * serviceDelegation: { * name: "Microsoft.Web/serverFarms", * actions: ["Microsoft.Network/virtualNetworks/subnets/action"], * }, * }], * }); * const examplePlan = new azure.appservice.Plan("example", { * name: "example-app-service-plan", * location: example.location, * resourceGroupName: example.name, * sku: { * tier: "Standard", * size: "S1", * }, * }); * const exampleAppService = new azure.appservice.AppService("example", { * name: "example-app-service", * location: example.location, * resourceGroupName: example.name, * appServicePlanId: examplePlan.id, * }); * const exampleVirtualNetworkSwiftConnection = new azure.appservice.VirtualNetworkSwiftConnection("example", { * appServiceId: exampleAppService.id, * subnetId: exampleSubnet.id, * }); * ``` * * ### With Function App) * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as azure from "@pulumi/azure"; * * const example = new azure.core.ResourceGroup("example", { * name: "example-resources", * location: "West Europe", * }); * const exampleVirtualNetwork = new azure.network.VirtualNetwork("example", { * name: "example-virtual-network", * addressSpaces: ["10.0.0.0/16"], * location: example.location, * resourceGroupName: example.name, * }); * const exampleSubnet = new azure.network.Subnet("example", { * name: "example-subnet", * resourceGroupName: example.name, * virtualNetworkName: exampleVirtualNetwork.name, * addressPrefixes: ["10.0.1.0/24"], * delegations: [{ * name: "example-delegation", * serviceDelegation: { * name: "Microsoft.Web/serverFarms", * actions: ["Microsoft.Network/virtualNetworks/subnets/action"], * }, * }], * }); * const examplePlan = new azure.appservice.Plan("example", { * name: "example-app-service-plan", * location: example.location, * resourceGroupName: example.name, * sku: { * tier: "Standard", * size: "S1", * }, * }); * const exampleAccount = new azure.storage.Account("example", { * name: "functionsappexamplesa", * resourceGroupName: example.name, * location: example.location, * accountTier: "Standard", * accountReplicationType: "LRS", * }); * const exampleFunctionApp = new azure.appservice.FunctionApp("example", { * name: "example-function-app", * location: example.location, * resourceGroupName: example.name, * appServicePlanId: examplePlan.id, * storageAccountName: exampleAccount.name, * storageAccountAccessKey: exampleAccount.primaryAccessKey, * }); * const exampleVirtualNetworkSwiftConnection = new azure.appservice.VirtualNetworkSwiftConnection("example", { * appServiceId: exampleFunctionApp.id, * subnetId: exampleSubnet.id, * }); * ``` * * ## Import * * App Service Virtual Network Associations can be imported using the `resource id`, e.g. * * ```sh * $ pulumi import azure:appservice/virtualNetworkSwiftConnection:VirtualNetworkSwiftConnection myassociation /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Web/sites/instance1/config/virtualNetwork * ``` */ export declare class VirtualNetworkSwiftConnection extends pulumi.CustomResource { /** * Get an existing VirtualNetworkSwiftConnection resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: VirtualNetworkSwiftConnectionState, opts?: pulumi.CustomResourceOptions): VirtualNetworkSwiftConnection; /** * Returns true if the given object is an instance of VirtualNetworkSwiftConnection. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is VirtualNetworkSwiftConnection; /** * The ID of the App Service or Function App to associate to the VNet. Changing this forces a new resource to be created. */ readonly appServiceId: pulumi.Output; /** * The ID of the subnet the app service will be associated to (the subnet must have a `serviceDelegation` configured for `Microsoft.Web/serverFarms`). */ readonly subnetId: pulumi.Output; /** * Create a VirtualNetworkSwiftConnection resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: VirtualNetworkSwiftConnectionArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering VirtualNetworkSwiftConnection resources. */ export interface VirtualNetworkSwiftConnectionState { /** * The ID of the App Service or Function App to associate to the VNet. Changing this forces a new resource to be created. */ appServiceId?: pulumi.Input; /** * The ID of the subnet the app service will be associated to (the subnet must have a `serviceDelegation` configured for `Microsoft.Web/serverFarms`). */ subnetId?: pulumi.Input; } /** * The set of arguments for constructing a VirtualNetworkSwiftConnection resource. */ export interface VirtualNetworkSwiftConnectionArgs { /** * The ID of the App Service or Function App to associate to the VNet. Changing this forces a new resource to be created. */ appServiceId: pulumi.Input; /** * The ID of the subnet the app service will be associated to (the subnet must have a `serviceDelegation` configured for `Microsoft.Web/serverFarms`). */ subnetId: pulumi.Input; }