Service Graph Connector for AWS properties

reference brazil Updated Sep 10, 2026 11 min read cmdb-sgc-aws-props.md
Raw file servicenow.com

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.

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.

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.

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

Parent Topic:Service Graph Connector for AWS reference

Search documentation
Search document titles and file paths on the brazil branch