User Guide

214 Chapter 2: ColdFusion Tags
method Opt GET • GET: requests information from the server. Any data that
the server requires to identify the requested information
must be in the URL or in
cfhttp type="URL" tags.
• POST: sends information to the server for processing.
Requires one or more
cfhttpparam tags. Often used for
submitting form-like data.
• PUT: requests the server to store the message body at
the specified URL. Use this method to send files to the
server.
• DELETE: requests the server to delete the specified
URL.
• HEAD: identical to the GET method, but the server does
not send a message body in the response. Use this
method for testing hypertext links for validity and
accessibility, determining the type or modification time
of a document, or determining the type of server.
• TRACE: requests that the server echo the received
HTTP headers back to the sender in the response body.
Trace requests cannot have bodies. This method
enables the ColdFusion application to see what is being
received at the server, and use that data for testing or
diagnostic information.
• OPTIONS: a request for information about the
communication options available for the server or the
specified URL. This method enables the ColdFusion
application to determine the options and requirements
associated with a URL, or the capabilities of a server,
without requesting any additional activity by the server.
proxyServer Opt Host name or IP address of a proxy server to which to send
the request.
proxyPort Opt 80 Port number to use on the proxy server.
proxyUser Opt User name to provide to the proxy server.
proxyPassword Opt Password to provide to the proxy server.
username Opt Use to pass a user name to the target URL for Basic
Authentication. Combined with
password to form a base64
encoded string that is passed in the Authenticate header.
Does not provide support for Integrated Windows, NTLM,
or Kerebos authentication.
password Opt Use to pass a password to the target URL for Basic
Authentication. Combined with
username to form a base64
encoded string that is passed in the Authenticate header.
Does not provide support for Integrated Windows, NTLM,
or Kerebos authentication.
userAgent Opt Cold
Fusion
Text to put in the user agent request header. Used to
identify the request client software. Can make the
ColdFusion application appear to be a browser.
Attribute Req/Opt Default Description