Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. AWS
  4. API Docs
  5. pricingplanmanager
  6. Subscription
Viewing docs for AWS v7.51.1
published on Friday, Oct 16, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

aws.pricingplanmanager.Subscription

aws logo aws logo
Viewing docs for AWS v7.51.1
published on Friday, Oct 16, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

    Resource for managing an AWS Pricing Plan Manager Subscription. A subscription applies a flat-rate pricing plan, such as an Amazon CloudFront flat-rate plan, to a set of AWS resources: you pay a fixed recurring fee for the covered resources instead of usage-based pricing.

    Destroying this resource cancels the subscription. For active paid subscriptions, AWS schedules the cancellation to take effect at the end of the current billing period, so the subscription remains visible (and billed) in AWS until that date. Subscriptions in PENDING_APPROVAL status (and free-tier subscriptions) are deleted immediately. If a scheduled change (such as a downgrade) is pending, it is reverted automatically before the cancellation is requested.

    While a distribution is covered by a subscription, CloudFront blocks removing or replacing its web ACL and blocks deleting the distribution — including after cancellation, until the cancellation takes effect at the end of the billing cycle.

    Resources must meet the plan family’s eligibility requirements or CreateSubscription fails with a ValidationException. For the CloudFront plan family, distributions using legacy cache settings (forwardedValues) are rejected as not eligible — use cache policies instead.

    Example Usage

    Basic Usage

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

const example = new aws.pricingplanmanager.Subscription("example", {
    planFamily: "CloudFront",
    planTier: "PRO",
    resourceArns: [
        exampleAwsCloudfrontDistribution.arn,
        exampleAwsWafv2WebAcl.arn,
    ],
});

    import pulumi
import pulumi_aws as aws

