@aws-sdk/client-iot

import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client"; import { IoTServiceException as __BaseException } from "./IoTServiceException"; import { AbortConfig, Action, ActiveViolation, AggregationType, AlertTarget, AlertTargetType, ApplicationProtocol, AuditCheckConfiguration, AuditCheckDetails, AuditFinding, AuditFrequency, AuditMitigationActionExecutionMetadata, AuditMitigationActionsExecutionStatus, AuditMitigationActionsTaskMetadata, AuditMitigationActionsTaskStatus, AuditMitigationActionsTaskTarget, AuditNotificationTarget, AuditNotificationType, AuditSuppression, AuditTaskMetadata, AuditTaskStatus, AuditTaskType, AuthenticationType, AuthorizerConfig, AuthorizerDescription, AuthorizerStatus, AuthorizerSummary, AutoRegistrationStatus, AwsJobExecutionsRolloutConfig, AwsJobPresignedUrlConfig, Behavior, BillingGroupProperties, CertificateProviderOperation, ClientCertificateConfig, CommandNamespace, CommandParameter, CommandParameterValue, CommandPayload, CustomMetricType, DayOfWeek, DimensionType, FleetMetricUnit, HttpUrlDestinationProperties, JobExecutionsRetryConfig, JobExecutionsRolloutConfig, LogLevel, MaintenanceWindow, MetricsExportConfig, MetricToRetain, MitigationActionParams, OTAUpdateFile, OTAUpdateStatus, PackageVersionArtifact, PackageVersionStatus, Policy, PresignedUrlConfig, Protocol, ProvisioningHook, ResourceIdentifier, Sbom, SbomValidationStatus, SchedulingConfig, ServerCertificateConfig, ServiceType, StreamFile, TargetSelection, TaskStatisticsForAuditCheck, TemplateType, ThingGroupProperties, ThingTypeProperties, TimeoutConfig, TlsConfig, TopicRuleDestinationStatus, VerificationState } from "./models_0"; /** * The properties of a virtual private cloud (VPC) destination. * @public */ export interface VpcDestinationProperties { /** * The subnet IDs of the VPC destination. * @public */ subnetIds?: string[] | undefined; /** * The security groups of the VPC destination. * @public */ securityGroups?: string[] | undefined; /** * The ID of the VPC. * @public */ vpcId?: string | undefined; /** * The ARN of a role that has permission to create and attach to elastic network interfaces (ENIs). * @public */ roleArn?: string | undefined; } /** * A topic rule destination. * @public */ export interface TopicRuleDestination { /** * The topic rule destination URL. * @public */ arn?: string | undefined; /** * The status of the topic rule destination. Valid values are: * <dl> * <dt>IN_PROGRESS</dt> * <dd> * A topic rule destination was created but has not been confirmed. You can set * <code>status</code> to <code>IN_PROGRESS</code> by calling * <code>UpdateTopicRuleDestination</code>. Calling * <code>UpdateTopicRuleDestination</code> causes a new confirmation challenge to * be sent to your confirmation endpoint. * </dd> * <dt>ENABLED</dt> * <dd> * Confirmation was completed, and traffic to this destination is allowed. You can * set <code>status</code> to <code>DISABLED</code> by calling * <code>UpdateTopicRuleDestination</code>. * </dd> * <dt>DISABLED</dt> * <dd> * Confirmation was completed, and traffic to this destination is not allowed. You * can set <code>status</code> to <code>ENABLED</code> by calling * <code>UpdateTopicRuleDestination</code>. * </dd> * <dt>ERROR</dt> * <dd> * Confirmation could not be completed, for example if the confirmation timed out. * You can call <code>GetTopicRuleDestination</code> for details about the error. You * can set <code>status</code> to <code>IN_PROGRESS</code> by calling * <code>UpdateTopicRuleDestination</code>. Calling * <code>UpdateTopicRuleDestination</code> causes a new confirmation challenge to * be sent to your confirmation endpoint. * </dd> * </dl> * @public */ status?: TopicRuleDestinationStatus | undefined; /** * The date and time when the topic rule destination was created. * @public */ createdAt?: Date | undefined; /** * The date and time when the topic rule destination was last updated. * @public */ lastUpdatedAt?: Date | undefined; /** * Additional details or reason why the topic rule destination is in the current * status. * @public */ statusReason?: string | undefined; /** * Properties of the HTTP URL. * @public */ httpUrlProperties?: HttpUrlDestinationProperties | undefined; /** * Properties of the virtual private cloud (VPC) connection. * @public */ vpcProperties?: VpcDestinationProperties | undefined; } /** * @public */ export interface CreateTopicRuleDestinationResponse { /** * The topic rule destination. * @public */ topicRuleDestination?: TopicRuleDestination | undefined; } /** * @public */ export interface DeleteAccountAuditConfigurationRequest { /** * If true, all scheduled audits are deleted. * @public */ deleteScheduledAudits?: boolean | undefined; } /** * @public */ export interface DeleteAccountAuditConfigurationResponse { } /** * @public */ export interface DeleteAuditSuppressionRequest { /** * An audit check name. Checks must be enabled * for your account. (Use <code>DescribeAccountAuditConfiguration</code> to see the list * of all checks, including those that are enabled or use <code>UpdateAccountAuditConfiguration</code> * to select which checks are enabled.) * @public */ checkName: string | undefined; /** * Information that identifies the noncompliant resource. * @public */ resourceIdentifier: ResourceIdentifier | undefined; } /** * @public */ export interface DeleteAuditSuppressionResponse { } /** * @public */ export interface DeleteAuthorizerRequest { /** * The name of the authorizer to delete. * @public */ authorizerName: string | undefined; } /** * @public */ export interface DeleteAuthorizerResponse { } /** * You can't delete the resource because it is attached to one or more * resources. * @public */ export declare class DeleteConflictException extends __BaseException { readonly name: "DeleteConflictException"; readonly $fault: "client"; /** * @internal */ constructor(opts: __ExceptionOptionType<DeleteConflictException, __BaseException>); } /** * @public */ export interface DeleteBillingGroupRequest { /** * The name of the billing group. * @public */ billingGroupName: string | undefined; /** * The expected version of the billing group. If the version of the billing group does * not match the expected version specified in the request, the * <code>DeleteBillingGroup</code> request is rejected with a * <code>VersionConflictException</code>. * @public */ expectedVersion?: number | undefined; } /** * @public */ export interface DeleteBillingGroupResponse { } /** * The certificate operation is not allowed. * @public */ export declare class CertificateStateException extends __BaseException { readonly name: "CertificateStateException"; readonly $fault: "client"; /** * @internal */ constructor(opts: __ExceptionOptionType<CertificateStateException, __BaseException>); } /** * Input for the DeleteCACertificate operation. * @public */ export interface DeleteCACertificateRequest { /** * The ID of the certificate to delete. (The last part of the certificate ARN contains * the certificate ID.) * @public */ certificateId: string | undefined; } /** * The output for the DeleteCACertificate operation. * @public */ export interface DeleteCACertificateResponse { } /** * The input for the DeleteCertificate operation. * @public */ export interface DeleteCertificateRequest { /** * The ID of the certificate. (The last part of the certificate ARN contains the * certificate ID.) * @public */ certificateId: string | undefined; /** * Forces the deletion of a certificate if it is inactive and is not attached to an IoT * thing. * @public */ forceDelete?: boolean | undefined; } /** * @public */ export interface DeleteCertificateProviderRequest { /** * The name of the certificate provider. * @public */ certificateProviderName: string | undefined; } /** * @public */ export interface DeleteCertificateProviderResponse { } /** * @public */ export interface DeleteCommandRequest { /** * The unique identifier of the command to be deleted. * @public */ commandId: string | undefined; } /** * @public */ export interface DeleteCommandResponse { /** * The status code for the command deletion request. The status code is in the 200 range * for a successful request. * <ul> * <li> * If the command hasn't been deprecated, or has been deprecated for a duration that * is shorter than the maximum time out duration of 12 hours, when calling the * <code>DeleteCommand</code> request, the deletion will be scheduled and a 202 status code * will be returned. While the command is being deleted, it will be in a * <code>pendingDeletion</code> state. Once the time out duration has been reached, * the command will be permanently removed from your account. * </li> * <li> * If the command has been deprecated for a duration that is longer than the * maximum time out duration of 12 hours, when calling the <code>DeleteCommand</code> request, * the command will be deleted immediately and a 204 status code will be returned. * </li> * </ul> * @public */ statusCode?: number | undefined; } /** * @public */ export interface DeleteCommandExecutionRequest { /** * The unique identifier of the command execution that you want to delete from your * account. * @public */ executionId: string | undefined; /** * The Amazon Resource Number (ARN) of the target device for which you want to delete * command executions. * @public */ targetArn: string | undefined; } /** * @public */ export interface DeleteCommandExecutionResponse { } /** * @public */ export interface DeleteCustomMetricRequest { /** * * The name of the custom metric. * * @public */ metricName: string | undefined; } /** * @public */ export interface DeleteCustomMetricResponse { } /** * @public */ export interface DeleteDimensionRequest { /** * The unique identifier for the dimension that you want to delete. * @public */ name: string | undefined; } /** * @public */ export interface DeleteDimensionResponse { } /** * @public */ export interface DeleteDomainConfigurationRequest { /** * The name of the domain configuration to be deleted. * @public */ domainConfigurationName: string | undefined; } /** * @public */ export interface DeleteDomainConfigurationResponse { } /** * @public */ export interface DeleteDynamicThingGroupRequest { /** * The name of the dynamic thing group to delete. * @public */ thingGroupName: string | undefined; /** * The expected version of the dynamic thing group to delete. * @public */ expectedVersion?: number | undefined; } /** * @public */ export interface DeleteDynamicThingGroupResponse { } /** * @public */ export interface DeleteFleetMetricRequest { /** * The name of the fleet metric to delete. * @public */ metricName: string | undefined; /** * The expected version of the fleet metric to delete. * @public */ expectedVersion?: number | undefined; } /** * @public */ export interface DeleteJobRequest { /** * The ID of the job to be deleted. * After a job deletion is completed, you may reuse this jobId when you create a new * job. However, this is not recommended, and you must ensure that your devices are not * using the jobId to refer to the deleted job. * @public */ jobId: string | undefined; /** * (Optional) When true, you can delete a job which is "IN_PROGRESS". Otherwise, you * can only delete a job which is in a terminal state ("COMPLETED" or "CANCELED") or an * exception will occur. The default is false. * <note> * Deleting a job which is "IN_PROGRESS", will cause a device which is executing * the job to be unable to access job information or update the job execution status. * Use caution and ensure that each device executing a job which is deleted is able to * recover to a valid state. * </note> * @public */ force?: boolean | undefined; /** * The namespace used to indicate that a job is a customer-managed job. * When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to * MQTT topics that contain the value in the following format. * * <code>$aws/things/THING_NAME/jobs/JOB_ID/notify-namespace-NAMESPACE_ID/</code> * * <note> * The <code>namespaceId</code> feature is only supported by IoT Greengrass at this time. For * more information, see <a href="https://docs.aws.amazon.com/greengrass/v2/developerguide/setting-up.html">Setting up IoT Greengrass core devices.</a> * * </note> * @public */ namespaceId?: string | undefined; } /** * @public */ export interface DeleteJobExecutionRequest { /** * The ID of the job whose execution on a particular device will be deleted. * @public */ jobId: string | undefined; /** * The name of the thing whose job execution will be deleted. * @public */ thingName: string | undefined; /** * The ID of the job execution to be deleted. The <code>executionNumber</code> refers * to the execution of a particular job on a particular device. * Note that once a job execution is deleted, the <code>executionNumber</code> may be * reused by IoT, so be sure you get and use the correct value here. * @public */ executionNumber: number | undefined; /** * (Optional) When true, you can delete a job execution which is "IN_PROGRESS". * Otherwise, you can only delete a job execution which is in a terminal state * ("SUCCEEDED", "FAILED", "REJECTED", "REMOVED" or "CANCELED") or an exception will occur. * The default is false. * <note> * Deleting a job execution which is "IN_PROGRESS", will cause the device to be * unable to access job information or update the job execution status. Use caution and * ensure that the device is able to recover to a valid state. * </note> * @public */ force?: boolean | undefined; /** * The namespace used to indicate that a job is a customer-managed job. * When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to * MQTT topics that contain the value in the following format. * * <code>$aws/things/THING_NAME/jobs/JOB_ID/notify-namespace-NAMESPACE_ID/</code> * * <note> * The <code>namespaceId</code> feature is only supported by IoT Greengrass at this time. For * more information, see <a href="https://docs.aws.amazon.com/greengrass/v2/developerguide/setting-up.html">Setting up IoT Greengrass core devices.</a> * * </note> * @public */ namespaceId?: string | undefined; } /** * @public */ export interface DeleteJobTemplateRequest { /** * The unique identifier of the job template to delete. * @public */ jobTemplateId: string | undefined; } /** * @public */ export interface DeleteMitigationActionRequest { /** * The name of the mitigation action that you want to delete. * @public */ actionName: string | undefined; } /** * @public */ export interface DeleteMitigationActionResponse { } /** * @public */ export interface DeleteOTAUpdateRequest { /** * The ID of the OTA update to delete. * @public */ otaUpdateId: string | undefined; /** * When true, the stream created by the OTAUpdate process is deleted when the OTA update is deleted. * Ignored if the stream specified in the OTAUpdate is supplied by the user. * @public */ deleteStream?: boolean | undefined; /** * When true, deletes the IoT job created by the OTAUpdate process even if it is "IN_PROGRESS". Otherwise, if the * job is not in a terminal state ("COMPLETED" or "CANCELED") an exception will occur. The default is false. * @public */ forceDeleteAWSJob?: boolean | undefined; } /** * @public */ export interface DeleteOTAUpdateResponse { } /** * @public */ export interface DeletePackageRequest { /** * The name of the target software package. * @public */ packageName: string | undefined; /** * A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. * Don't reuse this client token if a new idempotent request is required. * @public */ clientToken?: string | undefined; } /** * @public */ export interface DeletePackageResponse { } /** * @public */ export interface DeletePackageVersionRequest { /** * The name of the associated software package. * @public */ packageName: string | undefined; /** * The name of the target package version. * @public */ versionName: string | undefined; /** * A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. * Don't reuse this client token if a new idempotent request is required. * @public */ clientToken?: string | undefined; } /** * @public */ export interface DeletePackageVersionResponse { } /** * The input for the DeletePolicy operation. * @public */ export interface DeletePolicyRequest { /** * The name of the policy to delete. * @public */ policyName: string | undefined; } /** * The input for the DeletePolicyVersion operation. * @public */ export interface DeletePolicyVersionRequest { /** * The name of the policy. * @public */ policyName: string | undefined; /** * The policy version ID. * @public */ policyVersionId: string | undefined; } /** * @public */ export interface DeleteProvisioningTemplateRequest { /** * The name of the fleet provision template to delete. * @public */ templateName: string | undefined; } /** * @public */ export interface DeleteProvisioningTemplateResponse { } /** * @public */ export interface DeleteProvisioningTemplateVersionRequest { /** * The name of the provisioning template version to delete. * @public */ templateName: string | undefined; /** * The provisioning template version ID to delete. * @public */ versionId: number | undefined; } /** * @public */ export interface DeleteProvisioningTemplateVersionResponse { } /** * The input for the DeleteRegistrationCode operation. * @public */ export interface DeleteRegistrationCodeRequest { } /** * The output for the DeleteRegistrationCode operation. * @public */ export interface DeleteRegistrationCodeResponse { } /** * @public */ export interface DeleteRoleAliasRequest { /** * The role alias to delete. * @public */ roleAlias: string | undefined; } /** * @public */ export interface DeleteRoleAliasResponse { } /** * @public */ export interface DeleteScheduledAuditRequest { /** * The name of the scheduled audit you want to delete. * @public */ scheduledAuditName: string | undefined; } /** * @public */ export interface DeleteScheduledAuditResponse { } /** * @public */ export interface DeleteSecurityProfileRequest { /** * The name of the security profile to be deleted. * @public */ securityProfileName: string | undefined; /** * The expected version of the security profile. A new version is generated whenever * the security profile is updated. If you specify a value that is different from the actual * version, a <code>VersionConflictException</code> is thrown. * @public */ expectedVersion?: number | undefined; } /** * @public */ export interface DeleteSecurityProfileResponse { } /** * @public */ export interface DeleteStreamRequest { /** * The stream ID. * @public */ streamId: string | undefined; } /** * @public */ export interface DeleteStreamResponse { } /** * The input for the DeleteThing operation. * @public */ export interface DeleteThingRequest { /** * The name of the thing to delete. * @public */ thingName: string | undefined; /** * The expected version of the thing record in the registry. If the version of the * record in the registry does not match the expected version specified in the request, the * <code>DeleteThing</code> request is rejected with a * <code>VersionConflictException</code>. * @public */ expectedVersion?: number | undefined; } /** * The output of the DeleteThing operation. * @public */ export interface DeleteThingResponse { } /** * @public */ export interface DeleteThingGroupRequest { /** * The name of the thing group to delete. * @public */ thingGroupName: string | undefined; /** * The expected version of the thing group to delete. * @public */ expectedVersion?: number | undefined; } /** * @public */ export interface DeleteThingGroupResponse { } /** * The input for the DeleteThingType operation. * @public */ export interface DeleteThingTypeRequest { /** * The name of the thing type. * @public */ thingTypeName: string | undefined; } /** * The output for the DeleteThingType operation. * @public */ export interface DeleteThingTypeResponse { } /** * The input for the DeleteTopicRule operation. * @public */ export interface DeleteTopicRuleRequest { /** * The name of the rule. * @public */ ruleName: string | undefined; } /** * @public */ export interface DeleteTopicRuleDestinationRequest { /** * The ARN of the topic rule destination to delete. * @public */ arn: string | undefined; } /** * @public */ export interface DeleteTopicRuleDestinationResponse { } /** * @public * @enum */ export declare const LogTargetType: { readonly CLIENT_ID: "CLIENT_ID"; readonly DEFAULT: "DEFAULT"; readonly PRINCIPAL_ID: "PRINCIPAL_ID"; readonly SOURCE_IP: "SOURCE_IP"; readonly THING_GROUP: "THING_GROUP"; }; /** * @public */ export type LogTargetType = (typeof LogTargetType)[keyof typeof LogTargetType]; /** * @public */ export interface DeleteV2LoggingLevelRequest { /** * The type of resource for which you are configuring logging. Must be * <code>THING_Group</code>. * @public */ targetType: LogTargetType | undefined; /** * The name of the resource for which you are configuring logging. * @public */ targetName: string | undefined; } /** * The input for the DeprecateThingType operation. * @public */ export interface DeprecateThingTypeRequest { /** * The name of the thing type to deprecate. * @public */ thingTypeName: string | undefined; /** * Whether to undeprecate a deprecated thing type. If true, the thing type will not be deprecated anymore and you can * associate it with things. * @public */ undoDeprecate?: boolean | undefined; } /** * The output for the DeprecateThingType operation. * @public */ export interface DeprecateThingTypeResponse { } /** * @public */ export interface DescribeAccountAuditConfigurationRequest { } /** * @public */ export interface DescribeAccountAuditConfigurationResponse { /** * The ARN of the role that grants permission to IoT to access information * about your devices, policies, certificates, and other items as required when * performing an audit. * On the first call to <code>UpdateAccountAuditConfiguration</code>, * this parameter is required. * @public */ roleArn?: string | undefined; /** * Information about the targets to which audit notifications are sent for * this account. * @public */ auditNotificationTargetConfigurations?: Partial<Record<AuditNotificationType, AuditNotificationTarget>> | undefined; /** * Which audit checks are enabled and disabled for this account. * @public */ auditCheckConfigurations?: Record<string, AuditCheckConfiguration> | undefined; } /** * @public */ export interface DescribeAuditFindingRequest { /** * A unique identifier for a single audit finding. You can use this identifier to apply mitigation actions to the finding. * @public */ findingId: string | undefined; } /** * @public */ export interface DescribeAuditFindingResponse { /** * The findings (results) of the audit. * @public */ finding?: AuditFinding | undefined; } /** * @public */ export interface DescribeAuditMitigationActionsTaskRequest { /** * The unique identifier for the audit mitigation task. * @public */ taskId: string | undefined; } /** * Describes which changes should be applied as part of a mitigation action. * @public */ export interface MitigationAction { /** * A user-friendly name for the mitigation action. * @public */ name?: string | undefined; /** * A unique identifier for the mitigation action. * @public */ id?: string | undefined; /** * The IAM role ARN used to apply this mitigation action. * @public */ roleArn?: string | undefined; /** * The set of parameters for this mitigation action. The parameters vary, depending on the kind of action you apply. * @public */ actionParams?: MitigationActionParams | undefined; } /** * @public */ export interface DescribeAuditMitigationActionsTaskResponse { /** * The current status of the task. * @public */ taskStatus?: AuditMitigationActionsTaskStatus | undefined; /** * The date and time when the task was started. * @public */ startTime?: Date | undefined; /** * The date and time when the task was completed or canceled. * @public */ endTime?: Date | undefined; /** * Aggregate counts of the results when the mitigation tasks were applied to the findings for this audit mitigation actions task. * @public */ taskStatistics?: Record<string, TaskStatisticsForAuditCheck> | undefined; /** * Identifies the findings to which the mitigation actions are applied. This can be by audit checks, by audit task, or a set of findings. * @public */ target?: AuditMitigationActionsTaskTarget | undefined; /** * Specifies the mitigation actions that should be applied to specific audit checks. * @public */ auditCheckToActionsMapping?: Record<string, string[]> | undefined; /** * Specifies the mitigation actions and their parameters that are applied as part of this task. * @public */ actionsDefinition?: MitigationAction[] | undefined; } /** * @public */ export interface DescribeAuditSuppressionRequest { /** * An audit check name. Checks must be enabled * for your account. (Use <code>DescribeAccountAuditConfiguration</code> to see the list * of all checks, including those that are enabled or use <code>UpdateAccountAuditConfiguration</code> * to select which checks are enabled.) * @public */ checkName: string | undefined; /** * Information that identifies the noncompliant resource. * @public */ resourceIdentifier: ResourceIdentifier | undefined; } /** * @public */ export interface DescribeAuditSuppressionResponse { /** * An audit check name. Checks must be enabled * for your account. (Use <code>DescribeAccountAuditConfiguration</code> to see the list * of all checks, including those that are enabled or use <code>UpdateAccountAuditConfiguration</code> * to select which checks are enabled.) * @public */ checkName?: string | undefined; /** * Information that identifies the noncompliant resource. * @public */ resourceIdentifier?: ResourceIdentifier | undefined; /** * * The epoch timestamp in seconds at which this suppression expires. * * @public */ expirationDate?: Date | undefined; /** * * Indicates whether a suppression should exist indefinitely or not. * * @public */ suppressIndefinitely?: boolean | undefined; /** * * The description of the audit suppression. * * @public */ description?: string | undefined; } /** * @public */ export interface DescribeAuditTaskRequest { /** * The ID of the audit whose information you want to get. * @public */ taskId: string | undefined; } /** * Statistics for the checks performed during the audit. * @public */ export interface TaskStatistics { /** * The number of checks in this audit. * @public */ totalChecks?: number | undefined; /** * The number of checks in progress. * @public */ inProgressChecks?: number | undefined; /** * The number of checks waiting for data collection. * @public */ waitingForDataCollectionChecks?: number | undefined; /** * The number of checks that found compliant resources. * @public */ compliantChecks?: number | undefined; /** * The number of checks that found noncompliant resources. * @public */ nonCompliantChecks?: number | undefined; /** * The number of checks. * @public */ failedChecks?: number | undefined; /** * The number of checks that did not run because the audit was canceled. * @public */ canceledChecks?: number | undefined; } /** * @public */ export interface DescribeAuditTaskResponse { /** * The status of the audit: one of "IN_PROGRESS", "COMPLETED", * "FAILED", or "CANCELED". * @public */ taskStatus?: AuditTaskStatus | undefined; /** * The type of audit: "ON_DEMAND_AUDIT_TASK" or "SCHEDULED_AUDIT_TASK". * @public */ taskType?: AuditTaskType | undefined; /** * The time the audit started. * @public */ taskStartTime?: Date | undefined; /** * Statistical information about the audit. * @public */ taskStatistics?: TaskStatistics | undefined; /** * The name of the scheduled audit (only if the audit was a scheduled audit). * @public */ scheduledAuditName?: string | undefined; /** * Detailed information about each check performed during this audit. * @public */ auditDetails?: Record<string, AuditCheckDetails> | undefined; } /** * @public */ export interface DescribeAuthorizerRequest { /** * The name of the authorizer to describe. * @public */ authorizerName: string | undefined; } /** * @public */ export interface DescribeAuthorizerResponse { /** * The authorizer description. * @public */ authorizerDescription?: AuthorizerDescription | undefined; } /** * @public */ export interface DescribeBillingGroupRequest { /** * The name of the billing group. * @public */ billingGroupName: string | undefined; } /** * Additional information about the billing group. * @public */ export interface BillingGroupMetadata { /** * The date the billing group was created. * @public */ creationDate?: Date | undefined; } /** * @public */ export interface DescribeBillingGroupResponse { /** * The name of the billing group. * @public */ billingGroupName?: string | undefined; /** * The ID of the billing group. * @public */ billingGroupId?: string | undefined; /** * The ARN of the billing group. * @public */ billingGroupArn?: string | undefined; /** * The version of the billing group. * @public */ version?: number | undefined; /** * The properties of the billing group. * @public */ billingGroupProperties?: BillingGroupProperties | undefined; /** * Additional information about the billing group. * @public */ billingGroupMetadata?: BillingGroupMetadata | undefined; } /** * The input for the DescribeCACertificate operation. * @public */ export interface DescribeCACertificateRequest { /** * The CA certificate identifier. * @public */ certificateId: string | undefined; } /** * @public * @enum */ export declare const CertificateMode: { readonly DEFAULT: "DEFAULT"; readonly SNI_ONLY: "SNI_ONLY"; }; /** * @public */ export type CertificateMode = (typeof CertificateMode)[keyof typeof CertificateMode]; /** * @public * @enum */ export declare const CACertificateStatus: { readonly ACTIVE: "ACTIVE"; readonly INACTIVE: "INACTIVE"; }; /** * @public */ export type CACertificateStatus = (typeof CACertificateStatus)[keyof typeof CACertificateStatus]; /** * When the certificate is valid. * @public */ export interface CertificateValidity { /** * The certificate is not valid before this date. * @public */ notBefore?: Date | undefined; /** * The certificate is not valid after this date. * @public */ notAfter?: Date | undefined; } /** * Describes a CA certificate. * @public */ export interface CACertificateDescription { /** * The CA certificate ARN. * @public */ certificateArn?: string | undefined; /** * The CA certificate ID. * @public */ certificateId?: string | undefined; /** * The status of a CA certificate. * @public */ status?: CACertificateStatus | undefined; /** * The CA certificate data, in PEM format. * @public */ certificatePem?: string | undefined; /** * The owner of the CA certificate. * @public */ ownedBy?: string | undefined; /** * The date the CA certificate was created. * @public */ creationDate?: Date | undefined; /** * Whether the CA certificate configured for auto registration of device certificates. * Valid values are "ENABLE" and "DISABLE" * @public */ autoRegistrationStatus?: AutoRegistrationStatus | undefined; /** * The date the CA certificate was last modified. * @public */ lastModifiedDate?: Date | undefined; /** * The customer version of the CA certificate. * @public */ customerVersion?: number | undefined; /** * The generation ID of the CA certificate. * @public */ generationId?: string | undefined; /** * When the CA certificate is valid. * @public */ validity?: CertificateValidity | undefined; /** * The mode of the CA. * All the device certificates that are registered using this CA will be registered * in the same mode as the CA. For more information about certificate mode for device certificates, see <a href="https://docs.aws.amazon.com/iot/latest/apireference/API_CertificateDescription.html#iot-Type-CertificateDescription-certificateMode">certificate mode</a>. * @public */ certificateMode?: CertificateMode | undefined; } /** * The registration configuration. * @public */ export interface RegistrationConfig { /** * The template body. * @public */ templateBody?: string | undefined; /** * The ARN of the role. * @public */ roleArn?: string | undefined; /** * The name of the provisioning template. * @public */ templateName?: string | undefined; } /** * The output from the DescribeCACertificate operation. * @public */ export interface DescribeCACertificateResponse { /** * The CA certificate description. * @public */ certificateDescription?: CACertificateDescription | undefined; /** * Information about the registration configuration. * @public */ registrationConfig?: RegistrationConfig | undefined; } /** * The input for the DescribeCertificate operation. * @public */ export interface DescribeCertificateRequest { /** * The ID of the certificate. (The last part of the certificate ARN contains the * certificate ID.) * @public */ certificateId: string | undefined; } /** * @public * @enum */ export declare const CertificateStatus: { readonly ACTIVE: "ACTIVE"; readonly INACTIVE: "INACTIVE"; readonly PENDING_ACTIVATION: "PENDING_ACTIVATION"; readonly PENDING_TRANSFER: "PENDING_TRANSFER"; readonly REGISTER_INACTIVE: "REGISTER_INACTIVE"; readonly REVOKED: "REVOKED"; }; /** * @public */ export type CertificateStatus = (typeof CertificateStatus)[keyof typeof CertificateStatus]; /** * Data used to transfer a certificate to an Amazon Web Services account. * @public */ export interface TransferData { /** * The transfer message. * @public */ transferMessage?: string | undefined; /** * The reason why the transfer was rejected. * @public */ rejectReason?: string | undefined; /** * The date the transfer took place. * @public */ transferDate?: Date | undefined; /** * The date the transfer was accepted. * @public */ acceptDate?: Date | undefined; /** * The date the transfer was rejected. * @public */ rejectDate?: Date | undefined; } /** * Describes a certificate. * @public */ export interface CertificateDescription { /** * The ARN of the certificate. * @public */ certificateArn?: string | undefined; /** * The ID of the certificate. * @public */ certificateId?: string | undefined; /** * The certificate ID of the CA certificate used to sign this certificate. * @public */ caCertificateId?: string | undefined; /** * The status of the certificate. * @public */ status?: CertificateStatus | undefined; /** * The certificate data, in PEM format. * @public */ certificatePem?: string | undefined; /** * The ID of the Amazon Web Services account that owns the certificate. * @public */ ownedBy?: string | undefined; /** * The ID of the Amazon Web Services account of the previous owner of the certificate. * @public */ previousOwnedBy?: string | undefined; /** * The date and time the certificate was created. * @public */ creationDate?: Date | undefined; /** * The date and time the certificate was last modified. * @public */ lastModifiedDate?: Date | undefined; /** * The customer version of the certificate. * @public */ customerVersion?: number | undefined; /** * The transfer data. * @public */ transferData?: TransferData | undefined; /** * The generation ID of the certificate. * @public */ generationId?: string | undefined; /** * When the certificate is valid. * @public */ validity?: CertificateValidity | undefined; /** * The mode of the certificate. * * <code>DEFAULT</code>: A certificate in <code>DEFAULT</code> mode is either generated by * Amazon Web Services IoT Core or registered with an issuer certificate authority (CA) in <code>DEFAULT</code> mode. Devices with * certificates in <code>DEFAULT</code> mode aren't required to send the Server Name * Indication (SNI) extension when connecting to Amazon Web Services IoT Core. However, to use features such as * custom domains and VPC endpoints, we recommend that you use the SNI extension when * connecting to Amazon Web Services IoT Core. * * <code>SNI_ONLY</code>: A certificate in <code>SNI_ONLY</code> mode is registered without an issuer CA. Devices with certificates * in <code>SNI_ONLY</code> mode must send the SNI extension when connecting to Amazon Web Services IoT Core. * For more information about the value for SNI extension, see <a href="https://docs.aws.amazon.com/iot/latest/developerguide/transport-security.html">Transport security in IoT</a>. * @public */ certificateMode?: CertificateMode | undefined; } /** * The output of the DescribeCertificate operation. * @public */ export interface DescribeCertificateResponse { /** * The description of the certificate. * @public */ certificateDescription?: CertificateDescription | undefined; } /** * @public */ export interface DescribeCertificateProviderRequest { /** * The name of the certificate provider. * @public */ certificateProviderName: string | undefined; } /** * @public */ export interface DescribeCertificateProviderResponse { /** * The name of the certificate provider. * @public */ certificateProviderName?: string | undefined; /** * The ARN of the certificate provider. * @public */ certificateProviderArn?: string | undefined; /** * The Lambda function ARN that's associated with the certificate provider. * @public */ lambdaFunctionArn?: string | undefined; /** * A list of the operations that the certificate provider will use to generate certificates. * Valid value: <code>CreateCertificateFromCsr</code>. * @public */ accountDefaultForOperations?: CertificateProviderOperation[] | undefined; /** * The date-time string that indicates when the certificate provider was created. * @public */ creationDate?: Date | undefined; /** * The date-time string that indicates when the certificate provider was last updated. * @public */ lastModifiedDate?: Date | undefined; } /** * @public */ export interface DescribeCustomMetricRequest { /** * * The name of the custom metric. * * @public */ metricName: string | undefined; } /** * @public */ export interface DescribeCustomMetricResponse { /** * * The name of the custom metric. * * @public */ metricName?: string | undefined; /** * * The Amazon Resource Number (ARN) of the custom metric. * * @public */ metricArn?: string | undefined; /** * The type of the custom metric. * <important> * The type <code>number</code> only takes a single metric value as an input, but while submitting the metrics value in the DeviceMetrics report, it must be passed as an array with a single value. * </important> * @public */ metricType?: CustomMetricType | undefined; /** * * Field represents a friendly name in the console for the custom metric; doesn't have to be unique. Don't use this name as the metric identifier in the device metric report. Can be updated. * * @public */ displayName?: string | undefined; /** * * The creation date of the custom metric in milliseconds since epoch. * * @public */ creationDate?: Date | undefined; /** * * The time the custom metric was last modified in milliseconds since epoch. * * @public */ lastModifiedDate?: Date | undefined; } /** * @public */ export interface DescribeDefaultAuthorizerRequest { } /** * @public */ export interface DescribeDefaultAuthorizerResponse { /** * The default authorizer's description. * @public */ authorizerDescription?: AuthorizerDescription | undefined; } /** * @public */ export interface DescribeDetectMitigationActionsTaskRequest { /** * * The unique identifier of the task. * * @public */ taskId: string | undefined; } /** * * The target of a mitigation action task. * * @public */ export interface DetectMitigationActionsTaskTarget { /** * * The unique identifiers of the violations. * * @public */ violationIds?: string[] | undefined; /** * * The name of the security profile. * * @public */ securityProfileName?: string | undefined; /** * * The name of the behavior. * * @public */ behaviorName?: string | undefined; } /** * * The statistics of a mitigation action task. * * @public */ export interface DetectMitigationActionsTaskStatistics { /** * * The actions that were performed. * * @public */ actionsExecuted?: number | undefined; /** * * The actions that were skipped. * * @public */ actionsSkipped?: number | undefined; /** * * The actions that failed. * * @public */ actionsFailed?: number | undefined; } /** * @public * @enum */ export declare const DetectMitigationActionsTaskStatus: { readonly CANCELED: "CANCELED"; readonly FAILED: "FAILED"; readonly IN_PROGRESS: "IN_PROGRESS"; readonly SUCCESSFUL: "SUCCESSFUL"; }; /** * @public */ export type DetectMitigationActionsTaskStatus = (typeof DetectMitigationActionsTaskStatus)[keyof typeof DetectMitigationActionsTaskStatus]; /** * * Specifies the time period of which violation events occurred between. * * @public */ export interface ViolationEventOccurrenceRange { /** * * The start date and time of a time period in which violation events occurred. * * @public