Add a version rule

post

https://{hostname}/cloudlets/api/v2/policies/{policyId}/versions/{version}/rules

Add a new rule to an existing policy version. You can only add one rule at a time.

Path Params

version

number

required

The version number of the policy.

policyId

integer

required

The ID of the policy.

Query Params

index

integer

The order within the current list of rules where you want to add the new rule. If you do not set this parameter, the new rule is added to the end of the current rule list. For Cloudlets, the first rule listed is the first rule evaluated.

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

Contains match rule information for Application Load Balancer.

disabled

boolean

Defaults to false

If true, disables a rule so it's not evaluated against incoming requests. The default setting is false.

end

integer

≥ 0

Defaults to 0

The end time for this match rule in epoch seconds. When end is 0, there is no end time for this match rule.

forwardSettings

object

Defines data used to construct a new request URL. If all set conditions are true, the edge server returns an HTTP response from the rewritten URL. You can specify any of the following with this object: originId, pathAndQS, and useIncomingQueryString.

matchURL

string | null

The URL the Cloudlet uses to match the incoming request.

matches

array of objects | null

The matchType and the matchValue or objectMatchValue used to conditionally pass through the request. Plus additional criteria to match on, like case sensitivity (caseSensitive).

matches

matchesAlways

boolean

The match rule always applies when true. When false, the rule applies within the start and end time range.

name

string | null

The name of the rule.

start

integer

≥ 0

Defaults to 0

The start time for this match rule in epoch seconds. When start is 0, the match rule is on.

type

string

enum

required

The type of Cloudlet the rule is for. For example, the string for Application Load Balancer is albMatchRule.

Allowed:

Response

200Returns details of a policy version match rule.