⚠️ Edit Forwarder

PUT {{cb_url}}/data_forwarder/v1/orgs/{{cb_org_key}}/configs/{{cb_forwarder_id}}

This call is used to edit an existing forwarder. You can edit the Enabling/Disabling functionality or change the s3 bucket name.

When editing an existing forwarder, the API will make additional calls to check whether the Carbon Black Cloud event or alert forwarder can write to the specified S3 Bucket using the configuration supplied. It will attempt to write a test message called healthcheck.json to the specified bucket. If the bucket is misconfigured (i.e. incorrect permissions, principle arn, etc.) or the configuration is incorrect (i.e. bucket prefix doesn’t match path specified in policy or bucket does not exist), the Event Forwarder Configuration API will respond with a 400 and message including information regarding what was incorrect, providing the customer with feedback that enables them to fix issues as needed.

If you want to remove filters that are applied to your configuration then update the configuration with an empty array for the filters property.

RBAC Permissions Required

Permission (.notation name)Operation(s)
event-forwarder.settingsUPDATE

Schema

FieldDefinitionData TypeValuesRequired
nameDefined name for the specific event or alert forwarderStringN/AYes
s3_bucket_nameConfigured unique name for s3 bucketStringN/AYes
s3_prefixDefined folder structure the forwarder will write events or alerts toStringN/AYes
typeThe datastream type that is to be forwarded.Stringendpoint.event, alertYes
filtersA list of filters to apply to the data being forwarded. Use only one of equals, not_equals, or match_any_bits per filter in the list. Only supported when type equals endpoint.eventArray[{ "attribute": "<string>", "equals": "<string>", "not_equals": "<string>", "match_any_bits": ["<string>", "<string>"]}]No

See Documentation

Request Body

{"name"=>"<string>", "s3_bucket_name"=>"<string>", "s3_prefix"=>"<string>", "type"=>"<string>", "filters"=>[{"attribute"=>"<string>", "equals"=>"<string>", "not_equals"=>"<string>", "match_any_bits"=>["<string>", "<string>"]}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring