amazonka-iotdeviceadvisor-2.0: Amazon IoT Core Device Advisor SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.IoTDeviceAdvisor.Lens

Description

 
Synopsis

Operations

CreateSuiteDefinition

createSuiteDefinition_tags :: Lens' CreateSuiteDefinition (Maybe (HashMap Text Text)) Source #

The tags to be attached to the suite definition.

createSuiteDefinition_suiteDefinitionConfiguration :: Lens' CreateSuiteDefinition SuiteDefinitionConfiguration Source #

Creates a Device Advisor test suite with suite definition configuration.

createSuiteDefinitionResponse_suiteDefinitionName :: Lens' CreateSuiteDefinitionResponse (Maybe Text) Source #

The suite definition name of the test suite. This is a required parameter.

DeleteSuiteDefinition

deleteSuiteDefinition_suiteDefinitionId :: Lens' DeleteSuiteDefinition Text Source #

Suite definition ID of the test suite to be deleted.

GetEndpoint

getEndpoint_certificateArn :: Lens' GetEndpoint (Maybe Text) Source #

The certificate ARN of the device. This is an optional parameter.

getEndpoint_thingArn :: Lens' GetEndpoint (Maybe Text) Source #

The thing ARN of the device. This is an optional parameter.

getEndpointResponse_endpoint :: Lens' GetEndpointResponse (Maybe Text) Source #

The response of an Device Advisor endpoint.

GetSuiteDefinition

getSuiteDefinition_suiteDefinitionVersion :: Lens' GetSuiteDefinition (Maybe Text) Source #

Suite definition version of the test suite to get.

getSuiteDefinition_suiteDefinitionId :: Lens' GetSuiteDefinition Text Source #

Suite definition ID of the test suite to get.

getSuiteDefinitionResponse_createdAt :: Lens' GetSuiteDefinitionResponse (Maybe UTCTime) Source #

Date (in Unix epoch time) when the suite definition was created.

getSuiteDefinitionResponse_lastModifiedAt :: Lens' GetSuiteDefinitionResponse (Maybe UTCTime) Source #

Date (in Unix epoch time) when the suite definition was last modified.

getSuiteDefinitionResponse_latestVersion :: Lens' GetSuiteDefinitionResponse (Maybe Text) Source #

Latest suite definition version of the suite definition.

GetSuiteRun

getSuiteRun_suiteDefinitionId :: Lens' GetSuiteRun Text Source #

Suite definition ID for the test suite run.

getSuiteRun_suiteRunId :: Lens' GetSuiteRun Text Source #

Suite run ID for the test suite run.

getSuiteRunResponse_endTime :: Lens' GetSuiteRunResponse (Maybe UTCTime) Source #

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

getSuiteRunResponse_errorReason :: Lens' GetSuiteRunResponse (Maybe Text) Source #

Error reason for any test suite run failure.

getSuiteRunResponse_startTime :: Lens' GetSuiteRunResponse (Maybe UTCTime) Source #

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

getSuiteRunResponse_suiteDefinitionId :: Lens' GetSuiteRunResponse (Maybe Text) Source #

Suite definition ID for the test suite run.

getSuiteRunResponse_suiteDefinitionVersion :: Lens' GetSuiteRunResponse (Maybe Text) Source #

Suite definition version for the test suite run.

getSuiteRunResponse_suiteRunId :: Lens' GetSuiteRunResponse (Maybe Text) Source #

Suite run ID for the test suite run.

getSuiteRunResponse_tags :: Lens' GetSuiteRunResponse (Maybe (HashMap Text Text)) Source #

The tags attached to the suite run.

GetSuiteRunReport

getSuiteRunReport_suiteDefinitionId :: Lens' GetSuiteRunReport Text Source #

Suite definition ID of the test suite.

getSuiteRunReport_suiteRunId :: Lens' GetSuiteRunReport Text Source #

Suite run ID of the test suite run.

ListSuiteDefinitions

listSuiteDefinitions_maxResults :: Lens' ListSuiteDefinitions (Maybe Natural) Source #

The maximum number of results to return at once.

listSuiteDefinitions_nextToken :: Lens' ListSuiteDefinitions (Maybe Text) Source #

A token used to get the next set of results.

listSuiteDefinitionsResponse_suiteDefinitionInformationList :: Lens' ListSuiteDefinitionsResponse (Maybe [SuiteDefinitionInformation]) Source #

