aws-sdk-simspaceweaver 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 4a5d4193bc5f2203532679a47cc99a16eddf38a776591ea03fcc2415b965f9f0
4
- data.tar.gz: d9c94e80d7965b717ead660ba2a79c5a0edbaf8eedff3460d5b24bb3c9c34875
3
+ metadata.gz: 1366131d2c0db118e6d55b36155eb8ff7d1a7ffc7bdf0ee79df8dcfd4992acac
4
+ data.tar.gz: 3de6ee564d5c055cd5dfdf47a8fa48881555b59ef597bd6e9b4c330426660328
5
5
  SHA512:
6
- metadata.gz: ca85b231eddaac128837177df48c415b94459fb162066f240ae71ebf3a6e0dcfe5089d5b8df62941d7c00cb9071b9d418153ac76a1e8881509d9b131470abd2c
7
- data.tar.gz: 59e170a5aa59b2e9250b692d6e9455f6a4f620a61542c7ad3eec8f76af0c5bdd3f19af0b7fe68a292d0c92a7fdefa74e7b279052c7665cdd6f012004ce053468
6
+ metadata.gz: 1bda1beb236c3486df0d828cb5f0a3818992160e1a35536c8af4224c659880a61592f85ae2e92cf66f72b55ef2b3d3315ef7353ff49518b9db5a0e757abddee1
7
+ data.tar.gz: ce72e6ba229ec21244b1fbaa48cb2ac783c39dd8d90992f12fd452394af8576bbb9a7d5b0670c04c6e2c2aca22a4d91ecffda49becbb79067d008320749f1bac
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.2.0 (2023-04-28)
5
+ ------------------
6
+
7
+ * Feature - Added a new CreateSnapshot API. For the StartSimulation API, SchemaS3Location is now optional, added a new SnapshotS3Location parameter. For the DescribeSimulation API, added SNAPSHOT_IN_PROGRESS simulation state, deprecated SchemaError, added new fields: StartError and SnapshotS3Location.
8
+
4
9
  1.1.0 (2023-01-18)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.1.0
1
+ 1.2.0
@@ -368,6 +368,68 @@ module Aws::SimSpaceWeaver
368
368
 
369
369
  # @!group API Operations
370
370
 
371
+ # Creates a snapshot of the specified simulation. A snapshot is a file
372
+ # that contains simulation state data at a specific time. The state data
373
+ # saved in a snapshot includes entity data from the State Fabric, the
374
+ # simulation configuration specified in the schema, and the clock tick
375
+ # number. You can use the snapshot to initialize a new simulation. For
376
+ # more information about snapshots, see [Snapshots][1] in the *SimSpace
377
+ # Weaver User Guide*.
378
+ #
379
+ # You specify a `Destination` when you create a snapshot. The
380
+ # `Destination` is the name of an Amazon S3 bucket and an optional
381
+ # `ObjectKeyPrefix`. The `ObjectKeyPrefix` is usually the name of a
382
+ # folder in the bucket. SimSpace Weaver creates a `snapshot` folder
383
+ # inside the `Destination` and places the snapshot file there.
384
+ #
385
+ # The snapshot file is an Amazon S3 object. It has an object key with
386
+ # the form: `
387
+ # object-key-prefix/snapshot/simulation-name-YYMMdd-HHmm-ss.zip`, where:
388
+ #
389
+ # * ` YY ` is the 2-digit year
390
+ #
391
+ # * ` MM ` is the 2-digit month
392
+ #
393
+ # * ` dd ` is the 2-digit day of the month
394
+ #
395
+ # * ` HH ` is the 2-digit hour (24-hour clock)
396
+ #
397
+ # * ` mm ` is the 2-digit minutes
398
+ #
399
+ # * ` ss ` is the 2-digit seconds
400
+ #
401
+ #
402
+ #
403
+ # [1]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/working-with_snapshots.html
404
+ #
405
+ # @option params [required, Types::S3Destination] :destination
406
+ # The Amazon S3 bucket and optional folder (object key prefix) where
407
+ # SimSpace Weaver creates the snapshot file.
408
+ #
409
+ # @option params [required, String] :simulation
410
+ # The name of the simulation.
411
+ #
412
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
413
+ #
414
+ # @example Request syntax with placeholder values
415
+ #
416
+ # resp = client.create_snapshot({
417
+ # destination: { # required
418
+ # bucket_name: "BucketName",
419
+ # object_key_prefix: "ObjectKeyPrefix",
420
+ # },
421
+ # simulation: "SimSpaceWeaverResourceName", # required
422
+ # })
423
+ #
424
+ # @see http://docs.aws.amazon.com/goto/WebAPI/simspaceweaver-2022-10-28/CreateSnapshot AWS API Documentation
425
+ #
426
+ # @overload create_snapshot(params = {})
427
+ # @param [Hash] params ({})
428
+ def create_snapshot(params = {}, options = {})
429
+ req = build_request(:create_snapshot, params)
430
+ req.send_request(options)
431
+ end
432
+
371
433
  # Deletes the instance of the given custom app.
372
434
  #
373
435
  # @option params [required, String] :app
@@ -401,9 +463,8 @@ module Aws::SimSpaceWeaver
401
463
  # Deletes all SimSpace Weaver resources assigned to the given
402
464
  # simulation.
403
465
  #
404
- # <note markdown="1"> Your simulation uses resources in other Amazon Web Services services.
405
- # This API operation doesn't delete resources in other Amazon Web
406
- # Services services.
466
+ # <note markdown="1"> Your simulation uses resources in other Amazon Web Services. This API
467
+ # operation doesn't delete resources in other Amazon Web Services.
407
468
  #
408
469
  # </note>
409
470
  #
@@ -452,7 +513,7 @@ module Aws::SimSpaceWeaver
452
513
  # @example Request syntax with placeholder values
453
514
  #
454
515
  # resp = client.describe_app({
455
- # app: "SimSpaceWeaverResourceName", # required
516
+ # app: "SimSpaceWeaverLongResourceName", # required
456
517
  # domain: "SimSpaceWeaverResourceName", # required
457
518
  # simulation: "SimSpaceWeaverResourceName", # required
458
519
  # })
