1. Packages
  2. Packages
  3. Azure Classic
  4. API Docs
  5. appservice
  6. Plan

We recommend using Azure Native.

Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-azure

azure.appservice.Plan

azure logo

We recommend using Azure Native.

Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-azure

    Manages an App Service Plan component.

    Example Usage

    Dedicated)

    using Pulumi;
using Azure = Pulumi.Azure;

class MyStack : Stack
{
    public MyStack()
    {
        var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new Azure.Core.ResourceGroupArgs
        {
            Location = "West Europe",
        });
        var examplePlan = new Azure.AppService.Plan("examplePlan", new Azure.AppService.PlanArgs
        {
            Location = exampleResourceGroup.Location,
            ResourceGroupName = exampleResourceGroup.Name,
            Sku = new Azure.AppService.Inputs.PlanSkuArgs
            {
                Tier = "Standard",
                Size = "S1",
            },
        });
    }

}

    package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/appservice"
	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleResourceGroup, err := core.NewResourceGroup(ctx, "exampleResourceGroup", &core.ResourceGroupArgs{
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		_, err = appservice.NewPlan(ctx, "examplePlan", &appservice.PlanArgs{
			Location:          exampleResourceGroup.Location,
			ResourceGroupName: exampleResourceGroup.Name,
			Sku: &appservice.PlanSkuArgs{
				Tier: pulumi.String("Standard"),
				Size: pulumi.String("S1"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const exampleResourceGroup = new azure.core.ResourceGroup("exampleResourceGroup", {location: "West Europe"});
const examplePlan = new azure.appservice.Plan("examplePlan", {
    location: exampleResourceGroup.location,
    resourceGroupName: exampleResourceGroup.name,
    sku: {
        tier: "Standard",
        size: "S1",
    },
});

    import pulumi
import pulumi_azure as azure

example_resource_group = azure.core.ResourceGroup("exampleResourceGroup", location="West Europe")
example_plan = azure.appservice.Plan("examplePlan",
    location=example_resource_group.location,
    resource_group_name=example_resource_group.name,
    sku=azure.appservice.PlanSkuArgs(
        tier="Standard",
        size="S1",
    ))

    Example coming soon!

    Shared / Consumption Plan)

    using Pulumi;
using Azure = Pulumi.Azure;

class MyStack : Stack
{
    public MyStack()
    {
        var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new Azure.Core.ResourceGroupArgs
        {
            Location = "West Europe",
        });
        var examplePlan = new Azure.AppService.Plan("examplePlan", new Azure.AppService.PlanArgs
        {
            Location = exampleResourceGroup.Location,
            ResourceGroupName = exampleResourceGroup.Name,
            Kind = "FunctionApp",
            Sku = new Azure.AppService.Inputs.PlanSkuArgs
            {
                Tier = "Dynamic",
                Size = "Y1",
            },
        });
    }

}

    package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/appservice"
	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleResourceGroup, err := core.NewResourceGroup(ctx, "exampleResourceGroup", &core.ResourceGroupArgs{
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		_, err = appservice.NewPlan(ctx, "examplePlan", &appservice.PlanArgs{
			Location:          exampleResourceGroup.Location,
			ResourceGroupName: exampleResourceGroup.Name,
			Kind:              pulumi.Any("FunctionApp"),
			Sku: &appservice.PlanSkuArgs{
				Tier: pulumi.String("Dynamic"),
				Size: pulumi.String("Y1"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const exampleResourceGroup = new azure.core.ResourceGroup("exampleResourceGroup", {location: "West Europe"});
const examplePlan = new azure.appservice.Plan("examplePlan", {
    location: exampleResourceGroup.location,
    resourceGroupName: exampleResourceGroup.name,
    kind: "FunctionApp",
    sku: {
        tier: "Dynamic",
        size: "Y1",
    },
});

    import pulumi
import pulumi_azure as azure

example_resource_group = azure.core.ResourceGroup("exampleResourceGroup", location="West Europe")
example_plan = azure.appservice.Plan("examplePlan",
    location=example_resource_group.location,
    resource_group_name=example_resource_group.name,
    kind="FunctionApp",
    sku=azure.appservice.PlanSkuArgs(
        tier="Dynamic",
        size="Y1",
    ))

    Example coming soon!

    Linux)

    using Pulumi;
using Azure = Pulumi.Azure;

class MyStack : Stack
{
    public MyStack()
    {
        var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new Azure.Core.ResourceGroupArgs
        {
            Location = "West Europe",
        });
        var examplePlan = new Azure.AppService.Plan("examplePlan", new Azure.AppService.PlanArgs
        {
            Location = exampleResourceGroup.Location,
            ResourceGroupName = exampleResourceGroup.Name,
            Kind = "Linux",
            Reserved = true,
            Sku = new Azure.AppService.Inputs.PlanSkuArgs
            {
                Tier = "Standard",
                Size = "S1",
            },
        });
    }

}

    package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/appservice"
	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleResourceGroup, err := core.NewResourceGroup(ctx, "exampleResourceGroup", &core.ResourceGroupArgs{
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		_, err = appservice.NewPlan(ctx, "examplePlan", &appservice.PlanArgs{
			Location:          exampleResourceGroup.Location,
			ResourceGroupName: exampleResourceGroup.Name,
			Kind:              pulumi.Any("Linux"),
			Reserved:          pulumi.Bool(true),
			Sku: &appservice.PlanSkuArgs{
				Tier: pulumi.String("Standard"),
				Size: pulumi.String("S1"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const exampleResourceGroup = new azure.core.ResourceGroup("exampleResourceGroup", {location: "West Europe"});
const examplePlan = new azure.appservice.Plan("examplePlan", {
    location: exampleResourceGroup.location,
    resourceGroupName: exampleResourceGroup.name,
    kind: "Linux",
    reserved: true,
    sku: {
        tier: "Standard",
        size: "S1",
    },
});

    import pulumi
import pulumi_azure as azure

example_resource_group = azure.core.ResourceGroup("exampleResourceGroup", location="West Europe")
example_plan = azure.appservice.Plan("examplePlan",
    location=example_resource_group.location,
    resource_group_name=example_resource_group.name,
    kind="Linux",
    reserved=True,
    sku=azure.appservice.PlanSkuArgs(
        tier="Standard",
        size="S1",
    ))

    Example coming soon!

    Windows Container)

    using Pulumi;
using Azure = Pulumi.Azure;

class MyStack : Stack
{
    public MyStack()
    {
        var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new Azure.Core.ResourceGroupArgs
        {
            Location = "West Europe",
        });
        var examplePlan = new Azure.AppService.Plan("examplePlan", new Azure.AppService.PlanArgs
        {
            Location = exampleResourceGroup.Location,
            ResourceGroupName = exampleResourceGroup.Name,
            Kind = "xenon",
            IsXenon = true,
            Sku = new Azure.AppService.Inputs.PlanSkuArgs
            {
                Tier = "PremiumContainer",
                Size = "PC2",
            },
        });
    }

}

    package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/appservice"
	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleResourceGroup, err := core.NewResourceGroup(ctx, "exampleResourceGroup", &core.ResourceGroupArgs{
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		_, err = appservice.NewPlan(ctx, "examplePlan", &appservice.PlanArgs{
			Location:          exampleResourceGroup.Location,
			ResourceGroupName: exampleResourceGroup.Name,
			Kind:              pulumi.Any("xenon"),
			IsXenon:           pulumi.Bool(true),
			Sku: &appservice.PlanSkuArgs{
				Tier: pulumi.String("PremiumContainer"),
				Size: pulumi.String("PC2"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const exampleResourceGroup = new azure.core.ResourceGroup("exampleResourceGroup", {location: "West Europe"});
const examplePlan = new azure.appservice.Plan("examplePlan", {
    location: exampleResourceGroup.location,
    resourceGroupName: exampleResourceGroup.name,
    kind: "xenon",
    isXenon: true,
    sku: {
        tier: "PremiumContainer",
        size: "PC2",
    },
});

    import pulumi
import pulumi_azure as azure

example_resource_group = azure.core.ResourceGroup("exampleResourceGroup", location="West Europe")
example_plan = azure.appservice.Plan("examplePlan",
    location=example_resource_group.location,
    resource_group_name=example_resource_group.name,
    kind="xenon",
    is_xenon=True,
    sku=azure.appservice.PlanSkuArgs(
        tier="PremiumContainer",
        size="PC2",
    ))

    Example coming soon!

    Create Plan Resource

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

    Constructor syntax

    new Plan(name: string, args: PlanArgs, opts?: CustomResourceOptions);
    @overload
def Plan(resource_name: str,
         args: PlanArgs,
         opts: Optional[ResourceOptions] = None)

@overload
def Plan(resource_name: str,
         opts: Optional[ResourceOptions] = None,
         resource_group_name: Optional[str] = None,
         sku: Optional[PlanSkuArgs] = None,
         app_service_environment_id: Optional[str] = None,
         is_xenon: Optional[bool] = None,
         kind: Optional[str] = None,
         location: Optional[str] = None,
         maximum_elastic_worker_count: Optional[int] = None,
         name: Optional[str] = None,
         per_site_scaling: Optional[bool] = None,
         reserved: Optional[bool] = None,
         tags: Optional[Mapping[str, str]] = None,
         zone_redundant: Optional[bool] = None)
    func NewPlan(ctx *Context, name string, args PlanArgs, opts ...ResourceOption) (*Plan, error)
    public Plan(string name, PlanArgs args, CustomResourceOptions? opts = null)
    public Plan(String name, PlanArgs args)
public Plan(String name, PlanArgs args, CustomResourceOptions options)

    type: azure:appservice:Plan
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 PlanArgs
    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 PlanArgs
    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 PlanArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args PlanArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args PlanArgs
    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 planResource = new Azure.AppService.Plan("planResource", new()
{
    ResourceGroupName = "string",
    Sku = new Azure.AppService.Inputs.PlanSkuArgs
    {
        Size = "string",
        Tier = "string",
        Capacity = 0,
    },
    AppServiceEnvironmentId = "string",
    IsXenon = false,
    Kind = "string",
    Location = "string",
    MaximumElasticWorkerCount = 0,
    Name = "string",
    PerSiteScaling = false,
    Reserved = false,
    Tags = 
    {
        { "string", "string" },
    },
    ZoneRedundant = false,
});

    example, err := appservice.NewPlan(ctx, "planResource", &appservice.PlanArgs{
	ResourceGroupName: pulumi.String("string"),
	Sku: &appservice.PlanSkuArgs{
		Size:     pulumi.String("string"),
		Tier:     pulumi.String("string"),
		Capacity: pulumi.Int(0),
	},
	AppServiceEnvironmentId:   pulumi.String("string"),
	IsXenon:                   pulumi.Bool(false),
	Kind:                      pulumi.Any("string"),
	Location:                  pulumi.String("string"),
	MaximumElasticWorkerCount: pulumi.Int(0),
	Name:                      pulumi.String("string"),
	PerSiteScaling:            pulumi.Bool(false),
	Reserved:                  pulumi.Bool(false),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	ZoneRedundant: pulumi.Bool(false),
})

    var planResource = new Plan("planResource", PlanArgs.builder()
    .resourceGroupName("string")
    .sku(PlanSkuArgs.builder()
        .size("string")
        .tier("string")
        .capacity(0)
        .build())
    .appServiceEnvironmentId("string")
    .isXenon(false)
    .kind("string")
    .location("string")
    .maximumElasticWorkerCount(0)
    .name("string")
    .perSiteScaling(false)
    .reserved(false)
    .tags(Map.of("string", "string"))
    .zoneRedundant(false)
    .build());

    plan_resource = azure.appservice.Plan("planResource",
    resource_group_name="string",
    sku={
        "size": "string",
        "tier": "string",
        "capacity": 0,
    },
    app_service_environment_id="string",
    is_xenon=False,
    kind="string",
    location="string",
    maximum_elastic_worker_count=0,
    name="string",
    per_site_scaling=False,
    reserved=False,
    tags={
        "string": "string",
    },
    zone_redundant=False)

    const planResource = new azure.appservice.Plan("planResource", {
    resourceGroupName: "string",
    sku: {
        size: "string",
        tier: "string",
        capacity: 0,
    },
    appServiceEnvironmentId: "string",
    isXenon: false,
    kind: "string",
    location: "string",
    maximumElasticWorkerCount: 0,
    name: "string",
    perSiteScaling: false,
    reserved: false,
    tags: {
        string: "string",
    },
    zoneRedundant: false,
});

    type: azure:appservice:Plan
properties:
    appServiceEnvironmentId: string
    isXenon: false
    kind: string
    location: string
    maximumElasticWorkerCount: 0
    name: string
    perSiteScaling: false
    reserved: false
    resourceGroupName: string
    sku:
        capacity: 0
        size: string
        tier: string
    tags:
        string: string
    zoneRedundant: false

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

    ResourceGroupName string
    The name of the resource group in which to create the App Service Plan component.
    Sku PlanSku
    A sku block as documented below.
    AppServiceEnvironmentId string
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    IsXenon bool
    Kind string | string
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    Location string
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    MaximumElasticWorkerCount int
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    Name string
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    PerSiteScaling bool
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    Reserved bool
    Is this App Service Plan Reserved. Defaults to false.
    Tags Dictionary<string, string>
    A mapping of tags to assign to the resource.
    ZoneRedundant bool
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    ResourceGroupName string
    The name of the resource group in which to create the App Service Plan component.
    Sku PlanSkuArgs
    A sku block as documented below.
    AppServiceEnvironmentId string
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    IsXenon bool
    Kind string | string
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    Location string
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    MaximumElasticWorkerCount int
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    Name string
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    PerSiteScaling bool
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    Reserved bool
    Is this App Service Plan Reserved. Defaults to false.
    Tags map[string]string
    A mapping of tags to assign to the resource.
    ZoneRedundant bool
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    resourceGroupName String
    The name of the resource group in which to create the App Service Plan component.
    sku PlanSku
    A sku block as documented below.
    appServiceEnvironmentId String
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    isXenon Boolean
    kind String | String
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    location String
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    maximumElasticWorkerCount Integer
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    name String
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    perSiteScaling Boolean
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    reserved Boolean
    Is this App Service Plan Reserved. Defaults to false.
    tags Map<String,String>
    A mapping of tags to assign to the resource.
    zoneRedundant Boolean
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    resourceGroupName string
    The name of the resource group in which to create the App Service Plan component.
    sku PlanSku
    A sku block as documented below.
    appServiceEnvironmentId string
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    isXenon boolean
    kind string | Kind
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    location string
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    maximumElasticWorkerCount number
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    name string
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    perSiteScaling boolean
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    reserved boolean
    Is this App Service Plan Reserved. Defaults to false.
    tags {[key: string]: string}
    A mapping of tags to assign to the resource.
    zoneRedundant boolean
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    resource_group_name str
    The name of the resource group in which to create the App Service Plan component.
    sku PlanSkuArgs
    A sku block as documented below.
    app_service_environment_id str
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    is_xenon bool
    kind str | str
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    location str
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    maximum_elastic_worker_count int
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    name str
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    per_site_scaling bool
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    reserved bool
    Is this App Service Plan Reserved. Defaults to false.
    tags Mapping[str, str]
    A mapping of tags to assign to the resource.
    zone_redundant bool
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    resourceGroupName String
    The name of the resource group in which to create the App Service Plan component.
    sku Property Map
    A sku block as documented below.
    appServiceEnvironmentId String
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    isXenon Boolean
    kind String |
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    location String
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    maximumElasticWorkerCount Number
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    name String
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    perSiteScaling Boolean
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    reserved Boolean
    Is this App Service Plan Reserved. Defaults to false.
    tags Map<String>
    A mapping of tags to assign to the resource.
    zoneRedundant Boolean
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    MaximumNumberOfWorkers int
    The maximum number of workers supported with the App Service Plan's sku.
    Id string
    The provider-assigned unique ID for this managed resource.
    MaximumNumberOfWorkers int
    The maximum number of workers supported with the App Service Plan's sku.
    id String
    The provider-assigned unique ID for this managed resource.
    maximumNumberOfWorkers Integer
    The maximum number of workers supported with the App Service Plan's sku.
    id string
    The provider-assigned unique ID for this managed resource.
    maximumNumberOfWorkers number
    The maximum number of workers supported with the App Service Plan's sku.
    id str
    The provider-assigned unique ID for this managed resource.
    maximum_number_of_workers int
    The maximum number of workers supported with the App Service Plan's sku.
    id String
    The provider-assigned unique ID for this managed resource.
    maximumNumberOfWorkers Number
    The maximum number of workers supported with the App Service Plan's sku.

    Look up Existing Plan Resource

    Get an existing Plan 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?: PlanState, opts?: CustomResourceOptions): Plan
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        app_service_environment_id: Optional[str] = None,
        is_xenon: Optional[bool] = None,
        kind: Optional[str] = None,
        location: Optional[str] = None,
        maximum_elastic_worker_count: Optional[int] = None,
        maximum_number_of_workers: Optional[int] = None,
        name: Optional[str] = None,
        per_site_scaling: Optional[bool] = None,
        reserved: Optional[bool] = None,
        resource_group_name: Optional[str] = None,
        sku: Optional[PlanSkuArgs] = None,
        tags: Optional[Mapping[str, str]] = None,
        zone_redundant: Optional[bool] = None) -> Plan
    func GetPlan(ctx *Context, name string, id IDInput, state *PlanState, opts ...ResourceOption) (*Plan, error)
    public static Plan Get(string name, Input<string> id, PlanState? state, CustomResourceOptions? opts = null)
    public static Plan get(String name, Output<String> id, PlanState state, CustomResourceOptions options)
    resources:  _:    type: azure:appservice:Plan    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:
    AppServiceEnvironmentId string
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    IsXenon bool
    Kind string | string
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    Location string
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    MaximumElasticWorkerCount int
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    MaximumNumberOfWorkers int
    The maximum number of workers supported with the App Service Plan's sku.
    Name string
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    PerSiteScaling bool
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    Reserved bool
    Is this App Service Plan Reserved. Defaults to false.
    ResourceGroupName string
    The name of the resource group in which to create the App Service Plan component.
    Sku PlanSku
    A sku block as documented below.
    Tags Dictionary<string, string>
    A mapping of tags to assign to the resource.
    ZoneRedundant bool
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    AppServiceEnvironmentId string
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    IsXenon bool
    Kind string | string
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    Location string
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    MaximumElasticWorkerCount int
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    MaximumNumberOfWorkers int
    The maximum number of workers supported with the App Service Plan's sku.
    Name string
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    PerSiteScaling bool
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    Reserved bool
    Is this App Service Plan Reserved. Defaults to false.
    ResourceGroupName string
    The name of the resource group in which to create the App Service Plan component.
    Sku PlanSkuArgs
    A sku block as documented below.
    Tags map[string]string
    A mapping of tags to assign to the resource.
    ZoneRedundant bool
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    appServiceEnvironmentId String
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    isXenon Boolean
    kind String | String
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    location String
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    maximumElasticWorkerCount Integer
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    maximumNumberOfWorkers Integer
    The maximum number of workers supported with the App Service Plan's sku.
    name String
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    perSiteScaling Boolean
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    reserved Boolean
    Is this App Service Plan Reserved. Defaults to false.
    resourceGroupName String
    The name of the resource group in which to create the App Service Plan component.
    sku PlanSku
    A sku block as documented below.
    tags Map<String,String>
    A mapping of tags to assign to the resource.
    zoneRedundant Boolean
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    appServiceEnvironmentId string
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    isXenon boolean
    kind string | Kind
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    location string
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    maximumElasticWorkerCount number
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    maximumNumberOfWorkers number
    The maximum number of workers supported with the App Service Plan's sku.
    name string
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    perSiteScaling boolean
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    reserved boolean
    Is this App Service Plan Reserved. Defaults to false.
    resourceGroupName string
    The name of the resource group in which to create the App Service Plan component.
    sku PlanSku
    A sku block as documented below.
    tags {[key: string]: string}
    A mapping of tags to assign to the resource.
    zoneRedundant boolean
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    app_service_environment_id str
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    is_xenon bool
    kind str | str
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    location str
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    maximum_elastic_worker_count int
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    maximum_number_of_workers int
    The maximum number of workers supported with the App Service Plan's sku.
    name str
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    per_site_scaling bool
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    reserved bool
    Is this App Service Plan Reserved. Defaults to false.
    resource_group_name str
    The name of the resource group in which to create the App Service Plan component.
    sku PlanSkuArgs
    A sku block as documented below.
    tags Mapping[str, str]
    A mapping of tags to assign to the resource.
    zone_redundant bool
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.
    appServiceEnvironmentId String
    The ID of the App Service Environment where the App Service Plan should be located. Changing forces a new resource to be created.
    isXenon Boolean
    kind String |
    The kind of the App Service Plan to create. Possible values are Windows (also available as App), Linux, elastic (for Premium Consumption) and FunctionApp (for a Consumption Plan). Defaults to Windows. Changing this forces a new resource to be created.
    location String
    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    maximumElasticWorkerCount Number
    The maximum number of total workers allowed for this ElasticScaleEnabled App Service Plan.
    maximumNumberOfWorkers Number
    The maximum number of workers supported with the App Service Plan's sku.
    name String
    Specifies the name of the App Service Plan component. Changing this forces a new resource to be created.
    perSiteScaling Boolean
    Can Apps assigned to this App Service Plan be scaled independently? If set to false apps assigned to this plan will scale to all instances of the plan. Defaults to false.
    reserved Boolean
    Is this App Service Plan Reserved. Defaults to false.
    resourceGroupName String
    The name of the resource group in which to create the App Service Plan component.
    sku Property Map
    A sku block as documented below.
    tags Map<String>
    A mapping of tags to assign to the resource.
    zoneRedundant Boolean
    Specifies if the App Service Plan should be Zone Redundant. Changing this forces a new resource to be created. Defaults to false.

    Supporting Types

    PlanSku, PlanSkuArgs

    Size string
    Specifies the plan's instance size.
    Tier string
    Specifies the plan's pricing tier.
    Capacity int
    Specifies the number of workers associated with this App Service Plan.
    Size string
    Specifies the plan's instance size.
    Tier string
    Specifies the plan's pricing tier.
    Capacity int
    Specifies the number of workers associated with this App Service Plan.
    size String
    Specifies the plan's instance size.
    tier String
    Specifies the plan's pricing tier.
    capacity Integer
    Specifies the number of workers associated with this App Service Plan.
    size string
    Specifies the plan's instance size.
    tier string
    Specifies the plan's pricing tier.
    capacity number
    Specifies the number of workers associated with this App Service Plan.
    size str
    Specifies the plan's instance size.
    tier str
    Specifies the plan's pricing tier.
    capacity int
    Specifies the number of workers associated with this App Service Plan.
    size String
    Specifies the plan's instance size.
    tier String
    Specifies the plan's pricing tier.
    capacity Number
    Specifies the number of workers associated with this App Service Plan.

    Import

    App Service Plan instances can be imported using the resource id, e.g.

     $ pulumi import azure:appservice/plan:Plan instance1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Web/serverfarms/instance1

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Azure Classic pulumi/pulumi-azure
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the azurerm Terraform Provider.
    azure logo

    We recommend using Azure Native.

    Viewing docs for Azure v4.42.0 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
    Go to latest version
    Schema (JSON)
    pulumi/pulumi-azure
      Try Pulumi Cloud free. Your team will thank you.