Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. pricingplanmanager
  6. getSubscription

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
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.pricingplanmanager.getSubscription

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
Schema (JSON)
pulumi/pulumi-aws-native

    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.

    Using getSubscription

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getSubscription(args: GetSubscriptionArgs, opts?: InvokeOptions): Promise<GetSubscriptionResult>
function getSubscriptionOutput(args: GetSubscriptionOutputArgs, opts?: InvokeOutputOptions): Output<GetSubscriptionResult>
    def get_subscription(arn: Optional[str] = None,
                     opts: Optional[InvokeOptions] = None) -> GetSubscriptionResult
def get_subscription_output(arn: pulumi.Input[Optional[str]] = None,
                     opts: Optional[InvokeOutputOptions] = None) -> Output[GetSubscriptionResult]
    func LookupSubscription(ctx *Context, args *LookupSubscriptionArgs, opts ...InvokeOption) (*LookupSubscriptionResult, error)
func LookupSubscriptionOutput(ctx *Context, args *LookupSubscriptionOutputArgs, opts ...InvokeOption) LookupSubscriptionResultOutput

    > Note: This function is named LookupSubscription in the Go SDK.

    public static class GetSubscription 
{
    public static Task<GetSubscriptionResult> InvokeAsync(GetSubscriptionArgs args, InvokeOptions? opts = null)
    public static Output<GetSubscriptionResult> Invoke(GetSubscriptionInvokeArgs args, InvokeOptions? opts = null)
    public static Output<GetSubscriptionResult> Invoke(GetSubscriptionInvokeArgs args, InvokeOutputOptions opts)
}
    public static CompletableFuture<GetSubscriptionResult> getSubscription(GetSubscriptionArgs args, InvokeOptions options)
public static Output<GetSubscriptionResult> getSubscription(GetSubscriptionArgs args, InvokeOptions options)
public static Output<GetSubscriptionResult> getSubscription(GetSubscriptionArgs args, InvokeOutputOptions options)

    fn::invoke:
  function: aws-native:pricingplanmanager:getSubscription
  arguments:
    # arguments dictionary
    data "aws-native_pricingplanmanager_get_subscription" "name" {
    # arguments
}

    The following arguments are supported:

    Arn string
    The ARN of the subscription.
    Arn string
    The ARN of the subscription.
    arn string
    The ARN of the subscription.
    arn String
    The ARN of the subscription.
    arn string
    The ARN of the subscription.
    arn str
    The ARN of the subscription.
    arn String
    The ARN of the subscription.

    getSubscription Result

    The following output properties are available:

    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.
    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.
    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.
    UsageLevel Pulumi.AwsNative.PricingPlanManager.SubscriptionUsageLevel
    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.
    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.
    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.
    UsageLevel SubscriptionUsageLevel
    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.
    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.
    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.
    usage_level "DEFAULT" | "CF_PREMIUM_L2" | "CF_PREMIUM_L3" | "CF_PREMIUM_L4" | "CF_PREMIUM_L5" | "CF_PREMIUM_L6" | "CF_PREMIUM_L7"
    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.
    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.
    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.
    usageLevel SubscriptionUsageLevel
    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.
    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.
    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.
    usageLevel SubscriptionUsageLevel
    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.
    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.
    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.
    usage_level SubscriptionUsageLevel
    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.
    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.
    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.
    usageLevel "DEFAULT" | "CF_PREMIUM_L2" | "CF_PREMIUM_L3" | "CF_PREMIUM_L4" | "CF_PREMIUM_L5" | "CF_PREMIUM_L6" | "CF_PREMIUM_L7"

    Supporting Types

    SubscriptionStatus

    SubscriptionUsageLevel

    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
    Schema (JSON)
    pulumi/pulumi-aws-native

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial