aws-cdk-lib.aws_iotsitewise.CfnPortalProps

interface CfnPortalProps

LanguageType name
.NETAmazon.CDK.AWS.IoTSiteWise.CfnPortalProps
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsiotsitewise#CfnPortalProps
Javasoftware.amazon.awscdk.services.iotsitewise.CfnPortalProps
Pythonaws_cdk.aws_iotsitewise.CfnPortalProps
TypeScript aws-cdk-lib » aws_iotsitewise » CfnPortalProps

Properties for defining a CfnPortal.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_iotsitewise as iotsitewise } from 'aws-cdk-lib';

declare const alarms: any;
const cfnPortalProps: iotsitewise.CfnPortalProps = {
  portalContactEmail: 'portalContactEmail',
  portalName: 'portalName',
  roleArn: 'roleArn',

  // the properties below are optional
  alarms: alarms,
  notificationSenderEmail: 'notificationSenderEmail',
  portalAuthMode: 'portalAuthMode',
  portalDescription: 'portalDescription',
  tags: [{
    key: 'key',
    value: 'value',
  }],
};

Properties

NameTypeDescription
portalContactEmailstringThe AWS administrator's contact email address.
portalNamestringA friendly name for the portal.
roleArnstringThe ARN of a service role that allows the portal's users to access your AWS IoT SiteWise resources on your behalf. For more information, see Using service roles for AWS IoT SiteWise Monitor in the AWS IoT SiteWise User Guide .
alarms?anyContains the configuration information of an alarm created in an AWS IoT SiteWise Monitor portal.
notificationSenderEmail?stringThe email address that sends alarm notifications.
portalAuthMode?stringThe service to use to authenticate users to the portal. Choose from the following options:.
portalDescription?stringA description for the portal.
tags?CfnTag[]A list of key-value pairs that contain metadata for the portal.

portalContactEmail

Type: string

The AWS administrator's contact email address.


portalName

Type: string

A friendly name for the portal.


roleArn

Type: string

The ARN of a service role that allows the portal's users to access your AWS IoT SiteWise resources on your behalf. For more information, see Using service roles for AWS IoT SiteWise Monitor in the AWS IoT SiteWise User Guide .


alarms?

Type: any (optional)

Contains the configuration information of an alarm created in an AWS IoT SiteWise Monitor portal.

You can use the alarm to monitor an asset property and get notified when the asset property value is outside a specified range. For more information, see Monitoring with alarms in the AWS IoT SiteWise Application Guide .


notificationSenderEmail?

Type: string (optional)

The email address that sends alarm notifications.

If you use the AWS IoT Events managed Lambda function to manage your emails, you must verify the sender email address in Amazon SES .


portalAuthMode?

Type: string (optional)

The service to use to authenticate users to the portal. Choose from the following options:.

  • SSO – The portal uses AWS IAM Identity Center (successor to AWS Single Sign-On) to authenticate users and manage user permissions. Before you can create a portal that uses IAM Identity Center , you must enable IAM Identity Center . For more information, see Enabling IAM Identity Center in the AWS IoT SiteWise User Guide . This option is only available in AWS Regions other than the China Regions.
  • IAM – The portal uses AWS Identity and Access Management ( IAM ) to authenticate users and manage user permissions.

You can't change this value after you create a portal.

Default: SSO


portalDescription?

Type: string (optional)

A description for the portal.


tags?

Type: CfnTag[] (optional)

A list of key-value pairs that contain metadata for the portal.

For more information, see Tagging your AWS IoT SiteWise resources in the AWS IoT SiteWise User Guide .