@@ -499,6 +560,8 @@ module Aws::SimSpaceWeaver
499
560
  # * {Types::DescribeSimulationOutput#role_arn #role_arn} => String
500
561
  # * {Types::DescribeSimulationOutput#schema_error #schema_error} => String
501
562
  # * {Types::DescribeSimulationOutput#schema_s3_location #schema_s3_location} => Types::S3Location
563
+ # * {Types::DescribeSimulationOutput#snapshot_s3_location #snapshot_s3_location} => Types::S3Location
564
+ # * {Types::DescribeSimulationOutput#start_error #start_error} => String
502
565
  # * {Types::DescribeSimulationOutput#status #status} => String
503
566
  # * {Types::DescribeSimulationOutput#target_status #target_status} => String
504
567
  #
@@ -528,7 +591,10 @@ module Aws::SimSpaceWeaver
528
591
  # resp.schema_error #=> String
529
592
  # resp.schema_s3_location.bucket_name #=> String
530
593
  # resp.schema_s3_location.object_key #=> String
531
- # resp.status #=> String, one of "UNKNOWN", "STARTING", "STARTED", "STOPPING", "STOPPED", "FAILED", "DELETING", "DELETED"
594
+ # resp.snapshot_s3_location.bucket_name #=> String
595
+ # resp.snapshot_s3_location.object_key #=> String
596
+ # resp.start_error #=> String
597
+ # resp.status #=> String, one of "UNKNOWN", "STARTING", "STARTED", "STOPPING", "STOPPED", "FAILED", "DELETING", "DELETED", "SNAPSHOT_IN_PROGRESS"
532
598
  # resp.target_status #=> String, one of "UNKNOWN", "STARTED", "STOPPED", "DELETED"
533
599
  #
534
600
  # @see http://docs.aws.amazon.com/goto/WebAPI/simspaceweaver-2022-10-28/DescribeSimulation AWS API Documentation
@@ -550,13 +616,13 @@ module Aws::SimSpaceWeaver
550
616
  # The maximum number of apps to list.
551
617
  #
552
618
  # @option params [String] :next_token
553
- # If SimSpace Weaver returns `nextToken`, there are more results
619
+ # If SimSpace Weaver returns `nextToken`, then there are more results
554
620
  # available. The value of `nextToken` is a unique pagination token for
555
621
  # each page. To retrieve the next page, call the operation again using
556
622
  # the returned token. Keep all other arguments unchanged. If no results
557
- # remain, `nextToken` is set to `null`. Each pagination token expires
558
- # after 24 hours. If you provide a token that isn't valid, you receive
559
- # an *HTTP 400 ValidationException* error.
623
+ # remain, then `nextToken` is set to `null`. Each pagination token
624
+ # expires after 24 hours. If you provide a token that isn't valid, then
625
+ # you receive an *HTTP 400 ValidationException* error.
560
626
  #
561
627
  # @option params [required, String] :simulation
562
628
  # The name of the simulation that you want to list apps for.
@@ -603,13 +669,13 @@ module Aws::SimSpaceWeaver
603
669
  # The maximum number of simulations to list.
604
670
  #
605
671
  # @option params [String] :next_token
606
- # If SimSpace Weaver returns `nextToken`, there are more results
672
+ # If SimSpace Weaver returns `nextToken`, then there are more results
607
673
  # available. The value of `nextToken` is a unique pagination token for
608
674
  # each page. To retrieve the next page, call the operation again using
609
675
  # the returned token. Keep all other arguments unchanged. If no results
610
- # remain, `nextToken` is set to `null`. Each pagination token expires
611
- # after 24 hours. If you provide a token that isn't valid, you receive
612
- # an *HTTP 400 ValidationException* error.
676
+ # remain, then `nextToken` is set to `null`. Each pagination token
677
+ # expires after 24 hours. If you provide a token that isn't valid, then
678
+ # you receive an *HTTP 400 ValidationException* error.
613
679
  #
614
680
  # @return [Types::ListSimulationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
615
681
  #
@@ -632,7 +698,7 @@ module Aws::SimSpaceWeaver
632
698
  # resp.simulations[0].arn #=> String
633
699
  # resp.simulations[0].creation_time #=> Time
634
700
  # resp.simulations[0].name #=> String
635
- # resp.simulations[0].status #=> String, one of "UNKNOWN", "STARTING", "STARTED", "STOPPING", "STOPPED", "FAILED", "DELETING", "DELETED"
701
+ # resp.simulations[0].status #=> String, one of "UNKNOWN", "STARTING", "STARTED", "STOPPING", "STOPPED", "FAILED", "DELETING", "DELETED", "SNAPSHOT_IN_PROGRESS"
636
702
  # resp.simulations[0].target_status #=> String, one of "UNKNOWN", "STARTED", "STOPPED", "DELETED"
637
703
  #
638
704
  # @see http://docs.aws.amazon.com/goto/WebAPI/simspaceweaver-2022-10-28/ListSimulations AWS API Documentation
@@ -698,8 +764,8 @@ module Aws::SimSpaceWeaver
698
764
  # The name of the domain of the app.
699
765
  #
700
766
  # @option params [Types::LaunchOverrides] :launch_overrides
701
- # Options that apply when the app starts. These optiAons override
702
- # default behavior.
767
+ # Options that apply when the app starts. These options override default
768
+ # behavior.
703
769
  #
704
770
  # @option params [required, String] :name
705
771
  # The name of the app.
@@ -763,7 +829,16 @@ module Aws::SimSpaceWeaver
763
829
  req.send_request(options)
764
830
  end
765
831
 
766
- # Starts a simulation with the given name and schema.
832
+ # Starts a simulation with the given name. You must choose to start your
833
+ # simulation from a schema or from a snapshot. For more information
834
+ # about the schema, see the [schema reference][1] in the *SimSpace
835
+ # Weaver User Guide*. For more information about snapshots, see
836
+ # [Snapshots][2] in the *SimSpace Weaver User Guide*.
837
+ #
838
+ #
839
+ #
840
+ # [1]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/schema-reference.html
841
+ # [2]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/working-with_snapshots.html
767
842
  #
768
843
  # @option params [String] :client_token
