GuideReference
TrainingSupportCommunity
Reference

modify_​incoming_​response_​header

  • Property Manager name: Modify Incoming Response Header
  • Behavior version: The v2023-01-05 rule format supports the modify_​incoming_​response_​header behavior v1.2.
  • Rule format status: GA, stable
  • Access: Read/Write
  • Allowed in includes: Yes

Modify, add, remove, or pass along specific response headers coming downstream from the origin.

Depending on the type of action you want to perform, specify the corresponding standard header name, or a custom_​header_​name if the standard name is set to OTHER. The header_​value serves as a match condition when the action is DELETE or MODIFY, and the new_​header_​value applies when the action is ADD or MODIFY.

See also modify​_incoming​_request​_header, modify​_outgoing​_request​_header, and modify​_outgoing​_response​_header.

OptionTypeDescriptionRequires
actionenum

Either ADD, DELETE, MODIFY, or PASS incoming HTTP response headers.

{"displayType":"enum","options":["ADD","DELETE","MODIFY","PASS"],"tag":"select"}
ADD

Add the header.

DELETE

Delete the header.

MODIFY

Modify the header.

PASS

Pass through the header.

standard_​add_​header_​nameenum

If the value of action is ADD, this specifies the name of the field to add.

action is ADD
{"displayType":"enum","options":["CACHE_CONTROL","CONTENT_TYPE","EDGE_CONTROL","EXPIRES","LAST_MODIFIED","OTHER"],"tag":"select"}
{"if":{"attribute":"action","op":"eq","value":"ADD"}}
CACHE_​CONTROL

The Cache-Control header.

CONTENT_​TYPE

The Content-Type header.

EDGE_​CONTROL

The Edge-Control header.

EXPIRES

The Expires header.

LAST_​MODIFIED

The Last-Modified header.

OTHER

Specify another header to add.

standard_​delete_​header_​nameenum

If the value of action is DELETE, this specifies the name of the field to remove.

action is DELETE
{"displayType":"enum","options":["CACHE_CONTROL","CONTENT_TYPE","VARY","OTHER"],"tag":"select"}
{"if":{"attribute":"action","op":"eq","value":"DELETE"}}
CACHE_​CONTROL

The Cache-Control header.

CONTENT_​TYPE

The Content-Type header.

VARY

The Vary header.

OTHER

Specify another header to remove.

standard_​modify_​header_​nameenum

If the value of action is MODIFY, this specifies the name of the field to modify.

action is MODIFY
{"displayType":"enum","options":["CACHE_CONTROL","CONTENT_TYPE","EDGE_CONTROL","OTHER"],"tag":"select"}
{"if":{"attribute":"action","op":"eq","value":"MODIFY"}}
CACHE_​CONTROL

The Cache-Control header.

CONTENT_​TYPE

The Content-Type header.

EDGE_​CONTROL

The Edge-Control header.

OTHER

Specify another header to modify.

standard_​pass_​header_​nameenum

If the value of action is PASS, this specifies the name of the field to pass through.

action is PASS
{"displayType":"enum","options":["CACHE_CONTROL","EXPIRES","PRAGMA","OTHER"],"tag":"select"}
{"if":{"attribute":"action","op":"eq","value":"PASS"}}
CACHE_​CONTROL

Pass through the Cache-Control header.

EXPIRES

Pass through the Expires header.

PRAGMA

Pass through the Pragma header.

OTHER

Specify another header to pass.

custom_​header_​namestring (allows variables)

Specifies a custom field name that applies when the relevant standard header name is set to OTHER.

standard_​add_​header_​name is OTHER
OR standard_​delete_​header_​name is OTHER
OR standard_​modify_​header_​name is OTHER
OR standard_​pass_​header_​name is OTHER
{"displayType":"string","tag":"input","type":"text"}
{"if":{"op":"or","params":[{"attribute":"standardAddHeaderName","op":"eq","value":"OTHER"},{"attribute":"standardDeleteHeaderName","op":"eq","value":"OTHER"},{"attribute":"standardModifyHeaderName","op":"eq","value":"OTHER"},{"attribute":"standardPassHeaderName","op":"eq","value":"OTHER"}]}}
header_​valuestring (allows variables)

Specifies the header's new value.

action is ADD
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"action","op":"eq","value":"ADD"}}
new_​header_​valuestring (allows variables)

Specifies an HTTP header replacement value.

action is MODIFY
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"action","op":"eq","value":"MODIFY"}}
avoid_​duplicate_​headersboolean

When enabled with the action set to MODIFY, prevents creation of more than one instance of a header.

action is MODIFY
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"action","op":"eq","value":"MODIFY"}}