An array of objects that provide summaries of information about the suite definitions in the list.

ListSuiteRuns

listSuiteRuns_maxResults :: Lens' ListSuiteRuns (Maybe Natural) Source #

The maximum number of results to return at once.

listSuiteRuns_nextToken :: Lens' ListSuiteRuns (Maybe Text) Source #

A token to retrieve the next set of results.

listSuiteRuns_suiteDefinitionId :: Lens' ListSuiteRuns (Maybe Text) Source #

Lists the test suite runs of the specified test suite based on suite definition ID.

listSuiteRuns_suiteDefinitionVersion :: Lens' ListSuiteRuns (Maybe Text) Source #

Must be passed along with suiteDefinitionId. Lists the test suite runs of the specified test suite based on suite definition version.

listSuiteRunsResponse_nextToken :: Lens' ListSuiteRunsResponse (Maybe Text) Source #

A token to retrieve the next set of results.

listSuiteRunsResponse_suiteRunsList :: Lens' ListSuiteRunsResponse (Maybe [SuiteRunInformation]) Source #

An array of objects that provide summaries of information about the suite runs in the list.

ListTagsForResource

listTagsForResource_resourceArn :: Lens' ListTagsForResource Text Source #

The resource ARN of the IoT Device Advisor resource. This can be SuiteDefinition ARN or SuiteRun ARN.

listTagsForResourceResponse_tags :: Lens' ListTagsForResourceResponse (Maybe (HashMap Text Text)) Source #

The tags attached to the IoT Device Advisor resource.

StartSuiteRun

startSuiteRun_suiteDefinitionVersion :: Lens' StartSuiteRun (Maybe Text) Source #

Suite definition version of the test suite.

startSuiteRun_tags :: Lens' StartSuiteRun (Maybe (HashMap Text Text)) Source #

The tags to be attached to the suite run.

startSuiteRun_suiteDefinitionId :: Lens' StartSuiteRun Text Source #

Suite definition ID of the test suite.

startSuiteRunResponse_createdAt :: Lens' StartSuiteRunResponse (Maybe UTCTime) Source #

Starts a Device Advisor test suite run based on suite create time.

startSuiteRunResponse_endpoint :: Lens' StartSuiteRunResponse (Maybe Text) Source #

The response of an Device Advisor test endpoint.

startSuiteRunResponse_suiteRunArn :: Lens' StartSuiteRunResponse (Maybe Text) Source #

Amazon Resource Name (ARN) of the started suite run.

StopSuiteRun

stopSuiteRun_suiteDefinitionId :: Lens' StopSuiteRun Text Source #

Suite definition ID of the test suite run to be stopped.

stopSuiteRun_suiteRunId :: Lens' StopSuiteRun Text Source #

Suite run ID of the test suite run to be stopped.

TagResource

tagResource_resourceArn :: Lens' TagResource Text Source #

The resource ARN of an IoT Device Advisor resource. This can be SuiteDefinition ARN or SuiteRun ARN.

tagResource_tags :: Lens' TagResource (HashMap Text Text) Source #

The tags to be attached to the IoT Device Advisor resource.

UntagResource

untagResource_resourceArn :: Lens' UntagResource Text Source #

The resource ARN of an IoT Device Advisor resource. This can be SuiteDefinition ARN or SuiteRun ARN.

untagResource_tagKeys :: Lens' UntagResource [Text] Source #

List of tag keys to remove from the IoT Device Advisor resource.

UpdateSuiteDefinition

updateSuiteDefinition_suiteDefinitionId :: Lens' UpdateSuiteDefinition Text Source #

Suite definition ID of the test suite to be updated.

updateSuiteDefinition_suiteDefinitionConfiguration :: Lens' UpdateSuiteDefinition SuiteDefinitionConfiguration Source #

Updates a Device Advisor test suite with suite definition configuration.

updateSuiteDefinitionResponse_suiteDefinitionName :: Lens' UpdateSuiteDefinitionResponse (Maybe Text) Source #

Updates the suite definition name. This is a required parameter.

Types

DeviceUnderTest

GroupResult

groupResult_tests :: Lens' GroupResult (Maybe [TestCaseRun]) Source #

Tests under Group Result.

SuiteDefinitionConfiguration

suiteDefinitionConfiguration_protocol :: Lens' SuiteDefinitionConfiguration (Maybe Protocol) Source #

