Skip to main content

portals_list_only

Lists portals in a region or regions, for all properties use portals

Overview

Nameportals_list_only
TypeResource
DescriptionResource schema for AWS::IoTSiteWise::Portal
Idaws.iotsitewise.portals_list_only

Fields

NameDatatypeDescription
portal_auth_modestringThe service to use to authenticate users to the portal. Choose from SSO or IAM. You can't change this value after you create a portal.
portal_arnstringThe ARN of the portal, which has the following format.
portal_client_idstringThe AWS SSO application generated client ID (used with AWS SSO APIs).
portal_contact_emailstringThe AWS administrator's contact email address.
portal_descriptionstringA description for the portal.
portal_idstringThe ID of the portal.
portal_namestringA friendly name for the portal.
portal_start_urlstringThe public root URL for the AWS IoT AWS IoT SiteWise Monitor application portal.
role_arnstringThe ARN of a service role that allows the portal's users to access your AWS IoT SiteWise resources on your behalf.
notification_sender_emailstringThe email address that sends alarm notifications.
alarmsobjectContains 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.
tagsarrayA list of key-value pairs that contain metadata for the portal.
regionstringAWS region.

Methods

NameAccessible byRequired Params
list_resourcesSELECTregion

SELECT examples

Lists all portals in a region.

SELECT
region,
portal_id
FROM aws.iotsitewise.portals_list_only
WHERE region = 'us-east-1';

Permissions

For permissions required to operate on the portals_list_only resource, see portals