head (REST Plugin)
Perform a HEAD method REST call against an endpoint. This will return no body if the server honors the request, but the body is returned in case the server does return one.
If no body is returned, an empty string will be present in FDR_RESPONSE_STRING
.
Environment/Instance Properties
Property Name | Property Code | Required | Description |
---|---|---|---|
Project Properties
Property Name | Property Code | Required | Description |
---|---|---|---|
Inputs
Input Name | Input Code | Required | Description |
---|---|---|---|
REST URL | FDR_REQUEST_URL | Yes | URL to the desired REST Service @since 5.5.0.3 this input supports FlexDeploy property replacement. i.e. you can use ${{PROP1}} in the input value. |
Query String | FDR_QUERY_STRING | No | Query String to be used. Use Groovy if desired to use FlexDeploy variables in the query string. 'a=b&c=d&e='+FD_TEMP_DIR+'&f=g' or, if not using Groovy, simply a=b&c=d Spaces will not be trimmed from the string. @since 5.3.0.1 The query string input also allows FlexDeploy property replacement to be used |
Username | FDR_USER | No | The username for authentication |
Password | FDR_PASSWORD | No | The password for authentication |
Preemptive Authentication | FDR_PREEMPTIVE_AUTH | No | Use preemptive Basic authentication (provide authentication before being asked) if false, non-preemptive Universal authentication is used. |
Request Media Type | FDR_REQUEST_MEDIA_TYPE | No | The media type to request from the server |
Ignore SSL Errors | FDR_IGNORE_SSL_ERRORS | No | If checked, SSL errors will be ignored. Otherwise they will cause the operation to fail. |
Response Action | FDR_RESPONSE_ACTION | Yes | What action should be taken upon completion of this request? Possible options are:
@since 5.3.0.1 |
Headers | FDR_HEADERS | No | Headers to send with the request. Formatted as key=value. One key/value pair per line. For example:
The headers input also allows FlexDeploy property replacement to be used as seen in the x-client-secret header above @since 5.3.0.1 |
Validation Script | FDR_VALIDATION_SCRIPT | No | Groovy validation script to be run against the response body. This input expects a groovy script as plain text, meaning you should not enable the groovy script flag on the plugin input itself. Available variables:
Example script: PAYLOAD.myField && PAYLOAD.myField.equals('myValue') @since 5.3.0.1 |
Validation Action | FDR_VALIDATION_ACTION | No | What action should be taken if the Groovy Validation Script fails? Valid options are:
@since 5.3.0.1 |
Connect Timeout | FDR_CONNECT_TIMEOUT | No | Time to wait to allow a connection to be established. Setting to 0 will wait forever. @since 5.3.0.1 |
Read Timeout | FDR_READ_TIMEOUT | No | Time to wait for a response after establishing a connection. Setting to 0 will wait forever. @since 5.3.0.1 |
Outputs
Output Name | Required | Description |
---|---|---|
| No | The Integer response code of from the REST response |
FDR_RESPONSE_STRING | No | The first Response Entity is returned as a String. |
Artifacts
This operation doesn’t consume or produce any artifacts.
Endpoint Selection
This operation will select all available endpoints associated to the Environment/Instance.
Endpoint Execution
This operation will execute on any one of the selected endpoints and will be random in the determination of which one.
- style