1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. iot
  5. Logging

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

AWS Cloud Control v1.54.0 published on Monday, Feb 16, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.iot.Logging

aws-native logo

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

AWS Cloud Control v1.54.0 published on Monday, Feb 16, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Logging Options enable you to configure your IoT V2 logging role and default logging level so that you can monitor progress events logs as it passes from your devices through Iot core service.

    Create Logging Resource

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

    Constructor syntax

    new Logging(name: string, args: LoggingArgs, opts?: CustomResourceOptions);
    @overload
def Logging(resource_name: str,
            args: LoggingArgs,
            opts: Optional[ResourceOptions] = None)

@overload
def Logging(resource_name: str,
            opts: Optional[ResourceOptions] = None,
            account_id: Optional[str] = None,
            default_log_level: Optional[LoggingDefaultLogLevel] = None,
            role_arn: Optional[str] = None,
            event_configurations: Optional[Sequence[LoggingEventConfigurationArgs]] = None)
    func NewLogging(ctx *Context, name string, args LoggingArgs, opts ...ResourceOption) (*Logging, error)
    public Logging(string name, LoggingArgs args, CustomResourceOptions? opts = null)
    public Logging(String name, LoggingArgs args)
public Logging(String name, LoggingArgs args, CustomResourceOptions options)

    type: aws-native:iot:Logging
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 LoggingArgs
    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 LoggingArgs
    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 LoggingArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LoggingArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LoggingArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Logging 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 Logging resource accepts the following input properties:

    AccountId string
    Your 12-digit account ID (used as the primary identifier for the CloudFormation resource).
    DefaultLogLevel Pulumi.AwsNative.IoT.LoggingDefaultLogLevel
    The log level to use. Valid values are: ERROR, WARN, INFO, DEBUG, or DISABLED.
    RoleArn string
    The ARN of the role that allows IoT to write to Cloudwatch logs.
    EventConfigurations List<Pulumi.AwsNative.IoT.Inputs.LoggingEventConfiguration>
    Configurations for event-based logging that specifies which event types to log and their logging settings. Overrides account-level logging for the specified event
    AccountId string
    Your 12-digit account ID (used as the primary identifier for the CloudFormation resource).
    DefaultLogLevel LoggingDefaultLogLevel
    The log level to use. Valid values are: ERROR, WARN, INFO, DEBUG, or DISABLED.
    RoleArn string
    The ARN of the role that allows IoT to write to Cloudwatch logs.
    EventConfigurations []LoggingEventConfigurationArgs
    Configurations for event-based logging that specifies which event types to log and their logging settings. Overrides account-level logging for the specified event
    accountId String
    Your 12-digit account ID (used as the primary identifier for the CloudFormation resource).
    defaultLogLevel LoggingDefaultLogLevel
    The log level to use. Valid values are: ERROR, WARN, INFO, DEBUG, or DISABLED.
    roleArn String
    The ARN of the role that allows IoT to write to Cloudwatch logs.
    eventConfigurations List<LoggingEventConfiguration>
    Configurations for event-based logging that specifies which event types to log and their logging settings. Overrides account-level logging for the specified event
    accountId string
    Your 12-digit account ID (used as the primary identifier for the CloudFormation resource).
    defaultLogLevel LoggingDefaultLogLevel
    The log level to use. Valid values are: ERROR, WARN, INFO, DEBUG, or DISABLED.
    roleArn string
    The ARN of the role that allows IoT to write to Cloudwatch logs.
    eventConfigurations LoggingEventConfiguration[]
    Configurations for event-based logging that specifies which event types to log and their logging settings. Overrides account-level logging for the specified event
    account_id str
    Your 12-digit account ID (used as the primary identifier for the CloudFormation resource).
    default_log_level LoggingDefaultLogLevel
    The log level to use. Valid values are: ERROR, WARN, INFO, DEBUG, or DISABLED.
    role_arn str
    The ARN of the role that allows IoT to write to Cloudwatch logs.
    event_configurations Sequence[LoggingEventConfigurationArgs]
    Configurations for event-based logging that specifies which event types to log and their logging settings. Overrides account-level logging for the specified event
    accountId String
    Your 12-digit account ID (used as the primary identifier for the CloudFormation resource).
    defaultLogLevel "ERROR" | "WARN" | "INFO" | "DEBUG" | "DISABLED"
    The log level to use. Valid values are: ERROR, WARN, INFO, DEBUG, or DISABLED.
    roleArn String
    The ARN of the role that allows IoT to write to Cloudwatch logs.
    eventConfigurations List<Property Map>
    Configurations for event-based logging that specifies which event types to log and their logging settings. Overrides account-level logging for the specified event

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    LoggingDefaultLogLevel, LoggingDefaultLogLevelArgs

    Error
    ERROR
    Warn
    WARN
    Info
    INFO
    Debug
    DEBUG
    Disabled
    DISABLED
    LoggingDefaultLogLevelError
    ERROR
    LoggingDefaultLogLevelWarn
    WARN
    LoggingDefaultLogLevelInfo
    INFO
    LoggingDefaultLogLevelDebug
    DEBUG
    LoggingDefaultLogLevelDisabled
    DISABLED
    Error
    ERROR
    Warn
    WARN
    Info
    INFO
    Debug
    DEBUG
    Disabled
    DISABLED
    Error
    ERROR
    Warn
    WARN
    Info
    INFO
    Debug
    DEBUG
    Disabled
    DISABLED
    ERROR
    ERROR
    WARN
    WARN
    INFO
    INFO
    DEBUG
    DEBUG
    DISABLED
    DISABLED
    "ERROR"
    ERROR
    "WARN"
    WARN
    "INFO"
    INFO
    "DEBUG"
    DEBUG
    "DISABLED"
    DISABLED

    LoggingEventConfiguration, LoggingEventConfigurationArgs

    Configuration for event-based logging that specifies which event types to log and their logging settings. Used for account-level logging overrides.
    EventType string
    The type of event to log. These include event types like Connect, Publish, and Disconnect.
    LogDestination string
    CloudWatch Log Group for event-based logging. Specifies where log events should be sent. The log destination for event-based logging overrides default Log Group for the specified event type and applies to all resources associated with that event.
    LogLevel Pulumi.AwsNative.IoT.LoggingEventConfigurationLogLevel
    The logging level for the specified event type. Determines the verbosity of log messages generated for this event type.
    EventType string
    The type of event to log. These include event types like Connect, Publish, and Disconnect.
    LogDestination string
    CloudWatch Log Group for event-based logging. Specifies where log events should be sent. The log destination for event-based logging overrides default Log Group for the specified event type and applies to all resources associated with that event.
    LogLevel LoggingEventConfigurationLogLevel
    The logging level for the specified event type. Determines the verbosity of log messages generated for this event type.
    eventType String
    The type of event to log. These include event types like Connect, Publish, and Disconnect.
    logDestination String
    CloudWatch Log Group for event-based logging. Specifies where log events should be sent. The log destination for event-based logging overrides default Log Group for the specified event type and applies to all resources associated with that event.
    logLevel LoggingEventConfigurationLogLevel
    The logging level for the specified event type. Determines the verbosity of log messages generated for this event type.
    eventType string
    The type of event to log. These include event types like Connect, Publish, and Disconnect.
    logDestination string
    CloudWatch Log Group for event-based logging. Specifies where log events should be sent. The log destination for event-based logging overrides default Log Group for the specified event type and applies to all resources associated with that event.
    logLevel LoggingEventConfigurationLogLevel
    The logging level for the specified event type. Determines the verbosity of log messages generated for this event type.
    event_type str
    The type of event to log. These include event types like Connect, Publish, and Disconnect.
    log_destination str
    CloudWatch Log Group for event-based logging. Specifies where log events should be sent. The log destination for event-based logging overrides default Log Group for the specified event type and applies to all resources associated with that event.
    log_level LoggingEventConfigurationLogLevel
    The logging level for the specified event type. Determines the verbosity of log messages generated for this event type.
    eventType String
    The type of event to log. These include event types like Connect, Publish, and Disconnect.
    logDestination String
    CloudWatch Log Group for event-based logging. Specifies where log events should be sent. The log destination for event-based logging overrides default Log Group for the specified event type and applies to all resources associated with that event.
    logLevel "ERROR" | "WARN" | "INFO" | "DEBUG" | "DISABLED"
    The logging level for the specified event type. Determines the verbosity of log messages generated for this event type.

    LoggingEventConfigurationLogLevel, LoggingEventConfigurationLogLevelArgs

    Error
    ERROR
    Warn
    WARN
    Info
    INFO
    Debug
    DEBUG
    Disabled
    DISABLED
    LoggingEventConfigurationLogLevelError
    ERROR
    LoggingEventConfigurationLogLevelWarn
    WARN
    LoggingEventConfigurationLogLevelInfo
    INFO
    LoggingEventConfigurationLogLevelDebug
    DEBUG
    LoggingEventConfigurationLogLevelDisabled
    DISABLED
    Error
    ERROR
    Warn
    WARN
    Info
    INFO
    Debug
    DEBUG
    Disabled
    DISABLED
    Error
    ERROR
    Warn
    WARN
    Info
    INFO
    Debug
    DEBUG
    Disabled
    DISABLED
    ERROR
    ERROR
    WARN
    WARN
    INFO
    INFO
    DEBUG
    DEBUG
    DISABLED
    DISABLED
    "ERROR"
    ERROR
    "WARN"
    WARN
    "INFO"
    INFO
    "DEBUG"
    DEBUG
    "DISABLED"
    DISABLED

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

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

    AWS Cloud Control v1.54.0 published on Monday, Feb 16, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native
      Meet Neo: Your AI Platform Teammate