1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. pricingplanmanager
  6. Subscription

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.79.0
published on Monday, Sep 14, 2026 by Pulumi
aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.79.0
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:

    PlanFamily Pulumi.AwsNative.PricingPlanManager.SubscriptionPlanFamily
    The name of the pricing plan family.
    PlanTier 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.
    ResourceArns List<string>
    The ARNs of resources associated with the subscription.
    UsageLevel Pulumi.AwsNative.PricingPlanManager.SubscriptionUsageLevel
    PlanFamily SubscriptionPlanFamily
    The name of the pricing plan family.
    PlanTier 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.
    ResourceArns []string
    The ARNs of resources associated with the subscription.
    UsageLevel SubscriptionUsageLevel
    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"
    planFamily SubscriptionPlanFamily
    The name of the pricing plan family.
    planTier 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.
    resourceArns List<String>
    The ARNs of resources associated with the subscription.
    usageLevel SubscriptionUsageLevel
    planFamily SubscriptionPlanFamily
    The name of the pricing plan family.
    planTier 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.
    resourceArns string[]
    The ARNs of resources associated with the subscription.
    usageLevel SubscriptionUsageLevel
    plan_family SubscriptionPlanFamily
    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 SubscriptionUsageLevel
    planFamily "CloudFront"
    The name of the pricing plan family.
    planTier 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.
    resourceArns List<String>
    The ARNs of resources associated with the subscription.
    usageLevel "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.
    CreatedAt string
    The time the subscription was created, in ISO 8601 format.
    CurrentPlanTier string
    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.AwsNative.PricingPlanManager.SubscriptionStatus
    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.
    StatusReason 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.
    UpdatedAt string
    The time the subscription was last modified, in ISO 8601 format.
    Arn string
    The ARN of the subscription.
    CreatedAt string
    The time the subscription was created, in ISO 8601 format.
    CurrentPlanTier string
    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 SubscriptionStatus
    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.
    StatusReason 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.
    UpdatedAt 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_tier string
    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.
    createdAt String
    The time the subscription was created, in ISO 8601 format.
    currentPlanTier String
    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 SubscriptionStatus
    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.
    statusReason 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.
    updatedAt String
    The time the subscription was last modified, in ISO 8601 format.
    arn string
    The ARN of the subscription.
    createdAt string
    The time the subscription was created, in ISO 8601 format.
    currentPlanTier string
    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 SubscriptionStatus
    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.
    statusReason 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.
    updatedAt 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_tier str
    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 SubscriptionStatus
    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.
    createdAt String
    The time the subscription was created, in ISO 8601 format.
    currentPlanTier String
    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.
    statusReason 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.
    updatedAt String
    The time the subscription was last modified, in ISO 8601 format.

    Supporting Types

    SubscriptionPlanFamily, SubscriptionPlanFamilyArgs

    CloudFront
    CloudFront
    SubscriptionPlanFamilyCloudFront
    CloudFront
    "CloudFront"
    CloudFront
    CloudFront
    CloudFront
    CloudFront
    CloudFront
    CLOUD_FRONT
    CloudFront
    "CloudFront"
    CloudFront

    SubscriptionStatus, SubscriptionStatusArgs

    Active
    ACTIVE
    SyncInProgress
    SYNC_IN_PROGRESS
    Failed
    FAILED
    PendingApproval
    PENDING_APPROVAL
    SubscriptionStatusActive
    ACTIVE
    SubscriptionStatusSyncInProgress
    SYNC_IN_PROGRESS
    SubscriptionStatusFailed
    FAILED
    SubscriptionStatusPendingApproval
    PENDING_APPROVAL
    "ACTIVE"
    ACTIVE
    "SYNC_IN_PROGRESS"
    SYNC_IN_PROGRESS
    "FAILED"
    FAILED
    "PENDING_APPROVAL"
    PENDING_APPROVAL
    Active
    ACTIVE
    SyncInProgress
    SYNC_IN_PROGRESS
    Failed
    FAILED
    PendingApproval
    PENDING_APPROVAL
    Active
    ACTIVE
    SyncInProgress
    SYNC_IN_PROGRESS
    Failed
    FAILED
    PendingApproval
    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
    CfPremiumL2
    CF_PREMIUM_L2
    CfPremiumL3
    CF_PREMIUM_L3
    CfPremiumL4
    CF_PREMIUM_L4
    CfPremiumL5
    CF_PREMIUM_L5
    CfPremiumL6
    CF_PREMIUM_L6
    CfPremiumL7
    CF_PREMIUM_L7
    SubscriptionUsageLevelDefault
    DEFAULT
    SubscriptionUsageLevelCfPremiumL2
    CF_PREMIUM_L2
    SubscriptionUsageLevelCfPremiumL3
    CF_PREMIUM_L3
    SubscriptionUsageLevelCfPremiumL4
    CF_PREMIUM_L4
    SubscriptionUsageLevelCfPremiumL5
    CF_PREMIUM_L5
    SubscriptionUsageLevelCfPremiumL6
    CF_PREMIUM_L6
    SubscriptionUsageLevelCfPremiumL7
    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
    CfPremiumL2
    CF_PREMIUM_L2
    CfPremiumL3
    CF_PREMIUM_L3
    CfPremiumL4
    CF_PREMIUM_L4
    CfPremiumL5
    CF_PREMIUM_L5
    CfPremiumL6
    CF_PREMIUM_L6
    CfPremiumL7
    CF_PREMIUM_L7
    Default
    DEFAULT
    CfPremiumL2
    CF_PREMIUM_L2
    CfPremiumL3
    CF_PREMIUM_L3
    CfPremiumL4
    CF_PREMIUM_L4
    CfPremiumL5
    CF_PREMIUM_L5
    CfPremiumL6
    CF_PREMIUM_L6
    CfPremiumL7
    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
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.79.0
    published on Monday, Sep 14, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial