AND

• different property/tag/suppression

• different or same operator

OR

• same property/tag/suppression

• same operator

propertyID | tagID | suppressionID

string

Y

Specify the reference ID of the property, tag, or suppression from the corresponding catalog:

• See Subscriptions: Properties to retrieve propertyIDs available in the platform-specific Subscriptions Properties catalog.

• See Subscriptions: Tags to retrieve tagIDs available in the platform-specific Subscriptions Tags catalog.

• See Subscriptions: Suppressions to retrieve suppressionIDs available in the platform-specific Subscriptions Suppressions catalog.

You can only use global reference IDs or reference IDs that are owned by you.

operator

one of

• =
• <
• >
• <=
• >=
• like
• []
• ()
• (]
• [)

Y

Specify a logical operator for the property or tag comparison. The following operators are supported:

• "=" —equal to;
• "<" —lesser than;
• ">" —greater than;
• "<=" —less than or equal to;
• ">=" —greater than or equal to;
• "like" —matches to the provided substring; the "*" wildcard character can be used to anchor substring searches;
• "[]" —matches to values contained in the provided inclusive range, e.g. "values" : [1,3] matches to {1, 2, 3};
• "()" —matches to values in the provided exclusive range, e.g. "values": [3-8] matches to {4, 5, 6, 7};
• "(]" —matches to values in the provided exclusive beginning and inclusive ending range, e.g. "values": [2,5] matches to {3,4,5};
• "[)" —matches to values in the provided inclusive beginning and exclusive ending range, e.g. "values": [1, 3] matches to {1,2};

values

an array or range of

• string
• integer
• float

Y

Specify an array of values for the logical comparison.

For numeric ranges, specify the beginning and the end range values, e.g. "values": [1,10] implies from 1 to 10.

For multiple values, the filter condition considers the list as a series of OR clauses. For example, if you are comparing serviceType = ["EC2", "RDS", "Spot"], then the condition is evaluated as [serviceType = "EC2" OR serviceType = "RDS" OR serviceType = "Spot"].

For the "like" operator, use the "*" wildcard character to match zero, one or multiple characters to one end of the substring, e.g. "values": ["t2*"] matches to "t2", "t2.5", or "t2.micro", but not to "rds-t2.large".

Using the "like" operator without "*" wildcard will match the substring to any part of the property or tag value, e.g. "values": ["size"] matches to "Resize", "Upsize-Family", or "size-right".

Refer to the various cloud recommendation resource elements for valid values: Analysis: AWS Recommendations: Response, Analysis: Azure Recommendations: Response, and Analysis: GCP Recommendations: Response.

Note: To filter "Just Right" recommendations or "Not Analyzed" systems, you must use the exact recommendationType property string, "Not Analyzed" or "Just Right", when you use the "=" or "like" operator.

Subscription Identification

subscriptionRef

string

F

The unique referenced ID of the Densify subscription.

subscriptionName

string

The subscription name.

description

string

The subscription description.

owner

string

F

The designated owner of the subscription.

The subscription is considered global if this element is empty and private otherwise.

Subscription Configuration

outputType

string

application/json is the only supported output type.

active

string:

[true|false]

webhook

• uri
• authType
• authValue

The webhook definition to an external application, where your personalized recommendations will be sent.

propertyReferences

array of

• propertyID
• operator
• values

An array of property conditions to be evaluated on the set of system recommendations before including them in the returned data set.

For details of the propertyID listed in the condition, see Subscriptions: Properties to retrieve property definitions available in the platform-specific Subscriptions Properties catalog.

See Filter and Suppression Conditions for details on how property conditions are defined.

tagReferences

array of

• tagID
• operator
• values

An array of tag conditions to be evaluated on system attributes before including the system in the returned subscription data set.

For details of the tagID listed in the condition, see Subscriptions: Tags to retrieve tag definitions available in the platform-specific Subscriptions Tags catalog.

See Filter and Suppression Conditions for details on how tag conditions are defined.

suppressionReferences

array of

• suppressionID
• operator
• values
• revokeBy (optional)

An array of suppression conditions to determine system recommendations excluded from the returned subscription data set.

Revoked suppression conditions (i.e. when revokeBy datetime has passed) are not taken into consideration during the results data set generation.

For details of the suppressionID listed in the condition, see Subscriptions: Suppressions to retrieve suppression definitions available in the platform-specific Subscriptions Suppressions catalog.

See Filter and Suppression Conditions for details on how suppression conditions are defined.

schedule

• dayOfMonth
• dayOfWeek

returnStructure

array of property references and an array of attribute tag references:

• properties
• propertyID
• useAlias
• tags
• tagID
• useAlias

webhookStatus

string

The status, date, and time of the last subscription results pushed to the webhook location:

• Success—subscription results sent to the webhook successfully;
• Failure—transmission of subscription results to the webhook failed.

lastTriggered

string

The status, date, and time of the last subscription results request:

• On-Demand Success—the last request was on-demand and it was successful;
• On-Demand Failure—the last request was on-demand and it failed to produce results;
• Scheduled Success—the last request was a successful scheduled subscription event posted to a webhook;
• Scheduled-Failure—the last request was a failed webhook post of the scheduled subscription event.

Returned Error Message

message

string

The message for the status response is returned.

status

number

The HTTP response code of the request. Possible status values include:

• 200—success with request (usually with content in response body);
• 204—success with request, no content returned;
• 400—bad request (invalid parameters, logical errors);
• 401—authentication failed;
• 404—resource not found (or no privileges);
• 415—unsupported media type;
• 500—internal server error.