Delete Authentication Record

GET POST/api/2.0/fo/auth/{technology}/?action=delete

Delete a vault in the user's account. {technology} will reflect the record type, i.e. Windows, Unix, Docker, etc.

Permissions - Managers can update vaults. Unit Managers can update vaults if they are granted the permission "Create/edit authentication records/vaults" and all hosts in the record are in the user's business unit.

Input ParametersInput Parameters

Parameter

Required/Optional

Data Type

Description

action=update

Required String 

Specify to delete the auth record. 

echo_request={0|1}

Optional Integer 

Specify 1 to view (echo) input parameters in the XML output. By default these are not included.

ids={value}

Required Integer 

IDs for authentication records you want to delete. You can enter IDs and ID ranges. Multiple entries are comma separated. Valid IDs are required.

Sample - Delete Multiple Sybase Authentication RecordsSample - Delete Multiple Sybase Authentication Records

API Request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl Sample" -d "action=delete&ids=78187,78783-78784&echo_request=1" "https://<qualys_base_url>/api/2.0/fo/auth/sybase/" > file.xml

XML Output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE BATCH_RETURN SYSTEM "https://<qualys_base_url>/api/2.0/batch_return.dtd">
<BATCH_RETURN>
  <REQUEST>
    <DATETIME>2018-04-10T21:27:22Z</DATETIME>
    <USER_LOGIN>enter_ss</USER_LOGIN> <RESOURCE>https://<qualys_base_url>/api/2.0/fo/auth/sybase/</RESOURCE>
    <PARAM_LIST>
      <PARAM>
        <KEY>action</KEY>
        <VALUE>delete</VALUE>
      </PARAM>
      <PARAM>
        <KEY>ids</KEY>
        <VALUE>78187,78783-78784</VALUE>
      </PARAM>
      <PARAM>
        <KEY>echo_request</KEY>
        <VALUE>1</VALUE>
      </PARAM>
    </PARAM_LIST>
  </REQUEST>
  <RESPONSE>
    <DATETIME>2018-04-10T21:27:22Z</DATETIME>
    <BATCH_LIST>
      <BATCH>
        <TEXT>Successfully Deleted</TEXT>
        <ID_SET>
          <ID>78187</ID>
          <ID_RANGE>78783-78784</ID_RANGE>
        </ID_SET>
      </BATCH>
    </BATCH_LIST>
  </RESPONSE>
</BATCH_RETURN>

DTD

<platform API server>/api/2.0/batch_return.dtd