/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
/*
* Do not modify this file. This file is generated from the simspaceweaver-2022-10-28.normal.json service model.
*/
using System;
using System.Threading;
using System.Threading.Tasks;
using System.Collections.Generic;
using Amazon.Runtime;
using Amazon.SimSpaceWeaver.Model;
namespace Amazon.SimSpaceWeaver
{
///
/// Interface for accessing SimSpaceWeaver
///
/// SimSpace Weaver (SimSpace Weaver) is a managed service that you can use to build and
/// operate large-scale spatial simulations in the Amazon Web Services Cloud. For example,
/// you can create a digital twin of a city, crowd simulations with millions of people
/// and objects, and massively multiplayer games with hundreds of thousands of connected
/// players. For more information about SimSpace Weaver, see the SimSpace
/// Weaver User Guide .
///
///
///
/// This API reference describes the API operations and data types that you can use to
/// communicate directly with SimSpace Weaver.
///
///
///
/// SimSpace Weaver also provides the SimSpace Weaver app SDK, which you use for app development.
/// The SimSpace Weaver app SDK API reference is included in the SimSpace Weaver app SDK
/// documentation. This documentation is part of the SimSpace Weaver app SDK distributable
/// package.
///
///
public partial interface IAmazonSimSpaceWeaver : IAmazonService, IDisposable
{
#if AWS_ASYNC_ENUMERABLES_API
///
/// Paginators for the service
///
ISimSpaceWeaverPaginatorFactory Paginators { get; }
#endif
#region CreateSnapshot
///
/// Creates a snapshot of the specified simulation. A snapshot is a file that contains
/// simulation state data at a specific time. The state data saved in a snapshot includes
/// entity data from the State Fabric, the simulation configuration specified in the schema,
/// and the clock tick number. You can use the snapshot to initialize a new simulation.
/// For more information about snapshots, see Snapshots
/// in the SimSpace Weaver User Guide.
///
///
///
/// You specify a Destination
when you create a snapshot. The Destination
/// is the name of an Amazon S3 bucket and an optional ObjectKeyPrefix
. The
/// ObjectKeyPrefix
is usually the name of a folder in the bucket. SimSpace
/// Weaver creates a snapshot
folder inside the Destination
/// and places the snapshot file there.
///
///
///
/// The snapshot file is an Amazon S3 object. It has an object key with the form:
/// object-key-prefix/snapshot/simulation-name-YYMMdd-HHmm-ss.zip
,
/// where:
///
/// -
///
///
YY
is the 2-digit year
///
/// -
///
///
MM
is the 2-digit month
///
/// -
///
///
dd
is the 2-digit day of the month
///
/// -
///
///
HH
is the 2-digit hour (24-hour clock)
///
/// -
///
///
mm
is the 2-digit minutes
///
/// -
///
///
ss
is the 2-digit seconds
///
///
///
/// Container for the necessary parameters to execute the CreateSnapshot service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the CreateSnapshot service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for CreateSnapshot Operation
Task CreateSnapshotAsync(CreateSnapshotRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region DeleteApp
///
/// Deletes the instance of the given custom app.
///
/// Container for the necessary parameters to execute the DeleteApp service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the DeleteApp service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for DeleteApp Operation
Task DeleteAppAsync(DeleteAppRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region DeleteSimulation
///
/// Deletes all SimSpace Weaver resources assigned to the given simulation.
///
///
///
/// Your simulation uses resources in other Amazon Web Services. This API operation doesn't
/// delete resources in other Amazon Web Services.
///
///
///
/// Container for the necessary parameters to execute the DeleteSimulation service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the DeleteSimulation service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for DeleteSimulation Operation
Task DeleteSimulationAsync(DeleteSimulationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region DescribeApp
///
/// Returns the state of the given custom app.
///
/// Container for the necessary parameters to execute the DescribeApp service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the DescribeApp service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for DescribeApp Operation
Task DescribeAppAsync(DescribeAppRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region DescribeSimulation
///
/// Returns the current state of the given simulation.
///
/// Container for the necessary parameters to execute the DescribeSimulation service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the DescribeSimulation service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for DescribeSimulation Operation
Task DescribeSimulationAsync(DescribeSimulationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region ListApps
///
/// Lists all custom apps or service apps for the given simulation and domain.
///
/// Container for the necessary parameters to execute the ListApps service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the ListApps service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for ListApps Operation
Task ListAppsAsync(ListAppsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region ListSimulations
///
/// Lists the SimSpace Weaver simulations in the Amazon Web Services account used to make
/// the API call.
///
/// Container for the necessary parameters to execute the ListSimulations service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the ListSimulations service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
/// REST API Reference for ListSimulations Operation
Task ListSimulationsAsync(ListSimulationsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region ListTagsForResource
///
/// Lists all tags on a SimSpace Weaver resource.
///
/// Container for the necessary parameters to execute the ListTagsForResource service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the ListTagsForResource service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
/// REST API Reference for ListTagsForResource Operation
Task ListTagsForResourceAsync(ListTagsForResourceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region StartApp
///
/// Starts a custom app with the configuration specified in the simulation schema.
///
/// Container for the necessary parameters to execute the StartApp service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the StartApp service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for StartApp Operation
Task StartAppAsync(StartAppRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region StartClock
///
/// Starts the simulation clock.
///
/// Container for the necessary parameters to execute the StartClock service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the StartClock service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for StartClock Operation
Task StartClockAsync(StartClockRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region StartSimulation
///
/// Starts a simulation with the given name. You must choose to start your simulation
/// from a schema or from a snapshot. For more information about the schema, see the schema
/// reference in the SimSpace Weaver User Guide. For more information about
/// snapshots, see Snapshots
/// in the SimSpace Weaver User Guide.
///
/// Container for the necessary parameters to execute the StartSimulation service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the StartSimulation service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for StartSimulation Operation
Task StartSimulationAsync(StartSimulationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region StopApp
///
/// Stops the given custom app and shuts down all of its allocated compute resources.
///
/// Container for the necessary parameters to execute the StopApp service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the StopApp service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for StopApp Operation
Task StopAppAsync(StopAppRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region StopClock
///
/// Stops the simulation clock.
///
/// Container for the necessary parameters to execute the StopClock service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the StopClock service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for StopClock Operation
Task StopClockAsync(StopClockRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region StopSimulation
///
/// Stops the given simulation.
///
///
///
/// You can't restart a simulation after you stop it. If you want to restart a simulation,
/// then you must stop it, delete it, and start a new instance of it.
///
///
///
/// Container for the necessary parameters to execute the StopSimulation service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the StopSimulation service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
///
///
///
///
///
///
/// REST API Reference for StopSimulation Operation
Task StopSimulationAsync(StopSimulationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region TagResource
///
/// Adds tags to a SimSpace Weaver resource. For more information about tags, see Tagging
/// Amazon Web Services resources in the Amazon Web Services General Reference.
///
/// Container for the necessary parameters to execute the TagResource service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the TagResource service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
///
///
///
/// REST API Reference for TagResource Operation
Task TagResourceAsync(TagResourceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region UntagResource
///
/// Removes tags from a SimSpace Weaver resource. For more information about tags, see
/// Tagging Amazon
/// Web Services resources in the Amazon Web Services General Reference.
///
/// Container for the necessary parameters to execute the UntagResource service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the UntagResource service method, as returned by SimSpaceWeaver.
///
///
///
///
///
///
/// REST API Reference for UntagResource Operation
Task UntagResourceAsync(UntagResourceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken));
#endregion
}
}