OpsNow Developer Guide
  • About
  • Endpoint
    • Platform
    • Resources
  • Authentication
  • Errors
  • Rate Limiting
  • API reference
    • Platform
    • Cost
    • Resources
    • AutoSavings
    • Commitment
Powered by GitBook

© 2023 OpsNow, Inc.

On this page

Was this helpful?

Edit on GitHub
Export as PDF
  1. API reference

Resources

PreviousCostNextAutoSavings

Last updated 26 days ago

Was this helpful?

Common APIs

Elastic Search Filter APIs

Optimization Detail V3 APIs

Optimization Setting V3 APIs

Resource Optimization APIs

Resource Usage APIs

TagManager APIs

View list of support resources by optimization type

get

View list of support resources by optimization type

Authorizations
Path parameters
optimizeCategorystring · enumRequired

Optimization category

Possible values:
Responses
get
GET /asset/us-v1/optimization/setting/optimize-category/{optimizeCategory} HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "result": [
    {
      "vendor": "text",
      "resourceType": "text",
      "resourceName": "text"
    }
  ],
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

View list of resource optimization settings conditions

get

View the list of conditions that can be set according to resources by optimization category. If there are no conditions set, the default conditions are searched. Depending on the optimization type, resource type may be required.

Authorizations
Path parameters
cmpnIdstringRequired

Company Id

Example: 1
vendorstring · enumRequired

Vendor

Possible values:
optimizeCategorystring · enumRequired

Optimization category

Possible values:
ruleSetIdstringRequired

Rule id

Query parameters
resourceTypestringOptional

Resource type

Example: ec2
Responses
get
GET /asset/us-v1/optimization/setting/companies/{cmpnId}/vendors/{vendor}/optimize-category/{optimizeCategory}/rule-sets/{ruleSetId} HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

View list of resource optimization excluded tags

get

View the list of tags excluded from resource optimization.

Authorizations
Path parameters
cmpnIdstringRequired

Company unique ID

ruleSetIdstringRequired

Rule id

Example: Default
Responses
get
GET /asset/us-v1/optimization/setting/companies/{cmpnId}/rule-sets/{ruleSetId}/deny HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Search for optimization rule set ID of the site and company

get

Search for optimization rule set ID using site and company information.

Authorizations
Path parameters
cmpnIdstringRequired

Company Id

Example: 1
Responses
get
GET /asset/us-v1/optimization/setting/companies/{cmpnId}/rule-set-id HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "data": {
    "ruleSetId": "text"
  },
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get tagKeys

get
Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
Responses
get
GET /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/tag-keys HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get tagKeyVals

get
Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
tagKeystringRequired
Responses
get
GET /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/tag-keys/{tagKey}/tag-vals HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get tag statistics

get

Get tag compliance and status statistics

Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
Responses
get
GET /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/stats/tag HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get tag statistics

get

Get tag compliance and status statistics

Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
Responses
get
GET /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/stats/resource HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get AWS resource required tags

get

Get required tags information for AWS

Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
Responses
get
GET /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/required-tags HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get resources for a specific tag group

get
Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
groupIdstringRequired
Query parameters
pageinteger · int32Optional
sizeinteger · int32Optional
sortstringOptional
searchstringOptional
Responses
get
GET /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/groups/{groupId}/resources HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}
  • Common APIs
  • POST/us-v1/{menu}/{vendor}/grid-headers/{viewType}
  • Elastic Search Filter APIs
  • PUTFilter Data Quick Search For Usage
  • Optimization Detail V3 APIs
  • POSTOptimization Grid View
  • POSTOptimization Grid View
  • POSTOptimization Chart View
  • Optimization Setting V3 APIs
  • PUTReset resource optimization settings conditions
  • GETView list of support resources by optimization type
  • GETView list of resource optimization settings conditions
  • GETView list of resource optimization excluded tags
  • GETSearch for optimization rule set ID of the site and company
  • Resource Optimization APIs
  • PUTView top filter area by vendor
  • POSTLast optimization date lookup
  • POSTView top card area by optimization category
  • POSTPerform resource-optimized batch tasks
  • Resource Usage APIs
  • POSTUsage History Grid Data
  • POSTUsage Current Grid Data
  • POSTUsage Current Chart Data
  • POSTUsage History Chart Data
  • TagManager APIs
  • POSTGet tagKeys by accIds
  • POSTGet tagKeyVals
  • POSTTag modification tasks (addition, deletion, and modification)
  • POSTProvide a list of tag keys for deletion
  • POSTTag key modification tasks
  • POSTGet tags
  • POSTGet resources
  • POSTGet resources by tags
  • POSTGet tagGroups
  • GETGet tagKeys
  • GETGet tagKeyVals
  • GETGet tag statistics
  • GETGet tag statistics
  • GETGet AWS resource required tags
  • GETGet resources for a specific tag group
