REST Resource: projects.histories.executions.environments

资源：环境

环境表示来自父执行的一组测试运行（步骤），这些测试运行配置有相同的维度集（模型、版本、区域设置和方向）。多次此类运行的发生尤其是由于分片（分割测试套件以跨设备并行运行）和重新运行（多次运行测试以检查不同结果）等功能。

JSON 表示
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "environmentId": string,
  "dimensionValue": {
    string: string,
    ...
  },
  "displayName": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "shardSummaries": [
    {
      object (ShardSummary)
    }
  ],
  "environmentResult": {
    object (MergedResult)
  },
  "resultsStorage": {
    object (ResultsStorage)
  }
}
领域
projectId

string

仅输出。项目 ID。

historyId

string

仅输出。历史记录 ID。

executionId

string

仅输出。执行 ID。

environmentId

string

仅输出。环境 ID。

dimensionValue

map (key: string, value: string)

描述环境的维度值。维度值始终由“型号”、“版本”、“区域设置”和“方向”组成。

  • 响应：始终设置
  • 在创建请求中：始终设置
  • 在更新请求中：从未设置

包含"key": value对。示例： { "name": "wrench", "mass": "1.3kg", "count": "3" } 。

displayName

string

显示在 UI 中的人类可读的简短名称。最多 100 个字符。例如：Nexus 5，API 27。

creationTime

object ( Timestamp )

仅输出。创建环境的时间。

completionTime

object ( Timestamp )

仅输出。环境状态设置完成的时间。

当状态转换为 COMPLETE 时，将自动设置该值。

shardSummaries[]

object ( ShardSummary )

仅输出。碎片摘要。

除非在 TestExecutionService 中启用分片功能，否则只会出现一个分片。

environmentResult

object ( MergedResult )

环境的合并结果。

resultsStorage

object ( ResultsStorage )

输出文件在用户存储桶中的存储位置。

分片摘要

环境中分片的结果摘要。

JSON 表示
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
领域
runs[]

object ( StepSummary )

属于分片的步骤的摘要。

从 TestExecutionService 启用 flaky_test_attempts 后，可以出现多个运行（步骤）。并且运行将按 multistepNumber 排序。

shardResult

object ( MergedResult )

分片的合并结果。

步骤总结

该类型没有字段。

此执行中步骤的轻量级摘要。

合并结果

合并环境测试结果。

如果环境只有一个步骤（没有重新运行或分片），则合并结果与步骤结果相同。如果环境有多个分片和/或重新运行，则属于同一环境的分片和重新运行的结果将合并为一个环境结果。

JSON 表示
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
领域
state

enum ( State )

资源状态

outcome

object ( Outcome )

资源的结果

testSuiteOverviews[]

object ( TestSuiteOverview )

作为此环境的一部分运行的每个测试套件的组合和汇总结果。

组合：当套件中的测试用例在不同步骤（分片）中运行时，结果会在一个概述中重新添加到一起。 （例如，如果 shard1 有 2 次故障，而 shard2 有 1 次故障，则概览 failureCount = 3）。

Rollup：当同一套件中的测试用例运行多次（片状）时，结果将被合并（例如，如果 testcase1.run1 失败，testcase1.run2 通过，并且 testcase2.run1 和 testcase2.run2 都失败，则概述 flakyCount = 1 且失败计数 = 1)。

结果存储

测试结果的存储。

JSON 表示
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
领域
resultsStoragePath

object ( FileReference )

测试结果的根目录。

xunitXmlFile

object ( FileReference )

Xunit XML 文件的路径。

方法

get

获取一个环境。

list

列出给定执行的环境。
,

资源：环境

环境表示来自父执行的一组测试运行（步骤），这些测试运行配置有相同的维度集（模型、版本、区域设置和方向）。多次此类运行的发生尤其是由于分片（分割测试套件以跨设备并行运行）和重新运行（多次运行测试以检查不同结果）等功能。

JSON 表示
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "environmentId": string,
  "dimensionValue": {
    string: string,
    ...
  },
  "displayName": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "shardSummaries": [
    {
      object (ShardSummary)
    }
  ],
  "environmentResult": {
    object (MergedResult)
  },
  "resultsStorage": {
    object (ResultsStorage)
  }
}
领域
projectId

string

仅输出。项目 ID。

historyId

string

仅输出。历史记录 ID。

executionId

string

仅输出。执行 ID。

environmentId

string

仅输出。环境 ID。

dimensionValue

map (key: string, value: string)

描述环境的维度值。维度值始终由“型号”、“版本”、“区域设置”和“方向”组成。

  • 响应：始终设置
  • 在创建请求中：始终设置
  • 在更新请求中：从未设置

包含"key": value对。示例： { "name": "wrench", "mass": "1.3kg", "count": "3" } 。

displayName

string

显示在 UI 中的人类可读的简短名称。最多 100 个字符。例如：Nexus 5，API 27。

creationTime

object ( Timestamp )

仅输出。创建环境的时间。

completionTime

object ( Timestamp )

仅输出。环境状态设置完成的时间。

当状态转换为 COMPLETE 时，将自动设置该值。

shardSummaries[]

object ( ShardSummary )

仅输出。碎片摘要。

除非在 TestExecutionService 中启用分片功能，否则只会出现一个分片。

environmentResult

object ( MergedResult )

环境的合并结果。

resultsStorage

object ( ResultsStorage )

输出文件在用户存储桶中的存储位置。

分片摘要

环境中分片的结果摘要。

JSON 表示
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
领域
runs[]

object ( StepSummary )

属于分片的步骤的摘要。

从 TestExecutionService 启用 flaky_test_attempts 后，可以出现多个运行（步骤）。并且运行将按 multistepNumber 排序。

shardResult

object ( MergedResult )

分片的合并结果。

步骤总结

该类型没有字段。

此执行中步骤的轻量级摘要。

合并结果

合并环境测试结果。

如果环境只有一个步骤（没有重新运行或分片），则合并结果与步骤结果相同。如果环境有多个分片和/或重新运行，则属于同一环境的分片和重新运行的结果将合并为一个环境结果。

JSON 表示
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
领域
state

enum ( State )

资源状态

outcome

object ( Outcome )

资源的结果

testSuiteOverviews[]

object ( TestSuiteOverview )

作为此环境的一部分运行的每个测试套件的组合和汇总结果。

组合：当套件中的测试用例在不同步骤（分片）中运行时，结果会在一个概述中重新添加到一起。 （例如，如果 shard1 有 2 次故障，而 shard2 有 1 次故障，则概览 failureCount = 3）。

Rollup：当同一套件中的测试用例运行多次（片状）时，结果将被合并（例如，如果 testcase1.run1 失败，testcase1.run2 通过，并且 testcase2.run1 和 testcase2.run2 都失败，则概述 flakyCount = 1 且失败计数 = 1)。

结果存储

测试结果的存储。

JSON 表示
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
领域
resultsStoragePath

object ( FileReference )

测试结果的根目录。

xunitXmlFile

object ( FileReference )

Xunit XML 文件的路径。

方法

get

获取一个环境。

list

列出给定执行的环境。