AutoSavings

AutoSavings Account APIs

Get AutoSavings account List

get

Retrieve information about the AWS account registered with the company.

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
browserTimeZonestringOptional

Browser Timezone

Example: +09:00
linkedAccountIdstringOptional

Linked Account ID

Example: '123456789011'
linkedAccountAliasstringOptional

Linked Account Name

Example: 'Alias equals name'
accessTypestringOptional

AutoSavings AWS account access type

Example: 'role-arn / access-key '
roleArnstringOptional

roleArn

Example: 'roleArn'
accessKeystringOptional
secretKeystringOptional
tokenstringOptional
startDatestringOptional
endDatestringOptional
siteRegionstringOptional

siteRegion

Example: 'GLOBAL / CHINA'
servicesstringOptional

AutoSavings services subscribed to by the account

Example: 'AUTO-RI, AUTO-STORAGE, AUTO-DISK
encryptKeystringOptional
subscriptionStatusstringOptional

Current AutoSavings subscription status of the account

Example: 'SUBSCRIBED'
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "companyId": "1",
      "linkedAccountId": "123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "accessType": "role-arn",
      "roleArn": "aws:arn:123456:api",
      "siteRegion": "GLOBAL",
      "deleteYn": "0:false / 1:true",
      "createDate": "'%Y-%m-%d %H:%i:%s'",
      "createUser": "user",
      "updateDate": "'%Y-%m-%d %H:%i:%s'",
      "updateUser": "user"
    }
  ],
  "roleArnInfo": {
    "cloudFormationTemplateUrl": "text",
    "externalId": "text"
  },
  "data": {
    "siteRegion": "text"
  }
}

Get AutoSavings Account Subscription Histories

get

Retrieve AWS AutoSavings subscription histories

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
browserTimeZonestringOptional

Browser Timezone

Example: +09:00
linkedAccountIdstringOptional

Linked Account ID

Example: '123456789011'
linkedAccountAliasstringOptional

Linked Account Name

Example: 'Alias equals name'
accessTypestringOptional

AutoSavings AWS account access type

Example: 'role-arn / access-key '
roleArnstringOptional

roleArn

Example: 'roleArn'
accessKeystringOptional
secretKeystringOptional
tokenstringOptional
startDatestringOptional
endDatestringOptional
siteRegionstringOptional

siteRegion

Example: 'GLOBAL / CHINA'
servicesstringOptional

AutoSavings services subscribed to by the account

Example: 'AUTO-RI, AUTO-STORAGE, AUTO-DISK
encryptKeystringOptional
subscriptionStatusstringOptional

Current AutoSavings subscription status of the account

Example: 'SUBSCRIBED'
latestbooleanOptional

View the latest subscription information by account

Default: true
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts/subscription/histories HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "list": [
    {
      "linkedAccountId": "text",
      "payerAccountId": "text",
      "autoSavingsService": "text",
      "subscriptionStatus": "text",
      "startDateTime": "text",
      "cancelDateTime": "text",
      "endDateTime": "text"
    }
  ]
}

Get AutoSavings Account State

get

Retrieve registered AWS AutoSavings accounts state

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
browserTimeZonestringOptional

Browser Timezone

Example: +09:00
linkedAccountIdstringOptional

Linked Account ID

Example: '123456789011'
linkedAccountAliasstringOptional

Linked Account Name

Example: 'Alias equals name'
accessTypestringOptional

AutoSavings AWS account access type

Example: 'role-arn / access-key '
roleArnstringOptional

roleArn

Example: 'roleArn'
accessKeystringOptional
secretKeystringOptional
tokenstringOptional
startDatestringOptional
endDatestringOptional
siteRegionstringOptional

siteRegion

Example: 'GLOBAL / CHINA'
servicesstringOptional

AutoSavings services subscribed to by the account

Example: 'AUTO-RI, AUTO-STORAGE, AUTO-DISK
encryptKeystringOptional
subscriptionStatusstringOptional

Current AutoSavings subscription status of the account

Example: 'SUBSCRIBED'
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts/state HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "data": {
    "totalCount": 1,
    "subscriptionCount": 1,
    "state": "NONE",
    "savingsCost": 1,
    "monthlyEstimateCost": 1,
    "accounts": [
      {
        "linkedAccountId": "text",
        "linkedAccountName": "text",
        "autoRiSubscribed": true,
        "autoSpSubscribed": true,
        "subscribed": true,
        "purchase": true,
        "estimatedCost": 1,
        "accountStatus": "text"
      }
    ]
  }
}

Get AutoSavings account AWS role ARN Info

get

Retrieve the necessary information for AWS cross-account registration.

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
browserTimeZonestringOptional

Browser Timezone

Example: +09:00
linkedAccountIdstringOptional

Linked Account ID

Example: '123456789011'
linkedAccountAliasstringOptional

Linked Account Name

Example: 'Alias equals name'
accessTypestringOptional

AutoSavings AWS account access type

Example: 'role-arn / access-key '
roleArnstringOptional

roleArn

Example: 'roleArn'
accessKeystringOptional
secretKeystringOptional
tokenstringOptional
startDatestringOptional
endDatestringOptional
siteRegionstringOptional

siteRegion

Example: 'GLOBAL / CHINA'
servicesstringOptional

AutoSavings services subscribed to by the account

Example: 'AUTO-RI, AUTO-STORAGE, AUTO-DISK
encryptKeystringOptional
subscriptionStatusstringOptional

Current AutoSavings subscription status of the account

Example: 'SUBSCRIBED'
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts/role-arn HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "companyId": "1",
      "linkedAccountId": "123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "accessType": "role-arn",
      "roleArn": "aws:arn:123456:api",
      "siteRegion": "GLOBAL",
      "deleteYn": "0:false / 1:true",
      "createDate": "'%Y-%m-%d %H:%i:%s'",
      "createUser": "user",
      "updateDate": "'%Y-%m-%d %H:%i:%s'",
      "updateUser": "user"
    }
  ],
  "roleArnInfo": {
    "cloudFormationTemplateUrl": "text",
    "externalId": "text"
  },
  "data": {
    "siteRegion": "text"
  }
}

Get AutoSavings Site Region

get

Retrieve Information about customer sites utilizing AWS AutoSavings.

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
browserTimeZonestringOptional

Browser Timezone

Example: +09:00
linkedAccountIdstringOptional

Linked Account ID

Example: '123456789011'
linkedAccountAliasstringOptional

Linked Account Name

Example: 'Alias equals name'
accessTypestringOptional

AutoSavings AWS account access type

Example: 'role-arn / access-key '
roleArnstringOptional

roleArn

Example: 'roleArn'
accessKeystringOptional
secretKeystringOptional
tokenstringOptional
startDatestringOptional
endDatestringOptional
siteRegionstringOptional

siteRegion

Example: 'GLOBAL / CHINA'
servicesstringOptional

AutoSavings services subscribed to by the account

Example: 'AUTO-RI, AUTO-STORAGE, AUTO-DISK
encryptKeystringOptional
subscriptionStatusstringOptional

Current AutoSavings subscription status of the account

Example: 'SUBSCRIBED'
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts/region HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "companyId": "1",
      "linkedAccountId": "123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "accessType": "role-arn",
      "roleArn": "aws:arn:123456:api",
      "siteRegion": "GLOBAL",
      "deleteYn": "0:false / 1:true",
      "createDate": "'%Y-%m-%d %H:%i:%s'",
      "createUser": "user",
      "updateDate": "'%Y-%m-%d %H:%i:%s'",
      "updateUser": "user"
    }
  ],
  "roleArnInfo": {
    "cloudFormationTemplateUrl": "text",
    "externalId": "text"
  },
  "data": {
    "siteRegion": "text"
  }
}

Integrated(User & AutoSavings) Coverage APIs

Get Savings Plans List

get

Get Coverage List

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
dateTypestring · enumOptional

Date query type

Example: DAILYPossible values:
startDatestringRequired

Start Date

Example: 2020-10-01
endDatestringRequired

End Date

Example: 2020-10-31
accountsstringOptional

Linked Account IDs

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
autoRiYnstringOptional

If retrieve only AutoRI or not

searchTypestringOptional

Search type

Example: All, My, AutoSavings
commitmentServicestringOptional

AWS commitment service type

Example: all, savings-plans, reserved-instance
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "reservedInstanceCoverageRate": 1,
      "savingsPlansCoverageRate": 1,
      "autoRiCoverageRate": 1,
      "autoSpCoverageRate": 1,
      "onDemandCoverageRate": 1,
      "reservedInstanceOnDemandCostEquivalent": 1,
      "savingsPlansOnDemandCostEquivalent": 1,
      "autoRiOnDemandCostEquivalent": 1,
      "autoSpOnDemandCostEquivalent": 1,
      "onDemandCost": 1,
      "totalOnDemandCostEquivalent": 1,
      "reservedInstanceNormalizeFactorAmount": 1,
      "savingsPlansNormalizeFactorAmount": 1,
      "autoRiNormalizeFactorAmount": 1,
      "autoSpNormalizeFactorAmount": 1,
      "onDemandNormalizeFactorAmount": 1,
      "totalNormalizeFactorAmount": 1,
      "reservedInstanceAmount": 1,
      "savingsPlansAmount": 1,
      "autoRiAmount": 1,
      "autoSpAmount": 1,
      "onDemandAmount": 1,
      "totalAmount": 1,
      "linkedAccountId": "123456789011",
      "linkedAccountAlias": "Service Platform",
      "productCode": "AmazonEC2",
      "productName": "EC2",
      "platform": "Linux",
      "instanceType": "c4.xlarge",
      "instanceSize": "c4.xlarge",
      "tenancy": "Shared",
      "regionCode": "ap-northeast-2",
      "regionName": "Asia Pacific (Seoul)"
    }
  ]
}

Get Savings Plans Total Transition

get

Get Coverage Total Transition

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
dateTypestringRequired

Date query type

Example: DAILY
Query parameters
startDatestringRequired

Start Date

Example: 2020-10-01
endDatestringRequired

End Date

Example: 2020-10-31
accountsstringOptional

Linked Account IDs

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
autoRiYnstringOptional

If retrieve only AutoRI or not

searchTypestringOptional

Search type

Example: All, My, AutoSavings
commitmentServicestringOptional

AWS commitment service type

Example: all, savings-plans, reserved-instance
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages/time-series/{dateType} HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "reservedInstanceCoverageRate": 1,
      "savingsPlansCoverageRate": 1,
      "autoRiCoverageRate": 1,
      "autoSpCoverageRate": 1,
      "onDemandCoverageRate": 1,
      "reservedInstanceOnDemandCostEquivalent": 1,
      "savingsPlansOnDemandCostEquivalent": 1,
      "autoRiOnDemandCostEquivalent": 1,
      "autoSpOnDemandCostEquivalent": 1,
      "onDemandCost": 1,
      "totalOnDemandCostEquivalent": 1,
      "reservedInstanceNormalizeFactorAmount": 1,
      "savingsPlansNormalizeFactorAmount": 1,
      "autoRiNormalizeFactorAmount": 1,
      "autoSpNormalizeFactorAmount": 1,
      "onDemandNormalizeFactorAmount": 1,
      "totalNormalizeFactorAmount": 1,
      "reservedInstanceAmount": 1,
      "savingsPlansAmount": 1,
      "autoRiAmount": 1,
      "autoSpAmount": 1,
      "onDemandAmount": 1,
      "totalAmount": 1,
      "usageDate": "2020-07-01"
    }
  ]
}

Get Savings Plans Filter

get

Get Coverage Filter

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
dateTypestring · enumOptional

Date query type

Example: DAILYPossible values:
startDatestringRequired

Start Date

Example: 2020-10-01
endDatestringRequired

End Date

Example: 2020-10-31
accountsstringOptional

Linked Account IDs

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
autoRiYnstringOptional

If retrieve only AutoRI or not

searchTypestringOptional

Search type

Example: All, My, AutoSavings
commitmentServicestringOptional

AWS commitment service type

Example: all, savings-plans, reserved-instance
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages/categories HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "data": {
    "accounts": "['123456789011', '123456789012']",
    "products": "[ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]",
    "regions": "[ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]",
    "instanceTypes": "[ 't2.micro', 'm4.xlarge' ]",
    "opsNowProducts": "[ 'SELF', 'AUTO-RI']"
  }
}

Get Savings Plans total summary

get

Get Coverage Total summary

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
dateTypestring · enumOptional

Date query type

Example: DAILYPossible values:
startDatestringRequired

Start Date

Example: 2020-10-01
endDatestringRequired

End Date

Example: 2020-10-31
accountsstringOptional

Linked Account IDs

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
autoRiYnstringOptional

If retrieve only AutoRI or not

searchTypestringOptional

Search type

Example: All, My, AutoSavings
commitmentServicestringOptional

AWS commitment service type

