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

We recommend using Azure Native.

Azure Classic v5.73.0 published on Monday, Apr 22, 2024 by Pulumi

azure.appservice.ServicePlan

Explore with Pulumi AI

azure logo

We recommend using Azure Native.

Azure Classic v5.73.0 published on Monday, Apr 22, 2024 by Pulumi

    Manages an App Service: Service Plan.

    Example Usage

    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 exampleServicePlan = new azure.appservice.ServicePlan("example", {
        name: "example",
        resourceGroupName: example.name,
        location: example.location,
        osType: "Linux",
        skuName: "P1v2",
    });
    
    import pulumi
    import pulumi_azure as azure
    
    example = azure.core.ResourceGroup("example",
        name="example-resources",
        location="West Europe")
    example_service_plan = azure.appservice.ServicePlan("example",
        name="example",
        resource_group_name=example.name,
        location=example.location,
        os_type="Linux",
        sku_name="P1v2")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/appservice"
    	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		example, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
    			Name:     pulumi.String("example-resources"),
    			Location: pulumi.String("West Europe"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = appservice.NewServicePlan(ctx, "example", &appservice.ServicePlanArgs{
    			Name:              pulumi.String("example"),
    			ResourceGroupName: example.Name,
    			Location:          example.Location,
    			OsType:            pulumi.String("Linux"),
    			SkuName:           pulumi.String("P1v2"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Azure = Pulumi.Azure;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Azure.Core.ResourceGroup("example", new()
        {
            Name = "example-resources",
            Location = "West Europe",
        });
    
        var exampleServicePlan = new Azure.AppService.ServicePlan("example", new()
        {
            Name = "example",
            ResourceGroupName = example.Name,
            Location = example.Location,
            OsType = "Linux",
            SkuName = "P1v2",
        });
    
    });
    
    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.ServicePlan;
    import com.pulumi.azure.appservice.ServicePlanArgs;
    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 example = new ResourceGroup("example", ResourceGroupArgs.builder()        
                .name("example-resources")
                .location("West Europe")
                .build());
    
            var exampleServicePlan = new ServicePlan("exampleServicePlan", ServicePlanArgs.builder()        
                .name("example")
                .resourceGroupName(example.name())
                .location(example.location())
                .osType("Linux")
                .skuName("P1v2")
                .build());
    
        }
    }
    
    resources:
      example:
        type: azure:core:ResourceGroup
        properties:
          name: example-resources
          location: West Europe
      exampleServicePlan:
        type: azure:appservice:ServicePlan
        name: example
        properties:
          name: example
          resourceGroupName: ${example.name}
          location: ${example.location}
          osType: Linux
          skuName: P1v2
    

    Create ServicePlan Resource

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

    Constructor syntax

    new ServicePlan(name: string, args: ServicePlanArgs, opts?: CustomResourceOptions);
    @overload
    def ServicePlan(resource_name: str,
                    args: ServicePlanArgs,
                    opts: Optional[ResourceOptions] = None)
    
    @overload
    def ServicePlan(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    os_type: Optional[str] = None,
                    resource_group_name: Optional[str] = None,
                    sku_name: Optional[str] = None,
                    app_service_environment_id: Optional[str] = None,
                    location: Optional[str] = None,
                    maximum_elastic_worker_count: Optional[int] = None,
                    name: Optional[str] = None,
                    per_site_scaling_enabled: Optional[bool] = None,
                    tags: Optional[Mapping[str, str]] = None,
                    worker_count: Optional[int] = None,
                    zone_balancing_enabled: Optional[bool] = None)
    func NewServicePlan(ctx *Context, name string, args ServicePlanArgs, opts ...ResourceOption) (*ServicePlan, error)
    public ServicePlan(string name, ServicePlanArgs args, CustomResourceOptions? opts = null)
    public ServicePlan(String name, ServicePlanArgs args)
    public ServicePlan(String name, ServicePlanArgs args, CustomResourceOptions options)
    
    type: azure:appservice:ServicePlan
    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 ServicePlanArgs
    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 ServicePlanArgs
    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 ServicePlanArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ServicePlanArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ServicePlanArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Example

    The following reference example uses placeholder values for all input properties.

    var servicePlanResource = new Azure.AppService.ServicePlan("servicePlanResource", new()
    {
        OsType = "string",
        ResourceGroupName = "string",
        SkuName = "string",
        AppServiceEnvironmentId = "string",
        Location = "string",
        MaximumElasticWorkerCount = 0,
        Name = "string",
        PerSiteScalingEnabled = false,
        Tags = 
        {
            { "string", "string" },
        },
        WorkerCount = 0,
        ZoneBalancingEnabled = false,
    });
    
    example, err := appservice.NewServicePlan(ctx, "servicePlanResource", &appservice.ServicePlanArgs{
    	OsType:                    pulumi.String("string"),
    	ResourceGroupName:         pulumi.String("string"),
    	SkuName:                   pulumi.String("string"),
    	AppServiceEnvironmentId:   pulumi.String("string"),
    	Location:                  pulumi.String("string"),
    	MaximumElasticWorkerCount: pulumi.Int(0),
    	Name:                      pulumi.String("string"),
    	PerSiteScalingEnabled:     pulumi.Bool(false),
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	WorkerCount:          pulumi.Int(0),
    	ZoneBalancingEnabled: pulumi.Bool(false),
    })
    
    var servicePlanResource = new ServicePlan("servicePlanResource", ServicePlanArgs.builder()        
        .osType("string")
        .resourceGroupName("string")
        .skuName("string")
        .appServiceEnvironmentId("string")
        .location("string")
        .maximumElasticWorkerCount(0)
        .name("string")
        .perSiteScalingEnabled(false)
        .tags(Map.of("string", "string"))
        .workerCount(0)
        .zoneBalancingEnabled(false)
        .build());
    
    service_plan_resource = azure.appservice.ServicePlan("servicePlanResource",
        os_type="string",
        resource_group_name="string",
        sku_name="string",
        app_service_environment_id="string",
        location="string",
        maximum_elastic_worker_count=0,
        name="string",
        per_site_scaling_enabled=False,
        tags={
            "string": "string",
        },
        worker_count=0,
        zone_balancing_enabled=False)
    
    const servicePlanResource = new azure.appservice.ServicePlan("servicePlanResource", {
        osType: "string",
        resourceGroupName: "string",
        skuName: "string",
        appServiceEnvironmentId: "string",
        location: "string",
        maximumElasticWorkerCount: 0,
        name: "string",
        perSiteScalingEnabled: false,
        tags: {
            string: "string",
        },
        workerCount: 0,
        zoneBalancingEnabled: false,
    });
    
    type: azure:appservice:ServicePlan
    properties:
        appServiceEnvironmentId: string
        location: string
        maximumElasticWorkerCount: 0
        name: string
        osType: string
        perSiteScalingEnabled: false
        resourceGroupName: string
        skuName: string
        tags:
            string: string
        workerCount: 0
        zoneBalancingEnabled: false
    

    ServicePlan Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The ServicePlan resource accepts the following input properties:

    OsType string
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    ResourceGroupName string
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    SkuName string

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    AppServiceEnvironmentId string

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    Location string
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    MaximumElasticWorkerCount int
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    Name string
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    PerSiteScalingEnabled bool
    Should Per Site Scaling be enabled. Defaults to false.
    Tags Dictionary<string, string>
    A mapping of tags which should be assigned to the AppService.
    WorkerCount int
    The number of Workers (instances) to be allocated.
    ZoneBalancingEnabled bool

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    OsType string
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    ResourceGroupName string
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    SkuName string

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    AppServiceEnvironmentId string

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    Location string
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    MaximumElasticWorkerCount int
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    Name string
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    PerSiteScalingEnabled bool
    Should Per Site Scaling be enabled. Defaults to false.
    Tags map[string]string
    A mapping of tags which should be assigned to the AppService.
    WorkerCount int
    The number of Workers (instances) to be allocated.
    ZoneBalancingEnabled bool

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    osType String
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    resourceGroupName String
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    skuName String

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    appServiceEnvironmentId String

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    location String
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    maximumElasticWorkerCount Integer
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    name String
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    perSiteScalingEnabled Boolean
    Should Per Site Scaling be enabled. Defaults to false.
    tags Map<String,String>
    A mapping of tags which should be assigned to the AppService.
    workerCount Integer
    The number of Workers (instances) to be allocated.
    zoneBalancingEnabled Boolean

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    osType string
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    resourceGroupName string
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    skuName string

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    appServiceEnvironmentId string

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    location string
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    maximumElasticWorkerCount number
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    name string
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    perSiteScalingEnabled boolean
    Should Per Site Scaling be enabled. Defaults to false.
    tags {[key: string]: string}
    A mapping of tags which should be assigned to the AppService.
    workerCount number
    The number of Workers (instances) to be allocated.
    zoneBalancingEnabled boolean

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    os_type str
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    resource_group_name str
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    sku_name str

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    app_service_environment_id str

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    location str
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    maximum_elastic_worker_count int
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    name str
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    per_site_scaling_enabled bool
    Should Per Site Scaling be enabled. Defaults to false.
    tags Mapping[str, str]
    A mapping of tags which should be assigned to the AppService.
    worker_count int
    The number of Workers (instances) to be allocated.
    zone_balancing_enabled bool

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    osType String
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    resourceGroupName String
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    skuName String

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    appServiceEnvironmentId String

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    location String
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    maximumElasticWorkerCount Number
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    name String
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    perSiteScalingEnabled Boolean
    Should Per Site Scaling be enabled. Defaults to false.
    tags Map<String>
    A mapping of tags which should be assigned to the AppService.
    workerCount Number
    The number of Workers (instances) to be allocated.
    zoneBalancingEnabled Boolean

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Kind string
    A string representing the Kind of Service Plan.
    Reserved bool
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    Id string
    The provider-assigned unique ID for this managed resource.
    Kind string
    A string representing the Kind of Service Plan.
    Reserved bool
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    id String
    The provider-assigned unique ID for this managed resource.
    kind String
    A string representing the Kind of Service Plan.
    reserved Boolean
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    id string
    The provider-assigned unique ID for this managed resource.
    kind string
    A string representing the Kind of Service Plan.
    reserved boolean
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    id str
    The provider-assigned unique ID for this managed resource.
    kind str
    A string representing the Kind of Service Plan.
    reserved bool
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    id String
    The provider-assigned unique ID for this managed resource.
    kind String
    A string representing the Kind of Service Plan.
    reserved Boolean
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.

    Look up Existing ServicePlan Resource

    Get an existing ServicePlan 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?: ServicePlanState, opts?: CustomResourceOptions): ServicePlan
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            app_service_environment_id: Optional[str] = None,
            kind: Optional[str] = None,
            location: Optional[str] = None,
            maximum_elastic_worker_count: Optional[int] = None,
            name: Optional[str] = None,
            os_type: Optional[str] = None,
            per_site_scaling_enabled: Optional[bool] = None,
            reserved: Optional[bool] = None,
            resource_group_name: Optional[str] = None,
            sku_name: Optional[str] = None,
            tags: Optional[Mapping[str, str]] = None,
            worker_count: Optional[int] = None,
            zone_balancing_enabled: Optional[bool] = None) -> ServicePlan
    func GetServicePlan(ctx *Context, name string, id IDInput, state *ServicePlanState, opts ...ResourceOption) (*ServicePlan, error)
    public static ServicePlan Get(string name, Input<string> id, ServicePlanState? state, CustomResourceOptions? opts = null)
    public static ServicePlan get(String name, Output<String> id, ServicePlanState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    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 to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    Kind string
    A string representing the Kind of Service Plan.
    Location string
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    MaximumElasticWorkerCount int
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    Name string
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    OsType string
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    PerSiteScalingEnabled bool
    Should Per Site Scaling be enabled. Defaults to false.
    Reserved bool
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    ResourceGroupName string
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    SkuName string

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    Tags Dictionary<string, string>
    A mapping of tags which should be assigned to the AppService.
    WorkerCount int
    The number of Workers (instances) to be allocated.
    ZoneBalancingEnabled bool

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    AppServiceEnvironmentId string

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    Kind string
    A string representing the Kind of Service Plan.
    Location string
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    MaximumElasticWorkerCount int
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    Name string
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    OsType string
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    PerSiteScalingEnabled bool
    Should Per Site Scaling be enabled. Defaults to false.
    Reserved bool
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    ResourceGroupName string
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    SkuName string

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    Tags map[string]string
    A mapping of tags which should be assigned to the AppService.
    WorkerCount int
    The number of Workers (instances) to be allocated.
    ZoneBalancingEnabled bool

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    appServiceEnvironmentId String

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    kind String
    A string representing the Kind of Service Plan.
    location String
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    maximumElasticWorkerCount Integer
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    name String
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    osType String
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    perSiteScalingEnabled Boolean
    Should Per Site Scaling be enabled. Defaults to false.
    reserved Boolean
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    resourceGroupName String
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    skuName String

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    tags Map<String,String>
    A mapping of tags which should be assigned to the AppService.
    workerCount Integer
    The number of Workers (instances) to be allocated.
    zoneBalancingEnabled Boolean

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    appServiceEnvironmentId string

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    kind string
    A string representing the Kind of Service Plan.
    location string
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    maximumElasticWorkerCount number
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    name string
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    osType string
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    perSiteScalingEnabled boolean
    Should Per Site Scaling be enabled. Defaults to false.
    reserved boolean
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    resourceGroupName string
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    skuName string

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    tags {[key: string]: string}
    A mapping of tags which should be assigned to the AppService.
    workerCount number
    The number of Workers (instances) to be allocated.
    zoneBalancingEnabled boolean

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    app_service_environment_id str

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    kind str
    A string representing the Kind of Service Plan.
    location str
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    maximum_elastic_worker_count int
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    name str
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    os_type str
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    per_site_scaling_enabled bool
    Should Per Site Scaling be enabled. Defaults to false.
    reserved bool
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    resource_group_name str
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    sku_name str

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    tags Mapping[str, str]
    A mapping of tags which should be assigned to the AppService.
    worker_count int
    The number of Workers (instances) to be allocated.
    zone_balancing_enabled bool

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    appServiceEnvironmentId String

    The ID of the App Service Environment to create this Service Plan in.

    NOTE: Requires an Isolated SKU. Use one of I1, I2, I3 for azure.appservice.Environment, or I1v2, I2v2, I3v2 for azure.appservice.EnvironmentV3

    kind String
    A string representing the Kind of Service Plan.
    location String
    The Azure Region where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    maximumElasticWorkerCount Number
    The maximum number of workers to use in an Elastic SKU Plan. Cannot be set unless using an Elastic SKU.
    name String
    The name which should be used for this Service Plan. Changing this forces a new Service Plan to be created.
    osType String
    The O/S type for the App Services to be hosted in this plan. Possible values include Windows, Linux, and WindowsContainer. Changing this forces a new resource to be created.
    perSiteScalingEnabled Boolean
    Should Per Site Scaling be enabled. Defaults to false.
    reserved Boolean
    Whether this is a reserved Service Plan Type. true if os_type is Linux, otherwise false.
    resourceGroupName String
    The name of the Resource Group where the Service Plan should exist. Changing this forces a new Service Plan to be created.
    skuName String

    The SKU for the plan. Possible values include B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, and Y1.

    NOTE: Isolated SKUs (I1, I2, I3, I1v2, I2v2, and I3v2) can only be used with App Service Environments

    NOTE: Elastic and Consumption SKUs (Y1, EP1, EP2, and EP3) are for use with Function Apps.

    tags Map<String>
    A mapping of tags which should be assigned to the AppService.
    workerCount Number
    The number of Workers (instances) to be allocated.
    zoneBalancingEnabled Boolean

    Should the Service Plan balance across Availability Zones in the region. Changing this forces a new resource to be created.

    NOTE: If this setting is set to true and the worker_count value is specified, it should be set to a multiple of the number of availability zones in the region. Please see the Azure documentation for the number of Availability Zones in your region.

    Import

    AppServices can be imported using the resource id, e.g.

    $ pulumi import azure:appservice/servicePlan:ServicePlan example /subscriptions/12345678-1234-9876-4563-123456789012/resourceGroups/resGroup1/providers/Microsoft.Web/serverFarms/farm1
    

    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.

    Azure Classic v5.73.0 published on Monday, Apr 22, 2024 by Pulumi