post
Authorizations
Path parameters
menustringRequired

menu

Example: usage
vendorstringRequired

vendor

Example: aws
viewTypestringRequired

view type

Example: history
Body
cmpnIdstringRequired

Company id

Example: 1
rsrcTypestringOptional

Resource Type

Example: ec2
vendorstringOptional

Vendor

Example: aws
viewTypestringOptional

View Type(current, history)

Example: history
menustringOptional

menu

Example: usage
Responses
post
POST /asset/us-v1/{menu}/{vendor}/grid-headers/{viewType} HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 82

{
  "cmpnId": "1",
  "rsrcType": "ec2",
  "vendor": "aws",
  "viewType": "history",
  "menu": "usage"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Filter Data Quick Search For Usage

put

View Filter Data Quick Search For Usage

Authorizations
Path parameters
menuIdstringRequired

Menu Id

Example: usage
Body
cmpnIdstringRequired

Company id

Example: 1
actionTypestringRequired

Action Type(current, history)

Example: current
Responses
put
PUT /asset/us-v1/elastic/filter/{menuId} HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 115

{
  "cmpnId": "1",
  "actionType": "current",
  "keyList": [
    {
      "vndr": "aws",
      "key": "vendors",
      "value": "aws",
      "selectYn": "enabled"
    }
  ]
}
200

OK

{
  "result": {
    "vendors": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "accounts": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "regions": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "products": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "svcGrps": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "tags": [
      {
        "vndr": "aws",
        "key": "Name",
        "value": "test",
        "isRequired": true
      }
    ],
    "tagGrps": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ]
  },
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Optimization Grid View

post

Grid detail data inquiry according to optimization category and resource type

Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
optimizeCategorystring · enumRequiredPossible values:
accountIdstringRequiredExample: 000000000000
regionIdstringRequiredExample: ap-northeast-2
instanceIdstringRequiredExample: vol-00000
resourceTypestringRequiredExample: ebs
vendorstring · enumRequiredExample: awsPossible values:
recommendstringRequiredExample: idle
Responses
post
POST /asset/us-v1/optimization/detail/list/info HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 183

{
  "cmpnId": "1",
  "optimizeCategory": "right-sizing",
  "accountId": "000000000000",
  "regionId": "ap-northeast-2",
  "instanceId": "vol-00000",
  "resourceType": "ebs",
  "vendor": "aws",
  "recommend": "idle"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Optimization Grid View

post

Grid data inquiry according to optimization category and resource type

Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
optimizeCategorystring · enumRequired

Optimization category

Possible values:
resourceTypestringRequired

Resource type

Example: ec2
vendorstring · enumRequired

Cloud vendor

Possible values:
accountListstring[]Optional

List of accounts to filter optimization results for

regionListstring[]Optional

List of regions to filter optimization results for

serviceGroupListstring[]Optional

List of serviceGroups to filter optimization results for

Responses
post
POST /asset/us-v1/optimization/detail/list HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "cmpnId": "1",
  "optimizeCategory": "right-sizing",
  "resourceType": "ec2",
  "vendor": "aws",
  "accountList": [
    "text"
  ],
  "regionList": [
    "text"
  ],
  "serviceGroupList": [
    "text"
  ],
  "tagList": [
    {
      "key": "Name",
      "value": [
        "text"
      ]
    }
  ]
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Optimization Chart View

post

View optimization charts by optimization category and resource type

Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
optimizeCategorystring · enumRequired

Optimization category

Possible values:
resourceTypestringRequired

Resource type

Example: ec2
vendorstring · enumRequired

Cloud vendor

Possible values:
accountListstring[]Optional

List of accounts to filter optimization results for

regionListstring[]Optional

List of regions to filter optimization results for

serviceGroupListstring[]Optional

List of serviceGroups to filter optimization results for

Responses
post
POST /asset/us-v1/optimization/detail/chart HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "cmpnId": "1",
  "optimizeCategory": "right-sizing",
  "resourceType": "ec2",
  "vendor": "aws",
  "accountList": [
    "text"
  ],
  "regionList": [
    "text"
  ],
  "serviceGroupList": [
    "text"
  ],
  "tagList": [
    {
      "key": "Name",
      "value": [
        "text"
      ]
    }
  ]
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Reset resource optimization settings conditions

put

Reset the optimization setting conditions for each resource by optimization category.

Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
vendorstring · enumRequired

Vendor

Possible values:
resourceTypestringRequired

Resource Type

Example: ec2
optimizeCategorystring · enumRequired

Optimization category

Example: right-sizingPossible values:
Responses
put
PUT /asset/us-v1/optimization/setting/reset HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "cmpnId": "1",
  "vendor": "aws",
  "resourceType": "ec2",
  "optimizeCategory": "right-sizing"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

View top filter area by vendor

put

Search the top filter area data for each vendor.

Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
actionTypestringRequired

Action Type(current, history)

Example: current
Responses
put
PUT /asset/us-v1/optimization/summary/filter HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 115

{
  "cmpnId": "1",
  "actionType": "current",
  "keyList": [
    {
      "vndr": "aws",
      "key": "vendors",
      "value": "aws",
      "selectYn": "enabled"
    }
  ]
}
200

OK

{
  "data": {
    "vendors": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "accounts": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "regions": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "products": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "svcGrps": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ],
    "tags": [
      {
        "vndr": "aws",
        "key": "Name",
        "value": "test",
        "isRequired": true
      }
    ],
    "tagGrps": [
      {
        "vndr": "aws",
        "key": "vendors",
        "value": "aws",
        "selectYn": "enabled"
      }
    ]
  },
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Last optimization date lookup

post

Queries the last time resource optimization was performed.

Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
optimizeCategorystring · enumRequired

Optimization category

Possible values:
resourceTypestringRequired

Resource type

Example: ec2
vendorstring · enumRequired

Cloud vendor

Possible values:
accountListstring[]Optional

List of accounts to filter optimization results for

regionListstring[]Optional

List of regions to filter optimization results for

serviceGroupListstring[]Optional

List of serviceGroups to filter optimization results for

Responses
post
POST /asset/us-v1/optimization/summary/last-execute HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "cmpnId": "1",
  "optimizeCategory": "right-sizing",
  "resourceType": "ec2",
  "vendor": "aws",
  "accountList": [
    "text"
  ],
  "regionList": [
    "text"
  ],
  "serviceGroupList": [
    "text"
  ],
  "tagList": [
    {
      "key": "Name",
      "value": [
        "text"
      ]
    }
  ]
}
200

OK

{
  "data": {
    "lastExecuteDate": "2025-04-27T22:54:11.241Z"
  },
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

View top card area by optimization category

post

Search the top card area data for each optimization category.

Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
optimizeCategorystring · enumRequired

Optimization category

Possible values:
resourceTypestringRequired

Resource type

Example: ec2
vendorstring · enumRequired

Cloud vendor

Possible values:
accountListstring[]Optional

List of accounts to filter optimization results for

regionListstring[]Optional

List of regions to filter optimization results for

serviceGroupListstring[]Optional

List of serviceGroups to filter optimization results for

Responses
post
POST /asset/us-v1/optimization/summary/card HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "cmpnId": "1",
  "optimizeCategory": "right-sizing",
  "resourceType": "ec2",
  "vendor": "aws",
  "accountList": [
    "text"
  ],
  "regionList": [
    "text"
  ],
  "serviceGroupList": [
    "text"
  ],
  "tagList": [
    {
      "key": "Name",
      "value": [
        "text"
      ]
    }
  ]
}
200

OK

{
  "data": [
    {
      "resourceType": "text",
      "expectedSavingCost": 1,
      "expectedSavingCount": 1
    }
  ],
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Perform resource-optimized batch tasks

post

Perform resource-optimized batch tasks manually.

Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
Responses
post
POST /asset/us-v1/optimization/general/analysis HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "cmpnId": "1"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Usage History Grid Data

post

View History Usage Grid Data

Authorizations
Path parameters
prvrCdstring · enumRequired

Vendor

Example: awsPossible values:
Body
cmpnIdstringRequired

Company id

Example: 1
limitCntinteger · int32 · min: 1Optional

Page Limit Count

Example: 1
pageNuminteger · int32 · min: 1Optional

Page Number Count

Example: 1
offsetinteger · int32Optional

Page Offset

Example: 1
totalCntinteger · int32Optional

Page Total Count

Example: 1
fromstringRequired

From Date

Example: 2024-09-11
tostringRequired

To Date

Example: 2024-09-25
sortColIdstringRequired

Sort Column ID

Example: histDt
sortDirectionstringRequired

Sort Direction

Example: desc
excelYnstringRequired

Whether to download Excel

Example: N
rsrcTypestringRequired

Resource Type

Example: ec2
prvrCdstringRequired

Vendor

Example: aws
isGetHeaderstringOptional

Header or not

Example: Y
viewTypestringRequired

View Type(hour, day, week, month)

Example: day
langCdstringOptional

Language Code

Example: en
hasHistoryViewbooleanOptional

Whether to check history or not

Example: true
searchTextstringOptional

Search Text

Example: test
fieldListstring[]Optional

Field List

regionsstring[]Optional

Regions

svcGrpsstring[]Optional

Service Groups

accountsstring[]Optional

Accounts

Responses
post
POST /asset/us-v1/usage/{prvrCd}/grid/history HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 402

{
  "cmpnId": "1",
  "limitCnt": 1,
  "pageNum": 1,
  "offset": 1,
  "totalCnt": 1,
  "from": "2024-09-11",
  "to": "2024-09-25",
  "sortColId": "histDt",
  "sortDirection": "desc",
  "excelYn": "N",
  "rsrcType": "ec2",
  "prvrCd": "aws",
  "isGetHeader": "Y",
  "viewType": "day",
  "langCd": "en",
  "hasHistoryView": true,
  "searchText": "test",
  "fieldList": [
    "text"
  ],
  "regions": [
    "text"
  ],
  "svcGrps": [
    "text"
  ],
  "accounts": [
    "text"
  ],
  "tags": [
    {
      "key": "Name",
      "value": [
        "text"
      ]
    }
  ]
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Usage Current Grid Data

post

View Current Usage Grid Data

Authorizations
Path parameters
prvrCdstring · enumRequired

Vendor

Example: awsPossible values:
Body
cmpnIdstringRequired

Company id

Example: 1
rgnIdstringOptional

Region Id

Example: ap-northeast-2
limitCntinteger · int32Optional

Page Limit Count

Example: 1
pageNuminteger · int32Optional

Page Number Count

Example: 1
offsetinteger · int32Optional

Page Offset

Example: 1
totalCntinteger · int32Optional

Page Total Count

Example: 1
sortColIdstringOptional

Sort Column ID

Example: seq
sortDirectionstringOptional

Sort Direction

Example: desc
excelYnstringOptional

Whether to download Excel

Example: N
rsrcTypestringRequired

Resource Type

Example: ec2
prvrCdstringRequired

Vendor

Example: aws
viewTypestringOptional

View Type(hour, day, week, month)

Example: day
fromstringOptional

From Date

Example: 2024-09-11
tostringOptional

To Date

Example: 2024-09-25
searchTextstringOptional

Search Text

Example: test
isGetHeaderstringOptional

Header or not

Example: Y
fieldListstring[]Optional

Field List

regionsstring[]Optional

Regions

svcGrpsstring[]Optional

Service Groups

accountsstring[]Optional

Accounts

svcGrpViewstringOptional

Service Group View Id

Example: Default
langCdstringOptional

Language Code

Example: en
rsrcSeqstringOptional

Resource Seq

Example: 0
headerTypestringOptional

Header Type

Example: single
isResourcestringOptional

Resource or Not

Example: N
rsrcNmstringOptional

Resource Name

Example: test
hasHistoryViewbooleanOptional

Whether to check history or not

Example: true
delChkstringOptional

Whether to exclude deleted resources

Example: Y
Responses
post
POST /asset/us-v1/usage/{prvrCd}/grid/current HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 529

{
  "cmpnId": "1",
  "rgnId": "ap-northeast-2",
  "limitCnt": 1,
  "pageNum": 1,
  "offset": 1,
  "totalCnt": 1,
  "sortColId": "seq",
  "sortDirection": "desc",
  "excelYn": "N",
  "rsrcType": "ec2",
  "prvrCd": "aws",
  "viewType": "day",
  "from": "2024-09-11",
  "to": "2024-09-25",
  "searchText": "test",
  "isGetHeader": "Y",
  "fieldList": [
    "text"
  ],
  "regions": [
    "text"
  ],
  "svcGrps": [
    "text"
  ],
  "accounts": [
    "text"
  ],
  "tags": [
    {
      "key": "Name",
      "value": [
        "text"
      ]
    }
  ],
  "svcGrpView": "Default",
  "langCd": "en",
  "rsrcSeq": "0",
  "headerType": "single",
  "isResource": "N",
  "rsrcNm": "test",
  "hasHistoryView": true,
  "delChk": "Y"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Usage Current Chart Data

post

View Current Usage Chart Data

Authorizations
Path parameters
prvrCdstring · enumRequired

Vendor

Example: awsPossible values:
Body
cmpnIdstringRequired

Company id

Example: 1
rsrcTypestringRequired

Resource Type

Example: ec2
prvrCdstringRequired

Vendor

Example: aws
rsrcNmstringOptional

Resource Name

Example: test
regionsstring[]Optional

Regions

svcGrpsstring[]Optional

Service Groups

accountsstring[]Optional

Accounts

reqTypestringOptional
delChkstringOptional

Whether to exclude deleted resources

Example: Y
Responses
post
POST /asset/us-v1/usage/{prvrCd}/chart/pie/current HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "cmpnId": "1",
  "rsrcType": "ec2",
  "prvrCd": "aws",
  "rsrcNm": "test",
  "regions": [
    "text"
  ],
  "svcGrps": [
    "text"
  ],
  "accounts": [
    "text"
  ],
  "tags": [
    {
      "key": "Name",
      "value": [
        "text"
      ]
    }
  ],
  "reqType": "text",
  "delChk": "Y"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Usage History Chart Data

post

View History Usage Chart Data

Authorizations
Path parameters
prvrCdstring · enumRequired

Vendor

Example: awsPossible values:
Body
cmpnIdstringRequired

Company id

Example: 1
fromstringRequired

From Date

Example: 2024-09-11
tostringRequired

To Date

Example: 2024-09-25
rsrcTypestringRequired

Resource Type

Example: ec2
prvrCdstringRequired

Vendor

Example: aws
regionsstring[]Optional

Regions

svcGrpsstring[]Optional

Service Groups

accountsstring[]Optional

Accounts

viewTypestringRequired

View Type(hour, day, week, month)

Example: day
Responses
post
POST /asset/us-v1/usage/{prvrCd}/chart/history HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 200

{
  "cmpnId": "1",
  "from": "2024-09-11",
  "to": "2024-09-25",
  "rsrcType": "ec2",
  "prvrCd": "aws",
  "regions": [
    "text"
  ],
  "svcGrps": [
    "text"
  ],
  "accounts": [
    "text"
  ],
  "tags": [
    {
      "key": "Name",
      "value": [
        "text"
      ]
    }
  ],
  "viewType": "day"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get tagKeys by accIds

post

Get tag keys for specified AWS account IDs

Authorizations
Path parameters
vendorstringRequired
Body
vendorstring · enumOptionalPossible values:
pageinteger · int32Optional
sizeinteger · int32 · max: 1000Optional
offsetinteger · int32Optional
accIdsstring[]Optional
sortstringOptional
sortColIdstringOptional
sortDirectionstringOptional
Responses
post
POST /asset/us-v1/tag-manager/vendors/{vendor}/tag-keys HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 119

{
  "vendor": "aws",
  "page": 1,
  "size": 1,
  "offset": 1,
  "accIds": [
    "text"
  ],
  "sort": "text",
  "sortColId": "text",
  "sortDirection": "text"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get tagKeyVals

post
Authorizations
Path parameters
vendorstringRequired
tagKeystringRequired
Body
vendorstring · enumOptionalPossible values:
pageinteger · int32Optional
sizeinteger · int32 · max: 1000Optional
offsetinteger · int32Optional
accIdsstring[]Optional
sortstringOptional
sortColIdstringOptional
sortDirectionstringOptional
Responses
post
POST /asset/us-v1/tag-manager/vendors/{vendor}/tag-keys/{tagKey}/tag-vals HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 119

{
  "vendor": "aws",
  "page": 1,
  "size": 1,
  "offset": 1,
  "accIds": [
    "text"
  ],
  "sort": "text",
  "sortColId": "text",
  "sortDirection": "text"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Tag modification tasks (addition, deletion, and modification)

post
Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
updateTypestringOptional
replacementValuestringOptional
userEmailstringOptional
vendorstring · enumOptionalPossible values:
Responses
post
POST /asset/us-v1/tag-manager/update-tag HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 461

{
  "cmpnId": "1",
  "updateType": "text",
  "tagList": [
    {
      "tagKey": "text",
      "tagVal": "text",
      "creaDt": "2025-04-27T22:54:11.241Z",
      "instId": "text",
      "state": "text",
      "tagVals": [
        "text"
      ]
    }
  ],
  "resourceList": [
    {
      "accId": "text",
      "rgnId": "text",
      "rsrcType": "text",
      "instId": "text",
      "arn": "text",
      "resourceGroupTaggingYn": "text",
      "existTags": [
        {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      ],
      "sbscId": "text",
      "rsrcGrp": "text",
      "id": "text",
      "nrn": "text"
    }
  ],
  "replacementValue": "text",
  "userEmail": "text",
  "vendor": "aws"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Provide a list of tag keys for deletion

post
Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
vendorstring · enumOptionalPossible values:
Responses
post
POST /asset/us-v1/tag-manager/resources/tags HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 120

{
  "cmpnId": "1",
  "vendor": "aws",
  "data": [
    {
      "accId": "text",
      "rsrcType": "text",
      "rgnId": "text",
      "instId": "text",
      "tagKey": "text"
    }
  ]
}
200

OK

{
  "result": [
    {
      "tagKey": "text",
      "tagValue": [
        "text"
      ],
      "isCommon": true
    }
  ],
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Tag key modification tasks

post
Authorizations
Body
cmpnIdstringRequired

Company id

Example: 1
tagKeystringOptional
tagKeysstring[]Optional
renameTagKeystringOptional
userEmailstringOptional
vendorstring · enumOptionalPossible values:
Responses
post
POST /asset/us-v1/tag-manager/rename-tag-key HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "cmpnId": "1",
  "tagKey": "text",
  "tagKeys": [
    "text"
  ],
  "renameTagKey": "text",
  "userEmail": "text",
  "vendor": "aws"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get tags

post
Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
Body
cmpnIdstringRequired

Company id

Example: 1
vendorstring · enumOptionalPossible values:
pageinteger · int32Optional
sizeinteger · int32 · max: 1000Optional
offsetinteger · int32Optional
emptyDataFlagbooleanOptional
accIdstringOptional
accIdsstring[]Optional
rgnIdstringOptional
rgnIdsstring[]Optional
instIdstringOptional
instIdsstring[]Optional
rsrcTypestringOptional
rsrcTypesstring[]Optional
tagKeysstring[]Optional
tagTypestringOptional
tagTypesstring[]Optional
tagTypeConditionstringOptional
compliantTypestringOptional
compliantTypesstring[]Optional
groupIdstringOptional
groupIdsstring[]Optional
sortstringOptional
sortColIdstringOptional
sortDirectionstringOptional
tagSortstringOptional
sortTagKeystringOptional
searchstringOptional
noValueYnstringOptional
tagYnstringOptional
Responses
post
POST /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/tags HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 659

{
  "cmpnId": "1",
  "vendor": "aws",
  "page": 1,
  "size": 1,
  "offset": 1,
  "emptyDataFlag": true,
  "accId": "text",
  "accIds": [
    "text"
  ],
  "rgnId": "text",
  "rgnIds": [
    "text"
  ],
  "instId": "text",
  "instIds": [
    "text"
  ],
  "rsrcType": "text",
  "rsrcTypes": [
    "text"
  ],
  "tagKeys": [
    "text"
  ],
  "tagType": "text",
  "tagTypes": [
    "text"
  ],
  "tagTypeCondition": "text",
  "tags": [
    {
      "tagKey": "text",
      "tagVal": "text",
      "creaDt": "2025-04-27T22:54:11.241Z",
      "instId": "text",
      "state": "text",
      "tagVals": [
        "text"
      ]
    }
  ],
  "compliantType": "text",
  "compliantTypes": [
    "text"
  ],
  "groupId": "text",
  "groupIds": [
    "text"
  ],
  "sort": "text",
  "sortColId": "text",
  "sortDirection": "text",
  "tagSort": "text",
  "sortTagKey": "text",
  "search": "text",
  "noValueYn": "text",
  "tagYn": "text"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get resources

post
Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
Body
cmpnIdstringRequired

Company id

Example: 1
vendorstring · enumOptionalPossible values:
pageinteger · int32Optional
sizeinteger · int32 · max: 1000Optional
offsetinteger · int32Optional
emptyDataFlagbooleanOptional
accIdstringOptional
accIdsstring[]Optional
rgnIdstringOptional
rgnIdsstring[]Optional
instIdstringOptional
instIdsstring[]Optional
rsrcTypestringOptional
rsrcTypesstring[]Optional
tagKeysstring[]Optional
tagTypestringOptional
tagTypesstring[]Optional
tagTypeConditionstringOptional
compliantTypestringOptional
compliantTypesstring[]Optional
groupIdstringOptional
groupIdsstring[]Optional
sortstringOptional
sortColIdstringOptional
sortDirectionstringOptional
tagSortstringOptional
sortTagKeystringOptional
searchstringOptional
noValueYnstringOptional
tagYnstringOptional
Responses
post
POST /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/resources HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 659

{
  "cmpnId": "1",
  "vendor": "aws",
  "page": 1,
  "size": 1,
  "offset": 1,
  "emptyDataFlag": true,
  "accId": "text",
  "accIds": [
    "text"
  ],
  "rgnId": "text",
  "rgnIds": [
    "text"
  ],
  "instId": "text",
  "instIds": [
    "text"
  ],
  "rsrcType": "text",
  "rsrcTypes": [
    "text"
  ],
  "tagKeys": [
    "text"
  ],
  "tagType": "text",
  "tagTypes": [
    "text"
  ],
  "tagTypeCondition": "text",
  "tags": [
    {
      "tagKey": "text",
      "tagVal": "text",
      "creaDt": "2025-04-27T22:54:11.241Z",
      "instId": "text",
      "state": "text",
      "tagVals": [
        "text"
      ]
    }
  ],
  "compliantType": "text",
  "compliantTypes": [
    "text"
  ],
  "groupId": "text",
  "groupIds": [
    "text"
  ],
  "sort": "text",
  "sortColId": "text",
  "sortDirection": "text",
  "tagSort": "text",
  "sortTagKey": "text",
  "search": "text",
  "noValueYn": "text",
  "tagYn": "text"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get resources by tags

post
Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
Body
cmpnIdstringRequired

Company id

Example: 1
vendorstring · enumOptionalPossible values:
pageinteger · int32Optional
sizeinteger · int32 · max: 1000Optional
offsetinteger · int32Optional
emptyDataFlagbooleanOptional
accIdstringOptional
accIdsstring[]Optional
rgnIdstringOptional
rgnIdsstring[]Optional
instIdstringOptional
instIdsstring[]Optional
rsrcTypestringOptional
rsrcTypesstring[]Optional
tagKeysstring[]Optional
tagTypestringOptional
tagTypesstring[]Optional
tagTypeConditionstringOptional
compliantTypestringOptional
compliantTypesstring[]Optional
groupIdstringOptional
groupIdsstring[]Optional
sortstringOptional
sortColIdstringOptional
sortDirectionstringOptional
tagSortstringOptional
sortTagKeystringOptional
searchstringOptional
noValueYnstringOptional
tagYnstringOptional
Responses
post
POST /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/resources-by-tags HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 659

{
  "cmpnId": "1",
  "vendor": "aws",
  "page": 1,
  "size": 1,
  "offset": 1,
  "emptyDataFlag": true,
  "accId": "text",
  "accIds": [
    "text"
  ],
  "rgnId": "text",
  "rgnIds": [
    "text"
  ],
  "instId": "text",
  "instIds": [
    "text"
  ],
  "rsrcType": "text",
  "rsrcTypes": [
    "text"
  ],
  "tagKeys": [
    "text"
  ],
  "tagType": "text",
  "tagTypes": [
    "text"
  ],
  "tagTypeCondition": "text",
  "tags": [
    {
      "tagKey": "text",
      "tagVal": "text",
      "creaDt": "2025-04-27T22:54:11.241Z",
      "instId": "text",
      "state": "text",
      "tagVals": [
        "text"
      ]
    }
  ],
  "compliantType": "text",
  "compliantTypes": [
    "text"
  ],
  "groupId": "text",
  "groupIds": [
    "text"
  ],
  "sort": "text",
  "sortColId": "text",
  "sortDirection": "text",
  "tagSort": "text",
  "sortTagKey": "text",
  "search": "text",
  "noValueYn": "text",
  "tagYn": "text"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}

Get tagGroups

post
Authorizations
Path parameters
cmpnIdstringRequired
vendorstringRequired
Body
cmpnIdstringRequired

Company id

Example: 1
vendorstring · enumOptionalPossible values:
pageinteger · int32Optional
sizeinteger · int32 · max: 1000Optional
offsetinteger · int32Optional
emptyDataFlagbooleanOptional
accIdstringOptional
accIdsstring[]Optional
rgnIdstringOptional
rgnIdsstring[]Optional
instIdstringOptional
instIdsstring[]Optional
rsrcTypestringOptional
rsrcTypesstring[]Optional
tagKeysstring[]Optional
tagTypestringOptional
tagTypesstring[]Optional
tagTypeConditionstringOptional
compliantTypestringOptional
compliantTypesstring[]Optional
groupIdstringOptional
groupIdsstring[]Optional
sortstringOptional
sortColIdstringOptional
sortDirectionstringOptional
tagSortstringOptional
sortTagKeystringOptional
searchstringOptional
noValueYnstringOptional
tagYnstringOptional
Responses
post
POST /asset/us-v1/tag-manager/companies/{cmpnId}/vendors/{vendor}/groups HTTP/1.1
Host: api.opsnow.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 659

{
  "cmpnId": "1",
  "vendor": "aws",
  "page": 1,
  "size": 1,
  "offset": 1,
  "emptyDataFlag": true,
  "accId": "text",
  "accIds": [
    "text"
  ],
  "rgnId": "text",
  "rgnIds": [
    "text"
  ],
  "instId": "text",
  "instIds": [
    "text"
  ],
  "rsrcType": "text",
  "rsrcTypes": [
    "text"
  ],
  "tagKeys": [
    "text"
  ],
  "tagType": "text",
  "tagTypes": [
    "text"
  ],
  "tagTypeCondition": "text",
  "tags": [
    {
      "tagKey": "text",
      "tagVal": "text",
      "creaDt": "2025-04-27T22:54:11.241Z",
      "instId": "text",
      "state": "text",
      "tagVals": [
        "text"
      ]
    }
  ],
  "compliantType": "text",
  "compliantTypes": [
    "text"
  ],
  "groupId": "text",
  "groupIds": [
    "text"
  ],
  "sort": "text",
  "sortColId": "text",
  "sortDirection": "text",
  "tagSort": "text",
  "sortTagKey": "text",
  "search": "text",
  "noValueYn": "text",
  "tagYn": "text"
}
200

OK

{
  "status": "text",
  "error": {
    "code": "text",
    "message": "text"
  }
}