pulumi-azure-kotlin/com.pulumi.azure.appservice.kotlin/AppService

AppService

class AppService : KotlinCustomResource

Manages an App Service (within an App Service Plan). !>NOTE: This resource has been deprecated in version 3.0 of the AzureRM provider and will be removed in version 4.0. Please use azure.appservice.LinuxWebApp resources instead.

Note: When using Slots - the app_settings, connection_string and site_config blocks on the azure.appservice.AppService resource will be overwritten when promoting a Slot using the azure.appservice.ActiveSlot resource.

Example Usage

This example provisions a Windows App Service.

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.appservice.Plan;
import com.pulumi.azure.appservice.PlanArgs;
import com.pulumi.azure.appservice.inputs.PlanSkuArgs;
import com.pulumi.azure.appservice.AppService;
import com.pulumi.azure.appservice.AppServiceArgs;
import com.pulumi.azure.appservice.inputs.AppServiceSiteConfigArgs;
import com.pulumi.azure.appservice.inputs.AppServiceConnectionStringArgs;
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 exampleResourceGroup = new ResourceGroup("exampleResourceGroup", ResourceGroupArgs.builder()
            .location("West Europe")
            .build());
        var examplePlan = new Plan("examplePlan", PlanArgs.builder()
            .location(exampleResourceGroup.location())
            .resourceGroupName(exampleResourceGroup.name())
            .sku(PlanSkuArgs.builder()
                .tier("Standard")
                .size("S1")
                .build())
            .build());
        var exampleAppService = new AppService("exampleAppService", AppServiceArgs.builder()
            .location(exampleResourceGroup.location())
            .resourceGroupName(exampleResourceGroup.name())
            .appServicePlanId(examplePlan.id())
            .siteConfig(AppServiceSiteConfigArgs.builder()
                .dotnetFrameworkVersion("v4.0")
                .scmType("LocalGit")
                .build())
            .appSettings(Map.of("SOME_KEY", "some-value"))
            .connectionStrings(AppServiceConnectionStringArgs.builder()
                .name("Database")
                .type("SQLServer")
                .value("Server=some-server.mydomain.com;Integrated Security=SSPI")
                .build())
            .build());
    }
}
Content copied to clipboard

Import

App Services can be imported using the resource id, e.g.

$ pulumi import azure:appservice/appService:AppService instance1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Web/sites/instance1
Content copied to clipboard

Properties

Link copied to clipboard
val appServicePlanId: Output<String>

The ID of the App Service Plan within which to create this App Service.

Link copied to clipboard
val appSettings: Output<Map<String, String>>

A key-value pair of App Settings.

Link copied to clipboard
val authSettings: Output<AppServiceAuthSettings>

A auth_settings block as defined below.

Link copied to clipboard
val backup: Output<AppServiceBackup>?

A backup block as defined below.

Link copied to clipboard
val clientAffinityEnabled: Output<Boolean>?

Should the App Service send session affinity cookies, which route client requests in the same session to the same instance?

Link copied to clipboard
val clientCertEnabled: Output<Boolean>?

Does the App Service require client certificates for incoming requests? Defaults to false.

Link copied to clipboard
val clientCertMode: Output<String>

Mode of client certificates for this App Service. Possible values are Required, Optional and OptionalInteractiveUser. If this parameter is set, client_cert_enabled must be set to true, otherwise this parameter is ignored.

Link copied to clipboard
val connectionStrings: Output<List<AppServiceConnectionString>>

One or more connection_string blocks as defined below.

Link copied to clipboard
val customDomainVerificationId: Output<String>

An identifier used by App Service to perform domain ownership verification via DNS TXT record.

Link copied to clipboard
val defaultSiteHostname: Output<String>

The Default Hostname associated with the App Service - such as mysite.azurewebsites.net

Link copied to clipboard
val enabled: Output<Boolean>?

Is the App Service Enabled? Defaults to true.

Link copied to clipboard
val httpsOnly: Output<Boolean>?

Can the App Service only be accessed via HTTPS? Defaults to false.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val identity: Output<AppServiceIdentity>?

An identity block as defined below.

Link copied to clipboard
val keyVaultReferenceIdentityId: Output<String>

The User Assigned Identity Id used for looking up KeyVault secrets. The identity must be assigned to the application. For more information see - Access vaults with a user-assigned identity

Link copied to clipboard
val location: Output<String>

Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.

Link copied to clipboard
val logs: Output<AppServiceLogs>

A logs block as defined below.

Link copied to clipboard
val name: Output<String>

Specifies the name of the App Service. Changing this forces a new resource to be created.

Link copied to clipboard
val outboundIpAddresses: Output<String>

A comma separated list of outbound IP addresses - such as 52.23.25.3,52.143.43.12

Link copied to clipboard
val outboundIpAddressLists: Output<List<String>>

A list of outbound IP addresses - such as ["52&#46;23&#46;25&#46;3", "52&#46;143&#46;43&#46;12"]

Link copied to clipboard
val possibleOutboundIpAddresses: Output<String>

A comma separated list of outbound IP addresses - such as 52.23.25.3,52.143.43.12,52.143.43.17 - not all of which are necessarily in use. Superset of outbound_ip_addresses.

Link copied to clipboard
val possibleOutboundIpAddressLists: Output<List<String>>

A list of outbound IP addresses - such as ["52&#46;23&#46;25&#46;3", "52&#46;143&#46;43&#46;12", "52&#46;143&#46;43&#46;17"] - not all of which are necessarily in use. Superset of outbound_ip_address_list.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val resourceGroupName: Output<String>

The name of the resource group in which to create the App Service. Changing this forces a new resource to be created.

Link copied to clipboard
val siteConfig: Output<AppServiceSiteConfig>

A site_config block as defined below.

Link copied to clipboard
val siteCredentials: Output<List<AppServiceSiteCredential>>

A site_credential block as defined below, which contains the site-level credentials used to publish to this App Service.

Link copied to clipboard
val sourceControl: Output<AppServiceSourceControl>

A Source Control block as defined below

Link copied to clipboard
val storageAccounts: Output<List<AppServiceStorageAccount>>

One or more storage_account blocks as defined below.

Link copied to clipboard
val tags: Output<Map<String, String>>?

A mapping of tags to assign to the resource.

Link copied to clipboard
val urn: Output<String>