We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 14, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 14, 2026 by Pulumi
Resource type definition for AWS::PricingPlanManager::Subscription. Deleting an activated subscription does not terminate it immediately; it schedules a cancellation that takes effect at the end of the current billing period. Until that date the subscription remains active and billing continues. Deleting a subscription that has not yet been activated (PENDING_APPROVAL status) removes it immediately with no further charges.
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[SubscriptionPlanFamily] = None,
plan_tier: Optional[str] = None,
resource_arns: Optional[Sequence[str]] = None,
usage_level: Optional[SubscriptionUsageLevel] = 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-native:pricingplanmanager:Subscription
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "aws-native_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.
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:
- Plan
Family Pulumi.Aws Native. Pricing Plan Manager. Subscription Plan Family - The name of the pricing plan family.
- Plan
Tier string - The tier of the pricing plan. CloudFormation does not change the tier of an existing subscription; a stack update that changes the tier, upgrading or downgrading it, is rejected.
- Resource
Arns List<string> - The ARNs of resources associated with the subscription.
- Usage
Level Pulumi.Aws Native. Pricing Plan Manager. Subscription Usage Level
- Plan
Family SubscriptionPlan Family - The name of the pricing plan family.
- Plan
Tier string - The tier of the pricing plan. CloudFormation does not change the tier of an existing subscription; a stack update that changes the tier, upgrading or downgrading it, is rejected.
- Resource
Arns []string - The ARNs of resources associated with the subscription.
- Usage
Level SubscriptionUsage Level
- plan_
family "CloudFront" - The name of the pricing plan family.
- plan_
tier string - The tier of the pricing plan. CloudFormation does not change the tier of an existing subscription; a stack update that changes the tier, upgrading or downgrading it, is rejected.
- resource_
arns list(string) - The ARNs of resources associated with the subscription.
- usage_
level "DEFAULT" | "CF_PREMIUM_L2" | "CF_PREMIUM_L3" | "CF_PREMIUM_L4" | "CF_PREMIUM_L5" | "CF_PREMIUM_L6" | "CF_PREMIUM_L7"
- plan
Family SubscriptionPlan Family - The name of the pricing plan family.
- plan
Tier String - The tier of the pricing plan. CloudFormation does not change the tier of an existing subscription; a stack update that changes the tier, upgrading or downgrading it, is rejected.
- resource
Arns List<String> - The ARNs of resources associated with the subscription.
- usage
Level SubscriptionUsage Level
- plan
Family SubscriptionPlan Family - The name of the pricing plan family.
- plan
Tier string - The tier of the pricing plan. CloudFormation does not change the tier of an existing subscription; a stack update that changes the tier, upgrading or downgrading it, is rejected.
- resource
Arns string[] - The ARNs of resources associated with the subscription.
- usage
Level SubscriptionUsage Level
- plan_
family SubscriptionPlan Family - The name of the pricing plan family.
- plan_
tier str - The tier of the pricing plan. CloudFormation does not change the tier of an existing subscription; a stack update that changes the tier, upgrading or downgrading it, is rejected.
- resource_
arns Sequence[str] - The ARNs of resources associated with the subscription.
- usage_
level SubscriptionUsage Level
- plan
Family "CloudFront" - The name of the pricing plan family.
- plan
Tier String - The tier of the pricing plan. CloudFormation does not change the tier of an existing subscription; a stack update that changes the tier, upgrading or downgrading it, is rejected.
- resource
Arns List<String> - The ARNs of resources associated with the subscription.
- usage
Level "DEFAULT" | "CF_PREMIUM_L2" | "CF_PREMIUM_L3" | "CF_PREMIUM_L4" | "CF_PREMIUM_L5" | "CF_PREMIUM_L6" | "CF_PREMIUM_L7"
Outputs
All input properties are implicitly available as output properties. Additionally, the Subscription resource produces the following output properties:
- Arn string
- The ARN of the subscription.
- Created
At string - The time the subscription was created, in ISO 8601 format.
- Current
Plan stringTier - The plan tier currently active on the subscription as reported by the API. Populated by the Read handler. Diverges from PlanTier after a non-reversible CloudFormation rollback; surface via drift detection.
- Id string
- The provider-assigned unique ID for this managed resource.
- Status
Pulumi.
Aws Native. Pricing Plan Manager. Subscription Status - The status of the subscription. PENDING_APPROVAL means a paid-tier subscription has been created but is not yet active and incurs no charges until it is approved out of band via a separate ApprovePaidSubscription call; CloudFormation never approves it. Free-tier subscriptions are activated immediately and do not use this status. ACTIVE means the subscription is in effect and, for paid tiers, billing has started. SYNC_IN_PROGRESS means a change is being applied. FAILED means provisioning did not complete; see StatusReason.
- Status
Reason string - A human-readable explanation of why the subscription is in its current status. Populated only when Status is FAILED, where it carries the reason the subscription could not be provisioned. Empty for all other statuses.
- Updated
At string - The time the subscription was last modified, in ISO 8601 format.
- Arn string
- The ARN of the subscription.
- Created
At string - The time the subscription was created, in ISO 8601 format.
- Current
Plan stringTier - The plan tier currently active on the subscription as reported by the API. Populated by the Read handler. Diverges from PlanTier after a non-reversible CloudFormation rollback; surface via drift detection.
- Id string
- The provider-assigned unique ID for this managed resource.
- Status
Subscription
Status - The status of the subscription. PENDING_APPROVAL means a paid-tier subscription has been created but is not yet active and incurs no charges until it is approved out of band via a separate ApprovePaidSubscription call; CloudFormation never approves it. Free-tier subscriptions are activated immediately and do not use this status. ACTIVE means the subscription is in effect and, for paid tiers, billing has started. SYNC_IN_PROGRESS means a change is being applied. FAILED means provisioning did not complete; see StatusReason.
- Status
Reason string - A human-readable explanation of why the subscription is in its current status. Populated only when Status is FAILED, where it carries the reason the subscription could not be provisioned. Empty for all other statuses.
- Updated
At string - The time the subscription was last modified, in ISO 8601 format.
- arn string
- The ARN of the subscription.
- created_
at string - The time the subscription was created, in ISO 8601 format.
- current_
plan_ stringtier - The plan tier currently active on the subscription as reported by the API. Populated by the Read handler. Diverges from PlanTier after a non-reversible CloudFormation rollback; surface via drift detection.
- id string
- The provider-assigned unique ID for this managed resource.
- status "ACTIVE" | "SYNC_IN_PROGRESS" | "FAILED" | "PENDING_APPROVAL"
- The status of the subscription. PENDING_APPROVAL means a paid-tier subscription has been created but is not yet active and incurs no charges until it is approved out of band via a separate ApprovePaidSubscription call; CloudFormation never approves it. Free-tier subscriptions are activated immediately and do not use this status. ACTIVE means the subscription is in effect and, for paid tiers, billing has started. SYNC_IN_PROGRESS means a change is being applied. FAILED means provisioning did not complete; see StatusReason.
- status_
reason string - A human-readable explanation of why the subscription is in its current status. Populated only when Status is FAILED, where it carries the reason the subscription could not be provisioned. Empty for all other statuses.
- updated_
at string - The time the subscription was last modified, in ISO 8601 format.
- arn String
- The ARN of the subscription.
- created
At String - The time the subscription was created, in ISO 8601 format.
- current
Plan StringTier - The plan tier currently active on the subscription as reported by the API. Populated by the Read handler. Diverges from PlanTier after a non-reversible CloudFormation rollback; surface via drift detection.
- id String
- The provider-assigned unique ID for this managed resource.
- status
Subscription
Status - The status of the subscription. PENDING_APPROVAL means a paid-tier subscription has been created but is not yet active and incurs no charges until it is approved out of band via a separate ApprovePaidSubscription call; CloudFormation never approves it. Free-tier subscriptions are activated immediately and do not use this status. ACTIVE means the subscription is in effect and, for paid tiers, billing has started. SYNC_IN_PROGRESS means a change is being applied. FAILED means provisioning did not complete; see StatusReason.
- status
Reason String - A human-readable explanation of why the subscription is in its current status. Populated only when Status is FAILED, where it carries the reason the subscription could not be provisioned. Empty for all other statuses.
- updated
At String - The time the subscription was last modified, in ISO 8601 format.
- arn string
- The ARN of the subscription.
- created
At string - The time the subscription was created, in ISO 8601 format.
- current
Plan stringTier - The plan tier currently active on the subscription as reported by the API. Populated by the Read handler. Diverges from PlanTier after a non-reversible CloudFormation rollback; surface via drift detection.
- id string
- The provider-assigned unique ID for this managed resource.
- status
Subscription
Status - The status of the subscription. PENDING_APPROVAL means a paid-tier subscription has been created but is not yet active and incurs no charges until it is approved out of band via a separate ApprovePaidSubscription call; CloudFormation never approves it. Free-tier subscriptions are activated immediately and do not use this status. ACTIVE means the subscription is in effect and, for paid tiers, billing has started. SYNC_IN_PROGRESS means a change is being applied. FAILED means provisioning did not complete; see StatusReason.
- status
Reason string - A human-readable explanation of why the subscription is in its current status. Populated only when Status is FAILED, where it carries the reason the subscription could not be provisioned. Empty for all other statuses.
- updated
At string - The time the subscription was last modified, in ISO 8601 format.
- arn str
- The ARN of the subscription.
- created_
at str - The time the subscription was created, in ISO 8601 format.
- current_
plan_ strtier - The plan tier currently active on the subscription as reported by the API. Populated by the Read handler. Diverges from PlanTier after a non-reversible CloudFormation rollback; surface via drift detection.
- id str
- The provider-assigned unique ID for this managed resource.
- status
Subscription
Status - The status of the subscription. PENDING_APPROVAL means a paid-tier subscription has been created but is not yet active and incurs no charges until it is approved out of band via a separate ApprovePaidSubscription call; CloudFormation never approves it. Free-tier subscriptions are activated immediately and do not use this status. ACTIVE means the subscription is in effect and, for paid tiers, billing has started. SYNC_IN_PROGRESS means a change is being applied. FAILED means provisioning did not complete; see StatusReason.
- status_
reason str - A human-readable explanation of why the subscription is in its current status. Populated only when Status is FAILED, where it carries the reason the subscription could not be provisioned. Empty for all other statuses.
- updated_
at str - The time the subscription was last modified, in ISO 8601 format.
- arn String
- The ARN of the subscription.
- created
At String - The time the subscription was created, in ISO 8601 format.
- current
Plan StringTier - The plan tier currently active on the subscription as reported by the API. Populated by the Read handler. Diverges from PlanTier after a non-reversible CloudFormation rollback; surface via drift detection.
- id String
- The provider-assigned unique ID for this managed resource.
- status "ACTIVE" | "SYNC_IN_PROGRESS" | "FAILED" | "PENDING_APPROVAL"
- The status of the subscription. PENDING_APPROVAL means a paid-tier subscription has been created but is not yet active and incurs no charges until it is approved out of band via a separate ApprovePaidSubscription call; CloudFormation never approves it. Free-tier subscriptions are activated immediately and do not use this status. ACTIVE means the subscription is in effect and, for paid tiers, billing has started. SYNC_IN_PROGRESS means a change is being applied. FAILED means provisioning did not complete; see StatusReason.
- status
Reason String - A human-readable explanation of why the subscription is in its current status. Populated only when Status is FAILED, where it carries the reason the subscription could not be provisioned. Empty for all other statuses.
- updated
At String - The time the subscription was last modified, in ISO 8601 format.
Supporting Types
SubscriptionPlanFamily, SubscriptionPlanFamilyArgs
- Cloud
Front CloudFront
- Subscription
Plan Family Cloud Front CloudFront
- "Cloud
Front" CloudFront
- Cloud
Front CloudFront
- Cloud
Front CloudFront
- CLOUD_FRONT
CloudFront
- "Cloud
Front" CloudFront
SubscriptionStatus, SubscriptionStatusArgs
- Active
ACTIVE- Sync
In Progress SYNC_IN_PROGRESS- Failed
FAILED- Pending
Approval PENDING_APPROVAL
- Subscription
Status Active ACTIVE- Subscription
Status Sync In Progress SYNC_IN_PROGRESS- Subscription
Status Failed FAILED- Subscription
Status Pending Approval PENDING_APPROVAL
- "ACTIVE"
ACTIVE- "SYNC_IN_PROGRESS"
SYNC_IN_PROGRESS- "FAILED"
FAILED- "PENDING_APPROVAL"
PENDING_APPROVAL
- Active
ACTIVE- Sync
In Progress SYNC_IN_PROGRESS- Failed
FAILED- Pending
Approval PENDING_APPROVAL
- Active
ACTIVE- Sync
In Progress SYNC_IN_PROGRESS- Failed
FAILED- Pending
Approval PENDING_APPROVAL
- ACTIVE
ACTIVE- SYNC_IN_PROGRESS
SYNC_IN_PROGRESS- FAILED
FAILED- PENDING_APPROVAL
PENDING_APPROVAL
- "ACTIVE"
ACTIVE- "SYNC_IN_PROGRESS"
SYNC_IN_PROGRESS- "FAILED"
FAILED- "PENDING_APPROVAL"
PENDING_APPROVAL
SubscriptionUsageLevel, SubscriptionUsageLevelArgs
- Default
DEFAULT- Cf
Premium L2 CF_PREMIUM_L2- Cf
Premium L3 CF_PREMIUM_L3- Cf
Premium L4 CF_PREMIUM_L4- Cf
Premium L5 CF_PREMIUM_L5- Cf
Premium L6 CF_PREMIUM_L6- Cf
Premium L7 CF_PREMIUM_L7
- Subscription
Usage Level Default DEFAULT- Subscription
Usage Level Cf Premium L2 CF_PREMIUM_L2- Subscription
Usage Level Cf Premium L3 CF_PREMIUM_L3- Subscription
Usage Level Cf Premium L4 CF_PREMIUM_L4- Subscription
Usage Level Cf Premium L5 CF_PREMIUM_L5- Subscription
Usage Level Cf Premium L6 CF_PREMIUM_L6- Subscription
Usage Level Cf Premium L7 CF_PREMIUM_L7
- "DEFAULT"
DEFAULT- "CF_PREMIUM_L2"
CF_PREMIUM_L2- "CF_PREMIUM_L3"
CF_PREMIUM_L3- "CF_PREMIUM_L4"
CF_PREMIUM_L4- "CF_PREMIUM_L5"
CF_PREMIUM_L5- "CF_PREMIUM_L6"
CF_PREMIUM_L6- "CF_PREMIUM_L7"
CF_PREMIUM_L7
- Default
DEFAULT- Cf
Premium L2 CF_PREMIUM_L2- Cf
Premium L3 CF_PREMIUM_L3- Cf
Premium L4 CF_PREMIUM_L4- Cf
Premium L5 CF_PREMIUM_L5- Cf
Premium L6 CF_PREMIUM_L6- Cf
Premium L7 CF_PREMIUM_L7
- Default
DEFAULT- Cf
Premium L2 CF_PREMIUM_L2- Cf
Premium L3 CF_PREMIUM_L3- Cf
Premium L4 CF_PREMIUM_L4- Cf
Premium L5 CF_PREMIUM_L5- Cf
Premium L6 CF_PREMIUM_L6- Cf
Premium L7 CF_PREMIUM_L7
- DEFAULT
DEFAULT- CF_PREMIUM_L2
CF_PREMIUM_L2- CF_PREMIUM_L3
CF_PREMIUM_L3- CF_PREMIUM_L4
CF_PREMIUM_L4- CF_PREMIUM_L5
CF_PREMIUM_L5- CF_PREMIUM_L6
CF_PREMIUM_L6- CF_PREMIUM_L7
CF_PREMIUM_L7
- "DEFAULT"
DEFAULT- "CF_PREMIUM_L2"
CF_PREMIUM_L2- "CF_PREMIUM_L3"
CF_PREMIUM_L3- "CF_PREMIUM_L4"
CF_PREMIUM_L4- "CF_PREMIUM_L5"
CF_PREMIUM_L5- "CF_PREMIUM_L6"
CF_PREMIUM_L6- "CF_PREMIUM_L7"
CF_PREMIUM_L7
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 14, 2026 by Pulumi