Update cloud provider ingestion configuration

1 min

PUT

https://app.amberflo.io/focus/configuration

Update an existing FOCUS ingestion configuration to modify cloud provider connection settings, authentication credentials, or data source parameters. Validates updated configuration against provider requirements and tests connectivity when configuration is enabled for production use.

Body Parameters

bodyfocus.ingestion.FocusIngestionConfiguration.in
- enabledboolean
  Description
  Controls whether this FOCUS ingestion configuration actively processes cost reports from the cloud provider
- providerfocus.common.FocusProvider.inrequired
  Description
  Cloud provider for FOCUS report ingestion. Supported values: AWS (Amazon Web Services), AZURE (Microsoft Azure), GOOGLE_CLOUD (Google Cloud Platform). Each provider has specific configuration requirements and supported FOCUS versions.
- typefocus.common.CostDataType.inrequired
  Description
  Type of cost data for ingestion and analysis. FOCUS represents FinOps Cost and Usage Specification compliant data, COST_OPTIMIZATION represents cloud provider recommendations data for cost optimization insights.
- bucketNamestring
  Description
  Cloud provider storage location for FOCUS cost data. **Provider-specific formats:** - **AWS:** S3 bucket name - **Azure FOCUS data:** `{storage account name}/{container name}` - **Google Cloud:** `{project id}/{dataset id}` **Important note:** For Azure COST_OPTIMIZATION data, this field is not used.
- prefixstring
  Description
  Directory path and report name for locating cost export files. **Provider-specific formats:** - **AWS:** `{s3 prefix}/{report name}` as configured in AWS BCM data export - **Azure FOCUS data:** `{directory path}/{report name}` as configured in Azure Cost Management export **Important note:** Not used for Azure COST_OPTIMIZATION data or Google Cloud.
- billingAccountIdstring
  Description
  Google Cloud billing account identifier required for FOCUS data access. **Important note:** Only used for Google Cloud. Not required for AWS and Azure.
- labelstring
  Description
  Display name for this configuration to help identify it in user interfaces
- descriptionstring
  Description
  Optional description explaining the purpose and context of this FOCUS ingestion configuration
- deduplicationIdstring
  Description
  Unique identifier to prevent duplicate processing of FOCUS files. **Auto-generated behavior:** - **AWS/Azure:** Defaults to the report name from the prefix field - **Google Cloud:** Uses the billingAccountId automatically
- versionstring
  Description
  FOCUS specification version when type is FOCUS (defaults to 1.0). **Supported versions by provider:** - **AWS:** 1.0 - **Azure:** 1.0, 1.2 - **Google Cloud:** 1.0 - **Oracle:** 1.0-preview
- azureAppSecretfocus.ingestion.AzureAppSecret.in
  - clientIdstringrequired
    Description
    Application (client) ID of the Azure Application
  - tenantIdstringrequired
    Description
    Directory (tenant) ID of the Azure Application
  - secretstringrequired
    Description
    Value of the client secret of the Azure Application
- oracleConfigfocus.config.OracleConfig.in

Responses

200Successful request

focus.ingestion.FocusIngestionConfiguration.out
- accountIdstring
  Description
  Account identifier that owns this FOCUS ingestion configuration for multi-tenant access control
- idstring
  Description
  Unique UUID identifier for this specific FOCUS ingestion configuration instance
- enabledboolean
  Description
  Controls whether this FOCUS ingestion configuration actively processes cost reports from the cloud provider
- providerfocus.common.FocusProvider.outrequired
  Description
  Cloud provider for FOCUS report ingestion. Supported values: AWS (Amazon Web Services), AZURE (Microsoft Azure), GOOGLE_CLOUD (Google Cloud Platform). Each provider has specific configuration requirements and supported FOCUS versions.
- typefocus.common.CostDataType.outrequired
  Description
  Type of cost data for ingestion and analysis. FOCUS represents FinOps Cost and Usage Specification compliant data, COST_OPTIMIZATION represents cloud provider recommendations data for cost optimization insights.
