Configuring Parameters

To populate the configuration parameters with the correct values, complete the following steps:

  1. Log in to the CloudBlue Connect Distributor Portal.
  2. Go to Products and select the Azure RI product.
  3. Click Configuration and filter the parameters by scope (marketplace) to see the configuration parameters for the required marketplace.

  4. Assign the proper value to each parameter.

In the following table you can see a description of the parameters and detailed information on where to obtain the required values.

ID: tenant_id

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID: client_id

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID: client_secret

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID: refresh_token

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID: refresh_token_date

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID: usage_exchange_rate_list
Scope: Marketplace
Description:

This parameter allows you to configure your own custom usage exchange rates instead of using the Microsoft Azure API exchange rate. The exchange rates must be specified in json format.

Conversion Logic

All calculations are made by converting the Microsoft invoice amount into US Dollars (USD) first, and then into the final Destination Currency.

  1. If the Microsoft invoice is NOT in USD: You must specify two rates:

    • The rate to convert the Original CurrencyUSD.

    • The rate to convert USDDestination Currency.

  2. If the Microsoft invoice IS in USD: You only need to specify one rate:

    • The rate to convert USDDestination Currency.

Configuration Format

Currency rates must be configured as "USDPerUnit". This means you must specify the number of US dollars (USD) that corresponds to one unit of the other currency.

Original Currency Destination Currency Example of Exchange Rate Value to be Configured Conversion Path
USD HKD 0.13 {"HKD":0.13} USD → HKD
USD ILS 0.30 {"ILS":0.30} USD → ILS
USD ZAR 0.07 {"ZAR":0.07) USD → ZAR
EUR CHF 1.19, 1.09 {"EUR":1.19,"CHF":1.09} EUR → USD → CHF
ID: self_serve_policy
Scope: Marketplace
Description:

This parameter is required and will define if customers will be granted self-serve access to purchase Reserved Instances from the Azure portal.

  • If the parameter is set to YES, customers will be granted permission to purchase.

  • If the parameter is set to NO or is not configured, the self-service policy will not be enabled. In this case, customers will be asked to contact their reseller or distributor to request a Reserved Instance following the instructions provided in the Activation Template with the following ID: activation_template_self_serve_policy_off.

ID: ownership_validation_list
Scope: Marketplace
Description:

This parameter is used to configure the processor to skip the validation of the domain owner in the requests by specifying an external ID, Hub ID and a domain. This will be necessary when the processor is unable to validate the owner of a domain and the distributor needs to complete such validation manually.

Once the distributor has validated the domain ownership manually, it will be necessary to configure this parameter so that the processor can skip the validation of the domain owner in order to proceed with the request. The external id, hub id and domain required to configure this parameter will be provided in the email mentioned above.

The parameter must contain an object with the following format.

{
	"exclude": [
		{
		  "external_id": "1000001",
		  "hub_id": "HB-0000-0001",
		  "domain": "sample1.onmicrosoft.com"
		},
		{
		  "external_id": "1000002",
		  "hub_id": "HB-0000-0001",
		  "domain": "sample2.onmicrosoft.com"
		}
	]
}

Once the domain validation has been skipped, the object in this parameter can be removed.

ID: partner_margin
Scope: Marketplace
Description:

Partner margin used to calculate the price for the final customer. If no value is specified, if the specifed value is wrong or if it is 1 (invalid value), the default value (0.05) will be used. Please use "." as a decimal separator. If "," is used as decimal separator, the value will be considered incorrect and the default value (0.05) will be used.

Example value :0.05

ID: activation_template_direct_model
Scope: Marketplace
Description: This parameter allows you to specify the ID of the Activation Template that will be displayed for the direct model. Make sure that this parameter is configured with the following template ID: TL-887-458-538.
ID: activation_template_distribution_model
Scope: Marketplace
Description: This parameter allows you to specify the ID of the Activation Template that will be displayed for the distribution model. Make sure that this parameter is configured with the following template ID: TL-461-630-247.
ID: activation_template_self_serve_policy_on
Scope: Marketplace
Description: Configure the ID of the Activation Template that will be displayed when the subscription is purchased with automated provisioning of Self-Serve Policy on. Make sure that this parameter is configured with the following template ID: TL-761-865-428.
ID: activation_template_self_serve_policy_off
Scope: Marketplace
Description: This parameter allows you to specify the ID of the Activation Template that will be displayed when the subscription is purchased with Automated Provisioning of Self-Serve Policy Off. Make sure that this parameter is configured with the following template ID: TL-887-584-269.
ID: sp_self_serve_policy
Scope: Marketplace
Description: If you want Savings Plans to be available for self-serve for your customers, set this parameter to YES. Otherwise, set this parameter to NO.