.. _health_monitor_method_http:

health monitor method http
==========================

HTTP type


http Specification
------------------

	===================================== ==========================================================================
	 **Parameter**                         **Value** 

	===================================== ==========================================================================
	 **Type**                              *Configuration Resource*

	 **Element Name**                      http

	 **Element URI**                       /axapi/v3/health/monitor/{name}/method/http

	 **Element Attributes**                http_attributes

	 **Partition Visibility**              shared

	 **Schema**                             :download:`http schema <health-monitor-method-http/health-monitor-method-http.txt>`
	===================================== ==========================================================================





	**Operations Allowed:**




.. raw:: html

   <script type="text/javascript">
 function showExample(a,b) { document.getElementById(a+'_div').style.display = 'block'; document.getElementById(a+'_cl').style.display = 'block'; document.getElementById(a+'_eg').style.display = 'none';}
   function closeExample(a,b) { document.getElementById(a+'_div').style.display = 'none'; document.getElementById(a+'_cl').style.display = 'none'; document.getElementById(a+'_eg').style.display = 'block';}
 </script>
   <table width='90%' style='margin-left:5%'>



.. raw:: html

   <tr style='border-bottom: thin solid; border-top: thin solid'><th width=15%>Operation</th><th width=10%>Method</th><th>URI</th><th width=15%>Payload</th><th width=10%></th></tr>




.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Create Object



.. raw:: html

   </td><td valign = 'top'>


POST



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/health/monitor/{name}/method/http



.. raw:: html

   </td><td valign = 'top'>


:ref:`1839_http_attributes`



.. raw:: html

   </td><td><button id='post_eg' onClick="showExample('post')">example</button> <button id='post_cl' onClick="closeExample('post')" style='display:none'>close</button></td></tr>




.. raw:: html

   <tr><td colspan=5 style='padding: 0         % 0    %;' valign = 'top'><div id='post_div' style='display:none'>


.. include:: ../artifacts/health_monitor_method_http_POST.txt
   :literal:




.. raw:: html

   </div></td></tr>


.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Get Object



.. raw:: html

   </td><td valign = 'top'>


GET



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/health/monitor/{name}/method/http



.. raw:: html

   </td><td valign = 'top'>


:ref:`1839_http_attributes`



.. raw:: html

   </td><td><button id='get_eg' onClick="showExample('get')">example</button> <button id='get_cl' onClick="closeExample('get')" style='display:none'>close</button></td></tr>




.. raw:: html

   <tr><td colspan=5 style='padding: 0         % 0    %;' valign = 'top'><div id='get_div' style='display:none'>


.. include:: ../artifacts/health_monitor_method_http_GET.txt
   :literal:




.. raw:: html

   </div></td></tr>


.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Modify Object



.. raw:: html

   </td><td valign = 'top'>


POST



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/health/monitor/{name}/method/http



.. raw:: html

   </td><td valign = 'top'>


:ref:`1839_http_attributes`



.. raw:: html

   </td><td></td></tr>




.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Replace Object



.. raw:: html

   </td><td valign = 'top'>


PUT



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/health/monitor/{name}/method/http



.. raw:: html

   </td><td valign = 'top'>


:ref:`1839_http_attributes`



.. raw:: html

   </td><td><button id='put_eg' onClick="showExample('put')">example</button> <button id='put_cl' onClick="closeExample('put')" style='display:none'>close</button></td></tr>




.. raw:: html

   <tr><td colspan=5 style='padding: 0         % 0    %;' valign = 'top'><div id='put_div' style='display:none'>


.. include:: ../artifacts/health_monitor_method_http_PUT.txt
   :literal:




.. raw:: html

   </div></td></tr>


.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Delete Object



.. raw:: html

   </td><td valign = 'top'>


DELETE



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/health/monitor/{name}/method/http



.. raw:: html

   </td><td valign = 'top'>


:ref:`1839_http_attributes`



.. raw:: html

   </td><td><button id='delete_eg' onClick="showExample('delete')">example</button> <button id='delete_cl' onClick="closeExample('delete')" style='display:none'>close</button></td></tr>




.. raw:: html

   <tr><td colspan=5 style='padding: 0         % 0    %;' valign = 'top'><div id='delete_div' style='display:none'>


.. include:: ../artifacts/health_monitor_method_http_DELETE.txt
   :literal:




.. raw:: html

   </div></td></tr>


.. raw:: html

   </table>

.. _1839_http_attributes:

http attributes
---------------

    **http**

        **Description** HTTP type

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **http-encrypted**

        **Description** Do NOT use this option manually. (This is an A10 reserved keyword.) (The ENCRYPTED password string)

    **http-expect**

        **Description** Specify what you expect from the response message

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **http-host**

        **Description** Specify "Host:" header used in request (enclose IPv6 address in [])

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 63 characters

        **Maximum Length:** 1 characters

    **http-kerberos-auth**

        **Description** Http Kerberos Auth

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **http-kerberos-kdc**

        **Description:** http-kerberos-kdc is a **JSON Block**.  Please see below for :ref:`1839_http-kerberos-kdc` 

        **Type:** Object

    **http-kerberos-realm**

        **Description** Specify realm of Kerberos server

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 63 characters

        **Maximum Length:** 1 characters

    **http-maintenance-code**

        **Description** Specify response code for maintenance (Format is xx,xx-xx (xx between [100, 899]))

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 31 characters

        **Maximum Length:** 1 characters

    **http-password**

        **Description** Specify the user password

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **http-password-string**

        **Description** Specify password, '' means empty password

        **Type:** string

        **Format:** password

        **Maximum Length:** 31 characters

        **Maximum Length:** 1 characters

    **http-port**

        **Description** Specify HTTP Port (Specify port number (default 80))

        **Type:** number

        **Range:** 1-65534

        **Default:** 80

    **http-postdata**

        **Description** Specify the HTTP post data (Input post data here)

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 255 characters

        **Maximum Length:** 1 characters

    **http-postfile**

        **Description** Specify the HTTP post data (Input post data file name here)

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 31 characters

        **Maximum Length:** 1 characters

    **http-response-code**

        **Description** Specify response code range (e.g. 200,400-430) (Format is xx,xx-xx (xx between [100, 899]))

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 31 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion:** http-response-code and http-text are mutually exclusive

    **http-text**

        **Description** Specify text expected

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 127 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion:** http-text, http-response-code, and text-regex are mutually exclusive

    **http-url**

        **Description** Specify URL string, default is GET /

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **http-username**

        **Description** Specify the username

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 31 characters

        **Maximum Length:** 1 characters

    **maintenance**

        **Description** Specify response text for maintenance

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **maintenance-text**

        **Description** Specify text for maintenance

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 127 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion:** maintenance-text and maintenance-text-regex are mutually exclusive

    **maintenance-text-regex**

        **Description** Specify Regex text for maintenance

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 127 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion:** maintenance-text-regex and maintenance-text are mutually exclusive

    **post-path**

        **Description** Specify URL path, default is "/"

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 500 characters

        **Maximum Length:** 1 characters

    **post-type**

        **Description** 'postdata': Specify the HTTP post data; 'postfile': Specify the HTTP post data; 

        **Type:** string

        **Supported Values:** postdata, postfile

    **response-code-regex**

        **Description** Specify response code range with Regex (code with Regex, such as [2-5][0-9][0-9])

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 127 characters

        **Maximum Length:** 1 characters

    **text-regex**

        **Description** Specify text expected  with Regex

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 127 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion:** text-regex and http-text are mutually exclusive

    **url-path**

        **Description** Specify URL path, default is "/"

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 500 characters

        **Maximum Length:** 1 characters

    **url-type**

        **Description** 'GET': HTTP GET method; 'POST': HTTP POST method; 'HEAD': HTTP HEAD method; 

        **Type:** string

        **Supported Values:** GET, POST, HEAD

    **uuid**

        **Description** uuid of the object

        **Type:** string

        **Maximum Length:** 64 characters

        **Maximum Length:** 1 characters

    **version2**

        **Description** Specify HTTP version2 (Specify http version 2)

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

.. _1839_http-kerberos-kdc:

http-kerberos-kdc
^^^^^^^^^^^^^^^^^
	=============================== ===================================================
	**Specification**                 **Value**
	=============================== ===================================================
	 **Type**                        *object*

	=============================== ===================================================

    **http-kerberos-hostip**

        **Description** Kdc's hostname(length:1-31) or IP address

        **Type:** string

        **Format:** host

        **Maximum Length:** 31 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion:** http-kerberos-hostip and http-kerberos-hostipv6 are mutually exclusive

    **http-kerberos-hostipv6**

        **Description** Server's IPV6 address

        **Type:** string

        **Format:** ipv6-address

        **Mutual Exclusion:** http-kerberos-hostipv6 and http-kerberos-hostip are mutually exclusive

    **http-kerberos-port**

        **Description** Specify the kdc port

        **Type:** number

        **Range:** 1-65535

    **http-kerberos-portv6**

        **Description** Specify the kdc port

        **Type:** number

        **Range:** 1-65535