- bucketNamestring
  Description
  Cloud provider storage location for FOCUS cost data. **Provider-specific formats:** - **AWS:** S3 bucket name - **Azure FOCUS data:** `{storage account name}/{container name}` - **Google Cloud:** `{project id}/{dataset id}` **Important note:** For Azure COST_OPTIMIZATION data, this field is not used.
- bucketRegionstring
  Description
  AWS S3 bucket region automatically detected and stored for optimization purposes
- prefixstring
  Description
  Directory path and report name for locating cost export files. **Provider-specific formats:** - **AWS:** `{s3 prefix}/{report name}` as configured in AWS BCM data export - **Azure FOCUS data:** `{directory path}/{report name}` as configured in Azure Cost Management export **Important note:** Not used for Azure COST_OPTIMIZATION data or Google Cloud.
- billingAccountIdstring
  Description
  Google Cloud billing account identifier required for FOCUS data access. **Important note:** Only used for Google Cloud. Not required for AWS and Azure.
- labelstring
  Description
  Display name for this configuration to help identify it in user interfaces
- descriptionstring
  Description
  Optional description explaining the purpose and context of this FOCUS ingestion configuration
- deduplicationIdstring
  Description
  Unique identifier to prevent duplicate processing of FOCUS files. **Auto-generated behavior:** - **AWS/Azure:** Defaults to the report name from the prefix field - **Google Cloud:** Uses the billingAccountId automatically
- versionstring
  Description
  FOCUS specification version when type is FOCUS (defaults to 1.0). **Supported versions by provider:** - **AWS:** 1.0 - **Azure:** 1.0, 1.2 - **Google Cloud:** 1.0 - **Oracle:** 1.0-preview
- azureAppSecretfocus.ingestion.AzureAppSecret.out
  - clientIdstringrequired
    Description
    Application (client) ID of the Azure Application
  - tenantIdstringrequired
    Description
    Directory (tenant) ID of the Azure Application
  - secretstringrequired
    Description
    Value of the client secret of the Azure Application
- oracleConfigfocus.config.OracleConfig.out
- createTimeInSecondsinteger<int64>
  Description
  Unix timestamp when this FOCUS ingestion configuration was initially created
- updateTimeInSecondsinteger<int64>
  Description
  Unix timestamp when this FOCUS ingestion configuration was last modified
- lastScanTimeInSecondsinteger<int64>
  Description
  Unix timestamp when the last successful FOCUS cost data scan was completed

curl

curl --request PUT \
     --url https://app.amberflo.io/focus/configuration \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "provider": "",
     "type": "",
     "azureAppSecret": {
     "clientId": "",
     "tenantId": "",
     "secret": ""
     }
     }'

javascript

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

var raw = JSON.stringify({
   "provider": "",
   "type": "",
   "azureAppSecret": {
      "clientId": "",
      "tenantId": "",
      "secret": ""
   }
});

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

fetch("https://app.amberflo.io/focus/configuration", 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/focus/configuration")

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

request = Net::HTTP::Put.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "provider": "",
   "type": "",
   "azureAppSecret": {
      "clientId": "",
      "tenantId": "",
      "secret": ""
   }
})

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

python

import requests
import json

url = "https://app.amberflo.io/focus/configuration"

payload = json.dumps({
   "provider": "",
   "type": "",
   "azureAppSecret": {
      "clientId": "",
      "tenantId": "",
      "secret": ""
   }
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

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

print(response.text)

200

// Successful request
{
  "accountId": "",
  "id": "",
  "enabled": false,
  "provider": "",
  "type": "",
  "bucketName": "",
  "bucketRegion": "",
  "prefix": "",
  "billingAccountId": "",
  "label": "",
  "description": "",
  "deduplicationId": "",
  "version": "",
  "azureAppSecret": {
    "clientId": "",
    "tenantId": "",
    "secret": ""
  },
  "oracleConfig": {},
  "createTimeInSeconds": "",
  "updateTimeInSeconds": "",
  "lastScanTimeInSeconds": ""
}