步骤 7:获取模拟详细信息 - AWS SimSpace Weaver

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

步骤 7:获取模拟详细信息

SimSpace Weaver 应用程序 SDK 提供了一个帮助程序脚本,其中包含 AWS CLI。通过提供 SimSpace Weaver 服务端点,该脚本简化了对 AWS CLI 的调用。您可以使用此帮助程序脚本来调用 SimSpace Weaver API。DescribeSimulation API 提供有关模拟的详细信息,包括其状态。模拟可处于以下几种状态之一:

模拟生命周期状态
  1. STARTING – 调用 StartSimulation 后的初始状态

  2. STARTED – 所有空间应用程序均已启动且运行状况正常

  3. STOPPING – 调用 StopSimulation 后的初始状态

  4. STOPPED – 所有计算资源均已停止

  5. DELETING – 调用 DeleteSimulation 后的初始状态

  6. DELETED – 所有分配给模拟的资源均已被删除

  7. FAILED – 模拟发生严重错误/故障且已停止

  8. SNAPSHOT_IN_PROGRESS – 正在拍摄快照

Docker
获取模拟详细信息
  1. 如果您没有打开 tools 文件夹,请转到项目和平台的 tools 文件夹。您的 project-folderpath\project-name,它使用您在创建项目时提供的值。

    Windows 命令提示符下,输入:

    cd project-folder\tools\windows
  2. 使用 CLI 帮助程序脚本调用 ListSimulations API。

    .\weaver-project-name-cli.bat list-simulations
    重要

    对于 AWS Command Line Interface (AWS CLI),如果您使用 AWS IAM Identity Center 或命令配置文件,则必须使用 SimSpace Weaver 应用程序 SDK 版本 1.12.1 或更高版本。最新版本是 1.16.0。有关 SimSpace Weaver 版本的信息,请参阅SimSpace Weaver 版本。SimSpace Weaver 应用程序 SDK 脚本使用 AWS CLI。如果您使用 IAM Identity Center,则可以将 AWS CLI 的 IAM Identity Center 配置文件复制到您的 default 配置文件中,也可以使用 --profile cli-profile-name 参数将您的 IAM Identity Center 配置文件名称提供给 SimSpace Weaver 应用程序 SDK 脚本。有关更多信息,请参阅《AWS Command Line Interface 用户指南》中的配置 AWS CLI 以使用 AWS IAM Identity Center,以及《AWS Command Line Interface 用户指南》中的配置和凭证文件设置

    该脚本应显示有关您的每个模拟的详细信息,类似于以下内容:

    {
        "Status": "STARTED",
        "CreationTime": 1664921418.09,
        "Name": "MyProjectSimulation_22-10-04_22_10_15",
        "Arn": "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MyProjectSimulation_22-10-04_22_10_15",
        "TargetStatus": "STARTED"
    }
    
  3. 调用 DescribeSimulation 以获取模拟详细信息。将 simulation-name 替换为上一步输出中模拟的 Name。

    .\weaver-project-name-cli.bat describe-simulation --simulation simulation-name

    该脚本应显示有关指定模拟的更多详细信息,类似于以下内容:

    
    {
    
        "Name": "MyProjectSimulation_22-10-04_22_10_15",
        "ExecutionId": "1a2b3c4d-0ab1-1234-567a-12ab34cd5e6f",
        "Arn": "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MyProjectSimulation_22-10-04_22_10_15",
        "RoleArn": "arn:aws:iam::111122223333:role/weaver-MyProject-app-role",
        "CreationTime": 1664921418.09,
        "Status": "STARTED",
        "TargetStatus": "STARTED",
        "SchemaS3Location": {
            "ObjectKey": "MyProject-schema.yaml",
            "BucketName": "weaver-myproject-111122223333-us-west-2"
        },
        "SchemaError": "[]",
        "LoggingConfiguration": {
            "Destinations": [
                {
                    "CloudWatchLogsLogGroup": {
                        "LogGroupArn": "arn:aws:logs:us-west-2:111122223333:log-group:MySimulationLogs"
                    }
                }
            ]
        },
        "LiveSimulationState": {
            "Domains": [
                {
                    "Type": "",
                    "Name": "MySpatialSimulation",
                    "Lifecycle": "Unknown"
                },
                {
                    "Type": "",
                    "Name": "MyViewDomain",
                    "Lifecycle": "ByRequest"
                }
            ],
            "Clocks": [
                {
                    "Status": "STARTED",
                    "TargetStatus": "STARTED"
                }
            ]
        },
        "MaximumDuration": "1H",
        "StartError": "[]"
    }
    
    
WSL
重要

为方便起见,我们提供了这些说明。它们可以与 Windows Subsystem for Linux (WSL) 一起使用,但不受支持。有关更多信息,请参阅为 SimSpace Weaver 设置本地环境

获取模拟详细信息
  1. 如果您没有打开 tools 文件夹,请转到项目和平台的 tools 文件夹。您的 project-folderpath/project-name,它使用您在创建项目时提供的值。

    Linux Shell 提示符下,输入:

    cd project-folder/tools/linux
  2. 使用 CLI 帮助程序脚本调用 ListSimulations API。

    ./weaver-project-name-cli.sh list-simulations
    重要

    对于 AWS Command Line Interface (AWS CLI),如果您使用 AWS IAM Identity Center 或命令配置文件,则必须使用 SimSpace Weaver 应用程序 SDK 版本 1.12.1 或更高版本。最新版本是 1.16.0。有关 SimSpace Weaver 版本的信息,请参阅SimSpace Weaver 版本。SimSpace Weaver 应用程序 SDK 脚本使用 AWS CLI。如果您使用 IAM Identity Center,则可以将 AWS CLI 的 IAM Identity Center 配置文件复制到您的 default 配置文件中,也可以使用 --profile cli-profile-name 参数将您的 IAM Identity Center 配置文件名称提供给 SimSpace Weaver 应用程序 SDK 脚本。有关更多信息,请参阅《AWS Command Line Interface 用户指南》中的配置 AWS CLI 以使用 AWS IAM Identity Center,以及《AWS Command Line Interface 用户指南》中的配置和凭证文件设置

    该脚本应显示有关您的每个模拟的详细信息,类似于以下内容:

    {
        "Status": "STARTED",
        "CreationTime": 1664921418.09,
        "Name": "MyProjectSimulation_22-10-04_22_10_15",
        "Arn": "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MyProjectSimulation_22-10-04_22_10_15",
        "TargetStatus": "STARTED"
    }
    
  3. 调用 DescribeSimulation 以获取模拟详细信息。将 simulation-name 替换为上一步输出中模拟的 Name。

    ./weaver-project-name-cli.sh describe-simulation --simulation simulation-name

    该脚本应显示有关指定模拟的更多详细信息,类似于以下内容:

    
    {
    
        "Name": "MyProjectSimulation_22-10-04_22_10_15",
        "ExecutionId": "1a2b3c4d-0ab1-1234-567a-12ab34cd5e6f",
        "Arn": "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MyProjectSimulation_22-10-04_22_10_15",
        "RoleArn": "arn:aws:iam::111122223333:role/weaver-MyProject-app-role",
        "CreationTime": 1664921418.09,
        "Status": "STARTED",
        "TargetStatus": "STARTED",
        "SchemaS3Location": {
            "ObjectKey": "MyProject-schema.yaml",
            "BucketName": "weaver-myproject-111122223333-us-west-2"
        },
        "SchemaError": "[]",
        "LoggingConfiguration": {
            "Destinations": [
                {
                    "CloudWatchLogsLogGroup": {
                        "LogGroupArn": "arn:aws:logs:us-west-2:111122223333:log-group:MySimulationLogs"
                    }
                }
            ]
        },
        "LiveSimulationState": {
            "Domains": [
                {
                    "Type": "",
                    "Name": "MySpatialSimulation",
                    "Lifecycle": "Unknown"
                },
                {
                    "Type": "",
                    "Name": "MyViewDomain",
                    "Lifecycle": "ByRequest"
                }
            ],
            "Clocks": [
                {
                    "Status": "STARTED",
                    "TargetStatus": "STARTED"
                }
            ]
        },
        "MaximumDuration": "1H",
        "StartError": "[]"
    }