aws-cdk-lib
Version:
Version 2 of the AWS Cloud Development Kit library
220 lines (219 loc) • 9.93 kB
TypeScript
import * as constructs from 'constructs';
import * as cdk from '../../core';
import * as cfn_parse from '../../core/lib/helpers-internal';
/**
* Properties for defining a `CfnSuiteDefinition`
*
* @struct
* @stability external
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotcoredeviceadvisor-suitedefinition.html
*/
export interface CfnSuiteDefinitionProps {
/**
* 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](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_DeviceUnderTest.html)
*
* 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](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html) .
*
* This is a required element.
*
* *Type:* String
* - ***suiteDefinitionName*** - The Suite Definition Configuration name.
*
* This is a required element.
*
* *Type:* String
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotcoredeviceadvisor-suitedefinition.html#cfn-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration
*/
readonly suiteDefinitionConfiguration: any | cdk.IResolvable;
/**
* Metadata that can be used to manage the the Suite Definition.
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotcoredeviceadvisor-suitedefinition.html#cfn-iotcoredeviceadvisor-suitedefinition-tags
*/
readonly tags?: cdk.CfnTag[];
}
/**
* A CloudFormation `AWS::IoTCoreDeviceAdvisor::SuiteDefinition`
*
* Creates a Device Advisor test suite.
*
* Requires permission to access the [CreateSuiteDefinition](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.
*
* @cloudformationResource AWS::IoTCoreDeviceAdvisor::SuiteDefinition
* @stability external
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotcoredeviceadvisor-suitedefinition.html
*/
export declare class CfnSuiteDefinition extends cdk.CfnResource implements cdk.IInspectable {
/**
* The CloudFormation resource type name for this resource class.
*/
static readonly CFN_RESOURCE_TYPE_NAME = "AWS::IoTCoreDeviceAdvisor::SuiteDefinition";
/**
* A factory method that creates a new instance of this class from an object
* containing the CloudFormation properties of this resource.
* Used in the @aws-cdk/cloudformation-include module.
*
* @internal
*/
static _fromCloudFormation(scope: constructs.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnSuiteDefinition;
/**
* The Arn of the Suite Definition.
* @cloudformationAttribute SuiteDefinitionArn
*/
readonly attrSuiteDefinitionArn: string;
/**
* The version of the Suite Definition.
* @cloudformationAttribute SuiteDefinitionId
*/
readonly attrSuiteDefinitionId: string;
/**
* The ID of the Suite Definition.
* @cloudformationAttribute SuiteDefinitionVersion
*/
readonly attrSuiteDefinitionVersion: string;
/**
* 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](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_DeviceUnderTest.html)
*
* 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](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html) .
*
* This is a required element.
*
* *Type:* String
* - ***suiteDefinitionName*** - The Suite Definition Configuration name.
*
* This is a required element.
*
* *Type:* String
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotcoredeviceadvisor-suitedefinition.html#cfn-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration
*/
suiteDefinitionConfiguration: any | cdk.IResolvable;
/**
* Metadata that can be used to manage the the Suite Definition.
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotcoredeviceadvisor-suitedefinition.html#cfn-iotcoredeviceadvisor-suitedefinition-tags
*/
readonly tags: cdk.TagManager;
/**
* Create a new `AWS::IoTCoreDeviceAdvisor::SuiteDefinition`.
*
* @param scope - scope in which this resource is defined
* @param id - scoped id of the resource
* @param props - resource properties
*/
constructor(scope: constructs.Construct, id: string, props: CfnSuiteDefinitionProps);
/**
* Examines the CloudFormation resource and discloses attributes.
*
* @param inspector - tree inspector to collect and process attributes
*
*/
inspect(inspector: cdk.TreeInspector): void;
protected get cfnProperties(): {
[key: string]: any;
};
protected renderProperties(props: {
[key: string]: any;
}): {
[key: string]: any;
};
}
export declare namespace CfnSuiteDefinition {
/**
* Information of a test device. A thing ARN or a certificate ARN is required.
*
* @struct
* @stability external
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iotcoredeviceadvisor-suitedefinition-deviceundertest.html
*/
interface DeviceUnderTestProperty {
/**
* Lists devices certificate ARN.
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iotcoredeviceadvisor-suitedefinition-deviceundertest.html#cfn-iotcoredeviceadvisor-suitedefinition-deviceundertest-certificatearn
*/
readonly certificateArn?: string;
/**
* Lists devices thing ARN.
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iotcoredeviceadvisor-suitedefinition-deviceundertest.html#cfn-iotcoredeviceadvisor-suitedefinition-deviceundertest-thingarn
*/
readonly thingArn?: string;
}
}
export declare namespace CfnSuiteDefinition {
/**
* Gets the suite definition configuration.
*
* @struct
* @stability external
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration.html
*/
interface SuiteDefinitionConfigurationProperty {
/**
* Gets the device permission ARN. This is a required parameter.
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration.html#cfn-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration-devicepermissionrolearn
*/
readonly devicePermissionRoleArn: string;
/**
* Gets the devices configured.
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration.html#cfn-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration-devices
*/
readonly devices?: Array<CfnSuiteDefinition.DeviceUnderTestProperty | cdk.IResolvable> | cdk.IResolvable;
/**
* Gets the tests intended for qualification in a suite.
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration.html#cfn-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration-intendedforqualification
*/
readonly intendedForQualification?: boolean | cdk.IResolvable;
/**
* Gets the test suite root group. This is a required parameter.
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration.html#cfn-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration-rootgroup
*/
readonly rootGroup: string;
/**
* Gets the suite definition name. This is a required parameter.
*
* @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration.html#cfn-iotcoredeviceadvisor-suitedefinition-suitedefinitionconfiguration-suitedefinitionname
*/
readonly suiteDefinitionName?: string;
}
}