Example: all, savings-plans, reserved-instance
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages/aggregated HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "data": {
    "reservedInstanceCoverageRate": 1,
    "savingsPlansCoverageRate": 1,
    "autoRiCoverageRate": 1,
    "autoSpCoverageRate": 1,
    "onDemandCoverageRate": 1,
    "reservedInstanceOnDemandCostEquivalent": 1,
    "savingsPlansOnDemandCostEquivalent": 1,
    "autoRiOnDemandCostEquivalent": 1,
    "autoSpOnDemandCostEquivalent": 1,
    "onDemandCost": 1,
    "totalOnDemandCostEquivalent": 1,
    "reservedInstanceNormalizeFactorAmount": 1,
    "savingsPlansNormalizeFactorAmount": 1,
    "autoRiNormalizeFactorAmount": 1,
    "autoSpNormalizeFactorAmount": 1,
    "onDemandNormalizeFactorAmount": 1,
    "totalNormalizeFactorAmount": 1,
    "reservedInstanceAmount": 1,
    "savingsPlansAmount": 1,
    "autoRiAmount": 1,
    "autoSpAmount": 1,
    "onDemandAmount": 1,
    "totalAmount": 1
  }
}

Integrated(User & AutoSavings) Inventory APIs

Get My Inventory List

get

Get My Inventory List

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
dateTypestring · enumOptional

Date query type

Example: DAILYPossible values:
startDatestringRequired

Start Date

Example: 2023-10-01
endDatestringRequired

End Date

Example: 2023-10-31
accountsstringOptional

Linked Account ID

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
regionsstringOptional

Regions

Example: [ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]
instanceTypesstringOptional

Instance types

Example: [ 't2.micro', 'm4.xlarge' ]
opsnowProductCodesstringOptional

OpsNow RI Purchase types

Example: [ 'AUTO-RI', 'AUTO-SP', 'CLIENT-RI' ]
searchTypestringOptional

Search type

Example: All, My, AutoSavings
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/inventory/my-list HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "inventoryId": "3118c6a8-7fc3-4b5d-8b53-a82fbe6f3169",
      "linkedAccountId": "123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "productCode": "AmazonEC2",
      "productName": "EC2",
      "instanceType": "c4.xlarge",
      "regionCode": "ap-northeast-2",
      "regionName": "Asia Pacific (Seoul)",
      "purchaseOption": "All Upfront",
      "remainingDays": 365,
      "startDate": "2019-01-01 23:59:59",
      "endDate": "2011-01-01 23:59:58",
      "duration": 31536000,
      "platform": "Linux/UNIX",
      "operationName": "RunInstances",
      "status": "active",
      "arn": "arn:aws:rds:ap-northeast-2:249145062117:ri:ri-2020-05-15-05-12-58-377",
      "hourlyCommitmentCost": 100,
      "upfrontFee": 777,
      "recurringFee": 777
    }
  ]
}

Get Savings Plans Inventory List

get

Get Savings Plans Inventory List

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
dateTypestring · enumOptional

Date query type

Example: DAILYPossible values:
startDatestringRequired

Start Date

Example: 2023-10-01
endDatestringRequired

End Date

Example: 2023-10-31
accountsstringOptional

Linked Account ID

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
regionsstringOptional

Regions

Example: [ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]
instanceTypesstringOptional

Instance types

Example: [ 't2.micro', 'm4.xlarge' ]
opsnowProductCodesstringOptional

OpsNow RI Purchase types

Example: [ 'AUTO-RI', 'AUTO-SP', 'CLIENT-RI' ]
searchTypestringOptional

Search type

Example: All, My, AutoSavings
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/inventory/list HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "inventoryId": "3118c6a8-7fc3-4b5d-8b53-a82fbe6f3169",
      "linkedAccountId": "123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "productCode": "AmazonEC2",
      "productName": "EC2",
      "instanceType": "c4.xlarge",
      "regionCode": "ap-northeast-2",
      "regionName": "Asia Pacific (Seoul)",
      "purchaseOption": "All Upfront",
      "remainingDays": 365,
      "startDate": "2019-01-01 23:59:59",
      "endDate": "2011-01-01 23:59:58",
      "duration": 31536000,
      "platform": "Linux/UNIX",
      "operationName": "RunInstances",
      "status": "active",
      "arn": "arn:aws:rds:ap-northeast-2:249145062117:ri:ri-2020-05-15-05-12-58-377",
      "hourlyCommitmentCost": 100,
      "upfrontFee": 777,
      "recurringFee": 777
    }
  ]
}

Get AutoSavings Inventory List

get

Get AutoSavings Inventory List

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
dateTypestring · enumOptional

Date query type

Example: DAILYPossible values:
startDatestringRequired

Start Date

Example: 2023-10-01
endDatestringRequired

End Date

Example: 2023-10-31
accountsstringOptional

Linked Account ID

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
regionsstringOptional

Regions

Example: [ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]
instanceTypesstringOptional

Instance types

Example: [ 't2.micro', 'm4.xlarge' ]
opsnowProductCodesstringOptional

OpsNow RI Purchase types

Example: [ 'AUTO-RI', 'AUTO-SP', 'CLIENT-RI' ]
searchTypestringOptional

Search type

Example: All, My, AutoSavings
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/inventory/auto-list HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "inventoryId": "3118c6a8-7fc3-4b5d-8b53-a82fbe6f3169",
      "linkedAccountId": "123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "productCode": "AmazonEC2",
      "productName": "EC2",
      "instanceType": "c4.xlarge",
      "regionCode": "ap-northeast-2",
      "regionName": "Asia Pacific (Seoul)",
      "purchaseOption": "All Upfront",
      "remainingDays": 365,
      "startDate": "2019-01-01 23:59:59",
      "endDate": "2011-01-01 23:59:58",
      "duration": 31536000,
      "platform": "Linux/UNIX",
      "operationName": "RunInstances",
      "status": "active",
      "arn": "arn:aws:rds:ap-northeast-2:249145062117:ri:ri-2020-05-15-05-12-58-377",
      "hourlyCommitmentCost": 100,
      "upfrontFee": 777,
      "recurringFee": 777
    }
  ]
}

Integrated(User & AutoSavings) Utilization APIs

Get Agreement Utilization List

get

Get Agreement Utilization List

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
dateTypestring · enumOptional

Date query type

Example: DAILYPossible values:
startDatestringRequired

Start Date

Example: 2023-10-01
endDatestringRequired

End Date

Example: 2023-10-31
accountsstringOptional

Linked Account ID

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
regionsstringOptional

Regions

Example: [ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]
instanceTypesstringOptional

Instance types

Example: [ 't2.micro', 'm4.xlarge' ]
opsnowProductCodesstringOptional

OpsNow RI Purchase types

Example: [ 'AUTO-RI', 'AUTO-SP', 'CLIENT-RI' ]
searchTypestringOptional

Search type

Example: All, My, AutoSavings
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "utilization": 78.15,
      "commitmentCost": 2880,
      "usedCommitmentCost": 3690.19,
      "netSavingsCost": 810.19,
      "usedCommitmentCostOnDemandEquivalent": 1,
      "netSavingsRate": 28.13,
      "opsNowProduct": "AUTO-RI",
      "inventoryId": "ri-2020-03-27-04-12-02-595",
      "inventoryArn": "arn:aws:rds:ap-northeast-2:216093335544:ri:ri-2020-03-27-04-12-02-595",
      "linkedAccountId": "123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "productCode": "EC2InstanceSavingsPlans",
      "productName": "EC2 Instance",
      "instanceType": "c5.2xlarge",
      "instanceSize": "c4.xlarge",
      "regionCode": "ap-northeast-2",
      "regionName": "Asia Pacific (Seoul)",
      "purchaseOption": "All Upfront",
      "startDate": "2025-06-21T06:45:56.112Z",
      "endDate": "2025-06-21T06:45:56.112Z"
    }
  ]
}

Get Total Transition

get

Get Utilization Total Transition

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
dateTypestringRequired

Date query type

Example: DAILY
Query parameters
startDatestringRequired

Start Date

Example: 2023-10-01
endDatestringRequired

End Date

Example: 2023-10-31
accountsstringOptional

Linked Account ID

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
regionsstringOptional

Regions

Example: [ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]
instanceTypesstringOptional

Instance types

Example: [ 't2.micro', 'm4.xlarge' ]
opsnowProductCodesstringOptional

OpsNow RI Purchase types

Example: [ 'AUTO-RI', 'AUTO-SP', 'CLIENT-RI' ]
searchTypestringOptional

Search type

Example: All, My, AutoSavings
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/time-series/{dateType} HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "utilization": 78.15,
      "commitmentCost": 2880,
      "usedCommitmentCost": 3690.19,
      "netSavingsCost": 810.19,
      "netSavingsRate": 28.13,
      "usedCommitmentCostOnDemandEquivalent": 1,
      "usageDate": "2020-07-01",
      "opsNowProduct": "AUTO-RI"
    }
  ]
}

Overview Monthly Overview Savings

get

Overview Monthly Overview Savings

Authorizations
Path parameters
companyIdstringRequired

Company ID

Query parameters
startDatestringOptional

Search start date

endDatestringOptional

Search end date

Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/overview-savings HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "state": {
    "totalCount": 1,
    "subscriptionCount": 1,
    "state": "NONE",
    "savingsCost": 1,
    "monthlyEstimateCost": 1,
    "accounts": [
      {
        "linkedAccountId": "text",
        "linkedAccountName": "text",
        "autoRiSubscribed": true,
        "autoSpSubscribed": true,
        "subscribed": true,
        "purchase": true,
        "estimatedCost": 1,
        "accountStatus": "text"
      }
    ]
  },
  "list": [
    {
      "yearMonth": "text",
      "lastDay": "Service Platform",
      "totalSavingCost": 1,
      "autoSavingCost": 1,
      "mySavingCost": 1,
      "estimatedCost": 1,
      "estimatedAutoSavingCost": 1,
      "estimatedMySavingCost": 1,
      "savingsCostComparedPreviousMonth": 1,
      "savingsRateComparedPreviousMonth": 1
    }
  ],
  "lastMonthNetSavings": {
    "yearMonth": "text",
    "lastDay": "Service Platform",
    "totalSavingCost": 1,
    "autoSavingCost": 1,
    "mySavingCost": 1,
    "estimatedCost": 1,
    "estimatedAutoSavingCost": 1,
    "estimatedMySavingCost": 1,
    "savingsCostComparedPreviousMonth": 1,
    "savingsRateComparedPreviousMonth": 1
  }
}

Get Filter

get

Get Utilization Filter

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
dateTypestring · enumOptional

Date query type

Example: DAILYPossible values:
startDatestringRequired

Start Date

Example: 2023-10-01
endDatestringRequired

End Date

Example: 2023-10-31
accountsstringOptional

Linked Account ID

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
regionsstringOptional

Regions

Example: [ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]
instanceTypesstringOptional

Instance types

Example: [ 't2.micro', 'm4.xlarge' ]
opsnowProductCodesstringOptional

OpsNow RI Purchase types

Example: [ 'AUTO-RI', 'AUTO-SP', 'CLIENT-RI' ]
searchTypestringOptional

Search type

Example: All, My, AutoSavings
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/categories HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "data": {
    "accounts": "['123456789011', '123456789012']",
    "products": "[ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]",
    "regions": "[ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]",
    "instanceTypes": "[ 't2.micro', 'm4.xlarge' ]",
    "opsNowProducts": "[ 'SELF', 'AUTO-RI']"
  }
}

Get total summary

get

Get Utilization Total summary

Authorizations
Path parameters
companyIdstringRequired

Company ID

Example: 1
Query parameters
dateTypestring · enumOptional

Date query type

Example: DAILYPossible values:
startDatestringRequired

Start Date

Example: 2023-10-01
endDatestringRequired

End Date

Example: 2023-10-31
accountsstringOptional

Linked Account ID

Example: ['123456789011', '123456789012']
productsstringOptional

Products

Example: ['EC2InstanceReserved', 'ComputeReserved']
regionsstringOptional

Regions

Example: [ {'code':'EC2InstanceReserved', 'value':'EC2 Instance'} ]
instanceTypesstringOptional

Instance types

Example: [ 't2.micro', 'm4.xlarge' ]
opsnowProductCodesstringOptional

OpsNow RI Purchase types

Example: [ 'AUTO-RI', 'AUTO-SP', 'CLIENT-RI' ]
searchTypestringOptional

Search type

Example: All, My, AutoSavings
Responses
200
OK
*/*
get
GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/aggregated HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "data": {
    "utilization": 78.15,
    "commitmentCost": 2880,
    "usedCommitmentCost": 3690.19,
    "netSavingsCost": 810.19,
    "netSavingsRate": 28.13,
    "usedCommitmentCostOnDemandEquivalent": 1,
    "usageDate": "2020-07-01",
    "opsNowProduct": "AUTO-RI"
  }
}
PreviousResourcesNextCommitment

Last updated