get_suite_run

get_suite_run(**kwargs)

Gets information about a Device Advisor test suite run.

Requires permission to access the GetSuiteRun action.

See also: AWS API Documentation

Request Syntax

response = client.get_suite_run(
    suiteDefinitionId='string',
    suiteRunId='string'
)

Parameters

• suiteDefinitionId (string) --

  [REQUIRED]

  Suite definition ID for the test suite run.

• suiteRunId (string) --

  [REQUIRED]

  Suite run ID for the test suite run.

Return type

dict

Returns

Response Syntax

{
    'suiteDefinitionId': 'string',
    'suiteDefinitionVersion': 'string',
    'suiteRunId': 'string',
    'suiteRunArn': 'string',
    'suiteRunConfiguration': {
        'primaryDevice': {
            'thingArn': 'string',
            'certificateArn': 'string'
        },
        'selectedTestList': [
            'string',
        ],
        'parallelRun': True|False
    },
    'testResult': {
        'groups': [
            {
                'groupId': 'string',
                'groupName': 'string',
                'tests': [
                    {
                        'testCaseRunId': 'string',
                        'testCaseDefinitionId': 'string',
                        'testCaseDefinitionName': 'string',
                        'status': 'PASS'|'FAIL'|'CANCELED'|'PENDING'|'RUNNING'|'STOPPING'|'STOPPED'|'PASS_WITH_WARNINGS'|'ERROR',
                        'startTime': datetime(2015, 1, 1),
                        'endTime': datetime(2015, 1, 1),
                        'logUrl': 'string',
                        'warnings': 'string',
                        'failure': 'string',
                        'testScenarios': [
                            {
                                'testCaseScenarioId': 'string',
                                'testCaseScenarioType': 'Advanced'|'Basic',
                                'status': 'PASS'|'FAIL'|'CANCELED'|'PENDING'|'RUNNING'|'STOPPING'|'STOPPED'|'PASS_WITH_WARNINGS'|'ERROR',
                                'failure': 'string',
                                'systemMessage': 'string'
                            },
                        ]
                    },
                ]
            },
        ]
    },
    'startTime': datetime(2015, 1, 1),
    'endTime': datetime(2015, 1, 1),
    'status': 'PASS'|'FAIL'|'CANCELED'|'PENDING'|'RUNNING'|'STOPPING'|'STOPPED'|'PASS_WITH_WARNINGS'|'ERROR',
    'errorReason': 'string',
    'tags': {
        'string': 'string'
    }
}

Response Structure

• (dict) --

  • suiteDefinitionId (string) --

    Suite definition ID for the test suite run.

  • suiteDefinitionVersion (string) --

    Suite definition version for the test suite run.

  • suiteRunId (string) --

    Suite run ID for the test suite run.

  • suiteRunArn (string) --

    The ARN of the suite run.

  • suiteRunConfiguration (dict) --

    Suite run configuration for the test suite run.

    • primaryDevice (dict) --

      Sets the primary device for the test suite run. This requires a thing ARN or a certificate ARN.

      • thingArn (string) --

        Lists devices thing ARN.

      • certificateArn (string) --

        Lists devices certificate ARN.

    • selectedTestList (list) --

      Sets test case list.

      • (string) --

    • parallelRun (boolean) --

      TRUE if multiple test suites run in parallel.

  • testResult (dict) --

    Test results for the test suite run.

    • groups (list) --

      Show each group of test results.

      • (dict) --

        Show Group Result.

        • groupId (string) --

          Group result ID.

        • groupName (string) --

          Group Result Name.

        • tests (list) --

          Tests under Group Result.

          • (dict) --

            Provides the test case run.

            • testCaseRunId (string) --

              Provides the test case run ID.

            • testCaseDefinitionId (string) --

              Provides the test case run definition ID.

            • testCaseDefinitionName (string) --

              Provides the test case run definition name.

            • status (string) --

              Provides the test case run status. Status is one of the following:

              • PASS : Test passed.
              • FAIL : Test failed.
              • PENDING : Test has not started running but is scheduled.
              • RUNNING : Test is running.
              • STOPPING : Test is performing cleanup steps. You will see this status only if you stop a suite run.
              • STOPPED Test is stopped. You will see this status only if you stop a suite run.
              • PASS_WITH_WARNINGS : Test passed with warnings.
              • ERORR : Test faced an error when running due to an internal issue.

            • startTime (datetime) --

              Provides test case run start time.

            • endTime (datetime) --

              Provides test case run end time.

            • logUrl (string) --

              Provides test case run log URL.

            • warnings (string) --

              Provides test case run warnings.

            • failure (string) --

              Provides test case run failure result.

            • testScenarios (list) --

              Provides the test scenarios for the test case run.

              • (dict) --

                Provides test case scenario.

                • testCaseScenarioId (string) --

                  Provides test case scenario ID.

                • testCaseScenarioType (string) --

                  Provides test case scenario type. Type is one of the following:

                  • Advanced
                  • Basic

                • status (string) --

                  Provides the test case scenario status. Status is one of the following:

                  • PASS : Test passed.
                  • FAIL : Test failed.
                  • PENDING : Test has not started running but is scheduled.
                  • RUNNING : Test is running.
                  • STOPPING : Test is performing cleanup steps. You will see this status only if you stop a suite run.
                  • STOPPED Test is stopped. You will see this status only if you stop a suite run.
                  • PASS_WITH_WARNINGS : Test passed with warnings.
                  • ERORR : Test faced an error when running due to an internal issue.

                • failure (string) --

                  Provides test case scenario failure result.

                • systemMessage (string) --

  • startTime (datetime) --

    Date (in Unix epoch time) when the test suite run started.

  • endTime (datetime) --

    Date (in Unix epoch time) when the test suite run ended.

  • status (string) --

    Status for the test suite run.

  • errorReason (string) --

    Error reason for any test suite run failure.

  • tags (dict) --

    The tags attached to the suite run.

    • (string) --
      • (string) --

Exceptions

• IoTDeviceAdvisor.Client.exceptions.ValidationException
• IoTDeviceAdvisor.Client.exceptions.InternalServerException
• IoTDeviceAdvisor.Client.exceptions.ResourceNotFoundException