Creates an AWS asset data connector for GovCloud regions: us-gov-west-1 and us-gov-east-1.
disabled (boolean) is used to disable an EC2 connector. This parameter can be set for a “create” or “update” request. When set to “true” the connector is disabled and will not run.
- If a single connector is run and it is disabled an error is returned.
- If multiple connectors are run and all are disabled an error is returned.
- If multiple connectors are run and some are disabled, only connectors that are enabled will run.
Permissions required - Managers with full scope.
API request
curl -u "USERNAME:PASSWORD" -H "Content-type: text/xml" -X "POST" --data-binary @- "<qualys_base_url>/qps/rest/2.0/create/am/awsassetdataconnector" < file.xml
Note: file.xml contains request POST data
Request POST data
<?xml version="1.0" encoding="UTF-8" ?>
<ServiceRequest>
<data>
<AwsAssetDataConnector>
<name>gov-cloud</name>
<activation>
<set>
<ActivationModule>VM</ActivationModule>
<ActivationModule>PC</ActivationModule>
</set>
</activation>
<isGovCloudConfigured>true</isGovCloudConfigured>
<arn>arn:aws:iam::205767712433:role/qualys-demo-account</arn>
<externalId>pod13-xxxxxx-xxxxx</externalId>
<allRegions>false</allRegions>
<disabled>false</disabled>
</AwsAssetDataConnector>
</data>
</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/2.0/am/aws_asset_data-connector.xsd">
<responseCode>SUCCESS</responseCode>
<count>1</count>
<data>
<AwsAssetDataConnector>
<id>149008</id>
<name>gov-cloud</name>
<awsAccountId>205767712438</awsAccountId>
<connectorState>PENDING</connectorState>
<type>AWS</type>
<defaultTags>
<list/>
</defaultTags>
<activation>
<list>
<ActivationModule>VM</ActivationModule>
<ActivationModule>PC</ActivationModule>
</list>
</activation>
<disabled>false</disabled>
<isGovCloudConfigured>true</isGovCloudConfigured>
<endpoints>
<list>
<AwsEndpointSimple>
<regionCode>us-gov-west-1</regionCode>
<regionCode>us-gov-east-1</regionCode>
</AwsEndpointSimple>
</list>
</endpoints>
<allRegions>false</allRegions>
</AwsAssetDataConnector>
</data>
</ServiceResponse>
<platform API server>/qps/xsd/2.0/am/aws_asset_data-connector.xsd