769
844
  # A value that you provide to ensure that repeated calls to this API
@@ -779,8 +854,11 @@ module Aws::SimSpaceWeaver
779
854
  #
780
855
  # @option params [String] :maximum_duration
781
856
  # The maximum running time of the simulation, specified as a number of
782
- # months (m or M), hours (h or H), or days (d or D). The simulation
783
- # stops when it reaches this limit.
857
+ # minutes (m or M), hours (h or H), or days (d or D). The simulation
858
+ # stops when it reaches this limit. The maximum value is `14D`, or its
859
+ # equivalent in the other units. The default value is `14D`. A value
860
+ # equivalent to `0` makes the simulation immediately transition to
861
+ # `Stopping` as soon as it reaches `Started`.
784
862
  #
785
863
  # @option params [required, String] :name
786
864
  # The name of the simulation.
@@ -798,11 +876,31 @@ module Aws::SimSpaceWeaver
798
876
  # [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
799
877
  # [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html
800
878
  #
801
- # @option params [required, Types::S3Location] :schema_s3_location
879
+ # @option params [Types::S3Location] :schema_s3_location
802
880
  # The location of the simulation schema in Amazon Simple Storage Service
803
881
  # (Amazon S3). For more information about Amazon S3, see the [ *Amazon
804
882
  # Simple Storage Service User Guide* ][1].
805
883
  #
884
+ # Provide a `SchemaS3Location` to start your simulation from a schema.
885
+ #
886
+ # If you provide a `SchemaS3Location` then you can't provide a
887
+ # `SnapshotS3Location`.
888
+ #
889
+ #
890
+ #
891
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html
892
+ #
893
+ # @option params [Types::S3Location] :snapshot_s3_location
894
+ # The location of the snapshot .zip file in Amazon Simple Storage
895
+ # Service (Amazon S3). For more information about Amazon S3, see the [
896
+ # *Amazon Simple Storage Service User Guide* ][1].
897
+ #
898
+ # Provide a `SnapshotS3Location` to start your simulation from a
899
+ # snapshot.
900
+ #
901
+ # If you provide a `SnapshotS3Location` then you can't provide a
902
+ # `SchemaS3Location`.
903
+ #
806
904
  #
807
905
  #
808
906
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html
@@ -830,7 +928,11 @@ module Aws::SimSpaceWeaver
830
928
  # maximum_duration: "TimeToLiveString",
831
929
  # name: "SimSpaceWeaverResourceName", # required
832
930
  # role_arn: "RoleArn", # required
833
- # schema_s3_location: { # required
931
+ # schema_s3_location: {
932
+ # bucket_name: "BucketName",
933
+ # object_key: "ObjectKey",
934
+ # },
935
+ # snapshot_s3_location: {
834
936
  # bucket_name: "BucketName",
835
937
  # object_key: "ObjectKey",
836
938
  # },
@@ -909,9 +1011,9 @@ module Aws::SimSpaceWeaver
909
1011
 
910
1012
  # Stops the given simulation.
911
1013
  #
912
- # You can't restart a simulation after you stop it. If you need to
913
- # restart a simulation, you must stop it, delete it, and start a new
914
- # instance of it.
1014
+ # You can't restart a simulation after you stop it. If you want to
1015
+ # restart a simulation, then you must stop it, delete it, and start a
1016
+ # new instance of it.
915
1017
  #
916
1018
  # @option params [required, String] :simulation
917
1019
  # The name of the simulation.
@@ -1024,7 +1126,7 @@ module Aws::SimSpaceWeaver
1024
1126
  params: params,
1025
1127
  config: config)
1026
1128
  context[:gem_name] = 'aws-sdk-simspaceweaver'
1027
- context[:gem_version] = '1.1.0'
1129
+ context[:gem_version] = '1.2.0'
1028
1130
  Seahorse::Client::Request.new(handlers, context)
1029
1131
  end
1030
1132
 
@@ -21,6 +21,8 @@ module Aws::SimSpaceWeaver
21
21
  ClockTargetStatus = Shapes::StringShape.new(name: 'ClockTargetStatus')
22
22
  CloudWatchLogsLogGroup = Shapes::StructureShape.new(name: 'CloudWatchLogsLogGroup')
23
23
  ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
24
+ CreateSnapshotInput = Shapes::StructureShape.new(name: 'CreateSnapshotInput')
25
+ CreateSnapshotOutput = Shapes::StructureShape.new(name: 'CreateSnapshotOutput')
24
26
  DeleteAppInput = Shapes::StructureShape.new(name: 'DeleteAppInput')
25
27
  DeleteAppOutput = Shapes::StructureShape.new(name: 'DeleteAppOutput')
26
28
  DeleteSimulationInput = Shapes::StructureShape.new(name: 'DeleteSimulationInput')
@@ -49,14 +51,17 @@ module Aws::SimSpaceWeaver
49
51
  LoggingConfiguration = Shapes::StructureShape.new(name: 'LoggingConfiguration')
50
52
  NonEmptyString = Shapes::StringShape.new(name: 'NonEmptyString')
51
53
  ObjectKey = Shapes::StringShape.new(name: 'ObjectKey')
54
+ ObjectKeyPrefix = Shapes::StringShape.new(name: 'ObjectKeyPrefix')
52
55
  OptionalString = Shapes::StringShape.new(name: 'OptionalString')
53
56
  PortNumber = Shapes::IntegerShape.new(name: 'PortNumber')
54
57
  PositiveInteger = Shapes::IntegerShape.new(name: 'PositiveInteger')
55
58
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
56
59
  RoleArn = Shapes::StringShape.new(name: 'RoleArn')
60
+ S3Destination = Shapes::StructureShape.new(name: 'S3Destination')
57
61
  S3Location = Shapes::StructureShape.new(name: 'S3Location')
58
62
  ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
59
63
  SimSpaceWeaverArn = Shapes::StringShape.new(name: 'SimSpaceWeaverArn')
64
+ SimSpaceWeaverLongResourceName = Shapes::StringShape.new(name: 'SimSpaceWeaverLongResourceName')
60
65
  SimSpaceWeaverResourceName = Shapes::StringShape.new(name: 'SimSpaceWeaverResourceName')
