Delete AWS Connector 3.0
Click to view navigation pane

Delete AWS Connector 3.0

POST/qps/rest/3.0/delete/am/awsassetdataconnector

POST/qps/rest/3.0/delete/am/awsassetdataconnector/<id>

Delete one or more AWS connectors from the Connectors application.

Using the NOT EQUALS operator for deleting AWS connectors could result in accidental deletion of AWS connectors without any warning. To prevent accidental deletion of unknown AWS connectors, we do not support NOT EQUALS operator for delete actions.

Permissions required - Managers with full scope.

Sample 1 - Delete a single AWS connectorSample 1 - Delete a single AWS connector

API request

curl -n -u "USERNAME:PASSWORD" "<qualys_base_url>/qps/rest/3.0/delete/am/awsassetdataconnector/12345"

Response

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/3.0/am/aws_asset_data_connector.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>1</count>
    <data>
        <AwsAssetDataConnector >
            <id>12345</id>
        </AwsAssetDataConnector >
    </data>
</ServiceResponse>

API Request (JSON)

curl -n -u "USERNAME:PASSWORD" "<qualys_base_url>/qps/rest/3.0/delete/am/awsassetdataconnector/12345"
--header 'Accept: application/json'
--header 'Content-Type: application/json'

Response (JSON)

{
  "ServiceResponse": {
    "responseCode": "SUCCESS",
    "count": 1,
    "data": {
      "AwsAssetDataConnector ": {
        "id": 12345
      }
    }
  }
}

Sample 2 - Delete several AWS connectors tagged with the To Delete tagSample 2 - Delete several AWS connectors tagged with the To Delete tag

API request

curl -u "USERNAME:PASSWORD" -H "content-type: text/xml" -X "POST" --data-binary @- "<qualys_base_url>/qps/rest/3.0/delete/am/awsassetdataconnector"

Request POST data

<?xml version="1.0" encoding="UTF-8" ?>
<ServiceRequest>
    <filters>
        <Criteria field="tagName" operator="EQUALS">To Delete</Criteria>
    </filters>
</ServiceRequest>

Response

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/3.0/am/awsassetdataconnector.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>1</count>
    <data>
        <AwsAssetDataConnector >
            <id>1680408</id>
        </AwsAssetDataConnector>
    </data>
</ServiceResponse>

API Request (JSON)

curl -u "USERNAME:PASSWORD" -X "POST" --data-binary @- "<qualys_base_url>/qps/rest/3.0/delete/am/awsassetdataconnector"
--header 'Accept: application/json'

Request POST Data (JSON)

{
  "ServiceRequest": {
    "filters": {
      "Criteria": [
        {
          "field": "activation",
          "operator": "EQUALS",
          " tagName": "Outdated"
        }
      ]
    }
  }
}

Response (JSON)

{
    "ServiceResponse": {
        "data": [
            {
                "AwsAssetDataConnector": {
                    "id": 1680411
                }
            }
        ],
        "count": 1,
        "responseCode": "SUCCESS"
    }
}

XSD

<platform API server>/qps/xsd/3.0/am/aws_asset_data_connector.xsd