Sets the MQTT protocol that is configured in the suite definition.

suiteDefinitionConfiguration_suiteDefinitionName :: Lens' SuiteDefinitionConfiguration Text Source #

Gets the suite definition name. This is a required parameter.

suiteDefinitionConfiguration_rootGroup :: Lens' SuiteDefinitionConfiguration Text Source #

Gets the test suite root group. This is a required parameter.

suiteDefinitionConfiguration_devicePermissionRoleArn :: Lens' SuiteDefinitionConfiguration Text Source #

Gets the device permission ARN. This is a required parameter.

SuiteDefinitionInformation

suiteDefinitionInformation_createdAt :: Lens' SuiteDefinitionInformation (Maybe UTCTime) Source #

Date (in Unix epoch time) when the test suite was created.

suiteDefinitionInformation_defaultDevices :: Lens' SuiteDefinitionInformation (Maybe [DeviceUnderTest]) Source #

Specifies the devices that are under test for the test suite.

suiteDefinitionInformation_intendedForQualification :: Lens' SuiteDefinitionInformation (Maybe Bool) Source #

Specifies if the test suite is intended for qualification.

suiteDefinitionInformation_isLongDurationTest :: Lens' SuiteDefinitionInformation (Maybe Bool) Source #

Verifies if the test suite is a long duration test.

suiteDefinitionInformation_protocol :: Lens' SuiteDefinitionInformation (Maybe Protocol) Source #

Gets the MQTT protocol that is configured in the suite definition.

SuiteRunConfiguration

suiteRunConfiguration_parallelRun :: Lens' SuiteRunConfiguration (Maybe Bool) Source #

TRUE if multiple test suites run in parallel.

suiteRunConfiguration_primaryDevice :: Lens' SuiteRunConfiguration DeviceUnderTest Source #

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

SuiteRunInformation

suiteRunInformation_createdAt :: Lens' SuiteRunInformation (Maybe UTCTime) Source #

Date (in Unix epoch time) when the suite run was created.

suiteRunInformation_endAt :: Lens' SuiteRunInformation (Maybe UTCTime) Source #

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

suiteRunInformation_failed :: Lens' SuiteRunInformation (Maybe Natural) Source #

Number of test cases that failed in the suite run.

suiteRunInformation_passed :: Lens' SuiteRunInformation (Maybe Natural) Source #

Number of test cases that passed in the suite run.

suiteRunInformation_startedAt :: Lens' SuiteRunInformation (Maybe UTCTime) Source #

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

TestCaseRun

testCaseRun_endTime :: Lens' TestCaseRun (Maybe UTCTime) Source #

Provides test case run end time.

testCaseRun_failure :: Lens' TestCaseRun (Maybe Text) Source #

Provides test case run failure result.

testCaseRun_logUrl :: Lens' TestCaseRun (Maybe Text) Source #

Provides test case run log URL.

testCaseRun_startTime :: Lens' TestCaseRun (Maybe UTCTime) Source #

Provides test case run start time.

testCaseRun_status :: Lens' TestCaseRun (Maybe Status) Source #

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.

testCaseRun_testCaseDefinitionId :: Lens' TestCaseRun (Maybe Text) Source #

Provides the test case run definition ID.

testCaseRun_testCaseDefinitionName :: Lens' TestCaseRun (Maybe Text) Source #

Provides the test case run definition name.

testCaseRun_testCaseRunId :: Lens' TestCaseRun (Maybe Text) Source #

Provides the test case run ID.

testCaseRun_testScenarios :: Lens' TestCaseRun (Maybe [TestCaseScenario]) Source #

Provides the test scenarios for the test case run.

testCaseRun_warnings :: Lens' TestCaseRun (Maybe Text) Source #

Provides test case run warnings.

TestCaseScenario

testCaseScenario_failure :: Lens' TestCaseScenario (Maybe Text) Source #

Provides test case scenario failure result.

testCaseScenario_status :: Lens' TestCaseScenario (Maybe TestCaseScenarioStatus) Source #

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.

testCaseScenario_testCaseScenarioType :: Lens' TestCaseScenario (Maybe TestCaseScenarioType) Source #

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

  • Advanced
  • Basic

TestResult

testResult_groups :: Lens' TestResult (Maybe [GroupResult]) Source #

Show each group of test results.