Service Graph Connector for AWS properties

  • Release version: Australia
  • Updated March 12, 2026
  • 11 minutes to read

    • Service Graph Connector for AWS properties control the behavior of the connector.

    Connection properties

    These connection properties are available for the Service Graph Connector for AWS.
    Note:
    To open the Service Graph Connection Properties [sn_cmdb_int_util_service_graph_connection_property] table for the connector, navigate to All > Service Graph Connectors > AWS > Connections, and select the connection name. The connection properties are displayed in the Service Graph Connection Properties related list.
    Table 1. Connection properties for Service Graph Connector for AWS
    Property Description

    aws_lookback_time_in_days

    		 This property is used for record removal. Time in days in which the sys_object_source records are queried for the deletion of CIs. The value is automatically updated to 15 after the initial run.

    Set the value of this property to empty to include all the older records populated by SG-AWS as removal candidates.

    Note:
    Do not modify this property if the value is empty.
    • Type: integer
    • Default value: empty

    config_aggregator_name

    		 Enter the name of the configuration aggregator.
    • Type: string
    • Default value: empty

    config_aggregator_account

    		 Enter the AWS account where the configuration aggregator is configured.
    • Type: string
    • Default value: empty

    config_aggregator_region

    		 Enter the AWS region in which the configuration aggregator is configured.
    • Type: string
    • Default value: empty

    sts_role

    		 Enter the AWS STS role name.
    • Type: string
    • Default value: empty

    aws_rotate_keys

    		 Set the property to true to enable the AWS key rotation process.
    • Type: true | false
    • Default value: false

    aws_rotate_keys_status

    		 The AWS key rotation status.
    • Type: string
    • Default value: empty

    aws_rotate_keys_date

    		 Enter the AWS key rotation date.
    • Type: string
    • Default value: empty

    aws_rotate_keys_period

    		 Enter the AWS key rotation period (in days).
    • Type: integer
    • Default value: 90

    aws_rotate_keys_error_notify_user

    		 Enter the comma-separated list of the email addresses of recipients to be sent notifications about AWS key rotation errors.
    • Type: string
    • Default value: empty

    aws_rotate_keys_error_notify_group

    		 Enter the comma-separated list of the ServiceNow email groups to be sent notifications about AWS key rotation errors.
    • Type: string
    • Default value: empty

    org_name

    		 Enter the name of the AWS organization.
    • Type: string
    • Default value: <ORG_NAME>

    org_description

    		 Enter the description of AWS organization.
    • Type: string
    • Default value: empty

    org_account_id

    		 Enter the AWS account ID that is used to identify the AWS organization.
    • Type: string
    • Default value: <ORG_ID>

    management_account_id

    		 Enter the AWS account ID that is used for the management account. This property is required only if the ServiceNow user is created in a designated account.
    • Type: string
    • Default value: empty

    u_connection_alias_id

    		 The ServiceNow sys_id for the connection alias.
    • Type: string
    • Default value: empty

    standalone_account_id

    		 Enter the AWS account ID for standalone setup. This property is required only if you set up AWS on a standalone account.
    • Type: string
    • Default value: empty

    gov_cloud

    		 Set the property to true to enable AWS GovCloud.
    • Type: true | false
    • Default value: empty

    aws_account_partition_size

    		 Enter the partition size for AWS accounts if parallel loading is enabled. The value must be a numeric value greater than zero.
    • Type: integer
    • Default value: empty

    ssm_sendcommand_windows_name

    		 Enter the SSM document name for the SendCommand for Windows.
    • Type: string
    • Default value: empty

    ssm_sendcommand_linux_name

    		 Enter the SSM document name for the SendCommand for Linux.
    • Type: string
    • Default value: empty

    ssm_eks_names_document

    		 Enter the SSM document name for the EKS data source.
    • Type: string
    • Default value: empty

    ssm_eks_shell_document

    		 Enter the SSM document name for EKS-Full data source.
    • Type: string
    • Default value: empty

    regions

    		 Enter the comma-separated list of AWS regions.
    • Type: string
    • Default value: empty

    s3_account_id

    		 Enter the numeric identifier of the AWS account that hosts the Amazon Simple Storage Service (Amazon S3) bucket.
    • Type: integer
    • Default value: empty

    s3_bucket_name

    		 Enter the name of the Amazon S3 bucket that collects the details from Amazon EC2 instances.
    • Type: string
    • Default value: empty

    s3_region

    		 Enter the region where the Amazon S3 bucket is set up.
    • Type: string
    • Default value: empty
    aws_generic_resource_partition_size Set the partition size for AWS Generic Resources if parallel loading is enabled.
    • Type: integer
    • Default value: empty

    Default system properties

    These default system properties are available for the Service Graph Connector for AWS.
    Note:
    To open the System Properties [sys_properties] table, enter sys_properties.list in the navigation filter.
    Table 2. Default system properties for Service Graph Connector for AWS
    Property Description

    sn_aws_integ.create_server_record_even_if_SSM_disabled

    		 This property controls server creation with or without SSM enabled on the instance. Set the property to true to create server records when SSM is disabled on the instance.
    • Type: true | false
    • Default value: false
    • Location: System Property [sys_properties] table

    sn_aws_integ.eks_document_processing_time

    		 Enter the time (in milliseconds) required to process the EKS SendCommand document, during which time the data source thread waits.
    • Type: integer
    • Default value: 100
    • Location: System Property [sys_properties] table

    sn_aws_integ.enableOptimizedDeletion

    		 Set the property to true to enable optimized deletion using the Integration Commons record removal API.

    During parallel data loading, delete jobs are created only for delta loads, not for full data loads.

    • Type: true | false
    • Default value: false
    • Location: System Property [sys_properties] table

    sn_aws_integ.global_generic_resource_region

    Set the region that has the configuration recorder that can record global resources such as IAM user and IAM group.

    Global generic resources are imported only when the region is set.

    • Type: string
    • Default value: empty
    • Location: System Property [sys_properties] table

    sn_aws_integ.is_software_inventory_enabled
    Important:
    This property is not supported in Service Graph Connector for AWS version 2.10.0 and later.
    Set the property to true if SG-AWS-Software-Inventory is enabled to improve the performance of SG-AWS-SendCommand.
    • Type: true | false
    • Default value: false
    • Location: System Property [sys_properties] table

    sn_aws_integ.load_all_images

    		 Set the property to true to run the DescribeImages API for all images that are included in the SG-AWS-Image-Id data source. Set the property to false to run the DescribeImages API only for images without names.
    • Type: true | false
    • Default value: false
    • Location: System Property [sys_properties] table

    sn_aws_integ.save_payload_as_attachment

    		 Option to save the REST responses as attachments. Set this property to true if the payload size is greater than 10 MB.
    • Type: true | false
    • Default value: false
    • Location: System Property [sys_properties] table

    sn_aws_integ.sgaws_config_list_discovered_resource_count

    		 Set the number of resource IDs for the list discovered API. The default value is 20, and the maximum value is 769.
    • Type: integer
    • Default value: 20
    • Location: System Property [sys_properties] table

    sn_aws_integ.sgaws_config_list_discovered_retry_count

    		 Set the retry count after a failure of the list discovered API.
    • Type: integer
    • Default value: 100
    • Location: System Property [sys_properties] table

    sn_aws_integ.sgaws_ssm_list_cmd_retry_count

    		 Set the retry count after a failure of the SendCommand API.
    • Type: integer
    • Default value: 200
    • Location: System Property [sys_properties] table

    sn_aws_integ.use_aggregator_configured_accounts

    		 Set the property to true to import CIs only from the aggregator configured accounts, not from all the member accounts.
    • Type: true | false
    • Default value: true
    • Location: System Property [sys_properties] table

    sn_aws_integ.u_sgaws_csv_supported_db

    		 Enter the list of database applications (such as MySQL and Postgres) that are supported for detection using the SSM SendCommand.
    • Type: string
    • Default value: {"mysql":"mysql"}
    • Location: System Property [sys_properties] table

    sn_aws_integ.linux_TCP_Established_Status
    • Type: string
    • Default value: ESTABLISHED | TIME_WAIT | CLOSE_WAIT
    • Location: System Property [sys_properties] table

    sn_aws_integ.linux_TCP_Listener_Status
    • Type: string
    • Default value: LISTEN
    • Location: System Property [sys_properties] table

    sn_aws_integ.windows_TCP_Established_Status
    • Type: string
    • Default value: ESTABLISHED|HERGESTELLT
    • Location: System Property [sys_properties] table

    sn_aws_integ.windows_TCP_Listener_Status
    • Type: string
    • Default value: LISTENING|ABHÖREN
    • Location: System Property [sys_properties] table

    Custom system properties

    You can create these custom system properties for the Service Graph Connector for AWS. These properties must be created in the Service Graph Connector for AWS application scope. The custom properties that you create are listed in the System Properties [sys_properties] table. For more information about creating custom system properties, see Add a system property.
    Table 3. Custom system properties for Service Graph Connector for AWS
    Property Description

    sn_aws_integ.eks_chunk_size

    		 Enter the number of EKS records per batch. The value of this property can be reduced if the import row size leads to transformation errors.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ssm_managed_instance_inventory_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-Software-Inventory data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ssm_managed_instance_inventory_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-Software-Inventory data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.generic_resource__batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-Generic-Resources data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.generic_resource_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-Generic-Resources data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.eks_cluster_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-EKS-Cluster data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.eks_cluster_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-EKS-Cluster data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_subnet_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-Subnets data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_subnet_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-Subnets data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_network_interface_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-Network-Interface data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_network_interface_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-Network-Interface data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_volume_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-Storage-Volume data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_volume_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-Storage-Volume data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_instance_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-EC2 data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_instance_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-EC2 data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.rds_db_instance_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-RDS data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.rds_db_instance_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-RDS data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.s3_bucket_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-S3 data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.s3_bucket_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-S3 data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.api_gateway_v2_api_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-API-Gateway data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.api_gateway_v2_api_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-API-Gateway data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_security_group_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-Security-Group data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_security_group_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-Security-Group data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_vpc_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-VPC data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.ec2_vpc_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-VPC data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.elastic_load_balancing_load_balancer_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-ELB-V1 data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.elastic_load_balancing_load_balancer_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-ELB-V1 data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.elastic_load_balancing_v2_load_balancer_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-ELB-V2 data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.elastic_load_balancing_v2_load_balancer_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-ELB-V2 data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.lambda_function_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-Lambda data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.lambda_function_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-Lambda data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.dynamo_db_table_batch_get_aggregate_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_AGGREGATE_RESOURCE_CONFIG API response for the SG-AWS-DynamoDb data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.dynamo_db_table_batch_get_resource_config_batch_size

    		 Set the batch size of the BATCH_GET_RESOURCE_CONFIG API response for the SG-AWS-DynamoDb data source. Specify a value between 1 and 100.
    • Type: integer
    • Default value: 100

    sn_aws_integ.throttling_min_wait_time_in_ms

    		 Set the minimum wait time (in milliseconds) before retrying after an API failure due to throttling or rate limiting issues.
    • Type: integer
    • Default value: 10,000

    sn_aws_integ.throttling_max_wait_time_in_ms

    		 Set the maximum waiting period (in milliseconds) after an API failure due to throttling or rate limiting issues.
    • Type: integer
    • Default value: 160,000

    sn_aws_integ.config_db_load_enabled

    		 Enter the list of import set table names for which the DB Load is to be enabled to improve performance.
    • Type: string
    • Default value: empty

    sn_itom_pattern.bring_discovery_container

    		 Set this property to false to set all EKS container classes to false during a full load.
    • Type: true | false
    • Default value: false

    Related content

    Data mapping for Service Graph Connector for AWS

    CMDB classes targeted in Service Graph Connector for AWS