We are introducing an API endpoint to update the status of a tenant connector. You can toggle between enabling or disabling the tenant connector by specifying the action as ENABLE or DISABLE.
|
Parameter |
Mandatory/Optional |
Data Type |
Description |
|---|---|---|---|
|
organizationConnectorId |
Mandatory |
Integer |
The ID (s) of the tenant connector you want to enable or disable. |
API request
curl --x "PUT" --location 'https://<QualysGatewayURL>/connectors/v1.0/org/azure/status/?action=ENABLE
--header 'Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
Request POST data
[xxxxxx]
Response
{
"currentPage": 0,
"currentPageSize": 1,
"totalPages": 1,
"numberOfElements": 1,
"content": [
{
"id": xxxxxx,
"organizationId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Azure Org",
"connectorPrefixName": "createdbyorg",
"runFrequency": "60",
"connectorRunFrequency": "60",
"lastSynced": "2023-05-17T07:56:38.051+00:00",
"customerId": "axxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"userUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"userName": "abcde_xxxx",
"type": "AZURE",
"lastError": null,
"isDeleted": false,
"isDisabled": false,
"description": "azure org connector description",
"state": "FINISHED_SUCCESS",
"nextSync": "2023-05-17T08:56:38.051+00:00",
"isRemediationEnabled": true,
"organizationName": "Azure org",
"uuid": xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"isAssignStaticTagToAssetsPulledByThatConnector": false,
"isAssignStaticTagToConnectors": false,
"connectorAppInfos": [
{
"name": "AI",
"identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tagId": null,
"tagMetadata": null
},
{
"name": "CI",
"identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tagId": null,
"tagMetadata": null
},
{
"name": "CSA",
"identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tagId": null,
"tagMetadata": null
}
],
"defaultTagIds": [],
"memberConfigurations": {
"includedMembers": [
"TestingManagementGroup"
],
"excludedMembers": []
},
"createConnectorForNewSubscriptionsAutomatically": true,
"disableConnectorsForDeletedManagementGroups": true,
"createStaticTagsForManagementGroups": false
}],
"hasContent": true,
"hasNext": false,
"hasPrevious": false,
"first": true,
"last": true
}
API request
curl --x "PUT" --location 'https://<QualysGatewayURL>/connectors/v1.0/org/azure/status/?action=DISABLE
--header 'Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
Request POST data
[xxxxxx]
Response
{
"currentPage": 0,
"currentPageSize": 1,
"totalPages": 1,
"numberOfElements": 1,
"content": [
{
"id": xxxxxx,
"organizationId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Azure Org",
"connectorPrefixName": "createdbyorg",
"runFrequency": "60",
"connectorRunFrequency": "60",
"lastSynced": "2023-05-17T07:56:38.051+00:00",
"customerId": "axxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"userUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"userName": "abcde_xxxx",
"type": "AZURE",
"lastError": null,
"isDeleted": false,
"isDisabled": true,
"description": "azure org connector description",
"state": "FINISHED_SUCCESS",
"nextSync": "2023-05-17T08:56:38.051+00:00",
"isRemediationEnabled": true,
"organizationName": "Azure org",
"uuid": xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"isAssignStaticTagToAssetsPulledByThatConnector": false,
"isAssignStaticTagToConnectors": false,
"connectorAppInfos": [
{
"name": "AI",
"identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tagId": null,
"tagMetadata": null
},
{
"name": "CI",
"identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tagId": null,
"tagMetadata": null
},
{
"name": "CSA",
"identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tagId": null,
"tagMetadata": null
}
],
"defaultTagIds": [],
"memberConfigurations": {
"includedMembers": [
"TestingManagementGroup"
],
"excludedMembers": []
},
"createConnectorForNewSubscriptionsAutomatically": true,
"disableConnectorsForDeletedManagementGroups": true,
"createStaticTagsForManagementGroups": false
}],
"hasContent": true,
"hasNext": false,
"hasPrevious": false,
"first": true,
"last": true
}