update_cloud_datasource

Updates the cloud datasource configuration (cloud database service protection).

This API is available in Guardium V10.1 and later.

GuardAPI syntax

update_cloud_datasource parameter=value

Parameters

Parameter Value type Description
cloudTitle String Required. Name of cloud account already defined in Guardium. Required. For valid values, call update_cloud_datasource from the command line with --help=true.

For more information, see create_cloudTitle.

conProperty String Use only if additional connection properties must be included on the JDBC URL to establish a JDBC connection with this datasource. The required format is property=value, where each property and value pair is separated from the next by a comma.
customURL String Connection string to the datasource; otherwise connection is made using host, port, instance, properties, etc. of the previously entered fields. This is useful, for example, when creating Oracle Internet Directory (OID) connections.
cyberarkConfigName String The name of the CyberArk configuration on your Guardium system. For valid values, call update_cloud_datasource from the command line with --help=true.
cyberarkObjectName String The CyberArk object name for the Guardium datasource.
dbInstanceAccount String Database Account Login Name that is used by CAS.
dbInstanceDirectory String Directory where database software was installed that is used by CAS.
dbName String For a Db2® or Oracle datasource, enter the schema name. For others, enter the database name.
description String A longer description of the datasource.
externalPasswordTypeName String For valid values, call update_cloud_datasource from the command line with --help=true.
host String Required. The host name or the IP address of the server hosting the DB you are monitoring.
importServerSSLcert Boolean Valid values:
  • 0 (false)
  • 1 (true)
KerberosConfigName String Name of Kerberos configuration already defined in Guardium system.
name String Required. A unique name for the datasource in the Guardium system.
new name string Specifies a new name for the datasource.
objectLimit Integer Required. The maximum number of sensitive objects found in the classification process that are added automatically to the list of audited objects. Default = 20.
password String Password for user.
port Integer Port number.
primaryCollector Integer The collector that extracts the audit data from the cloud database.
region String Required for AWS only. For valid values, call update_cloud_datasource from the command line with --help=true.
savePassword Boolean Saves and encrypts your authentication credentials on the Guardium appliance. Required if you are defining a datasource with an application that runs as a scheduled task (as opposed to on-demand). When set to yes, login name and password are required. Valid values:
  • 0 (false)
  • 1 (true)

Default = 1 (true)

serviceName String Required for Oracle, Informix®, Db2, and IBM® i. For a Db2 datasource enter the database name, for others enter the service name.
severity String Severity Classification (or impact level) for the datasource. For valid values, call update_cloud_datasource from the command line with --help=true.
shared String Set to true or Shared to share with other applications. To share the datasource with other users, you need to assign roles from the GUI. Valid values:
  • Shared
  • Not Shared
  • true
  • false
useExternalPassword Boolean Valid values:
  • 0 (false)
  • 1 (true)
useKerberos Boolean Set to 1 (true) to use Kerberos authentication. If true, KerberosConfigName is required. Valid values:
  • 0 (false)
  • 1 (true)
useLDAP Boolean Set to 1 (true) to use LDAP. Valid values:
  • 0 (false)
  • 1 (true)
user String User for the datasource. If used, password must also be specified.
useSSL Boolean Set to 1 (true) to use SSL authentication. Valid values:
  • 0 (false)
  • 1 (true)

Examples

Say something about the example

grdapi update_cloud_datasource