Pricing plan manifest reference¶

Creating Snowflake pricing plans programmatically requires a manifest, written in YAML (https://yaml.org/spec/ (https://yaml.org/spec/)). Use the information provided here to learn about the parameters available in the pricing plan manifest.

Pricing plan manifest¶

#
# Pricing plan manifest
#
pricing_plan_display_name: <pricing_plan_name>
currency: <three_letter_currency_code>
pricing_model: <pricing_plan_pricing_model>
usage_details:
  free_units: <number_of_free_monthly_queries>
  free_unit_kind: <free_unit_kind>
  usage_unit_price: <price_per_unit>
  usage_unit_kind: <usage_unit_kind>
  max_fee: <maximum_fee_per_month>
billing_events:
   class: <class_name>
   display_name: <billing_event_display_name>
   billing_quantity: <price_per_unit>
   billing_unit: <display_units>
   description: <description_for_the_billing_event>
compute_pool_surcharge:
   surcharge_type: <surcharge_type>
   compute_pool_rates:
    - identifier_type: <compute_pool_type>
      identifier_name: <compute_pool_name>
      surcharge_price: <price_per_credit>
      description: <compute_pool_rate_description>
    - identifier_type: <compute_pool_type>
      identifier_name: <compute_pool_name>
      surcharge_price: <price_per_credit>
      description: <compute_pool_rate_description>
base_fee: <monthly_fixed_fee>
billing_duration: <billing_duration_in_months>
sales_motion: <pricing_plan_type>
comment: <a_note_visible_only_to_the_provider>
metadata:
  description: <pricing_plan_description>
  price_prefix: <pricing_plan_prefix>
  pricing_unit: <|sf-web-interface|_pricing_plan_pricing_unit>
  button_text: <|sf-web-interface|_button_text>
  index: <|sf-web-interface|_pricing_plan_index>
  value_propositions: <pricing_plan_value_proposition>
visibility: <pricing_plan_visibility>
#
# Default offer fields
#
contract_type: <pricing plan contract type>
contract_duration_months: <pricing plan contract duration>

Copy

Pricing plan parameters¶

The parameters within the pricing plan manifest allow you to create pricing plans that meet your specific business requirements. Required and optional parameters are identified.

pricing_plan_display_name: Required. String. The pricing plan name that is visible to providers and consumers.
currency: Required. String. The three-letter currency code for the pricing plan. The default is USD.
pricing_model: Required. String. The pricing model for the pricing plan. The available values are FLAT_FEE and USAGE_BASED. For more information about pricing models, see Paid Listings Pricing Models.
usage_details: Optional. Defines pricing plan usage limitations. You can specify the following optional parameters.

Long. The number of queries a consumer can make without incurring a monthly usage fee.
billing_events: Optional. Defines consumer billing events. You can specify the following optional parameters.

String. The billing class name.
compute_pool_surcharge: Optional. Defines rates for compute pool use. You can specify the following optional parameters.

String. The compute pool surcharge type. The accepted values are HOUR or CREDIT.
base_fee: Required. Double. The pricing plan monthly fixed fee.
billing_duration: Required. Long. The pricing plan duration in months.
sales_motion: Required. String. The pricing plan type. The accepted values are SELF_SERVE and TALK_TO_SALES.
comment: Optional. String. Pricing plan information that is visible only to a provider.
metadata: Optional. Provides additional pricing plan information. You can specify the following optional parameters.

String. A description of the pricing plan.
visibility: Required. String. Defines pricing plan visibility. The accepted values are VISIBLE and HIDDEN.
contract_type: Required. String. The pricing plan contract type. The accepted values are SUBSCRIPTION and LIMITED_TIME.
contract_duration_months: Required. Long. The pricing plan contract duration in months.