AWS Cloud Control v1.28.0, May 19 25

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi

pulumi/pulumi-aws-native

aws-native.iotcoredeviceadvisor.SuiteDefinition

Explore with Pulumi AI

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi

pulumi/pulumi-aws-native

Example Usage

Example

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AwsNative = Pulumi.AwsNative;

return await Deployment.RunAsync(() => 
{
    var testSuiteDefinition = new AwsNative.IoTCoreDeviceAdvisor.SuiteDefinition("testSuiteDefinition", new()
    {
        SuiteDefinitionConfiguration = new AwsNative.IoTCoreDeviceAdvisor.Inputs.SuiteDefinitionConfigurationPropertiesArgs
        {
            SuiteDefinitionName = "SuiteDefinitionName",
            DevicePermissionRoleArn = "arn:aws:iam::123456789012:role/RoleName",
            Devices = new[]
            {
                new AwsNative.IoTCoreDeviceAdvisor.Inputs.SuiteDefinitionDeviceUnderTestArgs
                {
                    ThingArn = "arn:aws:iot:us-east-1:123456789012:thing/ThingName",
                },
            },
            RootGroup = @"{
""configuration"": {},
""tests"": [{
""name"": ""TestGroup"",
""configuration"": {
""EXECUTION_TIMEOUT"": ""30""
},
""tests"": [{
""name"": ""MQTTPublishTest"",
""configuration"": {
""TOPIC_FOR_PUBLISH_VALIDATION"": ""target""
},
""test"": {
""id"": ""MQTT_Publish"",
""version"": ""0.0.0""
}
}]
}]
}",
            IntendedForQualification = false,
        },
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/iotcoredeviceadvisor"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := iotcoredeviceadvisor.NewSuiteDefinition(ctx, "testSuiteDefinition", &iotcoredeviceadvisor.SuiteDefinitionArgs{
			SuiteDefinitionConfiguration: &iotcoredeviceadvisor.SuiteDefinitionConfigurationPropertiesArgs{
				SuiteDefinitionName:     pulumi.String("SuiteDefinitionName"),
				DevicePermissionRoleArn: pulumi.String("arn:aws:iam::123456789012:role/RoleName"),
				Devices: iotcoredeviceadvisor.SuiteDefinitionDeviceUnderTestArray{
					&iotcoredeviceadvisor.SuiteDefinitionDeviceUnderTestArgs{
						ThingArn: pulumi.String("arn:aws:iot:us-east-1:123456789012:thing/ThingName"),
					},
				},
				RootGroup: pulumi.String(`{
"configuration": {},
"tests": [{
"name": "TestGroup",
"configuration": {
"EXECUTION_TIMEOUT": "30"
},
"tests": [{
"name": "MQTTPublishTest",
"configuration": {
"TOPIC_FOR_PUBLISH_VALIDATION": "target"
},
"test": {
"id": "MQTT_Publish",
"version": "0.0.0"
}
}]
}]
}`),
				IntendedForQualification: pulumi.Bool(false),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

Coming soon!

import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const testSuiteDefinition = new aws_native.iotcoredeviceadvisor.SuiteDefinition("testSuiteDefinition", {suiteDefinitionConfiguration: {
    suiteDefinitionName: "SuiteDefinitionName",
    devicePermissionRoleArn: "arn:aws:iam::123456789012:role/RoleName",
    devices: [{
        thingArn: "arn:aws:iot:us-east-1:123456789012:thing/ThingName",
    }],
    rootGroup: `{
"configuration": {},
"tests": [{
"name": "TestGroup",
"configuration": {
"EXECUTION_TIMEOUT": "30"
},
"tests": [{
"name": "MQTTPublishTest",
"configuration": {
"TOPIC_FOR_PUBLISH_VALIDATION": "target"
},
"test": {
"id": "MQTT_Publish",
"version": "0.0.0"
}
}]
}]
}`,
    intendedForQualification: false,
}});

import pulumi
import pulumi_aws_native as aws_native

test_suite_definition = aws_native.iotcoredeviceadvisor.SuiteDefinition("testSuiteDefinition", suite_definition_configuration={
    "suite_definition_name": "SuiteDefinitionName",
    "device_permission_role_arn": "arn:aws:iam::123456789012:role/RoleName",
    "devices": [{
        "thing_arn": "arn:aws:iot:us-east-1:123456789012:thing/ThingName",
    }],
    "root_group": """{
"configuration": {},
"tests": [{
"name": "TestGroup",
"configuration": {
"EXECUTION_TIMEOUT": "30"
},
"tests": [{
"name": "MQTTPublishTest",
"configuration": {
"TOPIC_FOR_PUBLISH_VALIDATION": "target"
},
"test": {
"id": "MQTT_Publish",
"version": "0.0.0"
}
}]
}]
}""",
    "intended_for_qualification": False,
})

Coming soon!

Example

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AwsNative = Pulumi.AwsNative;

return await Deployment.RunAsync(() => 
{
    var testSuiteDefinition = new AwsNative.IoTCoreDeviceAdvisor.SuiteDefinition("testSuiteDefinition", new()
    {
        SuiteDefinitionConfiguration = new AwsNative.IoTCoreDeviceAdvisor.Inputs.SuiteDefinitionConfigurationPropertiesArgs
        {
            SuiteDefinitionName = "SuiteDefinitionName",
            DevicePermissionRoleArn = "arn:aws:iam::123456789012:role/RoleName",
            Devices = new[]
            {
                new AwsNative.IoTCoreDeviceAdvisor.Inputs.SuiteDefinitionDeviceUnderTestArgs
                {
                    ThingArn = "arn:aws:iot:us-east-1:123456789012:thing/ThingName",
                },
            },
            RootGroup = "{ \"configuration\": {}, \"tests\": [{ \"name\": \"TestGroup\", \"configuration\": { \"EXECUTION_TIMEOUT\": \"30\" }, \"tests\": [{ \"name\": \"MQTTPublishTest\", \"configuration\": { \"TOPIC_FOR_PUBLISH_VALIDATION\": \"target\" }, \"test\": { \"id\": \"MQTT_Publish\", \"version\": \"0.0.0\" } }] }] }",
            IntendedForQualification = false,
        },
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/iotcoredeviceadvisor"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := iotcoredeviceadvisor.NewSuiteDefinition(ctx, "testSuiteDefinition", &iotcoredeviceadvisor.SuiteDefinitionArgs{
			SuiteDefinitionConfiguration: &iotcoredeviceadvisor.SuiteDefinitionConfigurationPropertiesArgs{
				SuiteDefinitionName:     pulumi.String("SuiteDefinitionName"),
				DevicePermissionRoleArn: pulumi.String("arn:aws:iam::123456789012:role/RoleName"),
				Devices: iotcoredeviceadvisor.SuiteDefinitionDeviceUnderTestArray{
					&iotcoredeviceadvisor.SuiteDefinitionDeviceUnderTestArgs{
						ThingArn: pulumi.String("arn:aws:iot:us-east-1:123456789012:thing/ThingName"),
					},
				},
				RootGroup:                pulumi.String("{ \"configuration\": {}, \"tests\": [{ \"name\": \"TestGroup\", \"configuration\": { \"EXECUTION_TIMEOUT\": \"30\" }, \"tests\": [{ \"name\": \"MQTTPublishTest\", \"configuration\": { \"TOPIC_FOR_PUBLISH_VALIDATION\": \"target\" }, \"test\": { \"id\": \"MQTT_Publish\", \"version\": \"0.0.0\" } }] }] }"),
				IntendedForQualification: pulumi.Bool(false),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

Coming soon!

import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const testSuiteDefinition = new aws_native.iotcoredeviceadvisor.SuiteDefinition("testSuiteDefinition", {suiteDefinitionConfiguration: {
    suiteDefinitionName: "SuiteDefinitionName",
    devicePermissionRoleArn: "arn:aws:iam::123456789012:role/RoleName",
    devices: [{
        thingArn: "arn:aws:iot:us-east-1:123456789012:thing/ThingName",
    }],
    rootGroup: "{ \"configuration\": {}, \"tests\": [{ \"name\": \"TestGroup\", \"configuration\": { \"EXECUTION_TIMEOUT\": \"30\" }, \"tests\": [{ \"name\": \"MQTTPublishTest\", \"configuration\": { \"TOPIC_FOR_PUBLISH_VALIDATION\": \"target\" }, \"test\": { \"id\": \"MQTT_Publish\", \"version\": \"0.0.0\" } }] }] }",
    intendedForQualification: false,
}});

import pulumi
import pulumi_aws_native as aws_native

test_suite_definition = aws_native.iotcoredeviceadvisor.SuiteDefinition("testSuiteDefinition", suite_definition_configuration={
    "suite_definition_name": "SuiteDefinitionName",
    "device_permission_role_arn": "arn:aws:iam::123456789012:role/RoleName",
    "devices": [{
        "thing_arn": "arn:aws:iot:us-east-1:123456789012:thing/ThingName",
    }],
    "root_group": "{ \"configuration\": {}, \"tests\": [{ \"name\": \"TestGroup\", \"configuration\": { \"EXECUTION_TIMEOUT\": \"30\" }, \"tests\": [{ \"name\": \"MQTTPublishTest\", \"configuration\": { \"TOPIC_FOR_PUBLISH_VALIDATION\": \"target\" }, \"test\": { \"id\": \"MQTT_Publish\", \"version\": \"0.0.0\" } }] }] }",
    "intended_for_qualification": False,
})

Coming soon!

Create SuiteDefinition Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new SuiteDefinition(name: string, args: SuiteDefinitionArgs, opts?: CustomResourceOptions);

@overload
def SuiteDefinition(resource_name: str,
                    args: SuiteDefinitionArgs,
                    opts: Optional[ResourceOptions] = None)

@overload
def SuiteDefinition(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    suite_definition_configuration: Optional[SuiteDefinitionConfigurationPropertiesArgs] = None,
                    tags: Optional[Sequence[_root_inputs.TagArgs]] = None)

func NewSuiteDefinition(ctx *Context, name string, args SuiteDefinitionArgs, opts ...ResourceOption) (*SuiteDefinition, error)

public SuiteDefinition(string name, SuiteDefinitionArgs args, CustomResourceOptions? opts = null)

public SuiteDefinition(String name, SuiteDefinitionArgs args)
public SuiteDefinition(String name, SuiteDefinitionArgs args, CustomResourceOptions options)

type: aws-native:iotcoredeviceadvisor:SuiteDefinition
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args SuiteDefinitionArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args SuiteDefinitionArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args SuiteDefinitionArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args SuiteDefinitionArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args SuiteDefinitionArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

SuiteDefinition Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The SuiteDefinition resource accepts the following input properties:

SuiteDefinitionConfiguration Pulumi.AwsNative.IoTCoreDeviceAdvisor.Inputs.SuiteDefinitionConfigurationProperties

The configuration of the Suite Definition. Listed below are the required elements of the SuiteDefinitionConfiguration .

devicePermissionRoleArn - The device permission arn.

This is a required element.

Type: String

devices - The list of configured devices under test. For more information on devices under test, see DeviceUnderTest

Not a required element.

Type: List of devices under test

intendedForQualification - The tests intended for qualification in a suite.

Not a required element.

Type: Boolean

rootGroup - The test suite root group. For more information on creating and using root groups see the Device Advisor workflow .

This is a required element.

Type: String

suiteDefinitionName - The Suite Definition Configuration name.

This is a required element.

Type: String

Tags List<Pulumi.AwsNative.Inputs.Tag>

An array of key-value pairs to apply to this resource.

SuiteDefinitionConfiguration SuiteDefinitionConfigurationPropertiesArgs

The configuration of the Suite Definition. Listed below are the required elements of the SuiteDefinitionConfiguration .

devicePermissionRoleArn - The device permission arn.

This is a required element.

Type: String

devices - The list of configured devices under test. For more information on devices under test, see DeviceUnderTest

Not a required element.

Type: List of devices under test

intendedForQualification - The tests intended for qualification in a suite.

Not a required element.

Type: Boolean

rootGroup - The test suite root group. For more information on creating and using root groups see the Device Advisor workflow .

This is a required element.

Type: String

suiteDefinitionName - The Suite Definition Configuration name.

This is a required element.

Type: String

Tags TagArgs

An array of key-value pairs to apply to this resource.

suiteDefinitionConfiguration SuiteDefinitionConfigurationProperties

The configuration of the Suite Definition. Listed below are the required elements of the SuiteDefinitionConfiguration .

devicePermissionRoleArn - The device permission arn.

This is a required element.

Type: String

devices - The list of configured devices under test. For more information on devices under test, see DeviceUnderTest

Not a required element.

Type: List of devices under test

intendedForQualification - The tests intended for qualification in a suite.

Not a required element.

Type: Boolean

rootGroup - The test suite root group. For more information on creating and using root groups see the Device Advisor workflow .

This is a required element.

Type: String

suiteDefinitionName - The Suite Definition Configuration name.

This is a required element.

Type: String

tags List<Tag>

An array of key-value pairs to apply to this resource.

suiteDefinitionConfiguration SuiteDefinitionConfigurationProperties

The configuration of the Suite Definition. Listed below are the required elements of the SuiteDefinitionConfiguration .

devicePermissionRoleArn - The device permission arn.

This is a required element.

Type: String

devices - The list of configured devices under test. For more information on devices under test, see DeviceUnderTest

Not a required element.

Type: List of devices under test

intendedForQualification - The tests intended for qualification in a suite.

Not a required element.

Type: Boolean

rootGroup - The test suite root group. For more information on creating and using root groups see the Device Advisor workflow .

This is a required element.

Type: String

suiteDefinitionName - The Suite Definition Configuration name.

This is a required element.

Type: String

tags Tag[]

An array of key-value pairs to apply to this resource.

suite_definition_configuration SuiteDefinitionConfigurationPropertiesArgs

The configuration of the Suite Definition. Listed below are the required elements of the SuiteDefinitionConfiguration .

devicePermissionRoleArn - The device permission arn.

This is a required element.

Type: String

devices - The list of configured devices under test. For more information on devices under test, see DeviceUnderTest

Not a required element.

Type: List of devices under test

intendedForQualification - The tests intended for qualification in a suite.

Not a required element.

Type: Boolean

rootGroup - The test suite root group. For more information on creating and using root groups see the Device Advisor workflow .

This is a required element.

Type: String

suiteDefinitionName - The Suite Definition Configuration name.

This is a required element.

Type: String

tags Sequence[TagArgs]

An array of key-value pairs to apply to this resource.

suiteDefinitionConfiguration Property Map

The configuration of the Suite Definition. Listed below are the required elements of the SuiteDefinitionConfiguration .

devicePermissionRoleArn - The device permission arn.

This is a required element.

Type: String

devices - The list of configured devices under test. For more information on devices under test, see DeviceUnderTest

Not a required element.

Type: List of devices under test

intendedForQualification - The tests intended for qualification in a suite.

Not a required element.

Type: Boolean

rootGroup - The test suite root group. For more information on creating and using root groups see the Device Advisor workflow .

This is a required element.

Type: String

suiteDefinitionName - The Suite Definition Configuration name.

This is a required element.

Type: String

tags List<Property Map>

An array of key-value pairs to apply to this resource.

Outputs

All input properties are implicitly available as output properties. Additionally, the SuiteDefinition resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.
SuiteDefinitionArn string: The Amazon Resource name for the suite definition.
SuiteDefinitionId string: The unique identifier for the suite definition.
SuiteDefinitionVersion string: The suite definition version of a test suite.

Id string: The provider-assigned unique ID for this managed resource.
SuiteDefinitionArn string: The Amazon Resource name for the suite definition.
SuiteDefinitionId string: The unique identifier for the suite definition.
SuiteDefinitionVersion string: The suite definition version of a test suite.

id String: The provider-assigned unique ID for this managed resource.
suiteDefinitionArn String: The Amazon Resource name for the suite definition.
suiteDefinitionId String: The unique identifier for the suite definition.
suiteDefinitionVersion String: The suite definition version of a test suite.

id string: The provider-assigned unique ID for this managed resource.
suiteDefinitionArn string: The Amazon Resource name for the suite definition.
suiteDefinitionId string: The unique identifier for the suite definition.
suiteDefinitionVersion string: The suite definition version of a test suite.

id str: The provider-assigned unique ID for this managed resource.
suite_definition_arn str: The Amazon Resource name for the suite definition.
suite_definition_id str: The unique identifier for the suite definition.
suite_definition_version str: The suite definition version of a test suite.

id String: The provider-assigned unique ID for this managed resource.
suiteDefinitionArn String: The Amazon Resource name for the suite definition.
suiteDefinitionId String: The unique identifier for the suite definition.
suiteDefinitionVersion String: The suite definition version of a test suite.

Supporting Types

SuiteDefinitionConfigurationProperties, SuiteDefinitionConfigurationPropertiesArgs

DevicePermissionRoleArn string

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

RootGroup string

Gets the test suite root group. This is a required parameter. For updating or creating the latest qualification suite, if intendedForQualification is set to true, rootGroup can be an empty string. If intendedForQualification is false, rootGroup cannot be an empty string. If rootGroup is empty, and intendedForQualification is set to true, all the qualification tests are included, and the configuration is default.

For a qualification suite, the minimum length is 0, and the maximum is 2048. For a non-qualification suite, the minimum length is 1, and the maximum is 2048.

Devices List<Pulumi.AwsNative.IoTCoreDeviceAdvisor.Inputs.SuiteDefinitionDeviceUnderTest>

Gets the devices configured.

IntendedForQualification bool

Gets the tests intended for qualification in a suite.

SuiteDefinitionName string

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

DevicePermissionRoleArn string

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

RootGroup string

For a qualification suite, the minimum length is 0, and the maximum is 2048. For a non-qualification suite, the minimum length is 1, and the maximum is 2048.

Devices []SuiteDefinitionDeviceUnderTest

Gets the devices configured.

IntendedForQualification bool

Gets the tests intended for qualification in a suite.

SuiteDefinitionName string

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

devicePermissionRoleArn String

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

rootGroup String

For a qualification suite, the minimum length is 0, and the maximum is 2048. For a non-qualification suite, the minimum length is 1, and the maximum is 2048.

devices List<SuiteDefinitionDeviceUnderTest>

Gets the devices configured.

intendedForQualification Boolean

Gets the tests intended for qualification in a suite.

suiteDefinitionName String

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

devicePermissionRoleArn string

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

rootGroup string

For a qualification suite, the minimum length is 0, and the maximum is 2048. For a non-qualification suite, the minimum length is 1, and the maximum is 2048.

devices SuiteDefinitionDeviceUnderTest[]

Gets the devices configured.

intendedForQualification boolean

Gets the tests intended for qualification in a suite.

suiteDefinitionName string

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

device_permission_role_arn str

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

root_group str

For a qualification suite, the minimum length is 0, and the maximum is 2048. For a non-qualification suite, the minimum length is 1, and the maximum is 2048.

devices Sequence[SuiteDefinitionDeviceUnderTest]

Gets the devices configured.

intended_for_qualification bool

Gets the tests intended for qualification in a suite.

suite_definition_name str

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

devicePermissionRoleArn String

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

rootGroup String

For a qualification suite, the minimum length is 0, and the maximum is 2048. For a non-qualification suite, the minimum length is 1, and the maximum is 2048.

devices List<Property Map>