Create manual percentage-based allocation policy

1 min

POST

https://app.amberflo.io/business-unit/focus-allocation/manual

Creates a new manual FOCUS allocation policy that distributes cloud costs to business units using fixed percentage rules. Manual policies override automatic allocation and provide direct control over cost assignment for specific provider services.

Required request body fields:

provider: Cloud provider for the policy (AWS, AZURE, GOOGLE_CLOUD)
service: Specific cloud service name for cost allocation scope
policy: Distribution rule containing business unit allocation percentages
startTimeInSeconds: Policy activation time in Unix timestamp seconds

Optional request body fields:

endTimeInSeconds: Policy expiration time for time-bounded allocations

Important considerations:

Allocation percentages in policy must sum to 100.0 for complete cost distribution
Policy takes precedence over automatic rules for the specified provider and service
Business unit IDs in allocations must exist in the account's business unit registry
Time periods cannot overlap with existing policies for same provider/service combination

Returns created policy with system-generated timestamps and complete configuration. Use this endpoint to establish fixed cost distribution rules that bypass automatic allocation logic.

Body Parameters

bodybusiness_unit.focus_allocation.manual.ManualFocusAllocationPolicy.in
Description
Input model for creating manual FOCUS allocation policies that distribute cloud costs to business units using fixed percentage rules overriding automatic allocation.
- providerfocus.common.FocusProvider.inrequired
  Description
  Cloud provider for cost allocation policy. Supported values include AWS, AZURE, GOOGLE_CLOUD for targeted service cost distribution.
- servicestringrequired
  Description
  Specific cloud service name for cost allocation scope. Defines service boundaries for manual percentage-based cost distribution rules.
- policybusiness_unit.focus_allocation.manual.rules.SimpleDistributionRule.inrequired
  Description
  Distribution rule containing business unit allocation percentages. Defines how costs are divided among business units using fixed ratios.
  - typestringrequired
    Description
    Rule type identifier for simple distribution logic. Always set to 'simple_distribution' for percentage-based cost allocation rules.
    Default
    simple_distribution
  - allocationsmap<string, number>required
    Description
    Map of business unit IDs to allocation percentages. Keys are business unit identifiers, values are decimal percentages totaling 100.0.
- startTimeInSecondsinteger<int64>required
  Description
  Policy activation timestamp in Unix seconds format. Defines when manual allocation rule begins applying to cloud service costs.
- endTimeInSecondsinteger<int64>
  Description
  Policy expiration timestamp in Unix seconds format. Optional end time for time-bounded manual allocation rule application periods.

Responses

200Successful request

business_unit.focus_allocation.manual.ManualFocusAllocationPolicy.out
Description
Complete manual FOCUS allocation policy configuration with system metadata for distributing cloud costs using fixed percentage rules that override automatic allocation.
- providerfocus.common.FocusProvider.outrequired
  Description
  Cloud provider for cost allocation policy. Supported values include AWS, AZURE, GOOGLE_CLOUD for targeted service cost distribution.
- servicestringrequired
  Description
  Specific cloud service name for cost allocation scope. Defines service boundaries for manual percentage-based cost distribution rules.
- policybusiness_unit.focus_allocation.manual.rules.SimpleDistributionRule.outrequired
  Description
  Distribution rule containing business unit allocation percentages. Defines how costs are divided among business units using fixed ratios.
  - typestringrequired
    Description
    Rule type identifier for simple distribution logic. Always set to 'simple_distribution' for percentage-based cost allocation rules.
    Default
    simple_distribution
  - allocationsmap<string, number>required
    Description
    Map of business unit IDs to allocation percentages. Keys are business unit identifiers, values are decimal percentages totaling 100.0.
- startTimeInSecondsinteger<int64>required
  Description
  Policy activation timestamp in Unix seconds format. Defines when manual allocation rule begins applying to cloud service costs.
- endTimeInSecondsinteger<int64>
  Description
  Policy expiration timestamp in Unix seconds format. Optional end time for time-bounded manual allocation rule application periods.
- createTimeInMillisinteger<int64>
  Description
  Policy creation timestamp in Unix milliseconds format. Tracks when manual allocation policy was first established in system.
- updateTimeInMillisinteger<int64>
  Description
  Policy modification timestamp in Unix milliseconds format. Tracks when manual allocation policy configuration was last changed.

curl

curl --request POST \
     --url https://app.amberflo.io/business-unit/focus-allocation/manual \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "provider": "",
     "service": "",
     "policy": {
     "type": "simple_distribution",
     "allocations": ""
     },
     "startTimeInSeconds": 0
     }'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var raw = JSON.stringify({
   "provider": "",
   "service": "",
   "policy": {
      "type": "simple_distribution",
      "allocations": ""
   },
   "startTimeInSeconds": 0
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://app.amberflo.io/business-unit/focus-allocation/manual", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://app.amberflo.io/business-unit/focus-allocation/manual")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "provider": "",
   "service": "",
   "policy": {
      "type": "simple_distribution",
      "allocations": ""
   },
   "startTimeInSeconds": 0
})

response = https.request(request)
puts response.read_body

python

import requests
import json

url = "https://app.amberflo.io/business-unit/focus-allocation/manual"

payload = json.dumps({
   "provider": "",
   "service": "",
   "policy": {
      "type": "simple_distribution",
      "allocations": ""
   },
   "startTimeInSeconds": 0
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

200

// Successful request
{
  "provider": "",
  "service": "",
  "policy": {
    "type": "",
    "allocations": ""
  },
  "startTimeInSeconds": "",
  "endTimeInSeconds": "",
  "createTimeInMillis": "",
  "updateTimeInMillis": ""
}