1. Packages
  2. Cloudflare Provider
  3. API Docs
  4. ZoneSubscription
Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

cloudflare.ZoneSubscription

Explore with Pulumi AI

cloudflare logo
Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

    Example Usage

    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    resources:
      exampleZoneSubscription:
        type: cloudflare:ZoneSubscription
        name: example_zone_subscription
        properties:
          identifier: 506e3185e9c882d175a2d0cb0093d9f2
          frequency: monthly
          ratePlan:
            id: free
            currency: USD
            externally_managed: false
            is_contract: false
            public_name: Business Plan
            scope: zone
            sets:
              - string
    

    Create ZoneSubscription Resource

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

    Constructor syntax

    new ZoneSubscription(name: string, args: ZoneSubscriptionArgs, opts?: CustomResourceOptions);
    @overload
    def ZoneSubscription(resource_name: str,
                         args: ZoneSubscriptionArgs,
                         opts: Optional[ResourceOptions] = None)
    
    @overload
    def ZoneSubscription(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         identifier: Optional[str] = None,
                         frequency: Optional[str] = None,
                         rate_plan: Optional[ZoneSubscriptionRatePlanArgs] = None)
    func NewZoneSubscription(ctx *Context, name string, args ZoneSubscriptionArgs, opts ...ResourceOption) (*ZoneSubscription, error)
    public ZoneSubscription(string name, ZoneSubscriptionArgs args, CustomResourceOptions? opts = null)
    public ZoneSubscription(String name, ZoneSubscriptionArgs args)
    public ZoneSubscription(String name, ZoneSubscriptionArgs args, CustomResourceOptions options)
    
    type: cloudflare:ZoneSubscription
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args ZoneSubscriptionArgs
    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 ZoneSubscriptionArgs
    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 ZoneSubscriptionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ZoneSubscriptionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ZoneSubscriptionArgs
    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 zoneSubscriptionResource = new Cloudflare.ZoneSubscription("zoneSubscriptionResource", new()
    {
        Identifier = "string",
        Frequency = "string",
        RatePlan = new Cloudflare.Inputs.ZoneSubscriptionRatePlanArgs
        {
            Currency = "string",
            ExternallyManaged = false,
            Id = "string",
            IsContract = false,
            PublicName = "string",
            Scope = "string",
            Sets = new[]
            {
                "string",
            },
        },
    });
    
    example, err := cloudflare.NewZoneSubscription(ctx, "zoneSubscriptionResource", &cloudflare.ZoneSubscriptionArgs{
    	Identifier: pulumi.String("string"),
    	Frequency:  pulumi.String("string"),
    	RatePlan: &cloudflare.ZoneSubscriptionRatePlanArgs{
    		Currency:          pulumi.String("string"),
    		ExternallyManaged: pulumi.Bool(false),
    		Id:                pulumi.String("string"),
    		IsContract:        pulumi.Bool(false),
    		PublicName:        pulumi.String("string"),
    		Scope:             pulumi.String("string"),
    		Sets: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    	},
    })
    
    var zoneSubscriptionResource = new ZoneSubscription("zoneSubscriptionResource", ZoneSubscriptionArgs.builder()
        .identifier("string")
        .frequency("string")
        .ratePlan(ZoneSubscriptionRatePlanArgs.builder()
            .currency("string")
            .externallyManaged(false)
            .id("string")
            .isContract(false)
            .publicName("string")
            .scope("string")
            .sets("string")
            .build())
        .build());
    
    zone_subscription_resource = cloudflare.ZoneSubscription("zoneSubscriptionResource",
        identifier="string",
        frequency="string",
        rate_plan={
            "currency": "string",
            "externally_managed": False,
            "id": "string",
            "is_contract": False,
            "public_name": "string",
            "scope": "string",
            "sets": ["string"],
        })
    
    const zoneSubscriptionResource = new cloudflare.ZoneSubscription("zoneSubscriptionResource", {
        identifier: "string",
        frequency: "string",
        ratePlan: {
            currency: "string",
            externallyManaged: false,
            id: "string",
            isContract: false,
            publicName: "string",
            scope: "string",
            sets: ["string"],
        },
    });
    
    type: cloudflare:ZoneSubscription
    properties:
        frequency: string
        identifier: string
        ratePlan:
            currency: string
            externallyManaged: false
            id: string
            isContract: false
            publicName: string
            scope: string
            sets:
                - string
    

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

    Identifier string
    Subscription identifier tag.
    Frequency string
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    RatePlan ZoneSubscriptionRatePlan
    The rate plan applied to the subscription.
    Identifier string
    Subscription identifier tag.
    Frequency string
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    RatePlan ZoneSubscriptionRatePlanArgs
    The rate plan applied to the subscription.
    identifier String
    Subscription identifier tag.
    frequency String
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    ratePlan ZoneSubscriptionRatePlan
    The rate plan applied to the subscription.
    identifier string
    Subscription identifier tag.
    frequency string
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    ratePlan ZoneSubscriptionRatePlan
    The rate plan applied to the subscription.
    identifier str
    Subscription identifier tag.
    frequency str
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    rate_plan ZoneSubscriptionRatePlanArgs
    The rate plan applied to the subscription.
    identifier String
    Subscription identifier tag.
    frequency String
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    ratePlan Property Map
    The rate plan applied to the subscription.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing ZoneSubscription Resource

    Get an existing ZoneSubscription 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?: ZoneSubscriptionState, opts?: CustomResourceOptions): ZoneSubscription
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            frequency: Optional[str] = None,
            identifier: Optional[str] = None,
            rate_plan: Optional[ZoneSubscriptionRatePlanArgs] = None) -> ZoneSubscription
    func GetZoneSubscription(ctx *Context, name string, id IDInput, state *ZoneSubscriptionState, opts ...ResourceOption) (*ZoneSubscription, error)
    public static ZoneSubscription Get(string name, Input<string> id, ZoneSubscriptionState? state, CustomResourceOptions? opts = null)
    public static ZoneSubscription get(String name, Output<String> id, ZoneSubscriptionState state, CustomResourceOptions options)
    resources:  _:    type: cloudflare:ZoneSubscription    get:      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:
    Frequency string
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    Identifier string
    Subscription identifier tag.
    RatePlan ZoneSubscriptionRatePlan
    The rate plan applied to the subscription.
    Frequency string
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    Identifier string
    Subscription identifier tag.
    RatePlan ZoneSubscriptionRatePlanArgs
    The rate plan applied to the subscription.
    frequency String
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    identifier String
    Subscription identifier tag.
    ratePlan ZoneSubscriptionRatePlan
    The rate plan applied to the subscription.
    frequency string
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    identifier string
    Subscription identifier tag.
    ratePlan ZoneSubscriptionRatePlan
    The rate plan applied to the subscription.
    frequency str
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    identifier str
    Subscription identifier tag.
    rate_plan ZoneSubscriptionRatePlanArgs
    The rate plan applied to the subscription.
    frequency String
    How often the subscription is renewed automatically. Available values: "weekly", "monthly", "quarterly", "yearly".
    identifier String
    Subscription identifier tag.
    ratePlan Property Map
    The rate plan applied to the subscription.

    Supporting Types

    ZoneSubscriptionRatePlan, ZoneSubscriptionRatePlanArgs

    Currency string
    The currency applied to the rate plan subscription.
    ExternallyManaged bool
    Whether this rate plan is managed externally from Cloudflare.
    Id string
    The ID of the rate plan. Available values: "free", "lite", "pro", "proplus", "business", "enterprise", "partnersfree", "partnerspro", "partnersbusiness", "partners_enterprise".
    IsContract bool
    Whether a rate plan is enterprise-based (or newly adopted term contract).
    PublicName string
    The full name of the rate plan.
    Scope string
    The scope that this rate plan applies to.
    Sets List<string>
    The list of sets this rate plan applies to.
    Currency string
    The currency applied to the rate plan subscription.
    ExternallyManaged bool
    Whether this rate plan is managed externally from Cloudflare.
    Id string
    The ID of the rate plan. Available values: "free", "lite", "pro", "proplus", "business", "enterprise", "partnersfree", "partnerspro", "partnersbusiness", "partners_enterprise".
    IsContract bool
    Whether a rate plan is enterprise-based (or newly adopted term contract).
    PublicName string
    The full name of the rate plan.
    Scope string
    The scope that this rate plan applies to.
    Sets []string
    The list of sets this rate plan applies to.
    currency String
    The currency applied to the rate plan subscription.
    externallyManaged Boolean
    Whether this rate plan is managed externally from Cloudflare.
    id String
    The ID of the rate plan. Available values: "free", "lite", "pro", "proplus", "business", "enterprise", "partnersfree", "partnerspro", "partnersbusiness", "partners_enterprise".
    isContract Boolean
    Whether a rate plan is enterprise-based (or newly adopted term contract).
    publicName String
    The full name of the rate plan.
    scope String
    The scope that this rate plan applies to.
    sets List<String>
    The list of sets this rate plan applies to.
    currency string
    The currency applied to the rate plan subscription.
    externallyManaged boolean
    Whether this rate plan is managed externally from Cloudflare.
    id string
    The ID of the rate plan. Available values: "free", "lite", "pro", "proplus", "business", "enterprise", "partnersfree", "partnerspro", "partnersbusiness", "partners_enterprise".
    isContract boolean
    Whether a rate plan is enterprise-based (or newly adopted term contract).
    publicName string
    The full name of the rate plan.
    scope string
    The scope that this rate plan applies to.
    sets string[]
    The list of sets this rate plan applies to.
    currency str
    The currency applied to the rate plan subscription.
    externally_managed bool
    Whether this rate plan is managed externally from Cloudflare.
    id str
    The ID of the rate plan. Available values: "free", "lite", "pro", "proplus", "business", "enterprise", "partnersfree", "partnerspro", "partnersbusiness", "partners_enterprise".
    is_contract bool
    Whether a rate plan is enterprise-based (or newly adopted term contract).
    public_name str
    The full name of the rate plan.
    scope str
    The scope that this rate plan applies to.
    sets Sequence[str]
    The list of sets this rate plan applies to.
    currency String
    The currency applied to the rate plan subscription.
    externallyManaged Boolean
    Whether this rate plan is managed externally from Cloudflare.
    id String
    The ID of the rate plan. Available values: "free", "lite", "pro", "proplus", "business", "enterprise", "partnersfree", "partnerspro", "partnersbusiness", "partners_enterprise".
    isContract Boolean
    Whether a rate plan is enterprise-based (or newly adopted term contract).
    publicName String
    The full name of the rate plan.
    scope String
    The scope that this rate plan applies to.
    sets List<String>
    The list of sets this rate plan applies to.

    Package Details

    Repository
    Cloudflare pulumi/pulumi-cloudflare
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the cloudflare Terraform Provider.
    cloudflare logo
    Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi