AutoSavings

AutoSavings Account APIs

Get AutoSavings account List

get

Retrieve information about the AWS account registered with the company.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts

HTTPcURLJavaScriptPython

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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts/subscription/histories

HTTPcURLJavaScriptPython

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": [
    {
      "vendor": "text",
      "linkedAccountId": "text",
      "payerAccountId": "text",
      "autoSavingsService": "text",
      "accountType": "text",
      "subscriptionStatus": "text",
      "startDateTime": "text",
      "cancelDateTime": "text",
      "endDateTime": "text"
    }
  ]
}

Get AutoSavings Account State

get

Retrieve registered AWS AutoSavings accounts state

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts/state

HTTPcURLJavaScriptPython

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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts/role-arn

HTTPcURLJavaScriptPython

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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/accounts/region

HTTPcURLJavaScriptPython

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"
  }
}

AutoSavings Account - All Vendor APIs

Get AutoSavings Account Subscription Histories

get

Retrieve Azure AutoSavings subscription histories

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/all/services/accounts/subscription/histories

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/all/services/accounts/subscription/histories HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

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

Get Azure AutoSavings Account State

get

Retrieve registered Azure AutoSavings accounts state for specified period

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/all/services/accounts/state

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/all/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,
    "aws": {
      "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"
        }
      ]
    },
    "azure": {
      "totalCount": 1,
      "subscriptionCount": 1,
      "state": "NONE",
      "savingsCost": 1,
      "monthlyEstimateCost": 1,
      "accounts": [
        {
          "subscriptionId": "text",
          "subscriptionName": "text",
          "subscribed": true,
          "estimatedCost": 1
        }
      ]
    }
  }
}

AutoSavings Azure Account APIs

Get AutoSavings Account Subscription Histories

get

Retrieve Azure AutoSavings subscription histories

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/accounts/subscription/histories

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/services/accounts/subscription/histories HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

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

Get Azure AutoSavings Account State

get

Retrieve registered Azure AutoSavings accounts state for specified period

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/accounts/state

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/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": [
      {
        "subscriptionId": "text",
        "subscriptionName": "text",
        "subscribed": true,
        "estimatedCost": 1
      }
    ]
  }
}

Integrated(User & AutoSavings) Coverage APIs

Get Savings Plans List

get

Get Coverage List

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages?startDate=2020-10-01&endDate=2020-10-31 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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages/time-series/{dateType}

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages/time-series/{dateType}?startDate=2020-10-01&endDate=2020-10-31 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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages/categories

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages/categories?startDate=2020-10-01&endDate=2020-10-31 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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages/aggregated

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/coverages/aggregated?startDate=2020-10-01&endDate=2020-10-31 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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/inventory/my-list

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/inventory/my-list?startDate=2023-10-01&endDate=2023-10-31 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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/inventory/list

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/inventory/list?startDate=2023-10-01&endDate=2023-10-31 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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/inventory/auto-list

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/inventory/auto-list?startDate=2023-10-01&endDate=2023-10-31 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) Inventory - Azure APIs

Get My Azure Inventory List

get

Get My Azure Inventory List

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

subscriptionIdsstringOptional

Subscription ID

Example: ['123456789011', '123456789012']

displayNamesstringOptional

Display Name

Example: ['123456789011', '123456789012']

productNamesstringOptional

Product Names

Example: ['Virtual Machines', 'SQL Database']

accountsstringOptional

Linked Account ID

Example: ['subscription-1', 'subscription-2']

productsstringOptional

Products

Example: ['VirtualMachines', 'SQLDatabase']

regionsstringOptional

Regions

Example: ['eastus', 'westus']

instanceTypesstringOptional

Instance types

Example: ['Standard_D2s_v3', 'Standard_B1s']

opsnowProductCodesstringOptional

OpsNow RI Purchase types

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

searchTypestringOptional

Search type

Example: All, My, AutoSavings

isExpiredstringOptional

Include expired reservations

Example: false

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/inventory/my-list

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/inventory/my-list?startDate=2023-10-01&endDate=2023-10-31 HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "inventoryId": "ff190dc7-3f20-4b92-825d-896084a00f4b",
      "linkedAccountId": "12345678-1234-1234-1234-123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "productCode": "VirtualMachines",
      "productName": "Virtual Machines",
      "instanceType": "Standard_D2s_v3",
      "regionCode": "eastus",
      "regionName": "East US",
      "purchaseOption": "Monthly",
      "remainingDays": 365,
      "startDate": "2020-10-12 05:28:52",
      "endDate": "2023-10-12 00:00:00",
      "duration": 94608000,
      "platform": "text",
      "operationName": "text",
      "status": "Active",
      "arn": "text",
      "hourlyCommitmentCost": 3.5,
      "upfrontFee": 0,
      "recurringFee": 3.5
    }
  ]
}

Get list of Azure Reservations inventory

get

Retrieve Azure Reservations inventory (same as commitment API)

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

subscriptionIdsstringOptional

Subscription ID

Example: ['123456789011', '123456789012']

displayNamesstringOptional

Display Name

Example: ['123456789011', '123456789012']

productNamesstringOptional

Product Names

Example: ['Virtual Machines', 'SQL Database']

accountsstringOptional

Linked Account ID

Example: ['subscription-1', 'subscription-2']

productsstringOptional

Products

Example: ['VirtualMachines', 'SQLDatabase']

regionsstringOptional

Regions

Example: ['eastus', 'westus']

instanceTypesstringOptional

Instance types

Example: ['Standard_D2s_v3', 'Standard_B1s']

opsnowProductCodesstringOptional

OpsNow RI Purchase types

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

searchTypestringOptional

Search type

Example: All, My, AutoSavings

isExpiredstringOptional

Include expired reservations

Example: false

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/inventory/list

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/inventory/list?startDate=2023-10-01&endDate=2023-10-31 HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "inventoryId": "ff190dc7-3f20-4b92-825d-896084a00f4b",
      "linkedAccountId": "12345678-1234-1234-1234-123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "productCode": "VirtualMachines",
      "productName": "Virtual Machines",
      "instanceType": "Standard_D2s_v3",
      "regionCode": "eastus",
      "regionName": "East US",
      "purchaseOption": "Monthly",
      "remainingDays": 365,
      "startDate": "2020-10-12 05:28:52",
      "endDate": "2023-10-12 00:00:00",
      "duration": 94608000,
      "platform": "text",
      "operationName": "text",
      "status": "Active",
      "arn": "text",
      "hourlyCommitmentCost": 3.5,
      "upfrontFee": 0,
      "recurringFee": 3.5
    }
  ]
}

Get category list of Azure Reservations inventory

get

Retrieve the categories of Azure Reservations inventory (same as commitment API)

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

subscriptionIdsstringOptional

Subscription ID

Example: ['123456789011', '123456789012']

displayNamesstringOptional

Display Name

Example: ['123456789011', '123456789012']

productNamesstringOptional

Product Names

Example: ['Virtual Machines', 'SQL Database']

accountsstringOptional

Linked Account ID

Example: ['subscription-1', 'subscription-2']

productsstringOptional

Products

Example: ['VirtualMachines', 'SQLDatabase']

regionsstringOptional

Regions

Example: ['eastus', 'westus']

instanceTypesstringOptional

Instance types

Example: ['Standard_D2s_v3', 'Standard_B1s']

opsnowProductCodesstringOptional

OpsNow RI Purchase types

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

searchTypestringOptional

Search type

Example: All, My, AutoSavings

isExpiredstringOptional

Include expired reservations

Example: false

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/inventory/categories

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/inventory/categories?startDate=2023-10-01&endDate=2023-10-31 HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "data": {
    "subscriptions": [
      {
        "code": "ap-northeast-2",
        "name": "Asia Pacific (Seoul)"
      }
    ],
    "products": [
      {
        "code": "ap-northeast-2",
        "name": "Asia Pacific (Seoul)"
      }
    ]
  }
}

Get AutoSavings Azure Inventory List

get

Get AutoSavings Azure Inventory List

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

subscriptionIdsstringOptional

Subscription ID

Example: ['123456789011', '123456789012']

displayNamesstringOptional

Display Name

Example: ['123456789011', '123456789012']

productNamesstringOptional

Product Names

Example: ['Virtual Machines', 'SQL Database']

accountsstringOptional

Linked Account ID

Example: ['subscription-1', 'subscription-2']

productsstringOptional

Products

Example: ['VirtualMachines', 'SQLDatabase']

regionsstringOptional

Regions

Example: ['eastus', 'westus']

instanceTypesstringOptional

Instance types

Example: ['Standard_D2s_v3', 'Standard_B1s']

opsnowProductCodesstringOptional

OpsNow RI Purchase types

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

searchTypestringOptional

Search type

Example: All, My, AutoSavings

isExpiredstringOptional

Include expired reservations

Example: false

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/inventory/auto-list

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/inventory/auto-list?startDate=2023-10-01&endDate=2023-10-31 HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "inventoryId": "ff190dc7-3f20-4b92-825d-896084a00f4b",
      "linkedAccountId": "12345678-1234-1234-1234-123456789012",
      "linkedAccountAlias": "Bespinglobal Platform",
      "productCode": "VirtualMachines",
      "productName": "Virtual Machines",
      "instanceType": "Standard_D2s_v3",
      "regionCode": "eastus",
      "regionName": "East US",
      "purchaseOption": "Monthly",
      "remainingDays": 365,
      "startDate": "2020-10-12 05:28:52",
      "endDate": "2023-10-12 00:00:00",
      "duration": 94608000,
      "platform": "text",
      "operationName": "text",
      "status": "Active",
      "arn": "text",
      "hourlyCommitmentCost": 3.5,
      "upfrontFee": 0,
      "recurringFee": 3.5
    }
  ]
}

Integrated(User & AutoSavings) Utilization APIs

Get Agreement Utilization List

get

Get Agreement Utilization List

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations?startDate=2023-10-01&endDate=2023-10-31 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-12-10T11:11:53.342Z",
      "endDate": "2025-12-10T11:11:53.342Z"
    }
  ]
}

Get Total Transition

get

Get Utilization Total Transition

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/time-series/{dateType}

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/time-series/{dateType}?startDate=2023-10-01&endDate=2023-10-31 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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

companyIdstringRequired

Company ID

Query parameters

startDatestringOptional

Search start date

endDatestringOptional

Search end date

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/overview-savings

HTTPcURLJavaScriptPython

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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/categories

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/categories?startDate=2023-10-01&endDate=2023-10-31 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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/aggregated

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/aws/services/integration/utilizations/aggregated?startDate=2023-10-01&endDate=2023-10-31 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"
  }
}

Integrated(User & AutoSavings) Utilization - Azure APIs

Get Agreement Utilization List

get

Get Azure Agreement Utilization List

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

subscriptionIdsstringOptional

Subscription ID

Example: ['123456789011', '123456789012']

displayNamesstringOptional

Display Name

Example: ['123456789011', '123456789012']

productNamesstringOptional

Product Names

Example: ['Virtual Machines', 'SQL Database']

accountsstringOptional

Linked Account ID

Example: ['subscription-1', 'subscription-2']

productsstringOptional

Products

Example: ['VirtualMachines', 'SQLDatabase']

regionsstringOptional

Regions

Example: ['eastus', 'westus']

instanceTypesstringOptional

Instance types

Example: ['Standard_D2s_v3', 'Standard_B1s']

opsnowProductCodesstringOptional

OpsNow RI Purchase types

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

searchTypestringOptional

Search type

Example: All, My, AutoSavings

isExpiredstringOptional

Include expired reservations

Example: false

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/utilizations

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/utilizations?startDate=2023-10-01&endDate=2023-10-31 HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "commitmentCost": 1234.56,
      "usedCommitmentCost": 1234.56,
      "netSavingsCost": 1234.56,
      "usedCommitmentCostOnDemandEquivalent": 1234.56,
      "utilization": 85.5,
      "netSavingsRate": 25.3,
      "inventoryId": "ri-2020-03-27-04-12-02-595",
      "inventoryArn": "/subscriptions/12345678-1234-1234-1234-123456789abc/providers/Microsoft.Capacity/reservationOrders/...",
      "linkedAccountId": "12345678-1234-1234-1234-123456789abc",
      "linkedAccountAlias": "Production Subscription",
      "productCode": "VirtualMachines",
      "productName": "Virtual Machines",
      "instanceType": "Standard_D2s_v3",
      "instanceSize": "Standard_D2s_v3",
      "regionCode": "eastus",
      "regionName": "East US",
      "purchaseOption": "Upfront",
      "startDate": "2025-12-10T11:11:53.342Z",
      "endDate": "2025-12-10T11:11:53.342Z"
    }
  ]
}

Get Total Transition

get

Get Azure Utilization Total Transition (Monthly Aggregation)

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

subscriptionIdsstringOptional

Subscription ID

Example: ['123456789011', '123456789012']

displayNamesstringOptional

Display Name

Example: ['123456789011', '123456789012']

productNamesstringOptional

Product Names

Example: ['Virtual Machines', 'SQL Database']

accountsstringOptional

Linked Account ID

Example: ['subscription-1', 'subscription-2']

productsstringOptional

Products

Example: ['VirtualMachines', 'SQLDatabase']

regionsstringOptional

Regions

Example: ['eastus', 'westus']

instanceTypesstringOptional

Instance types

Example: ['Standard_D2s_v3', 'Standard_B1s']

opsnowProductCodesstringOptional

OpsNow RI Purchase types

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

searchTypestringOptional

Search type

Example: All, My, AutoSavings

isExpiredstringOptional

Include expired reservations

Example: false

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/utilizations/time-series/{dateType}

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/utilizations/time-series/{dateType}?startDate=2023-10-01&endDate=2023-10-31 HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "list": [
    {
      "commitmentCost": 1234.56,
      "usedCommitmentCost": 1234.56,
      "netSavingsCost": 1234.56,
      "usedCommitmentCostOnDemandEquivalent": 1234.56,
      "utilization": 85.5,
      "netSavingsRate": 25.3,
      "usageDate": "2020-07-01"
    }
  ]
}

Overview Monthly Overview Savings

get

Overview Monthly Azure Overview Savings

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

companyIdstringRequired

Company ID

Example: 1

Query parameters

minusMonthstringOptional

Months to look back

Example: 12

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/utilizations/overview-savings

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/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": [
      {
        "subscriptionId": "text",
        "subscriptionName": "text",
        "subscribed": true,
        "estimatedCost": 1
      }
    ]
  },
  "list": [
    {
      "yearMonth": "text",
      "lastDay": "Production Subscription",
      "totalSavingCost": 1,
      "autoSavingCost": 1,
      "mySavingCost": 1,
      "estimatedCost": 1,
      "estimatedAutoSavingCost": 1,
      "estimatedMySavingCost": 1,
      "savingsCostComparedPreviousMonth": 1,
      "savingsRateComparedPreviousMonth": 1
    }
  ],
  "lastMonthNetSavings": {
    "yearMonth": "text",
    "lastDay": "Production Subscription",
    "totalSavingCost": 1,
    "autoSavingCost": 1,
    "mySavingCost": 1,
    "estimatedCost": 1,
    "estimatedAutoSavingCost": 1,
    "estimatedMySavingCost": 1,
    "savingsCostComparedPreviousMonth": 1,
    "savingsRateComparedPreviousMonth": 1
  }
}

Get Filter

get

Get Azure Utilization Filter

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

subscriptionIdsstringOptional

Subscription ID

Example: ['123456789011', '123456789012']

displayNamesstringOptional

Display Name

Example: ['123456789011', '123456789012']

productNamesstringOptional

Product Names

Example: ['Virtual Machines', 'SQL Database']

accountsstringOptional

Linked Account ID

Example: ['subscription-1', 'subscription-2']

productsstringOptional

Products

Example: ['VirtualMachines', 'SQLDatabase']

regionsstringOptional

Regions

Example: ['eastus', 'westus']

instanceTypesstringOptional

Instance types

Example: ['Standard_D2s_v3', 'Standard_B1s']

opsnowProductCodesstringOptional

OpsNow RI Purchase types

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

searchTypestringOptional

Search type

Example: All, My, AutoSavings

isExpiredstringOptional

Include expired reservations

Example: false

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/utilizations/categories

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/utilizations/categories?startDate=2023-10-01&endDate=2023-10-31 HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "data": {
    "accounts": "['sub-123456789011', 'sub-123456789012']",
    "products": "[ {'code':'VirtualMachines', 'value':'Virtual Machines'} ]",
    "regions": "[ {'code':'eastus', 'value':'East US'} ]",
    "instanceTypes": "[ 'Standard_D2s_v3', 'Standard_B1s' ]",
    "opsNowProducts": "[ 'SELF', 'AUTO-RI']"
  }
}

Get total summary

get

Get Azure Utilization Total summary

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

subscriptionIdsstringOptional

Subscription ID

Example: ['123456789011', '123456789012']

displayNamesstringOptional

Display Name

Example: ['123456789011', '123456789012']

productNamesstringOptional

Product Names

Example: ['Virtual Machines', 'SQL Database']

accountsstringOptional

Linked Account ID

Example: ['subscription-1', 'subscription-2']

productsstringOptional

Products

Example: ['VirtualMachines', 'SQLDatabase']

regionsstringOptional

Regions

Example: ['eastus', 'westus']

instanceTypesstringOptional

Instance types

Example: ['Standard_D2s_v3', 'Standard_B1s']

opsnowProductCodesstringOptional

OpsNow RI Purchase types

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

searchTypestringOptional

Search type

Example: All, My, AutoSavings

isExpiredstringOptional

Include expired reservations

Example: false

Responses

200

OK

*/*

get

/cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/utilizations/aggregated

HTTPcURLJavaScriptPython

GET /cost/v3/autosave/companies/{companyId}/vendors/azure/services/integration/utilizations/aggregated?startDate=2023-10-01&endDate=2023-10-31 HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": "text",
  "error": {
    "Code": 1,
    "Message": "text"
  },
  "data": {
    "commitmentCost": 1234.56,
    "usedCommitmentCost": 1234.56,
    "netSavingsCost": 1234.56,
    "usedCommitmentCostOnDemandEquivalent": 1234.56,
    "utilization": 85.5,
    "netSavingsRate": 25.3
  }
}