IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.

« Get a ruleset Get associated deployments »

› › › ›

Updates a ruleset

edit

IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Updates a ruleset

edit

DEPRECATED: Updates the ruleset with the definition. Deprecated in favor of traffic-filter endpoints.

Request

edit

PUT /api/v1/deployments/ip-filtering/rulesets/{ruleset_id}

Path parameters

edit

Name	Type	Required	Description
`ruleset_id`	`string`	Y	The mandatory ruleset ID

Request body

edit

(IpFilterRuleset) (required) The ruleset definition

Responses

edit

200

(RuleSetResponse)

The ruleset definition was valid and the update has started

400

(BasicFailedReply)

The ruleset definition contains errors (code: 'ip_filtering.ruleset_invalid')

449

(BasicFailedReply)

elevated permissions are required. (code: '"root.unauthorized.rbac.elevated_permissions_required"')

500

(BasicFailedReply)

The request execution failed (code: 'ip_filtering.request_execution_failed')

Request example

edit

curl -XPUT https://{{hostname}}/api/v1/deployments/ip-filtering/rulesets/{ruleset_id} \
-H "Authorization: ApiKey $ECE_API_KEY" \
-d '
{
   "associations" : [
      {
         "entity_type" : "string",
         "id" : "string"
      }
   ],
   "description" : "string",
   "id" : "string",
   "name" : "string",
   "rules" : [
      {
         "description" : "string",
         "id" : "string",
         "source" : "string"
      }
   ],
   "total_associations" : 0
}
'

« Get a ruleset Get associated deployments »