example = aws.pricingplanmanager.Subscription("example",
    plan_family="CloudFront",
    plan_tier="PRO",
    resource_arns=[
        example_aws_cloudfront_distribution["arn"],
        example_aws_wafv2_web_acl["arn"],
    ])

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/pricingplanmanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := pricingplanmanager.NewSubscription(ctx, "example", &pricingplanmanager.SubscriptionArgs{
			PlanFamily: pulumi.String("CloudFront"),
			PlanTier:   pulumi.String("PRO"),
			ResourceArns: pulumi.StringArray{
				exampleAwsCloudfrontDistribution.Arn,
				exampleAwsWafv2WebAcl.Arn,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.PricingPlanManager.Subscription("example", new()
    {
        PlanFamily = "CloudFront",
        PlanTier = "PRO",
        ResourceArns = new[]
        {
            exampleAwsCloudfrontDistribution.Arn,
            exampleAwsWafv2WebAcl.Arn,
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.pricingplanmanager.Subscription;
import com.pulumi.aws.pricingplanmanager.SubscriptionArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 Subscription("example", SubscriptionArgs.builder()
            .planFamily("CloudFront")
            .planTier("PRO")
            .resourceArns(            
                exampleAwsCloudfrontDistribution.arn(),
                exampleAwsWafv2WebAcl.arn())
            .build());

    }
}

    resources:
  example:
    type: aws:pricingplanmanager:Subscription
    properties:
      planFamily: CloudFront
      planTier: PRO
      resourceArns:
        - ${exampleAwsCloudfrontDistribution.arn}
        - ${exampleAwsWafv2WebAcl.arn}

    pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_pricingplanmanager_subscription" "example" {
  plan_family   = "CloudFront"
  plan_tier     = "PRO"
  resource_arns = [exampleAwsCloudfrontDistribution.arn, exampleAwsWafv2WebAcl.arn]
}

    Manual Approval

    Paid-tier subscriptions created with approvalMode = "MANUAL" (the AWS default for paid tiers when approvalMode is not set) remain in PENDING_APPROVAL status, and billing does not start, until approved with a separate ApprovePaidSubscription API call.

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

const example = new aws.pricingplanmanager.Subscription("example", {
    approvalMode: "MANUAL",
    planFamily: "CloudFront",
    planTier: "BUSINESS",
    resourceArns: [
        exampleAwsCloudfrontDistribution.arn,
        exampleAwsWafv2WebAcl.arn,
    ],
});

    import pulumi
import pulumi_aws as aws

example = aws.pricingplanmanager.Subscription("example",
    approval_mode="MANUAL",
    plan_family="CloudFront",
    plan_tier="BUSINESS",
    resource_arns=[
        example_aws_cloudfront_distribution["arn"],
        example_aws_wafv2_web_acl["arn"],
    ])

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/pricingplanmanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := pricingplanmanager.NewSubscription(ctx, "example", &pricingplanmanager.SubscriptionArgs{
			ApprovalMode: pulumi.String("MANUAL"),
			PlanFamily:   pulumi.String("CloudFront"),
			PlanTier:     pulumi.String("BUSINESS"),
			ResourceArns: pulumi.StringArray{
				exampleAwsCloudfrontDistribution.Arn,
				exampleAwsWafv2WebAcl.Arn,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.PricingPlanManager.Subscription("example", new()
    {
        ApprovalMode = "MANUAL",
        PlanFamily = "CloudFront",
        PlanTier = "BUSINESS",
        ResourceArns = new[]
        {
            exampleAwsCloudfrontDistribution.Arn,
            exampleAwsWafv2WebAcl.Arn,
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.pricingplanmanager.Subscription;
import com.pulumi.aws.pricingplanmanager.SubscriptionArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 Subscription("example", SubscriptionArgs.builder()
            .approvalMode("MANUAL")
            .planFamily("CloudFront")
            .planTier("BUSINESS")
            .resourceArns(            
                exampleAwsCloudfrontDistribution.arn(),
                exampleAwsWafv2WebAcl.arn())
            .build());

    }
}

    resources:
  example:
    type: aws:pricingplanmanager:Subscription
    properties:
      approvalMode: MANUAL
      planFamily: CloudFront
      planTier: BUSINESS
      resourceArns:
        - ${exampleAwsCloudfrontDistribution.arn}
        - ${exampleAwsWafv2WebAcl.arn}

    pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_pricingplanmanager_subscription" "example" {
  approval_mode = "MANUAL"
  plan_family   = "CloudFront"
  plan_tier     = "BUSINESS"
  resource_arns = [exampleAwsCloudfrontDistribution.arn, exampleAwsWafv2WebAcl.arn]
}

    Create Subscription Resource

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

    Constructor syntax

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

@overload
def Subscription(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 plan_family: Optional[str] = None,
                 plan_tier: Optional[str] = None,
                 resource_arns: Optional[Sequence[str]] = None,
                 approval_mode: Optional[str] = None,
                 timeouts: Optional[SubscriptionTimeoutsArgs] = None,
                 usage_level: Optional[str] = None)
    func NewSubscription(ctx *Context, name string, args SubscriptionArgs, opts ...ResourceOption) (*Subscription, error)
    public Subscription(string name, SubscriptionArgs args, CustomResourceOptions? opts = null)
    public Subscription(String name, SubscriptionArgs args)
public Subscription(String name, SubscriptionArgs args, CustomResourceOptions options)

    type: aws:pricingplanmanager:Subscription
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "aws_pricingplanmanager_subscription" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args SubscriptionArgs
    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 SubscriptionArgs
    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 SubscriptionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args SubscriptionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args SubscriptionArgs
    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 subscriptionResource = new Aws.PricingPlanManager.Subscription("subscriptionResource", new()
{
    PlanFamily = "string",
    PlanTier = "string",
    ResourceArns = new[]
    {
        "string",
    },
    ApprovalMode = "string",
    Timeouts = new Aws.PricingPlanManager.Inputs.SubscriptionTimeoutsArgs
    {
        Create = "string",
        Delete = "string",
        Update = "string",
    },
    UsageLevel = "string",
});

    example, err := pricingplanmanager.NewSubscription(ctx, "subscriptionResource", &pricingplanmanager.SubscriptionArgs{
	PlanFamily: pulumi.String("string"),
	PlanTier:   pulumi.String("string"),
	ResourceArns: pulumi.StringArray{
		pulumi.String("string"),
	},
	ApprovalMode: pulumi.String("string"),
	Timeouts: &pricingplanmanager.SubscriptionTimeoutsArgs{
		Create: pulumi.String("string"),
		Delete: pulumi.String("string"),
		Update: pulumi.String("string"),
	},
	UsageLevel: pulumi.String("string"),
})

    resource "aws_pricingplanmanager_subscription" "subscriptionResource" {
  lifecycle {
    create_before_destroy = true
  }
  plan_family   = "string"
  plan_tier     = "string"
  resource_arns = ["string"]
  approval_mode = "string"
  timeouts = {
    create = "string"
    delete = "string"
    update = "string"
  }
  usage_level = "string"
}

    var subscriptionResource = new com.pulumi.aws.pricingplanmanager.Subscription("subscriptionResource", com.pulumi.aws.pricingplanmanager.SubscriptionArgs.builder()
    .planFamily("string")
    .planTier("string")
    .resourceArns("string")
    .approvalMode("string")
    .timeouts(SubscriptionTimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .update("string")
        .build())
    .usageLevel("string")
    .build());

    subscription_resource = aws.pricingplanmanager.Subscription("subscriptionResource",
    plan_family="string",
    plan_tier="string",
    resource_arns=["string"],
    approval_mode="string",
    timeouts={
        "create": "string",
        "delete": "string",
        "update": "string",
    },
    usage_level="string")

    const subscriptionResource = new aws.pricingplanmanager.Subscription("subscriptionResource", {
    planFamily: "string",
    planTier: "string",
    resourceArns: ["string"],
    approvalMode: "string",
    timeouts: {
        create: "string",
        "delete": "string",
        update: "string",
    },
    usageLevel: "string",
});

    type: aws:pricingplanmanager:Subscription
properties:
    approvalMode: string
    planFamily: string
    planTier: string
    resourceArns:
        - string
    timeouts:
        create: string
        delete: string
        update: string
    usageLevel: string

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

    PlanFamily string
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    PlanTier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    ResourceArns List<string>

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    ApprovalMode string
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    Timeouts SubscriptionTimeouts
    UsageLevel string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    PlanFamily string
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    PlanTier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    ResourceArns []string

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    ApprovalMode string
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    Timeouts SubscriptionTimeoutsArgs
    UsageLevel string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    plan_family string
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    plan_tier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resource_arns list(string)

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    approval_mode string
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    timeouts object
    usage_level string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    planFamily String
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    planTier String
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resourceArns List<String>

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    approvalMode String
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    timeouts SubscriptionTimeouts
    usageLevel String
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    planFamily string
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    planTier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resourceArns string[]

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    approvalMode string
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    timeouts SubscriptionTimeouts
    usageLevel string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    plan_family str
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    plan_tier str
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resource_arns Sequence[str]

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    approval_mode str
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    timeouts SubscriptionTimeoutsArgs
    usage_level str
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    planFamily String
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    planTier String
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resourceArns List<String>

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    approvalMode String
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    timeouts Property Map
    usageLevel String
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.

    Outputs

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

    Arn string
    ARN of the subscription.
    Etag string
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    Id string
    The provider-assigned unique ID for this managed resource.
    ScheduledChanges List<SubscriptionScheduledChange>
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    Status string
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    StatusReason string
    Human-readable explanation of the current status, when available.
    Arn string
    ARN of the subscription.
    Etag string
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    Id string
    The provider-assigned unique ID for this managed resource.
    ScheduledChanges []SubscriptionScheduledChange
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    Status string
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    StatusReason string
    Human-readable explanation of the current status, when available.
    arn string
    ARN of the subscription.
    etag string
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    id string
    The provider-assigned unique ID for this managed resource.
    scheduled_changes list(object)
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status string
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    status_reason string
    Human-readable explanation of the current status, when available.
    arn String
    ARN of the subscription.
    etag String
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    id String
    The provider-assigned unique ID for this managed resource.
    scheduledChanges List<SubscriptionScheduledChange>
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status String
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    statusReason String
    Human-readable explanation of the current status, when available.
    arn string
    ARN of the subscription.
    etag string
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    id string
    The provider-assigned unique ID for this managed resource.
    scheduledChanges SubscriptionScheduledChange[]
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status string
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    statusReason string
    Human-readable explanation of the current status, when available.
    arn str
    ARN of the subscription.
    etag str
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    id str
    The provider-assigned unique ID for this managed resource.
    scheduled_changes Sequence[SubscriptionScheduledChange]
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status str
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    status_reason str
    Human-readable explanation of the current status, when available.
    arn String
    ARN of the subscription.
    etag String
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    id String
    The provider-assigned unique ID for this managed resource.
    scheduledChanges List<Property Map>
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status String
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    statusReason String
    Human-readable explanation of the current status, when available.

    Look up Existing Subscription Resource

    Get an existing Subscription 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?: SubscriptionState, opts?: CustomResourceOptions): Subscription
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        approval_mode: Optional[str] = None,
        arn: Optional[str] = None,
        etag: Optional[str] = None,
        plan_family: Optional[str] = None,
        plan_tier: Optional[str] = None,
        resource_arns: Optional[Sequence[str]] = None,
        scheduled_changes: Optional[Sequence[SubscriptionScheduledChangeArgs]] = None,
        status: Optional[str] = None,
        status_reason: Optional[str] = None,
        timeouts: Optional[SubscriptionTimeoutsArgs] = None,
        usage_level: Optional[str] = None) -> Subscription
    func GetSubscription(ctx *Context, name string, id IDInput, state *SubscriptionState, opts ...ResourceOption) (*Subscription, error)
    public static Subscription Get(string name, Input<string> id, SubscriptionState? state, CustomResourceOptions? opts = null)
    public static Subscription get(String name, Output<String> id, SubscriptionState state, CustomResourceOptions options)
    resources:  _:    type: aws:pricingplanmanager:Subscription    get:      id: ${id}
    import {
  to = aws_pricingplanmanager_subscription.example
  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:
    ApprovalMode string
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    Arn string
    ARN of the subscription.
    Etag string
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    PlanFamily string
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    PlanTier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    ResourceArns List<string>

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    ScheduledChanges List<SubscriptionScheduledChange>
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    Status string
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    StatusReason string
    Human-readable explanation of the current status, when available.
    Timeouts SubscriptionTimeouts
    UsageLevel string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    ApprovalMode string
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    Arn string
    ARN of the subscription.
    Etag string
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    PlanFamily string
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    PlanTier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    ResourceArns []string

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    ScheduledChanges []SubscriptionScheduledChangeArgs
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    Status string
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    StatusReason string
    Human-readable explanation of the current status, when available.
    Timeouts SubscriptionTimeoutsArgs
    UsageLevel string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    approval_mode string
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    arn string
    ARN of the subscription.
    etag string
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    plan_family string
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    plan_tier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resource_arns list(string)

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    scheduled_changes list(object)
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status string
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    status_reason string
    Human-readable explanation of the current status, when available.
    timeouts object
    usage_level string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    approvalMode String
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    arn String
    ARN of the subscription.
    etag String
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    planFamily String
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    planTier String
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resourceArns List<String>

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    scheduledChanges List<SubscriptionScheduledChange>
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status String
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    statusReason String
    Human-readable explanation of the current status, when available.
    timeouts SubscriptionTimeouts
    usageLevel String
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    approvalMode string
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    arn string
    ARN of the subscription.
    etag string
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    planFamily string
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    planTier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resourceArns string[]

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    scheduledChanges SubscriptionScheduledChange[]
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status string
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    statusReason string
    Human-readable explanation of the current status, when available.
    timeouts SubscriptionTimeouts
    usageLevel string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    approval_mode str
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    arn str
    ARN of the subscription.
    etag str
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    plan_family str
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    plan_tier str
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resource_arns Sequence[str]

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    scheduled_changes Sequence[SubscriptionScheduledChangeArgs]
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status str
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    status_reason str
    Human-readable explanation of the current status, when available.
    timeouts SubscriptionTimeoutsArgs
    usage_level str
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    approvalMode String
    Whether the subscription requires explicit approval before billing starts. Valid values: MANUAL, IMMEDIATE. If not set, AWS defaults to MANUAL for paid-tier subscriptions and IMMEDIATE for FREE tier subscriptions. With MANUAL, paid-tier subscriptions remain in PENDING_APPROVAL (unbilled, and unmodifiable) until approved with a separate ApprovePaidSubscription API call. This value is used only at creation time and is not returned by the AWS API. Changing this argument creates a new resource.
    arn String
    ARN of the subscription.
    etag String
    Entity tag of the subscription, used by AWS for optimistic concurrency control.
    planFamily String
    Pricing plan family to subscribe to, such as CloudFront. Changing this argument creates a new resource.
    planTier String
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    resourceArns List<String>

    Set of ARNs of the AWS resources to include in the subscription, between 1 and 10 entries. For subscriptions in the CloudFront plan family, the resources must include exactly one CloudFront distribution and exactly one WAF web ACL, and can also include other supported resources such as Route 53 hosted zones (any tier) and CloudFront KeyValueStores (paid tiers only). Associated resources are protected by AWS while covered — for example, a hosted zone cannot be deleted until it is disassociated from the plan.

    The following arguments are optional:

    scheduledChanges List<Property Map>
    Pending change that takes effect at the end of the current billing period, if any. See scheduledChange below.
    status String
    Current status of the subscription. Valid values: PENDING_APPROVAL, ACTIVE, SYNC_IN_PROGRESS, FAILED.
    statusReason String
    Human-readable explanation of the current status, when available.
    timeouts Property Map
    usageLevel String
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.

    Supporting Types

    SubscriptionScheduledChange, SubscriptionScheduledChangeArgs

    ChangeType string
    Type of pending change. Valid values: DOWNGRADE, CANCELLATION.
    EffectiveDate string
    Date and time when the change takes effect.
    PlanTier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    UsageLevel string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    ChangeType string
    Type of pending change. Valid values: DOWNGRADE, CANCELLATION.
    EffectiveDate string
    Date and time when the change takes effect.
    PlanTier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    UsageLevel string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    change_type string
    Type of pending change. Valid values: DOWNGRADE, CANCELLATION.
    effective_date string
    Date and time when the change takes effect.
    plan_tier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    usage_level string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    changeType String
    Type of pending change. Valid values: DOWNGRADE, CANCELLATION.
    effectiveDate String
    Date and time when the change takes effect.
    planTier String
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    usageLevel String
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    changeType string
    Type of pending change. Valid values: DOWNGRADE, CANCELLATION.
    effectiveDate string
    Date and time when the change takes effect.
    planTier string
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    usageLevel string
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    change_type str
    Type of pending change. Valid values: DOWNGRADE, CANCELLATION.
    effective_date str
    Date and time when the change takes effect.
    plan_tier str
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    usage_level str
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.
    changeType String
    Type of pending change. Valid values: DOWNGRADE, CANCELLATION.
    effectiveDate String
    Date and time when the change takes effect.
    planTier String
    Tier level for the subscription, such as FREE, PRO, BUSINESS, or PREMIUM. Upgrades take effect immediately. Downgrades are scheduled by AWS to take effect at the end of the current billing period: until then AWS keeps billing the old tier and this argument reflects the desired (scheduled) tier, with the pending change exposed in scheduledChange. Raising the tier again before the downgrade takes effect reverts the pending change.
    usageLevel String
    Usage level within the plan tier. Specify DEFAULT for the base configuration, or a higher level if the plan tier supports it. If omitted on an update, the usage level is reset to the plan tier's default.

    SubscriptionTimeouts, SubscriptionTimeoutsArgs

    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    Update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    Update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

    Import

    Identity Schema

    Required

    • arn (String) ARN of the Pricing Plan Manager Subscription.

    Using pulumi import, import Pricing Plan Manager Subscription using the arn. For example:

    $ pulumi import aws:pricingplanmanager/subscription:Subscription example arn:aws:pricingplanmanager::123456789012:subscription:sub_1a2B3c4D5e6F7g8H9i0JkLmNoPq

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

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo aws logo
    Viewing docs for AWS v7.51.1
    published on Friday, Oct 16, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial