Package software.amazon.awscdk.services.ssm

Class CfnResourceDataSync

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.CfnElement
software.amazon.awscdk.CfnRefElement
software.amazon.awscdk.CfnResource
software.amazon.awscdk.services.ssm.CfnResourceDataSync
All Implemented Interfaces:
IInspectable, IEnvironmentAware, IResourceDataSyncRef, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)", date="2025-11-17T14:41:01.271Z") @Stability(Stable) public class CfnResourceDataSync extends CfnResource implements IInspectable, IResourceDataSyncRef
The AWS::SSM::ResourceDataSync resource creates, updates, or deletes a resource data sync for AWS Systems Manager .

A resource data sync helps you view data from multiple sources in a single location. Systems Manager offers two types of resource data sync: SyncToDestination and SyncFromSource .

You can configure Systems Manager Inventory to use the SyncToDestination type to synchronize Inventory data from multiple AWS Regions to a single Amazon S3 bucket.

You can configure Systems Manager Explorer to use the SyncFromSource type to synchronize operational work items (OpsItems) and operational data (OpsData) from multiple AWS Regions . This type can synchronize OpsItems and OpsData from multiple AWS accounts and Regions or from an EntireOrganization by using AWS Organizations .

A resource data sync is an asynchronous operation that returns immediately. After a successful initial sync is completed, the system continuously syncs data.

By default, data is not encrypted in Amazon S3 . We strongly recommend that you enable encryption in Amazon S3 to ensure secure data storage. We also recommend that you secure access to the Amazon S3 bucket by creating a restrictive bucket policy.

For more information, see Configuring Inventory Collection and Setting Up Systems Manager Explorer to Display Data from Multiple Accounts and Regions in the AWS Systems Manager User Guide .

The following Syntax section shows all fields that are supported for a resource data sync. The Examples section below shows the recommended way to specify configurations for each sync type. Refer to the Examples section when you create your resource data sync.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.ssm.*;
 CfnResourceDataSync cfnResourceDataSync = CfnResourceDataSync.Builder.create(this, "MyCfnResourceDataSync")
         .syncName("syncName")
         // the properties below are optional
         .bucketName("bucketName")
         .bucketPrefix("bucketPrefix")
         .bucketRegion("bucketRegion")
         .kmsKeyArn("kmsKeyArn")
         .s3Destination(S3DestinationProperty.builder()
                 .bucketName("bucketName")
                 .bucketRegion("bucketRegion")
                 .syncFormat("syncFormat")
                 // the properties below are optional
                 .bucketPrefix("bucketPrefix")
                 .kmsKeyArn("kmsKeyArn")
                 .build())
         .syncFormat("syncFormat")
         .syncSource(SyncSourceProperty.builder()
                 .sourceRegions(List.of("sourceRegions"))
                 .sourceType("sourceType")
                 // the properties below are optional
                 .awsOrganizationsSource(AwsOrganizationsSourceProperty.builder()
                         .organizationSourceType("organizationSourceType")
                         // the properties below are optional
                         .organizationalUnits(List.of("organizationalUnits"))
                         .build())
                 .includeFutureRegions(false)
                 .build())
         .syncType("syncType")
         .build();