61
66
  SimulationAppEndpointInfo = Shapes::StructureShape.new(name: 'SimulationAppEndpointInfo')
62
67
  SimulationAppList = Shapes::ListShape.new(name: 'SimulationAppList')
@@ -107,6 +112,12 @@ module Aws::SimSpaceWeaver
107
112
  ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "Message"))
108
113
  ConflictException.struct_class = Types::ConflictException
109
114
 
115
+ CreateSnapshotInput.add_member(:destination, Shapes::ShapeRef.new(shape: S3Destination, required: true, location_name: "Destination"))
116
+ CreateSnapshotInput.add_member(:simulation, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, required: true, location_name: "Simulation"))
117
+ CreateSnapshotInput.struct_class = Types::CreateSnapshotInput
118
+
119
+ CreateSnapshotOutput.struct_class = Types::CreateSnapshotOutput
120
+
110
121
  DeleteAppInput.add_member(:app, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, required: true, location: "querystring", location_name: "app"))
111
122
  DeleteAppInput.add_member(:domain, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, required: true, location: "querystring", location_name: "domain"))
112
123
  DeleteAppInput.add_member(:simulation, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, required: true, location: "querystring", location_name: "simulation"))
@@ -119,7 +130,7 @@ module Aws::SimSpaceWeaver
119
130
 
120
131
  DeleteSimulationOutput.struct_class = Types::DeleteSimulationOutput
121
132
 
122
- DescribeAppInput.add_member(:app, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, required: true, location: "querystring", location_name: "app"))
133
+ DescribeAppInput.add_member(:app, Shapes::ShapeRef.new(shape: SimSpaceWeaverLongResourceName, required: true, location: "querystring", location_name: "app"))
123
134
  DescribeAppInput.add_member(:domain, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, required: true, location: "querystring", location_name: "domain"))
124
135
  DescribeAppInput.add_member(:simulation, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, required: true, location: "querystring", location_name: "simulation"))
125
136
  DescribeAppInput.struct_class = Types::DescribeAppInput
@@ -128,7 +139,7 @@ module Aws::SimSpaceWeaver
128
139
  DescribeAppOutput.add_member(:domain, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, location_name: "Domain"))
129
140
  DescribeAppOutput.add_member(:endpoint_info, Shapes::ShapeRef.new(shape: SimulationAppEndpointInfo, location_name: "EndpointInfo"))
130
141
  DescribeAppOutput.add_member(:launch_overrides, Shapes::ShapeRef.new(shape: LaunchOverrides, location_name: "LaunchOverrides"))
131
- DescribeAppOutput.add_member(:name, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, location_name: "Name"))
142
+ DescribeAppOutput.add_member(:name, Shapes::ShapeRef.new(shape: SimSpaceWeaverLongResourceName, location_name: "Name"))
132
143
  DescribeAppOutput.add_member(:simulation, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, location_name: "Simulation"))
133
144
  DescribeAppOutput.add_member(:status, Shapes::ShapeRef.new(shape: SimulationAppStatus, location_name: "Status"))
134
145
  DescribeAppOutput.add_member(:target_status, Shapes::ShapeRef.new(shape: SimulationAppTargetStatus, location_name: "TargetStatus"))
@@ -146,8 +157,10 @@ module Aws::SimSpaceWeaver
146
157
  DescribeSimulationOutput.add_member(:maximum_duration, Shapes::ShapeRef.new(shape: TimeToLiveString, location_name: "MaximumDuration"))
147
158
  DescribeSimulationOutput.add_member(:name, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, location_name: "Name"))
148
159
  DescribeSimulationOutput.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "RoleArn"))
149
- DescribeSimulationOutput.add_member(:schema_error, Shapes::ShapeRef.new(shape: OptionalString, location_name: "SchemaError"))
160
+ DescribeSimulationOutput.add_member(:schema_error, Shapes::ShapeRef.new(shape: OptionalString, deprecated: true, location_name: "SchemaError", metadata: {"deprecatedMessage"=>"SchemaError is no longer used, check StartError instead."}))
150
161
  DescribeSimulationOutput.add_member(:schema_s3_location, Shapes::ShapeRef.new(shape: S3Location, location_name: "SchemaS3Location"))
162
+ DescribeSimulationOutput.add_member(:snapshot_s3_location, Shapes::ShapeRef.new(shape: S3Location, location_name: "SnapshotS3Location"))
163
+ DescribeSimulationOutput.add_member(:start_error, Shapes::ShapeRef.new(shape: OptionalString, location_name: "StartError"))
151
164
  DescribeSimulationOutput.add_member(:status, Shapes::ShapeRef.new(shape: SimulationStatus, location_name: "Status"))
152
165
  DescribeSimulationOutput.add_member(:target_status, Shapes::ShapeRef.new(shape: SimulationTargetStatus, location_name: "TargetStatus"))
153
166
  DescribeSimulationOutput.struct_class = Types::DescribeSimulationOutput
@@ -205,6 +218,10 @@ module Aws::SimSpaceWeaver
205
218
  ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "Message"))
206
219
  ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
207
220
 
221
+ S3Destination.add_member(:bucket_name, Shapes::ShapeRef.new(shape: BucketName, location_name: "BucketName"))
222
+ S3Destination.add_member(:object_key_prefix, Shapes::ShapeRef.new(shape: ObjectKeyPrefix, location_name: "ObjectKeyPrefix"))
223
+ S3Destination.struct_class = Types::S3Destination
224
+
208
225
  S3Location.add_member(:bucket_name, Shapes::ShapeRef.new(shape: BucketName, location_name: "BucketName"))
209
226
  S3Location.add_member(:object_key, Shapes::ShapeRef.new(shape: ObjectKey, location_name: "ObjectKey"))
210
227
  S3Location.struct_class = Types::S3Location
@@ -219,7 +236,7 @@ module Aws::SimSpaceWeaver
219
236
  SimulationAppList.member = Shapes::ShapeRef.new(shape: SimulationAppMetadata)
220
237
 
221
238
  SimulationAppMetadata.add_member(:domain, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, location_name: "Domain"))
