Skip to content

IoTClient#

Index > IoT > IoTClient

Auto-generated documentation for IoT type annotations stubs module mypy-boto3-iot.

IoTClient#

Type annotations and code completion for boto3.client("iot"). boto3 documentation

# IoTClient usage example

from boto3.session import Session
from mypy_boto3_iot.client import IoTClient

def get_iot_client() -> IoTClient:
    return Session().client("iot")

Exceptions#

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("iot").exceptions structure.

# Exceptions.exceptions usage example

client = boto3.client("iot")

try:
    do_something(client)
except (
    client.exceptions.CertificateConflictException,
    client.exceptions.CertificateStateException,
    client.exceptions.CertificateValidationException,
    client.exceptions.ClientError,
    client.exceptions.ConflictException,
    client.exceptions.ConflictingResourceUpdateException,
    client.exceptions.DeleteConflictException,
    client.exceptions.IndexNotReadyException,
    client.exceptions.InternalException,
    client.exceptions.InternalFailureException,
    client.exceptions.InternalServerException,
    client.exceptions.InvalidAggregationException,
    client.exceptions.InvalidQueryException,
    client.exceptions.InvalidRequestException,
    client.exceptions.InvalidResponseException,
    client.exceptions.InvalidStateTransitionException,
    client.exceptions.LimitExceededException,
    client.exceptions.MalformedPolicyException,
    client.exceptions.NotConfiguredException,
    client.exceptions.RegistrationCodeValidationException,
    client.exceptions.ResourceAlreadyExistsException,
    client.exceptions.ResourceNotFoundException,
    client.exceptions.ResourceRegistrationFailureException,
    client.exceptions.ServiceQuotaExceededException,
    client.exceptions.ServiceUnavailableException,
    client.exceptions.SqlParseException,
    client.exceptions.TaskAlreadyExistsException,
    client.exceptions.ThrottlingException,
    client.exceptions.TransferAlreadyCompletedException,
    client.exceptions.TransferConflictException,
    client.exceptions.UnauthorizedException,
    client.exceptions.ValidationException,
    client.exceptions.VersionConflictException,
    client.exceptions.VersionsLimitExceededException,
) as e:
    print(e)
# Exceptions.exceptions type checking example

from mypy_boto3_iot.client import Exceptions

def handle_error(exc: Exceptions.CertificateConflictException) -> None:
    ...

Methods#

accept_certificate_transfer#

Accepts a pending certificate transfer.

Type annotations and code completion for boto3.client("iot").accept_certificate_transfer method. boto3 documentation

# accept_certificate_transfer method definition

def accept_certificate_transfer(
    self,
    *,
    certificateId: str,
    setAsActive: bool = ...,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# accept_certificate_transfer method usage example with argument unpacking

kwargs: AcceptCertificateTransferRequestRequestTypeDef = {  # (1)
    "certificateId": ...,
}

parent.accept_certificate_transfer(**kwargs)
  1. See AcceptCertificateTransferRequestRequestTypeDef

add_thing_to_billing_group#

Adds a thing to a billing group.

Type annotations and code completion for boto3.client("iot").add_thing_to_billing_group method. boto3 documentation

# add_thing_to_billing_group method definition

def add_thing_to_billing_group(
    self,
    *,
    billingGroupName: str = ...,
    billingGroupArn: str = ...,
    thingName: str = ...,
    thingArn: str = ...,
) -> Dict[str, Any]:
    ...
# add_thing_to_billing_group method usage example with argument unpacking

kwargs: AddThingToBillingGroupRequestRequestTypeDef = {  # (1)
    "billingGroupName": ...,
}

parent.add_thing_to_billing_group(**kwargs)
  1. See AddThingToBillingGroupRequestRequestTypeDef

add_thing_to_thing_group#

Adds a thing to a thing group.

Type annotations and code completion for boto3.client("iot").add_thing_to_thing_group method. boto3 documentation

# add_thing_to_thing_group method definition

def add_thing_to_thing_group(
    self,
    *,
    thingGroupName: str = ...,
    thingGroupArn: str = ...,
    thingName: str = ...,
    thingArn: str = ...,
    overrideDynamicGroups: bool = ...,
) -> Dict[str, Any]:
    ...
# add_thing_to_thing_group method usage example with argument unpacking

kwargs: AddThingToThingGroupRequestRequestTypeDef = {  # (1)
    "thingGroupName": ...,
}

parent.add_thing_to_thing_group(**kwargs)
  1. See AddThingToThingGroupRequestRequestTypeDef

associate_targets_with_job#

Associates a group with a continuous job.

Type annotations and code completion for boto3.client("iot").associate_targets_with_job method. boto3 documentation

# associate_targets_with_job method definition

def associate_targets_with_job(
    self,
    *,
    targets: Sequence[str],
    jobId: str,
    comment: str = ...,
    namespaceId: str = ...,
) -> AssociateTargetsWithJobResponseTypeDef:  # (1)
    ...
  1. See AssociateTargetsWithJobResponseTypeDef
# associate_targets_with_job method usage example with argument unpacking

kwargs: AssociateTargetsWithJobRequestRequestTypeDef = {  # (1)
    "targets": ...,
    "jobId": ...,
}

parent.associate_targets_with_job(**kwargs)
  1. See AssociateTargetsWithJobRequestRequestTypeDef

attach_policy#

Attaches the specified policy to the specified principal (certificate or other credential).

Type annotations and code completion for boto3.client("iot").attach_policy method. boto3 documentation

# attach_policy method definition

def attach_policy(
    self,
    *,
    policyName: str,
    target: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# attach_policy method usage example with argument unpacking

kwargs: AttachPolicyRequestRequestTypeDef = {  # (1)
    "policyName": ...,
    "target": ...,
}

parent.attach_policy(**kwargs)
  1. See AttachPolicyRequestRequestTypeDef

attach_principal_policy#

Attaches the specified policy to the specified principal (certificate or other credential).

Type annotations and code completion for boto3.client("iot").attach_principal_policy method. boto3 documentation

# attach_principal_policy method definition

def attach_principal_policy(
    self,
    *,
    policyName: str,
    principal: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# attach_principal_policy method usage example with argument unpacking

kwargs: AttachPrincipalPolicyRequestRequestTypeDef = {  # (1)
    "policyName": ...,
    "principal": ...,
}

parent.attach_principal_policy(**kwargs)
  1. See AttachPrincipalPolicyRequestRequestTypeDef

attach_security_profile#

Associates a Device Defender security profile with a thing group or this account.

Type annotations and code completion for boto3.client("iot").attach_security_profile method. boto3 documentation

# attach_security_profile method definition

def attach_security_profile(
    self,
    *,
    securityProfileName: str,
    securityProfileTargetArn: str,
) -> Dict[str, Any]:
    ...
# attach_security_profile method usage example with argument unpacking

kwargs: AttachSecurityProfileRequestRequestTypeDef = {  # (1)
    "securityProfileName": ...,
    "securityProfileTargetArn": ...,
}

parent.attach_security_profile(**kwargs)
  1. See AttachSecurityProfileRequestRequestTypeDef

attach_thing_principal#

Attaches the specified principal to the specified thing.

Type annotations and code completion for boto3.client("iot").attach_thing_principal method. boto3 documentation

# attach_thing_principal method definition

def attach_thing_principal(
    self,
    *,
    thingName: str,
    principal: str,
) -> Dict[str, Any]:
    ...
# attach_thing_principal method usage example with argument unpacking

kwargs: AttachThingPrincipalRequestRequestTypeDef = {  # (1)
    "thingName": ...,
    "principal": ...,
}

parent.attach_thing_principal(**kwargs)
  1. See AttachThingPrincipalRequestRequestTypeDef

can_paginate#

Check if an operation can be paginated.

Type annotations and code completion for boto3.client("iot").can_paginate method. boto3 documentation

# can_paginate method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

cancel_audit_mitigation_actions_task#

Cancels a mitigation action task that is in progress.

Type annotations and code completion for boto3.client("iot").cancel_audit_mitigation_actions_task method. boto3 documentation

# cancel_audit_mitigation_actions_task method definition

def cancel_audit_mitigation_actions_task(
    self,
    *,
    taskId: str,
) -> Dict[str, Any]:
    ...
# cancel_audit_mitigation_actions_task method usage example with argument unpacking

kwargs: CancelAuditMitigationActionsTaskRequestRequestTypeDef = {  # (1)
    "taskId": ...,
}

parent.cancel_audit_mitigation_actions_task(**kwargs)
  1. See CancelAuditMitigationActionsTaskRequestRequestTypeDef

cancel_audit_task#

Cancels an audit that is in progress.

Type annotations and code completion for boto3.client("iot").cancel_audit_task method. boto3 documentation

# cancel_audit_task method definition

def cancel_audit_task(
    self,
    *,
    taskId: str,
) -> Dict[str, Any]:
    ...
# cancel_audit_task method usage example with argument unpacking

kwargs: CancelAuditTaskRequestRequestTypeDef = {  # (1)
    "taskId": ...,
}

parent.cancel_audit_task(**kwargs)
  1. See CancelAuditTaskRequestRequestTypeDef

cancel_certificate_transfer#

Cancels a pending transfer for the specified certificate.

Type annotations and code completion for boto3.client("iot").cancel_certificate_transfer method. boto3 documentation

# cancel_certificate_transfer method definition

def cancel_certificate_transfer(
    self,
    *,
    certificateId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# cancel_certificate_transfer method usage example with argument unpacking

kwargs: CancelCertificateTransferRequestRequestTypeDef = {  # (1)
    "certificateId": ...,
}

parent.cancel_certificate_transfer(**kwargs)
  1. See CancelCertificateTransferRequestRequestTypeDef

cancel_detect_mitigation_actions_task#

Cancels a Device Defender ML Detect mitigation action.

Type annotations and code completion for boto3.client("iot").cancel_detect_mitigation_actions_task method. boto3 documentation

# cancel_detect_mitigation_actions_task method definition

def cancel_detect_mitigation_actions_task(
    self,
    *,
    taskId: str,
) -> Dict[str, Any]:
    ...
# cancel_detect_mitigation_actions_task method usage example with argument unpacking

kwargs: CancelDetectMitigationActionsTaskRequestRequestTypeDef = {  # (1)
    "taskId": ...,
}

parent.cancel_detect_mitigation_actions_task(**kwargs)
  1. See CancelDetectMitigationActionsTaskRequestRequestTypeDef

cancel_job#

Cancels a job.

Type annotations and code completion for boto3.client("iot").cancel_job method. boto3 documentation

# cancel_job method definition

def cancel_job(
    self,
    *,
    jobId: str,
    reasonCode: str = ...,
    comment: str = ...,
    force: bool = ...,
) -> CancelJobResponseTypeDef:  # (1)
    ...
  1. See CancelJobResponseTypeDef
# cancel_job method usage example with argument unpacking

kwargs: CancelJobRequestRequestTypeDef = {  # (1)
    "jobId": ...,
}

parent.cancel_job(**kwargs)
  1. See CancelJobRequestRequestTypeDef

cancel_job_execution#

Cancels the execution of a job for a given thing.

Type annotations and code completion for boto3.client("iot").cancel_job_execution method. boto3 documentation

# cancel_job_execution method definition

def cancel_job_execution(
    self,
    *,
    jobId: str,
    thingName: str,
    force: bool = ...,
    expectedVersion: int = ...,
    statusDetails: Mapping[str, str] = ...,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# cancel_job_execution method usage example with argument unpacking

kwargs: CancelJobExecutionRequestRequestTypeDef = {  # (1)
    "jobId": ...,
    "thingName": ...,
}

parent.cancel_job_execution(**kwargs)
  1. See CancelJobExecutionRequestRequestTypeDef

clear_default_authorizer#

Clears the default authorizer.

Type annotations and code completion for boto3.client("iot").clear_default_authorizer method. boto3 documentation

# clear_default_authorizer method definition

def clear_default_authorizer(
    self,
) -> Dict[str, Any]:
    ...

close#

Closes underlying endpoint connections.

Type annotations and code completion for boto3.client("iot").close method. boto3 documentation

# close method definition

def close(
    self,
) -> None:
    ...

confirm_topic_rule_destination#

Confirms a topic rule destination.

Type annotations and code completion for boto3.client("iot").confirm_topic_rule_destination method. boto3 documentation

# confirm_topic_rule_destination method definition

def confirm_topic_rule_destination(
    self,
    *,
    confirmationToken: str,
) -> Dict[str, Any]:
    ...
# confirm_topic_rule_destination method usage example with argument unpacking

kwargs: ConfirmTopicRuleDestinationRequestRequestTypeDef = {  # (1)
    "confirmationToken": ...,
}

parent.confirm_topic_rule_destination(**kwargs)
  1. See ConfirmTopicRuleDestinationRequestRequestTypeDef

create_audit_suppression#

Creates a Device Defender audit suppression.

Type annotations and code completion for boto3.client("iot").create_audit_suppression method. boto3 documentation

# create_audit_suppression method definition

def create_audit_suppression(
    self,
    *,
    checkName: str,
    resourceIdentifier: ResourceIdentifierTypeDef,  # (1)
    clientRequestToken: str,
    expirationDate: Union[datetime, str] = ...,
    suppressIndefinitely: bool = ...,
    description: str = ...,
) -> Dict[str, Any]:
    ...
  1. See ResourceIdentifierTypeDef
# create_audit_suppression method usage example with argument unpacking

kwargs: CreateAuditSuppressionRequestRequestTypeDef = {  # (1)
    "checkName": ...,
    "resourceIdentifier": ...,
    "clientRequestToken": ...,
}

parent.create_audit_suppression(**kwargs)
  1. See CreateAuditSuppressionRequestRequestTypeDef

create_authorizer#

Creates an authorizer.

Type annotations and code completion for boto3.client("iot").create_authorizer method. boto3 documentation

# create_authorizer method definition

def create_authorizer(
    self,
    *,
    authorizerName: str,
    authorizerFunctionArn: str,
    tokenKeyName: str = ...,
    tokenSigningPublicKeys: Mapping[str, str] = ...,
    status: AuthorizerStatusType = ...,  # (1)
    tags: Sequence[TagTypeDef] = ...,  # (2)
    signingDisabled: bool = ...,
    enableCachingForHttp: bool = ...,
) -> CreateAuthorizerResponseTypeDef:  # (3)
    ...
  1. See AuthorizerStatusType
  2. See TagTypeDef
  3. See CreateAuthorizerResponseTypeDef
# create_authorizer method usage example with argument unpacking

kwargs: CreateAuthorizerRequestRequestTypeDef = {  # (1)
    "authorizerName": ...,
    "authorizerFunctionArn": ...,
}

parent.create_authorizer(**kwargs)
  1. See CreateAuthorizerRequestRequestTypeDef

create_billing_group#

Creates a billing group.

Type annotations and code completion for boto3.client("iot").create_billing_group method. boto3 documentation

# create_billing_group method definition

def create_billing_group(
    self,
    *,
    billingGroupName: str,
    billingGroupProperties: BillingGroupPropertiesTypeDef = ...,  # (1)
    tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateBillingGroupResponseTypeDef:  # (3)
    ...
  1. See BillingGroupPropertiesTypeDef
  2. See TagTypeDef
  3. See CreateBillingGroupResponseTypeDef
# create_billing_group method usage example with argument unpacking

kwargs: CreateBillingGroupRequestRequestTypeDef = {  # (1)
    "billingGroupName": ...,
}

parent.create_billing_group(**kwargs)
  1. See CreateBillingGroupRequestRequestTypeDef

create_certificate_from_csr#

Creates an X.509 certificate using the specified certificate signing request.

Type annotations and code completion for boto3.client("iot").create_certificate_from_csr method. boto3 documentation

# create_certificate_from_csr method definition

def create_certificate_from_csr(
    self,
    *,
    certificateSigningRequest: str,
    setAsActive: bool = ...,
) -> CreateCertificateFromCsrResponseTypeDef:  # (1)
    ...
  1. See CreateCertificateFromCsrResponseTypeDef
# create_certificate_from_csr method usage example with argument unpacking

kwargs: CreateCertificateFromCsrRequestRequestTypeDef = {  # (1)
    "certificateSigningRequest": ...,
}

parent.create_certificate_from_csr(**kwargs)
  1. See CreateCertificateFromCsrRequestRequestTypeDef

create_custom_metric#

Use this API to define a Custom Metric published by your devices to Device Defender.

Type annotations and code completion for boto3.client("iot").create_custom_metric method. boto3 documentation

# create_custom_metric method definition

def create_custom_metric(
    self,
    *,
    metricName: str,
    metricType: CustomMetricTypeType,  # (1)
    clientRequestToken: str,
    displayName: str = ...,
    tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateCustomMetricResponseTypeDef:  # (3)
    ...
  1. See CustomMetricTypeType
  2. See TagTypeDef
  3. See CreateCustomMetricResponseTypeDef
# create_custom_metric method usage example with argument unpacking

kwargs: CreateCustomMetricRequestRequestTypeDef = {  # (1)
    "metricName": ...,
    "metricType": ...,
    "clientRequestToken": ...,
}

parent.create_custom_metric(**kwargs)
  1. See CreateCustomMetricRequestRequestTypeDef

create_dimension#

Create a dimension that you can use to limit the scope of a metric used in a security profile for IoT Device Defender.

Type annotations and code completion for boto3.client("iot").create_dimension method. boto3 documentation

# create_dimension method definition

def create_dimension(
    self,
    *,
    name: str,
    type: DimensionTypeType,  # (1)
    stringValues: Sequence[str],
    clientRequestToken: str,
    tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateDimensionResponseTypeDef:  # (3)
    ...
  1. See DimensionTypeType
  2. See TagTypeDef
  3. See CreateDimensionResponseTypeDef
# create_dimension method usage example with argument unpacking

kwargs: CreateDimensionRequestRequestTypeDef = {  # (1)
    "name": ...,
    "type": ...,
    "stringValues": ...,
    "clientRequestToken": ...,
}

parent.create_dimension(**kwargs)
  1. See CreateDimensionRequestRequestTypeDef

create_domain_configuration#

Creates a domain configuration.

Type annotations and code completion for boto3.client("iot").create_domain_configuration method. boto3 documentation

# create_domain_configuration method definition

def create_domain_configuration(
    self,
    *,
    domainConfigurationName: str,
    domainName: str = ...,
    serverCertificateArns: Sequence[str] = ...,
    validationCertificateArn: str = ...,
    authorizerConfig: AuthorizerConfigTypeDef = ...,  # (1)
    serviceType: ServiceTypeType = ...,  # (2)
    tags: Sequence[TagTypeDef] = ...,  # (3)
    tlsConfig: TlsConfigTypeDef = ...,  # (4)
) -> CreateDomainConfigurationResponseTypeDef:  # (5)
    ...
  1. See AuthorizerConfigTypeDef
  2. See ServiceTypeType
  3. See TagTypeDef
  4. See TlsConfigTypeDef
  5. See CreateDomainConfigurationResponseTypeDef
# create_domain_configuration method usage example with argument unpacking

kwargs: CreateDomainConfigurationRequestRequestTypeDef = {  # (1)
    "domainConfigurationName": ...,
}

parent.create_domain_configuration(**kwargs)
  1. See CreateDomainConfigurationRequestRequestTypeDef

create_dynamic_thing_group#

Creates a dynamic thing group.

Type annotations and code completion for boto3.client("iot").create_dynamic_thing_group method. boto3 documentation

# create_dynamic_thing_group method definition

def create_dynamic_thing_group(
    self,
    *,
    thingGroupName: str,
    queryString: str,
    thingGroupProperties: ThingGroupPropertiesTypeDef = ...,  # (1)
    indexName: str = ...,
    queryVersion: str = ...,
    tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateDynamicThingGroupResponseTypeDef:  # (3)
    ...
  1. See ThingGroupPropertiesTypeDef
  2. See TagTypeDef
  3. See CreateDynamicThingGroupResponseTypeDef
# create_dynamic_thing_group method usage example with argument unpacking

kwargs: CreateDynamicThingGroupRequestRequestTypeDef = {  # (1)
    "thingGroupName": ...,
    "queryString": ...,
}

parent.create_dynamic_thing_group(**kwargs)
  1. See CreateDynamicThingGroupRequestRequestTypeDef

create_fleet_metric#

Creates a fleet metric.

Type annotations and code completion for boto3.client("iot").create_fleet_metric method. boto3 documentation

# create_fleet_metric method definition

def create_fleet_metric(
    self,
    *,
    metricName: str,
    queryString: str,
    aggregationType: AggregationTypeTypeDef,  # (1)
    period: int,
    aggregationField: str,
    description: str = ...,
    queryVersion: str = ...,
    indexName: str = ...,
    unit: FleetMetricUnitType = ...,  # (2)
    tags: Sequence[TagTypeDef] = ...,  # (3)
) -> CreateFleetMetricResponseTypeDef:  # (4)
    ...
  1. See AggregationTypeTypeDef
  2. See FleetMetricUnitType
  3. See TagTypeDef
  4. See CreateFleetMetricResponseTypeDef
# create_fleet_metric method usage example with argument unpacking

kwargs: CreateFleetMetricRequestRequestTypeDef = {  # (1)
    "metricName": ...,
    "queryString": ...,
    "aggregationType": ...,
    "period": ...,
    "aggregationField": ...,
}

parent.create_fleet_metric(**kwargs)
  1. See CreateFleetMetricRequestRequestTypeDef

create_job#

Creates a job.

Type annotations and code completion for boto3.client("iot").create_job method. boto3 documentation

# create_job method definition

def create_job(
    self,
    *,
    jobId: str,
    targets: Sequence[str],
    documentSource: str = ...,
    document: str = ...,
    description: str = ...,
    presignedUrlConfig: PresignedUrlConfigTypeDef = ...,  # (1)
    targetSelection: TargetSelectionType = ...,  # (2)
    jobExecutionsRolloutConfig: JobExecutionsRolloutConfigTypeDef = ...,  # (3)
    abortConfig: AbortConfigTypeDef = ...,  # (4)
    timeoutConfig: TimeoutConfigTypeDef = ...,  # (5)
    tags: Sequence[TagTypeDef] = ...,  # (6)
    namespaceId: str = ...,
    jobTemplateArn: str = ...,
    jobExecutionsRetryConfig: JobExecutionsRetryConfigTypeDef = ...,  # (7)
    documentParameters: Mapping[str, str] = ...,
    schedulingConfig: SchedulingConfigTypeDef = ...,  # (8)
    destinationPackageVersions: Sequence[str] = ...,
) -> CreateJobResponseTypeDef:  # (9)
    ...
  1. See PresignedUrlConfigTypeDef
  2. See TargetSelectionType
  3. See JobExecutionsRolloutConfigTypeDef
  4. See AbortConfigTypeDef
  5. See TimeoutConfigTypeDef
  6. See TagTypeDef
  7. See JobExecutionsRetryConfigTypeDef
  8. See SchedulingConfigTypeDef
  9. See CreateJobResponseTypeDef
# create_job method usage example with argument unpacking

kwargs: CreateJobRequestRequestTypeDef = {  # (1)
    "jobId": ...,
    "targets": ...,
}

parent.create_job(**kwargs)
  1. See CreateJobRequestRequestTypeDef

create_job_template#

Creates a job template.

Type annotations and code completion for boto3.client("iot").create_job_template method. boto3 documentation

# create_job_template method definition

def create_job_template(
    self,
    *,
    jobTemplateId: str,
    description: str,
    jobArn: str = ...,
    documentSource: str = ...,
    document: str = ...,
    presignedUrlConfig: PresignedUrlConfigTypeDef = ...,  # (1)
    jobExecutionsRolloutConfig: JobExecutionsRolloutConfigTypeDef = ...,  # (2)
    abortConfig: AbortConfigTypeDef = ...,  # (3)
    timeoutConfig: TimeoutConfigTypeDef = ...,  # (4)
    tags: Sequence[TagTypeDef] = ...,  # (5)
    jobExecutionsRetryConfig: JobExecutionsRetryConfigTypeDef = ...,  # (6)
    maintenanceWindows: Sequence[MaintenanceWindowTypeDef] = ...,  # (7)
    destinationPackageVersions: Sequence[str] = ...,
) -> CreateJobTemplateResponseTypeDef:  # (8)
    ...
  1. See PresignedUrlConfigTypeDef
  2. See JobExecutionsRolloutConfigTypeDef
  3. See AbortConfigTypeDef
  4. See TimeoutConfigTypeDef
  5. See TagTypeDef
  6. See JobExecutionsRetryConfigTypeDef
  7. See MaintenanceWindowTypeDef
  8. See CreateJobTemplateResponseTypeDef
# create_job_template method usage example with argument unpacking

kwargs: CreateJobTemplateRequestRequestTypeDef = {  # (1)
    "jobTemplateId": ...,
    "description": ...,
}

parent.create_job_template(**kwargs)
  1. See CreateJobTemplateRequestRequestTypeDef

create_keys_and_certificate#

Creates a 2048-bit RSA key pair and issues an X.509 certificate using the issued public key.

Type annotations and code completion for boto3.client("iot").create_keys_and_certificate method. boto3 documentation

# create_keys_and_certificate method definition

def create_keys_and_certificate(
    self,
    *,
    setAsActive: bool = ...,
) -> CreateKeysAndCertificateResponseTypeDef:  # (1)
    ...
  1. See CreateKeysAndCertificateResponseTypeDef
# create_keys_and_certificate method usage example with argument unpacking

kwargs: CreateKeysAndCertificateRequestRequestTypeDef = {  # (1)
    "setAsActive": ...,
}

parent.create_keys_and_certificate(**kwargs)
  1. See CreateKeysAndCertificateRequestRequestTypeDef

create_mitigation_action#

Defines an action that can be applied to audit findings by using StartAuditMitigationActionsTask.

Type annotations and code completion for boto3.client("iot").create_mitigation_action method. boto3 documentation

# create_mitigation_action method definition

def create_mitigation_action(
    self,
    *,
    actionName: str,
    roleArn: str,
    actionParams: MitigationActionParamsTypeDef,  # (1)
    tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateMitigationActionResponseTypeDef:  # (3)
    ...
  1. See MitigationActionParamsTypeDef
  2. See TagTypeDef
  3. See CreateMitigationActionResponseTypeDef
# create_mitigation_action method usage example with argument unpacking

kwargs: CreateMitigationActionRequestRequestTypeDef = {  # (1)
    "actionName": ...,
    "roleArn": ...,
    "actionParams": ...,
}

parent.create_mitigation_action(**kwargs)
  1. See CreateMitigationActionRequestRequestTypeDef

create_ota_update#

Creates an IoT OTA update on a target group of things or groups.

Type annotations and code completion for boto3.client("iot").create_ota_update method. boto3 documentation

# create_ota_update method definition

def create_ota_update(
    self,
    *,
    otaUpdateId: str,
    targets: Sequence[str],
    files: Sequence[OTAUpdateFileTypeDef],  # (1)
    roleArn: str,
    description: str = ...,
    protocols: Sequence[ProtocolType] = ...,  # (2)
    targetSelection: TargetSelectionType = ...,  # (3)
    awsJobExecutionsRolloutConfig: AwsJobExecutionsRolloutConfigTypeDef = ...,  # (4)
    awsJobPresignedUrlConfig: AwsJobPresignedUrlConfigTypeDef = ...,  # (5)
    awsJobAbortConfig: AwsJobAbortConfigTypeDef = ...,  # (6)
    awsJobTimeoutConfig: AwsJobTimeoutConfigTypeDef = ...,  # (7)
    additionalParameters: Mapping[str, str] = ...,
    tags: Sequence[TagTypeDef] = ...,  # (8)
) -> CreateOTAUpdateResponseTypeDef:  # (9)
    ...
  1. See OTAUpdateFileTypeDef
  2. See ProtocolType
  3. See TargetSelectionType
  4. See AwsJobExecutionsRolloutConfigTypeDef
  5. See AwsJobPresignedUrlConfigTypeDef
  6. See AwsJobAbortConfigTypeDef
  7. See AwsJobTimeoutConfigTypeDef
  8. See TagTypeDef
  9. See CreateOTAUpdateResponseTypeDef
# create_ota_update method usage example with argument unpacking

kwargs: CreateOTAUpdateRequestRequestTypeDef = {  # (1)
    "otaUpdateId": ...,
    "targets": ...,
    "files": ...,
    "roleArn": ...,
}

parent.create_ota_update(**kwargs)
  1. See CreateOTAUpdateRequestRequestTypeDef

create_package#

Creates an IoT software package that can be deployed to your fleet.

Type annotations and code completion for boto3.client("iot").create_package method. boto3 documentation

# create_package method definition

def create_package(
    self,
    *,
    packageName: str,
    description: str = ...,
    tags: Mapping[str, str] = ...,
    clientToken: str = ...,
) -> CreatePackageResponseTypeDef:  # (1)
    ...
  1. See CreatePackageResponseTypeDef
# create_package method usage example with argument unpacking

kwargs: CreatePackageRequestRequestTypeDef = {  # (1)
    "packageName": ...,
}

parent.create_package(**kwargs)
  1. See CreatePackageRequestRequestTypeDef

create_package_version#

Creates a new version for an existing IoT software package.

Type annotations and code completion for boto3.client("iot").create_package_version method. boto3 documentation

# create_package_version method definition

def create_package_version(
    self,
    *,
    packageName: str,
    versionName: str,
    description: str = ...,
    attributes: Mapping[str, str] = ...,
    tags: Mapping[str, str] = ...,
    clientToken: str = ...,
) -> CreatePackageVersionResponseTypeDef:  # (1)
    ...
  1. See CreatePackageVersionResponseTypeDef
# create_package_version method usage example with argument unpacking

kwargs: CreatePackageVersionRequestRequestTypeDef = {  # (1)
    "packageName": ...,
    "versionName": ...,
}

parent.create_package_version(**kwargs)
  1. See CreatePackageVersionRequestRequestTypeDef

create_policy#

Creates an IoT policy.

Type annotations and code completion for boto3.client("iot").create_policy method. boto3 documentation

# create_policy method definition

def create_policy(
    self,
    *,
    policyName: str,
    policyDocument: str,
    tags: Sequence[TagTypeDef] = ...,  # (1)
) -> CreatePolicyResponseTypeDef:  # (2)
    ...
  1. See TagTypeDef
  2. See CreatePolicyResponseTypeDef
# create_policy method usage example with argument unpacking

kwargs: CreatePolicyRequestRequestTypeDef = {  # (1)
    "policyName": ...,
    "policyDocument": ...,
}

parent.create_policy(**kwargs)
  1. See CreatePolicyRequestRequestTypeDef

create_policy_version#

Creates a new version of the specified IoT policy.

Type annotations and code completion for boto3.client("iot").create_policy_version method. boto3 documentation

# create_policy_version method definition

def create_policy_version(
    self,
    *,
    policyName: str,
    policyDocument: str,
    setAsDefault: bool = ...,
) -> CreatePolicyVersionResponseTypeDef:  # (1)
    ...
  1. See CreatePolicyVersionResponseTypeDef
# create_policy_version method usage example with argument unpacking

kwargs: CreatePolicyVersionRequestRequestTypeDef = {  # (1)
    "policyName": ...,
    "policyDocument": ...,
}

parent.create_policy_version(**kwargs)
  1. See CreatePolicyVersionRequestRequestTypeDef

create_provisioning_claim#

Creates a provisioning claim.

Type annotations and code completion for boto3.client("iot").create_provisioning_claim method. boto3 documentation

# create_provisioning_claim method definition

def create_provisioning_claim(
    self,
    *,
    templateName: str,
) -> CreateProvisioningClaimResponseTypeDef:  # (1)
    ...
  1. See CreateProvisioningClaimResponseTypeDef
# create_provisioning_claim method usage example with argument unpacking

kwargs: CreateProvisioningClaimRequestRequestTypeDef = {  # (1)
    "templateName": ...,
}

parent.create_provisioning_claim(**kwargs)
  1. See CreateProvisioningClaimRequestRequestTypeDef

create_provisioning_template#

Creates a provisioning template.

Type annotations and code completion for boto3.client("iot").create_provisioning_template method. boto3 documentation

# create_provisioning_template method definition

def create_provisioning_template(
    self,
    *,
    templateName: str,
    templateBody: str,
    provisioningRoleArn: str,
    description: str = ...,
    enabled: bool = ...,
    preProvisioningHook: ProvisioningHookTypeDef = ...,  # (1)
    tags: Sequence[TagTypeDef] = ...,  # (2)
    type: TemplateTypeType = ...,  # (3)
) -> CreateProvisioningTemplateResponseTypeDef:  # (4)
    ...
  1. See ProvisioningHookTypeDef
  2. See TagTypeDef
  3. See TemplateTypeType
  4. See CreateProvisioningTemplateResponseTypeDef
# create_provisioning_template method usage example with argument unpacking

kwargs: CreateProvisioningTemplateRequestRequestTypeDef = {  # (1)
    "templateName": ...,
    "templateBody": ...,
    "provisioningRoleArn": ...,
}

parent.create_provisioning_template(**kwargs)
  1. See CreateProvisioningTemplateRequestRequestTypeDef

create_provisioning_template_version#

Creates a new version of a provisioning template.

Type annotations and code completion for boto3.client("iot").create_provisioning_template_version method. boto3 documentation

# create_provisioning_template_version method definition

def create_provisioning_template_version(
    self,
    *,
    templateName: str,
    templateBody: str,
    setAsDefault: bool = ...,
) -> CreateProvisioningTemplateVersionResponseTypeDef:  # (1)
    ...
  1. See CreateProvisioningTemplateVersionResponseTypeDef
# create_provisioning_template_version method usage example with argument unpacking

kwargs: CreateProvisioningTemplateVersionRequestRequestTypeDef = {  # (1)
    "templateName": ...,
    "templateBody": ...,
}

parent.create_provisioning_template_version(**kwargs)
  1. See CreateProvisioningTemplateVersionRequestRequestTypeDef

create_role_alias#

Creates a role alias.

Type annotations and code completion for boto3.client("iot").create_role_alias method. boto3 documentation

# create_role_alias method definition

def create_role_alias(
    self,
    *,
    roleAlias: str,
    roleArn: str,
    credentialDurationSeconds: int = ...,
    tags: Sequence[TagTypeDef] = ...,  # (1)
) -> CreateRoleAliasResponseTypeDef:  # (2)
    ...
  1. See TagTypeDef
  2. See CreateRoleAliasResponseTypeDef
# create_role_alias method usage example with argument unpacking

kwargs: CreateRoleAliasRequestRequestTypeDef = {  # (1)
    "roleAlias": ...,
    "roleArn": ...,
}

parent.create_role_alias(**kwargs)
  1. See CreateRoleAliasRequestRequestTypeDef

create_scheduled_audit#

Creates a scheduled audit that is run at a specified time interval.

Type annotations and code completion for boto3.client("iot").create_scheduled_audit method. boto3 documentation

# create_scheduled_audit method definition

def create_scheduled_audit(
    self,
    *,
    frequency: AuditFrequencyType,  # (1)
    targetCheckNames: Sequence[str],
    scheduledAuditName: str,
    dayOfMonth: str = ...,
    dayOfWeek: DayOfWeekType = ...,  # (2)
    tags: Sequence[TagTypeDef] = ...,  # (3)
) -> CreateScheduledAuditResponseTypeDef:  # (4)
    ...
  1. See AuditFrequencyType
  2. See DayOfWeekType
  3. See TagTypeDef
  4. See CreateScheduledAuditResponseTypeDef
# create_scheduled_audit method usage example with argument unpacking

kwargs: CreateScheduledAuditRequestRequestTypeDef = {  # (1)
    "frequency": ...,
    "targetCheckNames": ...,
    "scheduledAuditName": ...,
}

parent.create_scheduled_audit(**kwargs)
  1. See CreateScheduledAuditRequestRequestTypeDef

create_security_profile#

Creates a Device Defender security profile.

Type annotations and code completion for boto3.client("iot").create_security_profile method. boto3 documentation

# create_security_profile method definition

def create_security_profile(
    self,
    *,
    securityProfileName: str,
    securityProfileDescription: str = ...,
    behaviors: Sequence[BehaviorTypeDef] = ...,  # (1)
    alertTargets: Mapping[AlertTargetTypeType, AlertTargetTypeDef] = ...,  # (2)
    additionalMetricsToRetain: Sequence[str] = ...,
    additionalMetricsToRetainV2: Sequence[MetricToRetainTypeDef] = ...,  # (3)
    tags: Sequence[TagTypeDef] = ...,  # (4)
) -> CreateSecurityProfileResponseTypeDef:  # (5)
    ...
  1. See BehaviorTypeDef
  2. See AlertTargetTypeType AlertTargetTypeDef
  3. See MetricToRetainTypeDef
  4. See TagTypeDef
  5. See CreateSecurityProfileResponseTypeDef
# create_security_profile method usage example with argument unpacking

kwargs: CreateSecurityProfileRequestRequestTypeDef = {  # (1)
    "securityProfileName": ...,
}

parent.create_security_profile(**kwargs)
  1. See CreateSecurityProfileRequestRequestTypeDef

create_stream#

Creates a stream for delivering one or more large files in chunks over MQTT.

Type annotations and code completion for boto3.client("iot").create_stream method. boto3 documentation

# create_stream method definition

def create_stream(
    self,
    *,
    streamId: str,
    files: Sequence[StreamFileTypeDef],  # (1)
    roleArn: str,
    description: str = ...,
    tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateStreamResponseTypeDef:  # (3)
    ...
  1. See StreamFileTypeDef
  2. See TagTypeDef
  3. See CreateStreamResponseTypeDef
# create_stream method usage example with argument unpacking

kwargs: CreateStreamRequestRequestTypeDef = {  # (1)
    "streamId": ...,
    "files": ...,
    "roleArn": ...,
}

parent.create_stream(**kwargs)
  1. See CreateStreamRequestRequestTypeDef

create_thing#

Creates a thing record in the registry.

Type annotations and code completion for boto3.client("iot").create_thing method. boto3 documentation

# create_thing method definition

def create_thing(
    self,
    *,
    thingName: str,
    thingTypeName: str = ...,
    attributePayload: AttributePayloadTypeDef = ...,  # (1)
    billingGroupName: str = ...,
) -> CreateThingResponseTypeDef:  # (2)
    ...
  1. See AttributePayloadTypeDef
  2. See CreateThingResponseTypeDef
# create_thing method usage example with argument unpacking

kwargs: CreateThingRequestRequestTypeDef = {  # (1)
    "thingName": ...,
}

parent.create_thing(**kwargs)
  1. See CreateThingRequestRequestTypeDef

create_thing_group#

Create a thing group.

Type annotations and code completion for boto3.client("iot").create_thing_group method. boto3 documentation

# create_thing_group method definition

def create_thing_group(
    self,
    *,
    thingGroupName: str,
    parentGroupName: str = ...,
    thingGroupProperties: ThingGroupPropertiesTypeDef = ...,  # (1)
    tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateThingGroupResponseTypeDef:  # (3)
    ...
  1. See ThingGroupPropertiesTypeDef
  2. See TagTypeDef
  3. See CreateThingGroupResponseTypeDef
# create_thing_group method usage example with argument unpacking

kwargs: CreateThingGroupRequestRequestTypeDef = {  # (1)
    "thingGroupName": ...,
}

parent.create_thing_group(**kwargs)
  1. See CreateThingGroupRequestRequestTypeDef

create_thing_type#

Creates a new thing type.

Type annotations and code completion for boto3.client("iot").create_thing_type method. boto3 documentation

# create_thing_type method definition

def create_thing_type(
    self,
    *,
    thingTypeName: str,
    thingTypeProperties: ThingTypePropertiesTypeDef = ...,  # (1)
    tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateThingTypeResponseTypeDef:  # (3)
    ...
  1. See ThingTypePropertiesTypeDef
  2. See TagTypeDef
  3. See CreateThingTypeResponseTypeDef
# create_thing_type method usage example with argument unpacking

kwargs: CreateThingTypeRequestRequestTypeDef = {  # (1)
    "thingTypeName": ...,
}

parent.create_thing_type(**kwargs)
  1. See CreateThingTypeRequestRequestTypeDef

create_topic_rule#

Creates a rule.

Type annotations and code completion for boto3.client("iot").create_topic_rule method. boto3 documentation

# create_topic_rule method definition

def create_topic_rule(
    self,
    *,
    ruleName: str,
    topicRulePayload: TopicRulePayloadTypeDef,  # (1)
    tags: str = ...,
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See TopicRulePayloadTypeDef
  2. See EmptyResponseMetadataTypeDef
# create_topic_rule method usage example with argument unpacking

kwargs: CreateTopicRuleRequestRequestTypeDef = {  # (1)
    "ruleName": ...,
    "topicRulePayload": ...,
}

parent.create_topic_rule(**kwargs)
  1. See CreateTopicRuleRequestRequestTypeDef

create_topic_rule_destination#

Creates a topic rule destination.

Type annotations and code completion for boto3.client("iot").create_topic_rule_destination method. boto3 documentation

# create_topic_rule_destination method definition

def create_topic_rule_destination(
    self,
    *,
    destinationConfiguration: TopicRuleDestinationConfigurationTypeDef,  # (1)
) -> CreateTopicRuleDestinationResponseTypeDef:  # (2)
    ...
  1. See TopicRuleDestinationConfigurationTypeDef
  2. See CreateTopicRuleDestinationResponseTypeDef
# create_topic_rule_destination method usage example with argument unpacking

kwargs: CreateTopicRuleDestinationRequestRequestTypeDef = {  # (1)
    "destinationConfiguration": ...,
}

parent.create_topic_rule_destination(**kwargs)
  1. See CreateTopicRuleDestinationRequestRequestTypeDef

delete_account_audit_configuration#

Restores the default settings for Device Defender audits for this account.

Type annotations and code completion for boto3.client("iot").delete_account_audit_configuration method. boto3 documentation

# delete_account_audit_configuration method definition

def delete_account_audit_configuration(
    self,
    *,
    deleteScheduledAudits: bool = ...,
) -> Dict[str, Any]:
    ...
# delete_account_audit_configuration method usage example with argument unpacking

kwargs: DeleteAccountAuditConfigurationRequestRequestTypeDef = {  # (1)
    "deleteScheduledAudits": ...,
}

parent.delete_account_audit_configuration(**kwargs)
  1. See DeleteAccountAuditConfigurationRequestRequestTypeDef

delete_audit_suppression#

Deletes a Device Defender audit suppression.

Type annotations and code completion for boto3.client("iot").delete_audit_suppression method. boto3 documentation

# delete_audit_suppression method definition

def delete_audit_suppression(
    self,
    *,
    checkName: str,
    resourceIdentifier: ResourceIdentifierTypeDef,  # (1)
) -> Dict[str, Any]:
    ...
  1. See ResourceIdentifierTypeDef
# delete_audit_suppression method usage example with argument unpacking

kwargs: DeleteAuditSuppressionRequestRequestTypeDef = {  # (1)
    "checkName": ...,
    "resourceIdentifier": ...,
}

parent.delete_audit_suppression(**kwargs)
  1. See DeleteAuditSuppressionRequestRequestTypeDef

delete_authorizer#

Deletes an authorizer.

Type annotations and code completion for boto3.client("iot").delete_authorizer method.