See Also:

  • Field Details

    • CFN_RESOURCE_TYPE_NAME

      @Stability(Stable) public static final String CFN_RESOURCE_TYPE_NAME
      The CloudFormation resource type name for this resource class.

  • Constructor Details

    • CfnResourceDataSync

      protected CfnResourceDataSync(software.amazon.jsii.JsiiObjectRef objRef)

    • CfnResourceDataSync

      protected CfnResourceDataSync(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • CfnResourceDataSync

      @Stability(Stable) public CfnResourceDataSync(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull CfnResourceDataSyncProps props)
      Create a new AWS::SSM::ResourceDataSync.

      Parameters:
      scope - Scope in which this resource is defined. This parameter is required.
      id - Construct identifier for this resource (unique in its scope). This parameter is required.
      props - Resource properties. This parameter is required.

  • Method Details

    • fromSyncName

      @Stability(Stable) @NotNull public static IResourceDataSyncRef fromSyncName(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull String syncName)
      Creates a new IResourceDataSyncRef from a syncName.

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      syncName - This parameter is required.

    • inspect

      @Stability(Stable) public void inspect(@NotNull TreeInspector inspector)
      Examines the CloudFormation resource and discloses attributes.

      Specified by:
      inspect in interface IInspectable
      Parameters:
      inspector - tree inspector to collect and process attributes. This parameter is required.

    • renderProperties

      @Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
      Overrides:
      renderProperties in class CfnResource
      Parameters:
      props - This parameter is required.

    • getAttrSyncName

      @Stability(Stable) @NotNull public String getAttrSyncName()

    • getCfnProperties

      @Stability(Stable) @NotNull protected Map<String,Object> getCfnProperties()
      Overrides:
      getCfnProperties in class CfnResource

    • getResourceDataSyncRef

      @Stability(Stable) @NotNull public ResourceDataSyncReference getResourceDataSyncRef()
      A reference to a ResourceDataSync resource.
      Specified by:
      getResourceDataSyncRef in interface IResourceDataSyncRef

    • getSyncName

      @Stability(Stable) @NotNull public String getSyncName()
      A name for the resource data sync.

    • setSyncName

      @Stability(Stable) public void setSyncName(@NotNull String value)
      A name for the resource data sync.

    • getBucketName

      @Stability(Stable) @Nullable public String getBucketName()
      The name of the S3 bucket where the aggregated data is stored.

    • setBucketName

      @Stability(Stable) public void setBucketName(@Nullable String value)
      The name of the S3 bucket where the aggregated data is stored.

    • getBucketPrefix

      @Stability(Stable) @Nullable public String getBucketPrefix()
      An Amazon S3 prefix for the bucket.

    • setBucketPrefix

      @Stability(Stable) public void setBucketPrefix(@Nullable String value)
      An Amazon S3 prefix for the bucket.

    • getBucketRegion

      @Stability(Stable) @Nullable public String getBucketRegion()
      The AWS Region with the S3 bucket targeted by the resource data sync.

    • setBucketRegion

      @Stability(Stable) public void setBucketRegion(@Nullable String value)
      The AWS Region with the S3 bucket targeted by the resource data sync.

    • getKmsKeyArn

      @Stability(Stable) @Nullable public String getKmsKeyArn()
      The Amazon Resource Name (ARN) of an encryption key for a destination in Amazon S3 .

    • setKmsKeyArn

      @Stability(Stable) public void setKmsKeyArn(@Nullable String value)
      The Amazon Resource Name (ARN) of an encryption key for a destination in Amazon S3 .

    • getS3Destination

      @Stability(Stable) @Nullable public Object getS3Destination()
      Configuration information for the target S3 bucket.

      Returns union: either IResolvable or CfnResourceDataSync.S3DestinationProperty

    • setS3Destination

      @Stability(Stable) public void setS3Destination(@Nullable IResolvable value)
      Configuration information for the target S3 bucket.

    • setS3Destination

      @Stability(Stable) public void setS3Destination(@Nullable CfnResourceDataSync.S3DestinationProperty value)
      Configuration information for the target S3 bucket.

    • getSyncFormat

      @Stability(Stable) @Nullable public String getSyncFormat()
      A supported sync format.

    • setSyncFormat

      @Stability(Stable) public void setSyncFormat(@Nullable String value)
      A supported sync format.

    • getSyncSource

      @Stability(Stable) @Nullable public Object getSyncSource()
      Information about the source where the data was synchronized.

      Returns union: either IResolvable or CfnResourceDataSync.SyncSourceProperty

    • setSyncSource

      @Stability(Stable) public void setSyncSource(@Nullable IResolvable value)
      Information about the source where the data was synchronized.

    • setSyncSource

      @Stability(Stable) public void setSyncSource(@Nullable CfnResourceDataSync.SyncSourceProperty value)
      Information about the source where the data was synchronized.

    • getSyncType

      @Stability(Stable) @Nullable public String getSyncType()
      The type of resource data sync.

    • setSyncType

      @Stability(Stable) public void setSyncType(@Nullable String value)
      The type of resource data sync.