222
- SimulationAppMetadata.add_member(:name, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, location_name: "Name"))
239
+ SimulationAppMetadata.add_member(:name, Shapes::ShapeRef.new(shape: SimSpaceWeaverLongResourceName, location_name: "Name"))
223
240
  SimulationAppMetadata.add_member(:simulation, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, location_name: "Simulation"))
224
241
  SimulationAppMetadata.add_member(:status, Shapes::ShapeRef.new(shape: SimulationAppStatus, location_name: "Status"))
225
242
  SimulationAppMetadata.add_member(:target_status, Shapes::ShapeRef.new(shape: SimulationAppTargetStatus, location_name: "TargetStatus"))
@@ -267,7 +284,8 @@ module Aws::SimSpaceWeaver
267
284
  StartSimulationInput.add_member(:maximum_duration, Shapes::ShapeRef.new(shape: TimeToLiveString, location_name: "MaximumDuration"))
268
285
  StartSimulationInput.add_member(:name, Shapes::ShapeRef.new(shape: SimSpaceWeaverResourceName, required: true, location_name: "Name"))
269
286
  StartSimulationInput.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "RoleArn"))
270
- StartSimulationInput.add_member(:schema_s3_location, Shapes::ShapeRef.new(shape: S3Location, required: true, location_name: "SchemaS3Location"))
287
+ StartSimulationInput.add_member(:schema_s3_location, Shapes::ShapeRef.new(shape: S3Location, location_name: "SchemaS3Location"))
288
+ StartSimulationInput.add_member(:snapshot_s3_location, Shapes::ShapeRef.new(shape: S3Location, location_name: "SnapshotS3Location"))
271
289
  StartSimulationInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
272
290
  StartSimulationInput.struct_class = Types::StartSimulationInput
273
291
 
@@ -334,6 +352,19 @@ module Aws::SimSpaceWeaver
334
352
  "uid" => "simspaceweaver-2022-10-28",
335
353
  }
336
354
 
