Actions available for resources. You will need a resource ID.
get
Gets basic metadata about a resource.
Parameters:
--company [company_id]
--id [12345]
--resource-id [cloud-resource-id]
--latest-configuration (optional) [boolean]get-compliance
Gets compliance check details for a resource.
Parameters:
--company [company_id]
--id [12345]
--resource-id [cloud-resource-id]
--status [open | remediated | policy-exception | mitigation]get-drift
Gets change records for a resource.
Parameters:
--company [company_id]
--id [12345]
--resource-id [cloud-resource-id]
--status [new | inprogress | acknowledged | resolved]
--concern "concern name"
--type [configuration_alert | security_alert]get-metric-names
Fetches metric names for a resource.
Parameters:
--company [company slug]
--id [12345]
--resource-id [cloud-resource-id]get-tags
Gets tags attached to a resource.
Parameters:
--company [company_id]
--id [12345]
--resource-id [cloud-resource-id]list
Lists a set of resources that match any given criteria.
Parameters:
--company [company_id]
--accounts [account_id]
--ids [12345]
--resource-ids [cloud-resource-id]
--cloud-providers [aws | azure | gcp | microsoft365]
--resource-types [resource-type-name]
--region-ids [region-id]
--tags [tag-value]
--resource-creation-date-beginning ["2020-11-11 00:00:00.000"]
--resource-creation-date-end ["2021-11-11 00:00:00.000"]
--open-compliance-issues [true | false]
--unacknowledged-changes [true | false]
--skip [12345]add-tags
Attaches one or more tags to a resource.
Parameters:
--company [company_id]
--id [12345]
--resource-id [cloud-resource-id]
--tag [tag-value]remove-tags
Removes one or more tags to a resource.
Parameters:
--company [company_id]
--id [12345]
--resource-id [cloud-resource-id]
--tag [tag-value]get-usage-analytics
Calculates the resource usage analytics for given criteria.
Parameters:
--id [resource_id]
--metric-type [string]
--analysis-type (optional) [string]
--grouping-period (optional) [h | d | m | y]
--calculated-at-from (optional) [2021-09-01T00:00:00.000Z]
--calculated-at-to (optional) [2023-10-01T00:00:00.000Z]get-metric-names-for-resource-type
Fetches metric names for provided resource type.
Parameters:
--company [company slug]
--resource-type [string]upload-metrics
Uploads a file of metrics for a resource.
Parameters:
--company [company_id]
--account [account_id]
--resource-id [cloud-resource-id]
--metrics [path to metrics file]scan
(beta)
Queues the requested resources / account for scanning. Currently only accessible through beta.
Parameters:
--company [company slug]
--account [account_id]
--ids (optional) [resource numeric id] Example: --ids 12345,56854,104455
--resourceIds (optional) [resource cloud id] Example: --resourceIds arn:aws:ec2:us-east-1:444855252760:customer-gateway/1234
--resourceTags (optional) [tag-value]get-latest-configuration
Gets the latest configuration for a resource.
Parameters:
--company [company_id]
--id [resource id]
--resource-id [cloud-resource-id]get-overprovisioned
Gets resources that have been marked as being overprovisioned.
Parameters:
--company [company_id]get-metric-check-results
Gets the metric check results for a resource.
Parameters:
--company [company_id]
--id [resource id]
--resource-id [cloud-resource-id]get-aggregate-metrics
Gets the aggregate metrics for a resource.
Parameters:
--granularity ['Day' or 'Hour']
--metric-check-result-id (optional) [metric check result id]
--offset (optional) [number] assists in pagination of records, default is 0
--limit (optional) [number] assists in pagination of records, default is 100, max is 250
--resource-id (optional) [database resource id]
--metric-type (optional) [string]
--calculated-at-from (optional) [timestamp]
--calculated-at-to (optional) [timestamp]