Update a custom field configuration (PUT)
The PUT command updates an existing custom field by using the XML representation of this field and modifying its content.
Command overview
Method — PUT
Resource — customfield
Resource identifier — Integer that identifies the custom field (custom field ID)
Parameters
Parameter | Description | Example |
---|---|---|
usr 1 | A valid system user name (case sensitive) | usr=myUsername |
pwd 1 | The password that corresponds to the usr (user name) parameter (case sensitive) | pwd=myPassword |
tid | The transaction identifier. You must specify the tid for all stateful operations. Do not include it in stateless operations. | tid=5456 |
1 This parameter is required.
Sample request
https://10.0.0.1/rest/configurationapi/customfieldapi/1.0/customfield/123?usr=jdoe&pwd=pa55w0rd!&tid=4738
...
<customField active="false" entity="object" srcEntity="object" type="string" policy="first-non-null" export="x- custom-gzip" grammar="custom_gzip">
<name><![CDATA[Text Compression]]></name>
<description><![CDATA[Tracking all gzip text compression]]></ description>
<extractions>
<extraction>
<name><![CDATA[Text Objects]]></name>
<expression><![CDATA[(mime_type contains "text" ignorecase)]]></expression>
<source>
<sourceHTTPHeader origin="response" index="0" indexType="all" characterLimit="50">
<key><![CDATA[Content-Encoding]]></key>
</sourceHTTPHeader>
</source>
<transformations/>
</extraction>
</extractions>
</customField>
...
<customField active="false" entity="object" srcEntity="object" type="string" policy="first-non-null" export="x- custom-gzip" grammar="custom_gzip">
<name><![CDATA[Text Compression]]></name>
<description><![CDATA[Tracking all gzip text compression]]></ description>
<extractions>
<extraction>
<name><![CDATA[Text Objects]]></name>
<expression><![CDATA[(mime_type contains "text" ignorecase)]]></expression>
<source>
<sourceHTTPHeader origin="response" index="0" indexType="all" characterLimit="50">
<key><![CDATA[Content-Encoding]]></key>
</sourceHTTPHeader>
</source>
<transformations/>
</extraction>
</extractions>
</customField>
Sample Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status result="success"></status>
</response>
<response>
<status result="success"></status>
</response>
Related topic
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*