355
+ api.add_operation(:create_snapshot, Seahorse::Model::Operation.new.tap do |o|
356
+ o.name = "CreateSnapshot"
357
+ o.http_method = "POST"
358
+ o.http_request_uri = "/createsnapshot"
359
+ o.input = Shapes::ShapeRef.new(shape: CreateSnapshotInput)
360
+ o.output = Shapes::ShapeRef.new(shape: CreateSnapshotOutput)
361
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
362
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
363
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
364
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
365
+ o.errors << Shapes::ShapeRef.new(shape: ConflictException)
366
+ end)
367
+
337
368
  api.add_operation(:delete_app, Seahorse::Model::Operation.new.tap do |o|
338
369
  o.name = "DeleteApp"
339
370
  o.http_method = "DELETE"
@@ -14,36 +14,39 @@ module Aws::SimSpaceWeaver
14
14
  use_dual_stack = parameters.use_dual_stack
15
15
  use_fips = parameters.use_fips
16
16
  endpoint = parameters.endpoint
17
- if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
18
- if Aws::Endpoints::Matchers.set?(endpoint) && (url = Aws::Endpoints::Matchers.parse_url(endpoint))
19
- if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
20
- raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
21
- end
22
- if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
23
- raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
24
- end
25
- return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
26
- end
27
- if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
28
- if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
29
- return Aws::Endpoints::Endpoint.new(url: "https://simspaceweaver-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
30
- end
31
- raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
32
- end
17
+ if Aws::Endpoints::Matchers.set?(endpoint)
33
18
  if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
34
- if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
35
- return Aws::Endpoints::Endpoint.new(url: "https://simspaceweaver-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
36
- end
37
- raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
19
+ raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
38
20
  end
39
21
  if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
40
- if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
41
- return Aws::Endpoints::Endpoint.new(url: "https://simspaceweaver.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
22
+ raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
23
+ end
24
+ return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
25
+ end
26
+ if Aws::Endpoints::Matchers.set?(region)
27
+ if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
28
+ if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
29
+ if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
30
+ return Aws::Endpoints::Endpoint.new(url: "https://simspaceweaver-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
31
+ end
32
+ raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
33
+ end
34
+ if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
35
+ if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
36
+ return Aws::Endpoints::Endpoint.new(url: "https://simspaceweaver-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
37
+ end
38
+ raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
39
+ end
40
+ if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
41
+ if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
42
+ return Aws::Endpoints::Endpoint.new(url: "https://simspaceweaver.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
43
+ end
44
+ raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
42
45
  end
43
- raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
46
+ return Aws::Endpoints::Endpoint.new(url: "https://simspaceweaver.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
44
47
  end
45
- return Aws::Endpoints::Endpoint.new(url: "https://simspaceweaver.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
46
48
  end
49
+ raise ArgumentError, "Invalid Configuration: Missing Region"
47
50
  raise ArgumentError, 'No endpoint could be resolved'
48
51
 
49
52
  end
@@ -11,6 +11,20 @@
11
11
  module Aws::SimSpaceWeaver
12
12
  module Endpoints
13
13
 
14
+ class CreateSnapshot
15
+ def self.build(context)
16
+ unless context.config.regional_endpoint
17
+ endpoint = context.config.endpoint.to_s
18
+ end
19
+ Aws::SimSpaceWeaver::EndpointParameters.new(
20
+ region: context.config.region,
21
+ use_dual_stack: context.config.use_dualstack_endpoint,
22
+ use_fips: context.config.use_fips_endpoint,
23
+ endpoint: endpoint,
24
+ )
25
+ end
26
+ end
27
+
14
28
  class DeleteApp
15
29
  def self.build(context)
16
30
  unless context.config.regional_endpoint
@@ -56,6 +56,8 @@ module Aws::SimSpaceWeaver
56
56
 
57
57
  def parameters_for_operation(context)
58
58
  case context.operation_name
59
+ when :create_snapshot
60
+ Aws::SimSpaceWeaver::Endpoints::CreateSnapshot.build(context)
59
61
  when :delete_app
60
62
  Aws::SimSpaceWeaver::Endpoints::DeleteApp.build(context)
61
63
  when :delete_simulation
@@ -62,6 +62,28 @@ module Aws::SimSpaceWeaver
62
62
  include Aws::Structure
63
63
  end
64
64
 
65
+ # @!attribute [rw] destination
66
+ # The Amazon S3 bucket and optional folder (object key prefix) where
67
+ # SimSpace Weaver creates the snapshot file.
68
+ # @return [Types::S3Destination]
69
+ #
70
+ # @!attribute [rw] simulation
71
+ # The name of the simulation.
72
+ # @return [String]
73
+ #
74
+ # @see http://docs.aws.amazon.com/goto/WebAPI/simspaceweaver-2022-10-28/CreateSnapshotInput AWS API Documentation
75
+ #
76
+ class CreateSnapshotInput < Struct.new(
77
+ :destination,
78
+ :simulation)
79
+ SENSITIVE = []
80
+ include Aws::Structure
81
+ end
82
+
83
+ # @see http://docs.aws.amazon.com/goto/WebAPI/simspaceweaver-2022-10-28/CreateSnapshotOutput AWS API Documentation
84
+ #
85
+ class CreateSnapshotOutput < Aws::EmptyStructure; end
86
+
65
87
  # @!attribute [rw] app
66
88
  # The name of the app.
67
89
  # @return [String]
@@ -140,7 +162,7 @@ module Aws::SimSpaceWeaver
140
162
  # @return [Types::SimulationAppEndpointInfo]
141
163
  #
142
164
  # @!attribute [rw] launch_overrides
143
- # Options that apply when the app starts. These optiAons override
165
+ # Options that apply when the app starts. These options override
144
166
  # default behavior.
145
167
  # @return [Types::LaunchOverrides]
146
168
  #
@@ -223,8 +245,11 @@ module Aws::SimSpaceWeaver
223
245
  #
224
246
  # @!attribute [rw] maximum_duration
225
247
  # The maximum running time of the simulation, specified as a number of
226
- # months (m or M), hours (h or H), or days (d or D). The simulation
227
- # stops when it reaches this limit.
248
+ # minutes (m or M), hours (h or H), or days (d or D). The simulation
249
+ # stops when it reaches this limit. The maximum value is `14D`, or its
250
+ # equivalent in the other units. The default value is `14D`. A value
251
+ # equivalent to `0` makes the simulation immediately transition to
252
+ # `Stopping` as soon as it reaches `Started`.
228
253
  # @return [String]
229
254
  #
230
255
  # @!attribute [rw] name
@@ -260,6 +285,22 @@ module Aws::SimSpaceWeaver
260
285
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html
261
286
  # @return [Types::S3Location]
262
287
  #
288
+ # @!attribute [rw] snapshot_s3_location
289
+ # A location in Amazon Simple Storage Service (Amazon S3) where
290
+ # SimSpace Weaver stores simulation data, such as your app .zip files
291
+ # and schema file. For more information about Amazon S3, see the [
292
+ # *Amazon Simple Storage Service User Guide* ][1].
293
+ #
294
+ #
295
+ #
296
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html
297
+ # @return [Types::S3Location]
298
+ #
299
+ # @!attribute [rw] start_error
300
+ # An error message that SimSpace Weaver returns only if a problem
301
+ # occurs when the simulation is in the `STARTING` state.
302
+ # @return [String]
303
+ #
263
304
  # @!attribute [rw] status
264
305
  # The current lifecycle state of the simulation.
265
306
  # @return [String]
@@ -282,6 +323,8 @@ module Aws::SimSpaceWeaver
282
323
  :role_arn,
283
324
  :schema_error,
284
325
  :schema_s3_location,
326
+ :snapshot_s3_location,
327
+ :start_error,
285
328
  :status,
286
329
  :target_status)
287
330
  SENSITIVE = []
@@ -291,33 +334,29 @@ module Aws::SimSpaceWeaver
291
334
  # A collection of app instances that run the same executable app code
292
335
  # and have the same launch options and commands.
293
336
  #
294
- # For more information about domains, see [Key concepts][1] in the
295
- # *Amazon Web Services SimSpace Weaver User Guide*.
337
+ # For more information about domains, see [Key concepts: Domains][1] in
338
+ # the *SimSpace Weaver User Guide*.
296
339
  #
297
340
  #
298
341
  #
299
- # [1]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/what-is_key-concepts.html
342
+ # [1]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/what-is_key-concepts.html#what-is_key-concepts_domains
300
343
  #
301
344
  # @!attribute [rw] lifecycle
302
- # The type of lifecycle management for apps in the domain. This value
303
- # indicates whether apps in this domain are *managed* (SimSpace Weaver
304
- # starts and stops the apps) or *unmanaged* (you must start and stop
305
- # the apps).
345
+ # The type of lifecycle management for apps in the domain. Indicates
346
+ # whether apps in this domain are *managed* (SimSpace Weaver starts
347
+ # and stops the apps) or *unmanaged* (you must start and stop the
348
+ # apps).
306
349
  #
307
350
  # **Lifecycle types**
308
351
  #
309
- # * `PerWorker` – Managed: SimSpace Weaver starts 1 app on each worker
310
- #
311
- # * `BySpatialSubdivision` – Managed: SimSpace Weaver starts 1 app for
312
- # each spatial partition
313
- #
314
- # * `ByRequest` – Unmanaged: You use the **StartApp** API to start the
315
- # apps and use the **StopApp** API to stop the apps.
352
+ # * `PerWorker` – Managed: SimSpace Weaver starts one app on each
353
+ # worker.
316
354
  #
317
- # <note markdown="1"> The lifecycle types will change when the service is released for
318
- # general availability (GA).
355
+ # * `BySpatialSubdivision` Managed: SimSpace Weaver starts one app
356
+ # for each spatial partition.
319
357
  #
320
- # </note>
358
+ # * `ByRequest` – Unmanaged: You use the `StartApp` API to start the
359
+ # apps and use the `StopApp` API to stop the apps.
321
360
  # @return [String]
322
361
  #
323
362
  # @!attribute [rw] name
@@ -344,8 +383,8 @@ module Aws::SimSpaceWeaver
344
383
  include Aws::Structure
345
384
  end
346
385
 
347
- # Options that apply when the app starts. These optiAons override
348
- # default behavior.
386
+ # Options that apply when the app starts. These options override default
387
+ # behavior.
349
388
  #
350
389
  # @!attribute [rw] launch_commands
351
390
  # App launch commands and command line parameters that override the
@@ -369,13 +408,13 @@ module Aws::SimSpaceWeaver
369
408
  # @return [Integer]
370
409
  #
371
410
  # @!attribute [rw] next_token
372
- # If SimSpace Weaver returns `nextToken`, there are more results
411
+ # If SimSpace Weaver returns `nextToken`, then there are more results
373
412
  # available. The value of `nextToken` is a unique pagination token for
374
413
  # each page. To retrieve the next page, call the operation again using
375
414
  # the returned token. Keep all other arguments unchanged. If no
376
- # results remain, `nextToken` is set to `null`. Each pagination token
377
- # expires after 24 hours. If you provide a token that isn't valid,
378
- # you receive an *HTTP 400 ValidationException* error.
415
+ # results remain, then `nextToken` is set to `null`. Each pagination
416
+ # token expires after 24 hours. If you provide a token that isn't
417
+ # valid, then you receive an *HTTP 400 ValidationException* error.
379
418
  # @return [String]
380
419
  #
381
420
  # @!attribute [rw] simulation
@@ -398,13 +437,13 @@ module Aws::SimSpaceWeaver
398
437
  # @return [Array<Types::SimulationAppMetadata>]
399
438
  #
400
439
  # @!attribute [rw] next_token
401
- # If SimSpace Weaver returns `nextToken`, there are more results
440
+ # If SimSpace Weaver returns `nextToken`, then there are more results
402
441
  # available. The value of `nextToken` is a unique pagination token for
403
442
  # each page. To retrieve the next page, call the operation again using
404
443
  # the returned token. Keep all other arguments unchanged. If no
405
- # results remain, `nextToken` is set to `null`. Each pagination token
406
- # expires after 24 hours. If you provide a token that isn't valid,
407
- # you receive an *HTTP 400 ValidationException* error.
444
+ # results remain, then `nextToken` is set to `null`. Each pagination
445
+ # token expires after 24 hours. If you provide a token that isn't
446
+ # valid, then you receive an *HTTP 400 ValidationException* error.
408
447
  # @return [String]
409
448
  #
410
449
  # @see http://docs.aws.amazon.com/goto/WebAPI/simspaceweaver-2022-10-28/ListAppsOutput AWS API Documentation
@@ -421,13 +460,13 @@ module Aws::SimSpaceWeaver
421
460
  # @return [Integer]
422
461
  #
423
462
  # @!attribute [rw] next_token
424
- # If SimSpace Weaver returns `nextToken`, there are more results
463
+ # If SimSpace Weaver returns `nextToken`, then there are more results
425
464
  # available. The value of `nextToken` is a unique pagination token for
426
465
  # each page. To retrieve the next page, call the operation again using
427
466
  # the returned token. Keep all other arguments unchanged. If no
428
- # results remain, `nextToken` is set to `null`. Each pagination token
429
- # expires after 24 hours. If you provide a token that isn't valid,
430
- # you receive an *HTTP 400 ValidationException* error.
467
+ # results remain, then `nextToken` is set to `null`. Each pagination
468
+ # token expires after 24 hours. If you provide a token that isn't
469
+ # valid, then you receive an *HTTP 400 ValidationException* error.
431
470
  # @return [String]
432
471
  #
433
472
  # @see http://docs.aws.amazon.com/goto/WebAPI/simspaceweaver-2022-10-28/ListSimulationsInput AWS API Documentation
@@ -440,13 +479,13 @@ module Aws::SimSpaceWeaver
440
479
  end
441
480
 
442
481
  # @!attribute [rw] next_token
443
- # If SimSpace Weaver returns `nextToken`, there are more results
482
+ # If SimSpace Weaver returns `nextToken`, then there are more results
444
483
  # available. The value of `nextToken` is a unique pagination token for
445
484
  # each page. To retrieve the next page, call the operation again using
446
485
  # the returned token. Keep all other arguments unchanged. If no
447
- # results remain, `nextToken` is set to `null`. Each pagination token
448
- # expires after 24 hours. If you provide a token that isn't valid,
449
- # you receive an *HTTP 400 ValidationException* error.
486
+ # results remain, then `nextToken` is set to `null`. Each pagination
487
+ # token expires after 24 hours. If you provide a token that isn't
488
+ # valid, then you receive an *HTTP 400 ValidationException* error.
450
489
  # @return [String]
451
490
  #
452
491
  # @!attribute [rw] simulations
@@ -505,12 +544,12 @@ module Aws::SimSpaceWeaver
505
544
  #
506
545
  # @!attribute [rw] domains
507
546
  # A list of domains for the simulation. For more information about
508
- # domains, see [Key concepts][1] in the *Amazon Web Services SimSpace
509
- # Weaver User Guide*.
547
+ # domains, see [Key concepts: Domains][1] in the *SimSpace Weaver User
548
+ # Guide*.
510
549
  #
511
550
  #
512
551
  #
513
- # [1]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/what-is_key-concepts.html
552
+ # [1]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/what-is_key-concepts.html#what-is_key-concepts_domains
514
553
  # @return [Array<Types::Domain>]
515
554
  #
516
555
  # @see http://docs.aws.amazon.com/goto/WebAPI/simspaceweaver-2022-10-28/LiveSimulationState AWS API Documentation
@@ -568,8 +607,41 @@ module Aws::SimSpaceWeaver
568
607
  include Aws::Structure
569
608
  end
570
609
 
610
+ # An Amazon S3 bucket and optional folder (object key prefix) where
611
+ # SimSpace Weaver creates a file.
612
+ #
613
+ # @!attribute [rw] bucket_name
614
+ # The name of an Amazon S3 bucket. For more information about buckets,
615
+ # see [Creating, configuring, and working with Amazon S3 buckets][1]
616
+ # in the *Amazon Simple Storage Service User Guide*.
617
+ #
618
+ #
619
+ #
620
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
621
+ # @return [String]
622
+ #
623
+ # @!attribute [rw] object_key_prefix
624
+ # A string prefix for an Amazon S3 object key. It's usually a folder
625
+ # name. For more information about folders in Amazon S3, see
626
+ # [Organizing objects in the Amazon S3 console using folders][1] in
627
+ # the *Amazon Simple Storage Service User Guide*.
628
+ #
629
+ #
630
+ #
631
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-folders.html
632
+ # @return [String]
633
+ #
634
+ # @see http://docs.aws.amazon.com/goto/WebAPI/simspaceweaver-2022-10-28/S3Destination AWS API Documentation
635
+ #
636
+ class S3Destination < Struct.new(
637
+ :bucket_name,
638
+ :object_key_prefix)
639
+ SENSITIVE = []
640
+ include Aws::Structure
641
+ end
642
+
571
643
  # A location in Amazon Simple Storage Service (Amazon S3) where SimSpace
572
- # Weaver stores simulation data, such as your app zip files and schema
644
+ # Weaver stores simulation data, such as your app .zip files and schema
573
645
  # file. For more information about Amazon S3, see the [ *Amazon Simple
574
646
  # Storage Service User Guide* ][1].
575
647
  #
@@ -619,7 +691,13 @@ module Aws::SimSpaceWeaver
619
691
  end
620
692
 
621
693
  # Information about the network endpoint that you can use to connect to
622
- # your custom or service app.
694
+ # your custom or service app. For more information about SimSpace Weaver
695
+ # apps, see [Key concepts: Apps][1] in the *SimSpace Weaver User
696
+ # Guide*..
697
+ #
698
+ #
699
+ #
700
+ # [1]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/what-is_key-concepts.html#what-is_key-concepts_apps
623
701
  #
624
702
  # @!attribute [rw] address
625
703
  # The IP address of the app. SimSpace Weaver dynamically assigns this
@@ -640,16 +718,15 @@ module Aws::SimSpaceWeaver
640
718
  include Aws::Structure
641
719
  end
642
720
 
643
- # A collection of metadata about an app.
721
+ # A collection of metadata about the app.
644
722
  #
645
723
  # @!attribute [rw] domain
646
724
  # The domain of the app. For more information about domains, see [Key
647
- # concepts][1] in the *Amazon Web Services SimSpace Weaver User
648
- # Guide*.
725
+ # concepts: Domains][1] in the *SimSpace Weaver User Guide*.
649
726
  #
650
727
  #
651
728
  #
652
- # [1]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/what-is_key-concepts.html
729
+ # [1]: https://docs.aws.amazon.com/simspaceweaver/latest/userguide/what-is_key-concepts.html#what-is_key-concepts_domains
653
730
  # @return [String]
654
731
  #
655
732
  # @!attribute [rw] name
@@ -786,7 +863,7 @@ module Aws::SimSpaceWeaver
786
863
  # @return [String]
787
864
  #
788
865
  # @!attribute [rw] launch_overrides
789
- # Options that apply when the app starts. These optiAons override
866
+ # Options that apply when the app starts. These options override
790
867
  # default behavior.
791
868
  # @return [Types::LaunchOverrides]
792
869
  #
@@ -865,8 +942,11 @@ module Aws::SimSpaceWeaver
865
942
  #
866
943
  # @!attribute [rw] maximum_duration
867
944
  # The maximum running time of the simulation, specified as a number of
868
- # months (m or M), hours (h or H), or days (d or D). The simulation
869
- # stops when it reaches this limit.
945
+ # minutes (m or M), hours (h or H), or days (d or D). The simulation
946
+ # stops when it reaches this limit. The maximum value is `14D`, or its
947
+ # equivalent in the other units. The default value is `14D`. A value
948
+ # equivalent to `0` makes the simulation immediately transition to
949
+ # `Stopping` as soon as it reaches `Started`.
870
950
  # @return [String]
871
951
  #
872
952
  # @!attribute [rw] name
@@ -892,6 +972,27 @@ module Aws::SimSpaceWeaver
892
972
  # Service (Amazon S3). For more information about Amazon S3, see the [
893
973
  # *Amazon Simple Storage Service User Guide* ][1].
894
974
  #
975
+ # Provide a `SchemaS3Location` to start your simulation from a schema.
976
+ #
977
+ # If you provide a `SchemaS3Location` then you can't provide a
978
+ # `SnapshotS3Location`.
979
+ #
980
+ #
981
+ #
982
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html
983
+ # @return [Types::S3Location]
984
+ #
985
+ # @!attribute [rw] snapshot_s3_location
986
+ # The location of the snapshot .zip file in Amazon Simple Storage
987
+ # Service (Amazon S3). For more information about Amazon S3, see the [
988
+ # *Amazon Simple Storage Service User Guide* ][1].
989
+ #
990
+ # Provide a `SnapshotS3Location` to start your simulation from a
991
+ # snapshot.
992
+ #
993
+ # If you provide a `SnapshotS3Location` then you can't provide a
994
+ # `SchemaS3Location`.
995
+ #
895
996
  #
896
997
  #
897
998
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html
@@ -916,6 +1017,7 @@ module Aws::SimSpaceWeaver
916
1017
  :name,
917
1018
  :role_arn,
918
1019
  :schema_s3_location,
1020
+ :snapshot_s3_location,
919
1021
  :tags)
920
1022
  SENSITIVE = [:client_token]
921
1023
  include Aws::Structure
@@ -32,7 +32,7 @@ require_relative 'aws-sdk-simspaceweaver/customizations'
32
32
  # structure.
33
33
  #
34
34
  # sim_space_weaver = Aws::SimSpaceWeaver::Client.new
35
- # resp = sim_space_weaver.delete_app(params)
35
+ # resp = sim_space_weaver.create_snapshot(params)
36
36
  #
37
37
  # See {Client} for more information.
38
38
  #
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-simspaceweaver/customizations'
52
52
  # @!group service
53
53
  module Aws::SimSpaceWeaver
54
54
 
55
- GEM_VERSION = '1.1.0'
55
+ GEM_VERSION = '1.2.0'
56
56
 
57
57
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-simspaceweaver
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.0
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-01-18 00:00:00.000000000 Z
11
+ date: 2023-04-28 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core