:credentials (required, Aws::CredentialProvider) —
Your AWS credentials. This can be an instance of any one of the following classes:
- Aws::Credentials - Used for configuring static, non-refreshing credentials.
- Aws::InstanceProfileCredentials - Used for loading credentials from an EC2 IMDS on an EC2 instance.
- Aws::SharedCredentials - Used for loading credentials from a shared file, such as ~/.aws/config.
- Aws::AssumeRoleCredentials - Used when you need to assume a role.
When :credentials are not configured directly, the following locations will be searched for credentials:
- Aws.config[:credentials]
- The :access_key_id, :secret_access_key, and :session_token options.
- ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
- ~/.aws/credentials
- ~/.aws/config
- EC2 IMDS instance profile - When used by default, the timeouts are very aggressive. Construct and pass an instance of Aws::InstanceProfileCredentails to enable retries and extended timeouts.
:region (required, String) —
The AWS region to connect to. The configured :region is used to determine the service :endpoint. When not passed, a default :region is search for in the following locations:
- Aws.config[:region]
- ENV['AWS_REGION']
- ENV['AMAZON_REGION']
- ENV['AWS_DEFAULT_REGION']
- ~/.aws/credentials
- ~/.aws/config
:access_key_id (String)
:active_endpoint_cache (Boolean) — default: false —
When set to true, a thread polling for endpoints will be running in the background every 60 secs (default). Defaults to false.
:client_side_monitoring (Boolean) — default: false —
When true, client-side metrics will be collected for all API requests from this client.
:client_side_monitoring_client_id (String) — default: "" —
Allows you to provide an identifier for this client which will be attached to all generated client side metrics. Defaults to an empty string.
:client_side_monitoring_host (String) — default: "127.0.0.1" —
Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client side monitoring agent is running on, where client metrics will be published via UDP.
:client_side_monitoring_port (Integer) — default: 31000 —
Required for publishing client metrics. The port that the client side monitoring agent is running on, where client metrics will be published via UDP.
:client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher) — default: Aws::ClientSideMonitoring::Publisher —
Allows you to provide a custom client-side monitoring publisher class. By default, will use the Client Side Monitoring Agent Publisher.
:convert_params (Boolean) — default: true —
When true, an attempt is made to coerce request parameters into the required types.
:disable_host_prefix_injection (Boolean) — default: false —
Set to true to disable SDK automatically adding host prefix to default service endpoint when available.
:endpoint (String) —
The client endpoint is normally constructed from the :region option. You should only configure an :endpoint when connecting to test endpoints. This should be avalid HTTP(S) URI.
:endpoint_cache_max_entries (Integer) — default: 1000 —
Used for the maximum size limit of the LRU cache storing endpoints data for endpoint discovery enabled operations. Defaults to 1000.
:endpoint_cache_max_threads (Integer) — default: 10 —
Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.
:endpoint_cache_poll_interval (Integer) — default: 60 —
When :endpoint_discovery and :active_endpoint_cache is enabled, Use this option to config the time interval in seconds for making requests fetching endpoints information. Defaults to 60 sec.
:endpoint_discovery (Boolean) — default: false —
When set to true, endpoint discovery will be enabled for operations when available. Defaults to false.
:log_formatter (Aws::Log::Formatter) — default: Aws::Log::Formatter.default —
The log formatter.
:log_level (Symbol) — default: :info —
The log level to send messages to the :logger at.
:logger (Logger) —
The Logger instance to send log messages to. If this option is not set, logging will be disabled.
:profile (String) — default: "default" —
Used when loading credentials from the shared credentials file at HOME/.aws/credentials. When not specified, 'default' is used.
:retry_base_delay (Float) — default: 0.3 —
The base delay in seconds used by the default backoff function.
:retry_jitter (Symbol) — default: :none —
A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.

@see https://www.awsarchitectureblog.com/2015/03/backoff.html
:retry_limit (Integer) — default: 3 —
The maximum number of times to retry failed requests. Only ~ 500 level server errors and certain ~ 400 level client errors are retried. Generally, these are throttling errors, data checksum errors, networking errors, timeout errors and auth errors from expired credentials.
:retry_max_delay (Integer) — default: 0 —
The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
:secret_access_key (String)
:session_token (String)
:stub_responses (Boolean) — default: false —
Causes the client to return stubbed responses. By default fake responses are generated and returned. You can specify the response data to return or errors to raise by calling ClientStubs#stub_responses. See ClientStubs for more information.

Please note When response stubbing is enabled, no HTTP requests are made, and retries are disabled.
:validate_params (Boolean) — default: true —
When true, request parameters are validated before sending the request.
:http_proxy (URI::HTTP, String) —
A proxy to send requests through. Formatted like 'http://proxy.com:123'.
:http_open_timeout (Float) — default: 15 —
The number of seconds to wait when opening a HTTP session before rasing a Timeout::Error.
:http_read_timeout (Integer) — default: 60 —
The default number of seconds to wait for response data. This value can safely be set per-request on the session yeidled by #session_for.
:http_idle_timeout (Float) — default: 5 —
The number of seconds a connection is allowed to sit idble before it is considered stale. Stale connections are closed and removed from the pool before making a request.
:http_continue_timeout (Float) — default: 1 —
The number of seconds to wait for a 100-continue response before sending the request body. This option has no effect unless the request has "Expect" header set to "100-continue". Defaults to nil which disables this behaviour. This value can safely be set per request on the session yeidled by #session_for.
:http_wire_trace (Boolean) — default: false —
When true, HTTP debug output will be sent to the :logger.
:ssl_verify_peer (Boolean) — default: true —
When true, SSL peer certificates are verified when establishing a connection.
:ssl_ca_bundle (String) —
Full path to the SSL certificate authority bundle file that should be used when verifying peer certificates. If you do not pass :ssl_ca_bundle or :ssl_ca_directory the the system default will be used if available.
:ssl_ca_directory (String) —
Full path of the directory that contains the unbundled SSL certificate authority files for verifying peer certificates. If you do not pass :ssl_ca_bundle or :ssl_ca_directory the the system default will be used if available.



251
252
253

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 251

def initialize(*args)
  super
end

Instance Method Details

#accept_certificate_transfer(params = {}) ⇒ `Struct`

Accepts a pending certificate transfer. The default state of the certificate is INACTIVE.

To check for pending certificate transfers, call ListCertificates to enumerate your certificates.

Examples:

Request syntax with placeholder values


resp = client.accept_certificate_transfer({
  certificate_id: "CertificateId", # required
  set_as_active: false,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:certificate_id (required, String) —
The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)
:set_as_active (Boolean) —
Specifies whether the certificate is active.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 281

def accept_certificate_transfer(params = {}, options = {})
  req = build_request(:accept_certificate_transfer, params)
  req.send_request(options)
end

#add_thing_to_billing_group(params = {}) ⇒ `Struct`

Adds a thing to a billing group.

Examples:

Request syntax with placeholder values


resp = client.add_thing_to_billing_group({
  billing_group_name: "BillingGroupName",
  billing_group_arn: "BillingGroupArn",
  thing_name: "ThingName",
  thing_arn: "ThingArn",
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:billing_group_name (String) —
The name of the billing group.
:billing_group_arn (String) —
The ARN of the billing group.
:thing_name (String) —
The name of the thing to be added to the billing group.
:thing_arn (String) —
The ARN of the thing to be added to the billing group.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 313

def add_thing_to_billing_group(params = {}, options = {})
  req = build_request(:add_thing_to_billing_group, params)
  req.send_request(options)
end

#add_thing_to_thing_group(params = {}) ⇒ `Struct`

Adds a thing to a thing group.

Examples:

Request syntax with placeholder values


resp = client.add_thing_to_thing_group({
  thing_group_name: "ThingGroupName",
  thing_group_arn: "ThingGroupArn",
  thing_name: "ThingName",
  thing_arn: "ThingArn",
  override_dynamic_groups: false,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_group_name (String) —
The name of the group to which you are adding a thing.
:thing_group_arn (String) —
The ARN of the group to which you are adding a thing.
:thing_name (String) —
The name of the thing to add to a group.
:thing_arn (String) —
The ARN of the thing to add to a group.
:override_dynamic_groups (Boolean) —
Override dynamic thing groups with static thing groups when 10-group limit is reached. If a thing belongs to 10 thing groups, and one or more of those groups are dynamic thing groups, adding a thing to a static group removes the thing from the last dynamic group.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 352

def add_thing_to_thing_group(params = {}, options = {})
  req = build_request(:add_thing_to_thing_group, params)
  req.send_request(options)
end

#associate_targets_with_job(params = {}) ⇒ `Types::AssociateTargetsWithJobResponse`

Associates a group with a continuous job. The following criteria must be met:

The job must have been created with the targetSelection field set to "CONTINUOUS".
The job status must currently be "IN_PROGRESS".
The total number of targets associated with a job must not exceed

Examples:

Request syntax with placeholder values


resp = client.associate_targets_with_job({
  targets: ["TargetArn"], # required
  job_id: "JobId", # required
  comment: "Comment",
})

Response structure


resp.job_arn #=> String
resp.job_id #=> String
resp.description #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:targets (required, Array<String>) —
A list of thing group ARNs that define the targets of the job.
:job_id (required, String) —
The unique identifier you assigned to this job when it was created.
:comment (String) —
An optional comment string describing why the job was associated with the targets.

Returns:

(Types::AssociateTargetsWithJobResponse) —
Returns a response object which responds to the following methods:
- #job_arn => String
- #job_id => String
- #description => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 400

def associate_targets_with_job(params = {}, options = {})
  req = build_request(:associate_targets_with_job, params)
  req.send_request(options)
end

#attach_policy(params = {}) ⇒ `Struct`

Attaches a policy to the specified target.

Examples:

Request syntax with placeholder values


resp = client.attach_policy({
  policy_name: "PolicyName", # required
  target: "PolicyTarget", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The name of the policy to attach.
:target (required, String) —
The identity to which the policy is attached.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 428

def attach_policy(params = {}, options = {})
  req = build_request(:attach_policy, params)
  req.send_request(options)
end

#attach_principal_policy(params = {}) ⇒ `Struct`

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

Note: This API is deprecated. Please use AttachPolicy instead.

Examples:

Request syntax with placeholder values


resp = client.attach_principal_policy({
  policy_name: "PolicyName", # required
  principal: "Principal", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The policy name.
:principal (required, String) —
The principal, which can be a certificate ARN (as returned from the CreateCertificate operation) or an Amazon Cognito ID.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 456

def attach_principal_policy(params = {}, options = {})
  req = build_request(:attach_principal_policy, params)
  req.send_request(options)
end

#attach_security_profile(params = {}) ⇒ `Struct`

Associates a Device Defender security profile with a thing group or this account. Each thing group or account can have up to five security profiles associated with it.

Examples:

Request syntax with placeholder values


resp = client.attach_security_profile({
  security_profile_name: "SecurityProfileName", # required
  security_profile_target_arn: "SecurityProfileTargetArn", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:security_profile_name (required, String) —
The security profile that is attached.
:security_profile_target_arn (required, String) —
The ARN of the target (thing group) to which the security profile is attached.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 483

def attach_security_profile(params = {}, options = {})
  req = build_request(:attach_security_profile, params)
  req.send_request(options)
end

#attach_thing_principal(params = {}) ⇒ `Struct`

Attaches the specified principal to the specified thing. A principal can be X.509 certificates, IAM users, groups, and roles, Amazon Cognito identities or federated identities.

Examples:

Request syntax with placeholder values


resp = client.attach_thing_principal({
  thing_name: "ThingName", # required
  principal: "Principal", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_name (required, String) —
The name of the thing.
:principal (required, String) —
The principal, which can be a certificate ARN (as returned from the CreateCertificate operation) or an Amazon Cognito ID.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 510

def attach_thing_principal(params = {}, options = {})
  req = build_request(:attach_thing_principal, params)
  req.send_request(options)
end

#cancel_audit_mitigation_actions_task(params = {}) ⇒ `Struct`

Cancels a mitigation action task that is in progress. If the task is not in progress, an InvalidRequestException occurs.

Examples:

Request syntax with placeholder values


resp = client.cancel_audit_mitigation_actions_task({
  task_id: "AuditMitigationActionsTaskId", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:task_id (required, String) —
The unique identifier for the task that you want to cancel.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 531

def cancel_audit_mitigation_actions_task(params = {}, options = {})
  req = build_request(:cancel_audit_mitigation_actions_task, params)
  req.send_request(options)
end

#cancel_audit_task(params = {}) ⇒ `Struct`

Cancels an audit that is in progress. The audit can be either scheduled or on-demand. If the audit is not in progress, an "InvalidRequestException" occurs.

Examples:

Request syntax with placeholder values


resp = client.cancel_audit_task({
  task_id: "AuditTaskId", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:task_id (required, String) —
The ID of the audit you want to cancel. You can only cancel an audit that is "IN_PROGRESS".

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 554

def cancel_audit_task(params = {}, options = {})
  req = build_request(:cancel_audit_task, params)
  req.send_request(options)
end

#cancel_certificate_transfer(params = {}) ⇒ `Struct`

Cancels a pending transfer for the specified certificate.

Note Only the transfer source account can use this operation to cancel a transfer. (Transfer destinations can use RejectCertificateTransfer instead.) After transfer, AWS IoT returns the certificate to the source account in the INACTIVE state. After the destination account has accepted the transfer, the transfer cannot be cancelled.

After a certificate transfer is cancelled, the status of the certificate changes from PENDING_TRANSFER to INACTIVE.

Examples:

Request syntax with placeholder values


resp = client.cancel_certificate_transfer({
  certificate_id: "CertificateId", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:certificate_id (required, String) —
The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 585

def cancel_certificate_transfer(params = {}, options = {})
  req = build_request(:cancel_certificate_transfer, params)
  req.send_request(options)
end

#cancel_job(params = {}) ⇒ `Types::CancelJobResponse`

Cancels a job.

Examples:

Request syntax with placeholder values


resp = client.cancel_job({
  job_id: "JobId", # required
  reason_code: "ReasonCode",
  comment: "Comment",
  force: false,
})

Response structure


resp.job_arn #=> String
resp.job_id #=> String
resp.description #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:job_id (required, String) —
The unique identifier you assigned to this job when it was created.
:reason_code (String) — default: Optional —
A reason code string that explains why the job was canceled.
:comment (String) —
An optional comment string describing why the job was canceled.
:force (Boolean) — default: Optional —
If true job executions with status "IN_PROGRESS" and "QUEUED" are canceled, otherwise only job executions with status "QUEUED" are canceled. The default is false.

Canceling a job which is "IN_PROGRESS", will cause a device which is executing the job to be unable to update the job execution status. Use caution and ensure that each device executing a job which is canceled is able to recover to a valid state.

Returns:

(Types::CancelJobResponse) —
Returns a response object which responds to the following methods:
- #job_arn => String
- #job_id => String
- #description => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 634

def cancel_job(params = {}, options = {})
  req = build_request(:cancel_job, params)
  req.send_request(options)
end

#cancel_job_execution(params = {}) ⇒ `Struct`

Cancels the execution of a job for a given thing.

Examples:

Request syntax with placeholder values


resp = client.cancel_job_execution({
  job_id: "JobId", # required
  thing_name: "ThingName", # required
  force: false,
  expected_version: 1,
  status_details: {
    "DetailsKey" => "DetailsValue",
  },
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:job_id (required, String) —
The ID of the job to be canceled.
:thing_name (required, String) —
The name of the thing whose execution of the job will be canceled.
:force (Boolean) — default: Optional —
If true the job execution will be canceled if it has status IN_PROGRESS or QUEUED, otherwise the job execution will be canceled only if it has status QUEUED. If you attempt to cancel a job execution that is IN_PROGRESS, and you do not set force to true, then an InvalidStateTransitionException will be thrown. The default is false.

Canceling a job execution which is "IN_PROGRESS", will cause the device to be unable to update the job execution status. Use caution and ensure that the device is able to recover to a valid state.
:expected_version (Integer) — default: Optional —
The expected current version of the job execution. Each time you update the job execution, its version is incremented. If the version of the job execution stored in Jobs does not match, the update is rejected with a VersionMismatch error, and an ErrorResponse that contains the current job execution status data is returned. (This makes it unnecessary to perform a separate DescribeJobExecution request in order to obtain the job execution status data.)
:status_details (Hash<String,String>) —
A collection of name/value pairs that describe the status of the job execution. If not specified, the statusDetails are unchanged. You can specify at most 10 name/value pairs.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 689

def cancel_job_execution(params = {}, options = {})
  req = build_request(:cancel_job_execution, params)
  req.send_request(options)
end

#clear_default_authorizer(params = {}) ⇒ `Struct`

Clears the default authorizer.

Parameters:

params (Hash) (defaults to: {}) —
({})

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 700

def clear_default_authorizer(params = {}, options = {})
  req = build_request(:clear_default_authorizer, params)
  req.send_request(options)
end

#confirm_topic_rule_destination(params = {}) ⇒ `Struct`

Confirms a topic rule destination. When you create a rule requiring a destination, AWS IoT sends a confirmation message to the endpoint or base address you specify. The message includes a token which you pass back when calling ConfirmTopicRuleDestination to confirm that you own or have access to the endpoint.

Examples:

Request syntax with placeholder values


resp = client.confirm_topic_rule_destination({
  confirmation_token: "ConfirmationToken", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:confirmation_token (required, String) —
The token used to confirm ownership or access to the topic rule confirmation URL.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 725

def confirm_topic_rule_destination(params = {}, options = {})
  req = build_request(:confirm_topic_rule_destination, params)
  req.send_request(options)
end

#create_authorizer(params = {}) ⇒ `Types::CreateAuthorizerResponse`

Creates an authorizer.

Examples:

Request syntax with placeholder values


resp = client.create_authorizer({
  authorizer_name: "AuthorizerName", # required
  authorizer_function_arn: "AuthorizerFunctionArn", # required
  token_key_name: "TokenKeyName",
  token_signing_public_keys: {
    "KeyName" => "KeyValue",
  },
  status: "ACTIVE", # accepts ACTIVE, INACTIVE
  signing_disabled: false,
})

Response structure


resp.authorizer_name #=> String
resp.authorizer_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:authorizer_name (required, String) —
The authorizer name.
:authorizer_function_arn (required, String) —
The ARN of the authorizer's Lambda function.
:token_key_name (String) —
The name of the token key used to extract the token from the HTTP headers.
:token_signing_public_keys (Hash<String,String>) —
The public keys used to verify the digital signature returned by your custom authentication service.
:status (String) —
The status of the create authorizer request.
:signing_disabled (Boolean) —
Specifies whether AWS IoT validates the token signature in an authorization request.

Returns:

(Types::CreateAuthorizerResponse) —
Returns a response object which responds to the following methods:
- #authorizer_name => String
- #authorizer_arn => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 778

def create_authorizer(params = {}, options = {})
  req = build_request(:create_authorizer, params)
  req.send_request(options)
end

#create_billing_group(params = {}) ⇒ `Types::CreateBillingGroupResponse`

Creates a billing group.

Examples:

Request syntax with placeholder values


resp = client.create_billing_group({
  billing_group_name: "BillingGroupName", # required
  billing_group_properties: {
    billing_group_description: "BillingGroupDescription",
  },
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.billing_group_name #=> String
resp.billing_group_arn #=> String
resp.billing_group_id #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:billing_group_name (required, String) —
The name you wish to give to the billing group.
:billing_group_properties (Types::BillingGroupProperties) —
The properties of the billing group.
:tags (Array<Types::Tag>) —
Metadata which can be used to manage the billing group.

Returns:

(Types::CreateBillingGroupResponse) —
Returns a response object which responds to the following methods:
- #billing_group_name => String
- #billing_group_arn => String
- #billing_group_id => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 823

def create_billing_group(params = {}, options = {})
  req = build_request(:create_billing_group, params)
  req.send_request(options)
end

#create_certificate_from_csr(params = {}) ⇒ `Types::CreateCertificateFromCsrResponse`

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

Note: The CSR must include a public key that is either an RSA key with a length of at least 2048 bits or an ECC key from NIST P-256 or NIST P-384 curves.

Note: Reusing the same certificate signing request (CSR) results in a distinct certificate.

You can create multiple certificates in a batch by creating a directory, copying multiple .csr files into that directory, and then specifying that directory on the command line. The following commands show how to create a batch of certificates given a batch of CSRs.

Assuming a set of CSRs are located inside of the directory my-csr-directory:

On Linux and OS X, the command is:

$ ls my-csr-directory/ | xargs -I {\} aws iot create-certificate-from-csr --certificate-signing-request file://my-csr-directory/{\}

This command lists all of the CSRs in my-csr-directory and pipes each CSR file name to the aws iot create-certificate-from-csr AWS CLI command to create a certificate for the corresponding CSR.

The aws iot create-certificate-from-csr part of the command can also be run in parallel to speed up the certificate creation process:

$ ls my-csr-directory/ | xargs -P 10 -I {\} aws iot create-certificate-from-csr --certificate-signing-request file://my-csr-directory/{\}

On Windows PowerShell, the command to create certificates for all CSRs in my-csr-directory is:

> ls -Name my-csr-directory | %{aws iot create-certificate-from-csr --certificate-signing-request file://my-csr-directory/$_\}

On a Windows command prompt, the command to create certificates for all CSRs in my-csr-directory is:

> forfiles /p my-csr-directory /c "cmd /c aws iot create-certificate-from-csr --certificate-signing-request file://@path"

Examples:

Request syntax with placeholder values


resp = client.create_certificate_from_csr({
  certificate_signing_request: "CertificateSigningRequest", # required
  set_as_active: false,
})

Response structure


resp.certificate_arn #=> String
resp.certificate_id #=> String
resp.certificate_pem #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:certificate_signing_request (required, String) —
The certificate signing request (CSR).
:set_as_active (Boolean) —
Specifies whether the certificate is active.

Returns:

(Types::CreateCertificateFromCsrResponse) —
Returns a response object which responds to the following methods:
- #certificate_arn => String
- #certificate_id => String
- #certificate_pem => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 904

def create_certificate_from_csr(params = {}, options = {})
  req = build_request(:create_certificate_from_csr, params)
  req.send_request(options)
end

#create_domain_configuration(params = {}) ⇒ `Types::CreateDomainConfigurationResponse`

Creates a domain configuration.

The domain configuration feature is in public preview and is subject to change.

Examples:

Request syntax with placeholder values


resp = client.create_domain_configuration({
  domain_configuration_name: "DomainConfigurationName", # required
  domain_name: "DomainName",
  server_certificate_arns: ["AcmCertificateArn"],
  validation_certificate_arn: "AcmCertificateArn",
  authorizer_config: {
    default_authorizer_name: "AuthorizerName",
    allow_authorizer_override: false,
  },
  service_type: "DATA", # accepts DATA, CREDENTIAL_PROVIDER, JOBS
})

Response structure


resp.domain_configuration_name #=> String
resp.domain_configuration_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:domain_configuration_name (required, String) —
The name of the domain configuration. This value must be unique to a region.
:domain_name (String) —
The name of the domain.
:server_certificate_arns (Array<String>) —
The ARNs of the certificates that AWS IoT passes to the device during the TLS handshake. Currently you can specify only one certificate ARN. This value is not required for AWS-managed domains.
:validation_certificate_arn (String) —
The certificate used to validate the server certificate and prove domain name ownership. This certificate must be signed by a public certificate authority. This value is not required for AWS-managed domains.
:authorizer_config (Types::AuthorizerConfig) —
An object that specifies the authorization service for a domain.
:service_type (String) —
The type of service delivered by the endpoint.

Returns:

(Types::CreateDomainConfigurationResponse) —
Returns a response object which responds to the following methods:
- #domain_configuration_name => String
- #domain_configuration_arn => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 966

def create_domain_configuration(params = {}, options = {})
  req = build_request(:create_domain_configuration, params)
  req.send_request(options)
end

#create_dynamic_thing_group(params = {}) ⇒ `Types::CreateDynamicThingGroupResponse`

Creates a dynamic thing group.

Examples:

Request syntax with placeholder values


resp = client.create_dynamic_thing_group({
  thing_group_name: "ThingGroupName", # required
  thing_group_properties: {
    thing_group_description: "ThingGroupDescription",
    attribute_payload: {
      attributes: {
        "AttributeName" => "AttributeValue",
      },
      merge: false,
    },
  },
  index_name: "IndexName",
  query_string: "QueryString", # required
  query_version: "QueryVersion",
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.thing_group_name #=> String
resp.thing_group_arn #=> String
resp.thing_group_id #=> String
resp.index_name #=> String
resp.query_string #=> String
resp.query_version #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_group_name (required, String) —
The dynamic thing group name to create.
:thing_group_properties (Types::ThingGroupProperties) —
The dynamic thing group properties.
:index_name (String) —
The dynamic thing group index name.

Currently one index is supported: "AWS_Things".
:query_string (required, String) —
The dynamic thing group search query string.

See Query Syntax for information about query string syntax.
:query_version (String) —
The dynamic thing group query version.

Currently one query version is supported: "2017-09-30". If not specified, the query version defaults to this value.
:tags (Array<Types::Tag>) —
Metadata which can be used to manage the dynamic thing group.

Returns:

(Types::CreateDynamicThingGroupResponse) —
Returns a response object which responds to the following methods:
- #thing_group_name => String
- #thing_group_arn => String
- #thing_group_id => String
- #index_name => String
- #query_string => String
- #query_version => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1050

def create_dynamic_thing_group(params = {}, options = {})
  req = build_request(:create_dynamic_thing_group, params)
  req.send_request(options)
end

#create_job(params = {}) ⇒ `Types::CreateJobResponse`

Creates a job.

Examples:

Request syntax with placeholder values


resp = client.create_job({
  job_id: "JobId", # required
  targets: ["TargetArn"], # required
  document_source: "JobDocumentSource",
  document: "JobDocument",
  description: "JobDescription",
  presigned_url_config: {
    role_arn: "RoleArn",
    expires_in_sec: 1,
  },
  target_selection: "CONTINUOUS", # accepts CONTINUOUS, SNAPSHOT
  job_executions_rollout_config: {
    maximum_per_minute: 1,
    exponential_rate: {
      base_rate_per_minute: 1, # required
      increment_factor: 1.0, # required
      rate_increase_criteria: { # required
        number_of_notified_things: 1,
        number_of_succeeded_things: 1,
      },
    },
  },
  abort_config: {
    criteria_list: [ # required
      {
        failure_type: "FAILED", # required, accepts FAILED, REJECTED, TIMED_OUT, ALL
        action: "CANCEL", # required, accepts CANCEL
        threshold_percentage: 1.0, # required
        min_number_of_executed_things: 1, # required
      },
    ],
  },
  timeout_config: {
    in_progress_timeout_in_minutes: 1,
  },
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.job_arn #=> String
resp.job_id #=> String
resp.description #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:job_id (required, String) —
A job identifier which must be unique for your AWS account. We recommend using a UUID. Alpha-numeric characters, "-" and "_" are valid for use here.
:targets (required, Array<String>) —
A list of things and thing groups to which the job should be sent.
:document_source (String) —
An S3 link to the job document.
:document (String) —
The job document.

If the job document resides in an S3 bucket, you must use a placeholder link when specifying the document.

The placeholder link is of the following form:

$\{aws:iot:s3-presigned-url:https://s3.amazonaws.com/bucket/key\}

where bucket is your bucket name and key is the object in the bucket to which you are linking.
:description (String) —
A short text description of the job.
:presigned_url_config (Types::PresignedUrlConfig) —
Configuration information for pre-signed S3 URLs.
:target_selection (String) —
Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a thing when the thing is added to a target group, even after the job was completed by all things originally in the group.
:job_executions_rollout_config (Types::JobExecutionsRolloutConfig) —
Allows you to create a staged rollout of the job.
:abort_config (Types::AbortConfig) —
Allows you to create criteria to abort a job.
:timeout_config (Types::TimeoutConfig) —
Specifies the amount of time each device has to finish its execution of the job. The timer is started when the job execution status is set to IN_PROGRESS. If the job execution status is not set to another terminal state before the time expires, it will be automatically set to TIMED_OUT.
:tags (Array<Types::Tag>) —
Metadata which can be used to manage the job.

Returns:

(Types::CreateJobResponse) —
Returns a response object which responds to the following methods:
- #job_arn => String
- #job_id => String
- #description => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1172

def create_job(params = {}, options = {})
  req = build_request(:create_job, params)
  req.send_request(options)
end

#create_keys_and_certificate(params = {}) ⇒ `Types::CreateKeysAndCertificateResponse`

Creates a 2048-bit RSA key pair and issues an X.509 certificate using the issued public key. You can also call CreateKeysAndCertificate over MQTT from a device, for more information, see Provisioning MQTT API.

Note This is the only time AWS IoT issues the private key for this certificate, so it is important to keep it in a secure location.

Examples:

Request syntax with placeholder values


resp = client.create_keys_and_certificate({
  set_as_active: false,
})

Response structure


resp.certificate_arn #=> String
resp.certificate_id #=> String
resp.certificate_pem #=> String
resp.key_pair.public_key #=> String
resp.key_pair.private_key #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:set_as_active (Boolean) —
Specifies whether the certificate is active.

Returns:

(Types::CreateKeysAndCertificateResponse) —
Returns a response object which responds to the following methods:
- #certificate_arn => String
- #certificate_id => String
- #certificate_pem => String
- #key_pair => Types::KeyPair

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1215

def create_keys_and_certificate(params = {}, options = {})
  req = build_request(:create_keys_and_certificate, params)
  req.send_request(options)
end

#create_mitigation_action(params = {}) ⇒ `Types::CreateMitigationActionResponse`

Defines an action that can be applied to audit findings by using StartAuditMitigationActionsTask. Each mitigation action can apply only one type of change.

Examples:

Request syntax with placeholder values


resp = client.create_mitigation_action({
  action_name: "MitigationActionName", # required
  role_arn: "RoleArn", # required
  action_params: { # required
    update_device_certificate_params: {
      action: "DEACTIVATE", # required, accepts DEACTIVATE
    },
    update_ca_certificate_params: {
      action: "DEACTIVATE", # required, accepts DEACTIVATE
    },
    add_things_to_thing_group_params: {
      thing_group_names: ["ThingGroupName"], # required
      override_dynamic_groups: false,
    },
    replace_default_policy_version_params: {
      template_name: "BLANK_POLICY", # required, accepts BLANK_POLICY
    },
    enable_io_t_logging_params: {
      role_arn_for_logging: "RoleArn", # required
      log_level: "DEBUG", # required, accepts DEBUG, INFO, ERROR, WARN, DISABLED
    },
    publish_finding_to_sns_params: {
      topic_arn: "SnsTopicArn", # required
    },
  },
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.action_arn #=> String
resp.action_id #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:action_name (required, String) —
A friendly name for the action. Choose a friendly name that accurately describes the action (for example, EnableLoggingAction).
:role_arn (required, String) —
The ARN of the IAM role that is used to apply the mitigation action.
:action_params (required, Types::MitigationActionParams) —
Defines the type of action and the parameters for that action.
:tags (Array<Types::Tag>) —
Metadata that can be used to manage the mitigation action.

Returns:

(Types::CreateMitigationActionResponse) —
Returns a response object which responds to the following methods:
- #action_arn => String
- #action_id => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1284

def create_mitigation_action(params = {}, options = {})
  req = build_request(:create_mitigation_action, params)
  req.send_request(options)
end

#create_ota_update(params = {}) ⇒ `Types::CreateOTAUpdateResponse`

Creates an AWS IoT OTAUpdate on a target group of things or groups.

Examples:

Request syntax with placeholder values


resp = client.create_ota_update({
  ota_update_id: "OTAUpdateId", # required
  description: "OTAUpdateDescription",
  targets: ["Target"], # required
  protocols: ["MQTT"], # accepts MQTT, HTTP
  target_selection: "CONTINUOUS", # accepts CONTINUOUS, SNAPSHOT
  aws_job_executions_rollout_config: {
    maximum_per_minute: 1,
  },
  aws_job_presigned_url_config: {
    expires_in_sec: 1,
  },
  files: [ # required
    {
      file_name: "FileName",
      file_version: "OTAUpdateFileVersion",
      file_location: {
        stream: {
          stream_id: "StreamId",
          file_id: 1,
        },
        s3_location: {
          bucket: "S3Bucket",
          key: "S3Key",
          version: "S3Version",
        },
      },
      code_signing: {
        aws_signer_job_id: "SigningJobId",
        start_signing_job_parameter: {
          signing_profile_parameter: {
            certificate_arn: "CertificateArn",
            platform: "Platform",
            certificate_path_on_device: "CertificatePathOnDevice",
          },
          signing_profile_name: "SigningProfileName",
          destination: {
            s3_destination: {
              bucket: "S3Bucket",
              prefix: "Prefix",
            },
          },
        },
        custom_code_signing: {
          signature: {
            inline_document: "data",
          },
          certificate_chain: {
            certificate_name: "CertificateName",
            inline_document: "InlineDocument",
          },
          hash_algorithm: "HashAlgorithm",
          signature_algorithm: "SignatureAlgorithm",
        },
      },
      attributes: {
        "AttributeKey" => "Value",
      },
    },
  ],
  role_arn: "RoleArn", # required
  additional_parameters: {
    "AttributeKey" => "Value",
  },
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.ota_update_id #=> String
resp.aws_iot_job_id #=> String
resp.ota_update_arn #=> String
resp.aws_iot_job_arn #=> String
resp.ota_update_status #=> String, one of "CREATE_PENDING", "CREATE_IN_PROGRESS", "CREATE_COMPLETE", "CREATE_FAILED"

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:ota_update_id (required, String) —
The ID of the OTA update to be created.
:description (String) —
The description of the OTA update.
:targets (required, Array<String>) —
The targeted devices to receive OTA updates.
:protocols (Array<String>) —
The protocol used to transfer the OTA update image. Valid values are [HTTP], [MQTT], [HTTP, MQTT]. When both HTTP and MQTT are specified, the target device can choose the protocol.
:target_selection (String) —
Specifies whether the update will continue to run (CONTINUOUS), or will be complete after all the things specified as targets have completed the update (SNAPSHOT). If continuous, the update may also be run on a thing when a change is detected in a target. For example, an update will run on a thing when the thing is added to a target group, even after the update was completed by all things originally in the group. Valid values: CONTINUOUS | SNAPSHOT.
:aws_job_executions_rollout_config (Types::AwsJobExecutionsRolloutConfig) —
Configuration for the rollout of OTA updates.
:aws_job_presigned_url_config (Types::AwsJobPresignedUrlConfig) —
Configuration information for pre-signed URLs.
:files (required, Array<Types::OTAUpdateFile>) —
The files to be streamed by the OTA update.
:role_arn (required, String) —
The IAM role that allows access to the AWS IoT Jobs service.
:additional_parameters (Hash<String,String>) —
A list of additional OTA update parameters which are name-value pairs.
:tags (Array<Types::Tag>) —
Metadata which can be used to manage updates.

Returns:

(Types::CreateOTAUpdateResponse) —
Returns a response object which responds to the following methods:
- #ota_update_id => String
- #aws_iot_job_id => String
- #ota_update_arn => String
- #aws_iot_job_arn => String
- #ota_update_status => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1424

def create_ota_update(params = {}, options = {})
  req = build_request(:create_ota_update, params)
  req.send_request(options)
end

#create_policy(params = {}) ⇒ `Types::CreatePolicyResponse`

Creates an AWS IoT policy.

The created policy is the default version for the policy. This operation creates a policy version with a version identifier of 1 and sets 1 as the policy's default version.

Examples:

Request syntax with placeholder values


resp = client.create_policy({
  policy_name: "PolicyName", # required
  policy_document: "PolicyDocument", # required
})

Response structure


resp.policy_name #=> String
resp.policy_arn #=> String
resp.policy_document #=> String
resp.policy_version_id #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The policy name.
:policy_document (required, String) —
The JSON document that describes the policy. policyDocument must have a minimum length of 1, with a maximum length of 2048, excluding whitespace.

Returns:

(Types::CreatePolicyResponse) —
Returns a response object which responds to the following methods:
- #policy_name => String
- #policy_arn => String
- #policy_document => String
- #policy_version_id => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1466

def create_policy(params = {}, options = {})
  req = build_request(:create_policy, params)
  req.send_request(options)
end

#create_policy_version(params = {}) ⇒ `Types::CreatePolicyVersionResponse`

Creates a new version of the specified AWS IoT policy. To update a policy, create a new policy version. A managed policy can have up to five versions. If the policy has five versions, you must use DeletePolicyVersion to delete an existing version before you create a new one.

Optionally, you can set the new version as the policy's default version. The default version is the operative version (that is, the version that is in effect for the certificates to which the policy is attached).

Examples:

Request syntax with placeholder values


resp = client.create_policy_version({
  policy_name: "PolicyName", # required
  policy_document: "PolicyDocument", # required
  set_as_default: false,
})

Response structure


resp.policy_arn #=> String
resp.policy_document #=> String
resp.policy_version_id #=> String
resp.is_default_version #=> Boolean

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The policy name.
:policy_document (required, String) —
The JSON document that describes the policy. Minimum length of 1. Maximum length of 2048, excluding whitespace.
:set_as_default (Boolean) —
Specifies whether the policy version is set as the default. When this parameter is true, the new policy version becomes the operative version (that is, the version that is in effect for the certificates to which the policy is attached).

Returns:

(Types::CreatePolicyVersionResponse) —
Returns a response object which responds to the following methods:
- #policy_arn => String
- #policy_document => String
- #policy_version_id => String
- #is_default_version => Boolean

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1519

def create_policy_version(params = {}, options = {})
  req = build_request(:create_policy_version, params)
  req.send_request(options)
end

#create_provisioning_claim(params = {}) ⇒ `Types::CreateProvisioningClaimResponse`

Creates a provisioning claim.

Examples:

Request syntax with placeholder values


resp = client.create_provisioning_claim({
  template_name: "TemplateName", # required
})

Response structure


resp.certificate_id #=> String
resp.certificate_pem #=> String
resp.key_pair.public_key #=> String
resp.key_pair.private_key #=> String
resp.expiration #=> Time

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:template_name (required, String) —
The name of the provisioning template to use.

Returns:

(Types::CreateProvisioningClaimResponse) —
Returns a response object which responds to the following methods:
- #certificate_id => String
- #certificate_pem => String
- #key_pair => Types::KeyPair
- #expiration => Time

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1552

def create_provisioning_claim(params = {}, options = {})
  req = build_request(:create_provisioning_claim, params)
  req.send_request(options)
end

#create_provisioning_template(params = {}) ⇒ `Types::CreateProvisioningTemplateResponse`

Creates a fleet provisioning template.

Examples:

Request syntax with placeholder values


resp = client.create_provisioning_template({
  template_name: "TemplateName", # required
  description: "TemplateDescription",
  template_body: "TemplateBody", # required
  enabled: false,
  provisioning_role_arn: "RoleArn", # required
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.template_arn #=> String
resp.template_name #=> String
resp.default_version_id #=> Integer

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:template_name (required, String) —
The name of the fleet provisioning template.
:description (String) —
The description of the fleet provisioning template.
:template_body (required, String) —
The JSON formatted contents of the fleet provisioning template.
:enabled (Boolean) —
True to enable the fleet provisioning template, otherwise false.
:provisioning_role_arn (required, String) —
The role ARN for the role associated with the fleet provisioning template. This IoT role grants permission to provision a device.
:tags (Array<Types::Tag>) —
Metadata which can be used to manage the fleet provisioning template.

For URI Request parameters use format: ...key1=value1&key2=value2...

For the CLI command-line parameter use format: &&tags "key1=value1&key2=value2..."

For the cli-input-json file use format: "tags": "key1=value1&key2=value2..."

Returns:

(Types::CreateProvisioningTemplateResponse) —
Returns a response object which responds to the following methods:
- #template_arn => String
- #template_name => String
- #default_version_id => Integer

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1619

def create_provisioning_template(params = {}, options = {})
  req = build_request(:create_provisioning_template, params)
  req.send_request(options)
end

#create_provisioning_template_version(params = {}) ⇒ `Types::CreateProvisioningTemplateVersionResponse`

Creates a new version of a fleet provisioning template.

Examples:

Request syntax with placeholder values


resp = client.create_provisioning_template_version({
  template_name: "TemplateName", # required
  template_body: "TemplateBody", # required
  set_as_default: false,
})

Response structure


resp.template_arn #=> String
resp.template_name #=> String
resp.version_id #=> Integer
resp.is_default_version #=> Boolean

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:template_name (required, String) —
The name of the fleet provisioning template.
:template_body (required, String) —
The JSON formatted contents of the fleet provisioning template.
:set_as_default (Boolean) —
Sets a fleet provision template version as the default version.

Returns:

(Types::CreateProvisioningTemplateVersionResponse) —
Returns a response object which responds to the following methods:
- #template_arn => String
- #template_name => String
- #version_id => Integer
- #is_default_version => Boolean

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1659

def create_provisioning_template_version(params = {}, options = {})
  req = build_request(:create_provisioning_template_version, params)
  req.send_request(options)
end

#create_role_alias(params = {}) ⇒ `Types::CreateRoleAliasResponse`

Creates a role alias.

Examples:

Request syntax with placeholder values


resp = client.create_role_alias({
  role_alias: "RoleAlias", # required
  role_arn: "RoleArn", # required
  credential_duration_seconds: 1,
})

Response structure


resp.role_alias #=> String
resp.role_alias_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:role_alias (required, String) —
The role alias that points to a role ARN. This allows you to change the role without having to update the device.
:role_arn (required, String) —
The role ARN.
:credential_duration_seconds (Integer) —
How long (in seconds) the credentials will be valid.

Returns:

(Types::CreateRoleAliasResponse) —
Returns a response object which responds to the following methods:
- #role_alias => String
- #role_alias_arn => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1696

def create_role_alias(params = {}, options = {})
  req = build_request(:create_role_alias, params)
  req.send_request(options)
end

#create_scheduled_audit(params = {}) ⇒ `Types::CreateScheduledAuditResponse`

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

Examples:

Request syntax with placeholder values


resp = client.create_scheduled_audit({
  frequency: "DAILY", # required, accepts DAILY, WEEKLY, BIWEEKLY, MONTHLY
  day_of_month: "DayOfMonth",
  day_of_week: "SUN", # accepts SUN, MON, TUE, WED, THU, FRI, SAT
  target_check_names: ["AuditCheckName"], # required
  scheduled_audit_name: "ScheduledAuditName", # required
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.scheduled_audit_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:frequency (required, String) —
How often the scheduled audit takes place. Can be one of "DAILY", "WEEKLY", "BIWEEKLY" or "MONTHLY". The start time of each audit is determined by the system.
:day_of_month (String) —
The day of the month on which the scheduled audit takes place. Can be "1" through "31" or "LAST". This field is required if the "frequency" parameter is set to "MONTHLY". If days 29-31 are specified, and the month does not have that many days, the audit takes place on the "LAST" day of the month.
:day_of_week (String) —
The day of the week on which the scheduled audit takes place. Can be one of "SUN", "MON", "TUE", "WED", "THU", "FRI", or "SAT". This field is required if the "frequency" parameter is set to "WEEKLY" or "BIWEEKLY".
:target_check_names (required, Array<String>) —
Which checks are performed during the scheduled audit. Checks must be enabled for your account. (Use DescribeAccountAuditConfiguration to see the list of all checks, including those that are enabled or use UpdateAccountAuditConfiguration to select which checks are enabled.)
:scheduled_audit_name (required, String) —
The name you want to give to the scheduled audit. (Max. 128 chars)
:tags (Array<Types::Tag>) —
Metadata that can be used to manage the scheduled audit.

Returns:

(Types::CreateScheduledAuditResponse) —
Returns a response object which responds to the following methods:
- #scheduled_audit_arn => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1759

def create_scheduled_audit(params = {}, options = {})
  req = build_request(:create_scheduled_audit, params)
  req.send_request(options)
end

#create_security_profile(params = {}) ⇒ `Types::CreateSecurityProfileResponse`

Creates a Device Defender security profile.

Examples:

Request syntax with placeholder values


resp = client.create_security_profile({
  security_profile_name: "SecurityProfileName", # required
  security_profile_description: "SecurityProfileDescription",
  behaviors: [
    {
      name: "BehaviorName", # required
      metric: "BehaviorMetric",
      criteria: {
        comparison_operator: "less-than", # accepts less-than, less-than-equals, greater-than, greater-than-equals, in-cidr-set, not-in-cidr-set, in-port-set, not-in-port-set
        value: {
          count: 1,
          cidrs: ["Cidr"],
          ports: [1],
        },
        duration_seconds: 1,
        consecutive_datapoints_to_alarm: 1,
        consecutive_datapoints_to_clear: 1,
        statistical_threshold: {
          statistic: "EvaluationStatistic",
        },
      },
    },
  ],
  alert_targets: {
    "SNS" => {
      alert_target_arn: "AlertTargetArn", # required
      role_arn: "RoleArn", # required
    },
  },
  additional_metrics_to_retain: ["BehaviorMetric"],
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.security_profile_name #=> String
resp.security_profile_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:security_profile_name (required, String) —
The name you are giving to the security profile.
:security_profile_description (String) —
A description of the security profile.
:behaviors (Array<Types::Behavior>) —
Specifies the behaviors that, when violated by a device (thing), cause an alert.
:alert_targets (Hash<String,Types::AlertTarget>) —
Specifies the destinations to which alerts are sent. (Alerts are always sent to the console.) Alerts are generated when a device (thing) violates a behavior.
:additional_metrics_to_retain (Array<String>) —
A list of metrics whose data is retained (stored). By default, data is retained for any metric used in the profile's behaviors, but it is also retained for any metric specified here.
:tags (Array<Types::Tag>) —
Metadata that can be used to manage the security profile.

Returns:

(Types::CreateSecurityProfileResponse) —
Returns a response object which responds to the following methods:
- #security_profile_name => String
- #security_profile_arn => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1841

def create_security_profile(params = {}, options = {})
  req = build_request(:create_security_profile, params)
  req.send_request(options)
end

#create_stream(params = {}) ⇒ `Types::CreateStreamResponse`

Creates a stream for delivering one or more large files in chunks over MQTT. A stream transports data bytes in chunks or blocks packaged as MQTT messages from a source like S3. You can have one or more files associated with a stream.

Examples:

Request syntax with placeholder values


resp = client.create_stream({
  stream_id: "StreamId", # required
  description: "StreamDescription",
  files: [ # required
    {
      file_id: 1,
      s3_location: {
        bucket: "S3Bucket",
        key: "S3Key",
        version: "S3Version",
      },
    },
  ],
  role_arn: "RoleArn", # required
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.stream_id #=> String
resp.stream_arn #=> String
resp.description #=> String
resp.stream_version #=> Integer

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:stream_id (required, String) —
The stream ID.
:description (String) —
A description of the stream.
:files (required, Array<Types::StreamFile>) —
The files to stream.
:role_arn (required, String) —
An IAM role that allows the IoT service principal assumes to access your S3 files.
:tags (Array<Types::Tag>) —
Metadata which can be used to manage streams.

Returns:

(Types::CreateStreamResponse) —
Returns a response object which responds to the following methods:
- #stream_id => String
- #stream_arn => String
- #description => String
- #stream_version => Integer

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1907

def create_stream(params = {}, options = {})
  req = build_request(:create_stream, params)
  req.send_request(options)
end

#create_thing(params = {}) ⇒ `Types::CreateThingResponse`

Creates a thing record in the registry. If this call is made multiple times using the same thing name and configuration, the call will succeed. If this call is made with the same thing name but different configuration a ResourceAlreadyExistsException is thrown.

This is a control plane operation. See Authorization for information about authorizing control plane actions.

Examples:

Request syntax with placeholder values


resp = client.create_thing({
  thing_name: "ThingName", # required
  thing_type_name: "ThingTypeName",
  attribute_payload: {
    attributes: {
      "AttributeName" => "AttributeValue",
    },
    merge: false,
  },
  billing_group_name: "BillingGroupName",
})

Response structure


resp.thing_name #=> String
resp.thing_arn #=> String
resp.thing_id #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_name (required, String) —
The name of the thing to create.
:thing_type_name (String) —
The name of the thing type associated with the new thing.
:attribute_payload (Types::AttributePayload) —
The attribute payload, which consists of up to three name/value pairs in a JSON document. For example:

\{"attributes":\{"string1":"string2"\}\}
:billing_group_name (String) —
The name of the billing group the thing will be added to.

Returns:

(Types::CreateThingResponse) —
Returns a response object which responds to the following methods:
- #thing_name => String
- #thing_arn => String
- #thing_id => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 1969

def create_thing(params = {}, options = {})
  req = build_request(:create_thing, params)
  req.send_request(options)
end

#create_thing_group(params = {}) ⇒ `Types::CreateThingGroupResponse`

Create a thing group.

This is a control plane operation. See Authorization for information about authorizing control plane actions.

Examples:

Request syntax with placeholder values


resp = client.create_thing_group({
  thing_group_name: "ThingGroupName", # required
  parent_group_name: "ThingGroupName",
  thing_group_properties: {
    thing_group_description: "ThingGroupDescription",
    attribute_payload: {
      attributes: {
        "AttributeName" => "AttributeValue",
      },
      merge: false,
    },
  },
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.thing_group_name #=> String
resp.thing_group_arn #=> String
resp.thing_group_id #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_group_name (required, String) —
The thing group name to create.
:parent_group_name (String) —
The name of the parent thing group.
:thing_group_properties (Types::ThingGroupProperties) —
The thing group properties.
:tags (Array<Types::Tag>) —
Metadata which can be used to manage the thing group.

Returns:

(Types::CreateThingGroupResponse) —
Returns a response object which responds to the following methods:
- #thing_group_name => String
- #thing_group_arn => String
- #thing_group_id => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2033

def create_thing_group(params = {}, options = {})
  req = build_request(:create_thing_group, params)
  req.send_request(options)
end

#create_thing_type(params = {}) ⇒ `Types::CreateThingTypeResponse`

Creates a new thing type.

Examples:

Request syntax with placeholder values


resp = client.create_thing_type({
  thing_type_name: "ThingTypeName", # required
  thing_type_properties: {
    thing_type_description: "ThingTypeDescription",
    searchable_attributes: ["AttributeName"],
  },
  tags: [
    {
      key: "TagKey",
      value: "TagValue",
    },
  ],
})

Response structure


resp.thing_type_name #=> String
resp.thing_type_arn #=> String
resp.thing_type_id #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_type_name (required, String) —
The name of the thing type.
:thing_type_properties (Types::ThingTypeProperties) —
The ThingTypeProperties for the thing type to create. It contains information about the new thing type including a description, and a list of searchable thing attribute names.
:tags (Array<Types::Tag>) —
Metadata which can be used to manage the thing type.

Returns:

(Types::CreateThingTypeResponse) —
Returns a response object which responds to the following methods:
- #thing_type_name => String
- #thing_type_arn => String
- #thing_type_id => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2081

def create_thing_type(params = {}, options = {})
  req = build_request(:create_thing_type, params)
  req.send_request(options)
end

#create_topic_rule(params = {}) ⇒ `Struct`

Creates a rule. Creating rules is an administrator-level action. Any user who has permission to create rules will be able to access data processed by the rule.

Examples:

Request syntax with placeholder values


resp = client.create_topic_rule({
  rule_name: "RuleName", # required
  topic_rule_payload: { # required
    sql: "SQL", # required
    description: "Description",
    actions: [ # required
      {
        dynamo_db: {
          table_name: "TableName", # required
          role_arn: "AwsArn", # required
          operation: "DynamoOperation",
          hash_key_field: "HashKeyField", # required
          hash_key_value: "HashKeyValue", # required
          hash_key_type: "STRING", # accepts STRING, NUMBER
          range_key_field: "RangeKeyField",
          range_key_value: "RangeKeyValue",
          range_key_type: "STRING", # accepts STRING, NUMBER
          payload_field: "PayloadField",
        },
        dynamo_d_bv_2: {
          role_arn: "AwsArn", # required
          put_item: { # required
            table_name: "TableName", # required
          },
        },
        lambda: {
          function_arn: "FunctionArn", # required
        },
        sns: {
          target_arn: "AwsArn", # required
          role_arn: "AwsArn", # required
          message_format: "RAW", # accepts RAW, JSON
        },
        sqs: {
          role_arn: "AwsArn", # required
          queue_url: "QueueUrl", # required
          use_base_64: false,
        },
        kinesis: {
          role_arn: "AwsArn", # required
          stream_name: "StreamName", # required
          partition_key: "PartitionKey",
        },
        republish: {
          role_arn: "AwsArn", # required
          topic: "TopicPattern", # required
          qos: 1,
        },
        s3: {
          role_arn: "AwsArn", # required
          bucket_name: "BucketName", # required
          key: "Key", # required
          canned_acl: "private", # accepts private, public-read, public-read-write, aws-exec-read, authenticated-read, bucket-owner-read, bucket-owner-full-control, log-delivery-write
        },
        firehose: {
          role_arn: "AwsArn", # required
          delivery_stream_name: "DeliveryStreamName", # required
          separator: "FirehoseSeparator",
        },
        cloudwatch_metric: {
          role_arn: "AwsArn", # required
          metric_namespace: "String", # required
          metric_name: "String", # required
          metric_value: "String", # required
          metric_unit: "String", # required
          metric_timestamp: "String",
        },
        cloudwatch_alarm: {
          role_arn: "AwsArn", # required
          alarm_name: "AlarmName", # required
          state_reason: "StateReason", # required
          state_value: "StateValue", # required
        },
        elasticsearch: {
          role_arn: "AwsArn", # required
          endpoint: "ElasticsearchEndpoint", # required
          index: "ElasticsearchIndex", # required
          type: "ElasticsearchType", # required
          id: "ElasticsearchId", # required
        },
        salesforce: {
          token: "SalesforceToken", # required
          url: "SalesforceEndpoint", # required
        },
        iot_analytics: {
          channel_arn: "AwsArn",
          channel_name: "ChannelName",
          role_arn: "AwsArn",
        },
        iot_events: {
          input_name: "InputName", # required
          message_id: "MessageId",
          role_arn: "AwsArn", # required
        },
        iot_site_wise: {
          put_asset_property_value_entries: [ # required
            {
              entry_id: "AssetPropertyEntryId",
              asset_id: "AssetId",
              property_id: "AssetPropertyId",
              property_alias: "AssetPropertyAlias",
              property_values: [ # required
                {
                  value: { # required
                    string_value: "AssetPropertyStringValue",
                    integer_value: "AssetPropertyIntegerValue",
                    double_value: "AssetPropertyDoubleValue",
                    boolean_value: "AssetPropertyBooleanValue",
                  },
                  timestamp: { # required
                    time_in_seconds: "AssetPropertyTimeInSeconds", # required
                    offset_in_nanos: "AssetPropertyOffsetInNanos",
                  },
                  quality: "AssetPropertyQuality",
                },
              ],
            },
          ],
          role_arn: "AwsArn", # required
        },
        step_functions: {
          execution_name_prefix: "ExecutionNamePrefix",
          state_machine_name: "StateMachineName", # required
          role_arn: "AwsArn", # required
        },
        http: {
          url: "Url", # required
          confirmation_url: "Url",
          headers: [
            {
              key: "HeaderKey", # required
              value: "HeaderValue", # required
            },
          ],
          auth: {
            sigv4: {
              signing_region: "SigningRegion", # required
              service_name: "ServiceName", # required
              role_arn: "AwsArn", # required
            },
          },
        },
      },
    ],
    rule_disabled: false,
    aws_iot_sql_version: "AwsIotSqlVersion",
    error_action: {
      dynamo_db: {
        table_name: "TableName", # required
        role_arn: "AwsArn", # required
        operation: "DynamoOperation",
        hash_key_field: "HashKeyField", # required
        hash_key_value: "HashKeyValue", # required
        hash_key_type: "STRING", # accepts STRING, NUMBER
        range_key_field: "RangeKeyField",
        range_key_value: "RangeKeyValue",
        range_key_type: "STRING", # accepts STRING, NUMBER
        payload_field: "PayloadField",
      },
      dynamo_d_bv_2: {
        role_arn: "AwsArn", # required
        put_item: { # required
          table_name: "TableName", # required
        },
      },
      lambda: {
        function_arn: "FunctionArn", # required
      },
      sns: {
        target_arn: "AwsArn", # required
        role_arn: "AwsArn", # required
        message_format: "RAW", # accepts RAW, JSON
      },
      sqs: {
        role_arn: "AwsArn", # required
        queue_url: "QueueUrl", # required
        use_base_64: false,
      },
      kinesis: {
        role_arn: "AwsArn", # required
        stream_name: "StreamName", # required
        partition_key: "PartitionKey",
      },
      republish: {
        role_arn: "AwsArn", # required
        topic: "TopicPattern", # required
        qos: 1,
      },
      s3: {
        role_arn: "AwsArn", # required
        bucket_name: "BucketName", # required
        key: "Key", # required
        canned_acl: "private", # accepts private, public-read, public-read-write, aws-exec-read, authenticated-read, bucket-owner-read, bucket-owner-full-control, log-delivery-write
      },
      firehose: {
        role_arn: "AwsArn", # required
        delivery_stream_name: "DeliveryStreamName", # required
        separator: "FirehoseSeparator",
      },
      cloudwatch_metric: {
        role_arn: "AwsArn", # required
        metric_namespace: "String", # required
        metric_name: "String", # required
        metric_value: "String", # required
        metric_unit: "String", # required
        metric_timestamp: "String",
      },
      cloudwatch_alarm: {
        role_arn: "AwsArn", # required
        alarm_name: "AlarmName", # required
        state_reason: "StateReason", # required
        state_value: "StateValue", # required
      },
      elasticsearch: {
        role_arn: "AwsArn", # required
        endpoint: "ElasticsearchEndpoint", # required
        index: "ElasticsearchIndex", # required
        type: "ElasticsearchType", # required
        id: "ElasticsearchId", # required
      },
      salesforce: {
        token: "SalesforceToken", # required
        url: "SalesforceEndpoint", # required
      },
      iot_analytics: {
        channel_arn: "AwsArn",
        channel_name: "ChannelName",
        role_arn: "AwsArn",
      },
      iot_events: {
        input_name: "InputName", # required
        message_id: "MessageId",
        role_arn: "AwsArn", # required
      },
      iot_site_wise: {
        put_asset_property_value_entries: [ # required
          {
            entry_id: "AssetPropertyEntryId",
            asset_id: "AssetId",
            property_id: "AssetPropertyId",
            property_alias: "AssetPropertyAlias",
            property_values: [ # required
              {
                value: { # required
                  string_value: "AssetPropertyStringValue",
                  integer_value: "AssetPropertyIntegerValue",
                  double_value: "AssetPropertyDoubleValue",
                  boolean_value: "AssetPropertyBooleanValue",
                },
                timestamp: { # required
                  time_in_seconds: "AssetPropertyTimeInSeconds", # required
                  offset_in_nanos: "AssetPropertyOffsetInNanos",
                },
                quality: "AssetPropertyQuality",
              },
            ],
          },
        ],
        role_arn: "AwsArn", # required
      },
      step_functions: {
        execution_name_prefix: "ExecutionNamePrefix",
        state_machine_name: "StateMachineName", # required
        role_arn: "AwsArn", # required
      },
      http: {
        url: "Url", # required
        confirmation_url: "Url",
        headers: [
          {
            key: "HeaderKey", # required
            value: "HeaderValue", # required
          },
        ],
        auth: {
          sigv4: {
            signing_region: "SigningRegion", # required
            service_name: "ServiceName", # required
            role_arn: "AwsArn", # required
          },
        },
      },
    },
  },
  tags: "String",
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:rule_name (required, String) —
The name of the rule.
:topic_rule_payload (required, Types::TopicRulePayload) —
The rule payload.
:tags (String) —
Metadata which can be used to manage the topic rule.

For URI Request parameters use format: ...key1=value1&key2=value2...

For the CLI command-line parameter use format: --tags "key1=value1&key2=value2..."

For the cli-input-json file use format: "tags": "key1=value1&key2=value2..."

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2403

def create_topic_rule(params = {}, options = {})
  req = build_request(:create_topic_rule, params)
  req.send_request(options)
end

#create_topic_rule_destination(params = {}) ⇒ `Types::CreateTopicRuleDestinationResponse`

Creates a topic rule destination. The destination must be confirmed prior to use.

Examples:

Request syntax with placeholder values


resp = client.create_topic_rule_destination({
  destination_configuration: { # required
    http_url_configuration: {
      confirmation_url: "Url", # required
    },
  },
})

Response structure


resp.topic_rule_destination.arn #=> String
resp.topic_rule_destination.status #=> String, one of "ENABLED", "IN_PROGRESS", "DISABLED", "ERROR"
resp.topic_rule_destination.status_reason #=> String
resp.topic_rule_destination.http_url_properties.confirmation_url #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:destination_configuration (required, Types::TopicRuleDestinationConfiguration) —
The topic rule destination configuration.

Returns:

(Types::CreateTopicRuleDestinationResponse) —
Returns a response object which responds to the following methods:
- #topic_rule_destination => Types::TopicRuleDestination

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2437

def create_topic_rule_destination(params = {}, options = {})
  req = build_request(:create_topic_rule_destination, params)
  req.send_request(options)
end

#delete_account_audit_configuration(params = {}) ⇒ `Struct`

Restores the default settings for Device Defender audits for this account. Any configuration data you entered is deleted and all audit checks are reset to disabled.

Examples:

Request syntax with placeholder values


resp = client.delete_account_audit_configuration({
  delete_scheduled_audits: false,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:delete_scheduled_audits (Boolean) —
If true, all scheduled audits are deleted.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2459

def delete_account_audit_configuration(params = {}, options = {})
  req = build_request(:delete_account_audit_configuration, params)
  req.send_request(options)
end

#delete_authorizer(params = {}) ⇒ `Struct`

Deletes an authorizer.

Examples:

Request syntax with placeholder values


resp = client.delete_authorizer({
  authorizer_name: "AuthorizerName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:authorizer_name (required, String) —
The name of the authorizer to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2479

def delete_authorizer(params = {}, options = {})
  req = build_request(:delete_authorizer, params)
  req.send_request(options)
end

#delete_billing_group(params = {}) ⇒ `Struct`

Deletes the billing group.

Examples:

Request syntax with placeholder values


resp = client.delete_billing_group({
  billing_group_name: "BillingGroupName", # required
  expected_version: 1,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:billing_group_name (required, String) —
The name of the billing group.
:expected_version (Integer) —
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 DeleteBillingGroup request is rejected with a VersionConflictException.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2506

def delete_billing_group(params = {}, options = {})
  req = build_request(:delete_billing_group, params)
  req.send_request(options)
end

#delete_ca_certificate(params = {}) ⇒ `Struct`

Deletes a registered CA certificate.

Examples:

Request syntax with placeholder values


resp = client.delete_ca_certificate({
  certificate_id: "CertificateId", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:certificate_id (required, String) —
The ID of the certificate to delete. (The last part of the certificate ARN contains the certificate ID.)

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2527

def delete_ca_certificate(params = {}, options = {})
  req = build_request(:delete_ca_certificate, params)
  req.send_request(options)
end

#delete_certificate(params = {}) ⇒ `Struct`

Deletes the specified certificate.

A certificate cannot be deleted if it has a policy or IoT thing attached to it or if its status is set to ACTIVE. To delete a certificate, first use the DetachPrincipalPolicy API to detach all policies. Next, use the UpdateCertificate API to set the certificate to the INACTIVE status.

Examples:

Request syntax with placeholder values


resp = client.delete_certificate({
  certificate_id: "CertificateId", # required
  force_delete: false,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:certificate_id (required, String) —
The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)
:force_delete (Boolean) —
Forces the deletion of a certificate if it is inactive and is not attached to an IoT thing.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2559

def delete_certificate(params = {}, options = {})
  req = build_request(:delete_certificate, params)
  req.send_request(options)
end

#delete_domain_configuration(params = {}) ⇒ `Struct`

Deletes the specified domain configuration.

The domain configuration feature is in public preview and is subject to change.

Examples:

Request syntax with placeholder values


resp = client.delete_domain_configuration({
  domain_configuration_name: "DomainConfigurationName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:domain_configuration_name (required, String) —
The name of the domain configuration to be deleted.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2584

def delete_domain_configuration(params = {}, options = {})
  req = build_request(:delete_domain_configuration, params)
  req.send_request(options)
end

#delete_dynamic_thing_group(params = {}) ⇒ `Struct`

Deletes a dynamic thing group.

Examples:

Request syntax with placeholder values


resp = client.delete_dynamic_thing_group({
  thing_group_name: "ThingGroupName", # required
  expected_version: 1,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_group_name (required, String) —
The name of the dynamic thing group to delete.
:expected_version (Integer) —
The expected version of the dynamic thing group to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2608

def delete_dynamic_thing_group(params = {}, options = {})
  req = build_request(:delete_dynamic_thing_group, params)
  req.send_request(options)
end

#delete_job(params = {}) ⇒ `Struct`

Deletes a job and its related job executions.

Deleting a job may take time, depending on the number of job executions created for the job and various other factors. While the job is being deleted, the status of the job will be shown as "DELETION_IN_PROGRESS". Attempting to delete or cancel a job whose status is already "DELETION_IN_PROGRESS" will result in an error.

Only 10 jobs may have status "DELETION_IN_PROGRESS" at the same time, or a LimitExceededException will occur.

Examples:

Request syntax with placeholder values


resp = client.delete_job({
  job_id: "JobId", # required
  force: false,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:job_id (required, String) —
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.
:force (Boolean) — default: 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.

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.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2656

def delete_job(params = {}, options = {})
  req = build_request(:delete_job, params)
  req.send_request(options)
end

#delete_job_execution(params = {}) ⇒ `Struct`

Deletes a job execution.

Examples:

Request syntax with placeholder values


resp = client.delete_job_execution({
  job_id: "JobId", # required
  thing_name: "ThingName", # required
  execution_number: 1, # required
  force: false,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:job_id (required, String) —
The ID of the job whose execution on a particular device will be deleted.
:thing_name (required, String) —
The name of the thing whose job execution will be deleted.
:execution_number (required, Integer) —
The ID of the job execution to be deleted. The executionNumber refers to the execution of a particular job on a particular device.

Note that once a job execution is deleted, the executionNumber may be reused by IoT, so be sure you get and use the correct value here.
:force (Boolean) — default: 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.

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.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2704

def delete_job_execution(params = {}, options = {})
  req = build_request(:delete_job_execution, params)
  req.send_request(options)
end

#delete_mitigation_action(params = {}) ⇒ `Struct`

Deletes a defined mitigation action from your AWS account.

Examples:

Request syntax with placeholder values


resp = client.delete_mitigation_action({
  action_name: "MitigationActionName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:action_name (required, String) —
The name of the mitigation action that you want to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2724

def delete_mitigation_action(params = {}, options = {})
  req = build_request(:delete_mitigation_action, params)
  req.send_request(options)
end

#delete_ota_update(params = {}) ⇒ `Struct`

Delete an OTA update.

Examples:

Request syntax with placeholder values


resp = client.delete_ota_update({
  ota_update_id: "OTAUpdateId", # required
  delete_stream: false,
  force_delete_aws_job: false,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:ota_update_id (required, String) —
The OTA update ID to delete.
:delete_stream (Boolean) —
Specifies if the stream associated with an OTA update should be deleted when the OTA update is deleted.
:force_delete_aws_job (Boolean) —
Specifies if the AWS Job associated with the OTA update should be deleted with the OTA update is deleted.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2754

def delete_ota_update(params = {}, options = {})
  req = build_request(:delete_ota_update, params)
  req.send_request(options)
end

#delete_policy(params = {}) ⇒ `Struct`

Deletes the specified policy.

A policy cannot be deleted if it has non-default versions or it is attached to any certificate.

To delete a policy, use the DeletePolicyVersion API to delete all non-default versions of the policy; use the DetachPrincipalPolicy API to detach the policy from any certificate; and then use the DeletePolicy API to delete the policy.

When a policy is deleted using DeletePolicy, its default version is deleted with it.

Examples:

Request syntax with placeholder values


resp = client.delete_policy({
  policy_name: "PolicyName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The name of the policy to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2785

def delete_policy(params = {}, options = {})
  req = build_request(:delete_policy, params)
  req.send_request(options)
end

#delete_policy_version(params = {}) ⇒ `Struct`

Deletes the specified version of the specified policy. You cannot delete the default version of a policy using this API. To delete the default version of a policy, use DeletePolicy. To find out which version of a policy is marked as the default version, use ListPolicyVersions.

Examples:

Request syntax with placeholder values


resp = client.delete_policy_version({
  policy_name: "PolicyName", # required
  policy_version_id: "PolicyVersionId", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The name of the policy.
:policy_version_id (required, String) —
The policy version ID.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2813

def delete_policy_version(params = {}, options = {})
  req = build_request(:delete_policy_version, params)
  req.send_request(options)
end

#delete_provisioning_template(params = {}) ⇒ `Struct`

Deletes a fleet provisioning template.

Examples:

Request syntax with placeholder values


resp = client.delete_provisioning_template({
  template_name: "TemplateName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:template_name (required, String) —
The name of the fleet provision template to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2833

def delete_provisioning_template(params = {}, options = {})
  req = build_request(:delete_provisioning_template, params)
  req.send_request(options)
end

#delete_provisioning_template_version(params = {}) ⇒ `Struct`

Deletes a fleet provisioning template version.

Examples:

Request syntax with placeholder values


resp = client.delete_provisioning_template_version({
  template_name: "TemplateName", # required
  version_id: 1, # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:template_name (required, String) —
The name of the fleet provisioning template version to delete.
:version_id (required, Integer) —
The fleet provisioning template version ID to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2857

def delete_provisioning_template_version(params = {}, options = {})
  req = build_request(:delete_provisioning_template_version, params)
  req.send_request(options)
end

#delete_registration_code(params = {}) ⇒ `Struct`

Deletes a CA certificate registration code.

Parameters:

params (Hash) (defaults to: {}) —
({})

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2868

def delete_registration_code(params = {}, options = {})
  req = build_request(:delete_registration_code, params)
  req.send_request(options)
end

#delete_role_alias(params = {}) ⇒ `Struct`

Deletes a role alias

Examples:

Request syntax with placeholder values


resp = client.delete_role_alias({
  role_alias: "RoleAlias", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:role_alias (required, String) —
The role alias to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2888

def delete_role_alias(params = {}, options = {})
  req = build_request(:delete_role_alias, params)
  req.send_request(options)
end

#delete_scheduled_audit(params = {}) ⇒ `Struct`

Deletes a scheduled audit.

Examples:

Request syntax with placeholder values


resp = client.delete_scheduled_audit({
  scheduled_audit_name: "ScheduledAuditName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:scheduled_audit_name (required, String) —
The name of the scheduled audit you want to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2908

def delete_scheduled_audit(params = {}, options = {})
  req = build_request(:delete_scheduled_audit, params)
  req.send_request(options)
end

#delete_security_profile(params = {}) ⇒ `Struct`

Deletes a Device Defender security profile.

Examples:

Request syntax with placeholder values


resp = client.delete_security_profile({
  security_profile_name: "SecurityProfileName", # required
  expected_version: 1,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:security_profile_name (required, String) —
The name of the security profile to be deleted.
:expected_version (Integer) —
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 VersionConflictException is thrown.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2935

def delete_security_profile(params = {}, options = {})
  req = build_request(:delete_security_profile, params)
  req.send_request(options)
end

#delete_stream(params = {}) ⇒ `Struct`

Deletes a stream.

Examples:

Request syntax with placeholder values


resp = client.delete_stream({
  stream_id: "StreamId", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:stream_id (required, String) —
The stream ID.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2955

def delete_stream(params = {}, options = {})
  req = build_request(:delete_stream, params)
  req.send_request(options)
end

#delete_thing(params = {}) ⇒ `Struct`

Deletes the specified thing. Returns successfully with no error if the deletion is successful or you specify a thing that doesn't exist.

Examples:

Request syntax with placeholder values


resp = client.delete_thing({
  thing_name: "ThingName", # required
  expected_version: 1,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_name (required, String) —
The name of the thing to delete.
:expected_version (Integer) —
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 DeleteThing request is rejected with a VersionConflictException.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 2983

def delete_thing(params = {}, options = {})
  req = build_request(:delete_thing, params)
  req.send_request(options)
end

#delete_thing_group(params = {}) ⇒ `Struct`

Deletes a thing group.

Examples:

Request syntax with placeholder values


resp = client.delete_thing_group({
  thing_group_name: "ThingGroupName", # required
  expected_version: 1,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_group_name (required, String) —
The name of the thing group to delete.
:expected_version (Integer) —
The expected version of the thing group to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3007

def delete_thing_group(params = {}, options = {})
  req = build_request(:delete_thing_group, params)
  req.send_request(options)
end

#delete_thing_type(params = {}) ⇒ `Struct`

Deletes the specified thing type. You cannot delete a thing type if it has things associated with it. To delete a thing type, first mark it as deprecated by calling DeprecateThingType, then remove any associated things by calling UpdateThing to change the thing type on any associated thing, and finally use DeleteThingType to delete the thing type.

Examples:

Request syntax with placeholder values


resp = client.delete_thing_type({
  thing_type_name: "ThingTypeName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_type_name (required, String) —
The name of the thing type.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3032

def delete_thing_type(params = {}, options = {})
  req = build_request(:delete_thing_type, params)
  req.send_request(options)
end

#delete_topic_rule(params = {}) ⇒ `Struct`

Deletes the rule.

Examples:

Request syntax with placeholder values


resp = client.delete_topic_rule({
  rule_name: "RuleName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:rule_name (required, String) —
The name of the rule.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3052

def delete_topic_rule(params = {}, options = {})
  req = build_request(:delete_topic_rule, params)
  req.send_request(options)
end

#delete_topic_rule_destination(params = {}) ⇒ `Struct`

Deletes a topic rule destination.

Examples:

Request syntax with placeholder values


resp = client.delete_topic_rule_destination({
  arn: "AwsArn", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:arn (required, String) —
The ARN of the topic rule destination to delete.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3072

def delete_topic_rule_destination(params = {}, options = {})
  req = build_request(:delete_topic_rule_destination, params)
  req.send_request(options)
end

#delete_v2_logging_level(params = {}) ⇒ `Struct`

Deletes a logging level.

Examples:

Request syntax with placeholder values


resp = client.delete_v2_logging_level({
  target_type: "DEFAULT", # required, accepts DEFAULT, THING_GROUP
  target_name: "LogTargetName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:target_type (required, String) —
The type of resource for which you are configuring logging. Must be THING_Group.
:target_name (required, String) —
The name of the resource for which you are configuring logging.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3097

def delete_v2_logging_level(params = {}, options = {})
  req = build_request(:delete_v2_logging_level, params)
  req.send_request(options)
end

#deprecate_thing_type(params = {}) ⇒ `Struct`

Deprecates a thing type. You can not associate new things with deprecated thing type.

Examples:

Request syntax with placeholder values


resp = client.deprecate_thing_type({
  thing_type_name: "ThingTypeName", # required
  undo_deprecate: false,
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_type_name (required, String) —
The name of the thing type to deprecate.
:undo_deprecate (Boolean) —
Whether to undeprecate a deprecated thing type. If true, the thing type will not be deprecated anymore and you can associate it with things.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3124

def deprecate_thing_type(params = {}, options = {})
  req = build_request(:deprecate_thing_type, params)
  req.send_request(options)
end

#describe_account_audit_configuration(params = {}) ⇒ `Types::DescribeAccountAuditConfigurationResponse`

Gets information about the Device Defender audit settings for this account. Settings include how audit notifications are sent and which audit checks are enabled or disabled.

Examples:

Response structure


resp.role_arn #=> String
resp.audit_notification_target_configurations #=> Hash
resp.audit_notification_target_configurations["AuditNotificationType"].target_arn #=> String
resp.audit_notification_target_configurations["AuditNotificationType"].role_arn #=> String
resp.audit_notification_target_configurations["AuditNotificationType"].enabled #=> Boolean
resp.audit_check_configurations #=> Hash
resp.audit_check_configurations["AuditCheckName"].enabled #=> Boolean

Parameters:

params (Hash) (defaults to: {}) —
({})

Returns:

(Types::DescribeAccountAuditConfigurationResponse) —
Returns a response object which responds to the following methods:
- #role_arn => String
- #audit_notification_target_configurations => Hash<String,Types::AuditNotificationTarget>
- #audit_check_configurations => Hash<String,Types::AuditCheckConfiguration>

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3151

def describe_account_audit_configuration(params = {}, options = {})
  req = build_request(:describe_account_audit_configuration, params)
  req.send_request(options)
end

#describe_audit_finding(params = {}) ⇒ `Types::DescribeAuditFindingResponse`

Gets information about a single audit finding. Properties include the reason for noncompliance, the severity of the issue, and when the audit that returned the finding was started.

Examples:

Request syntax with placeholder values


resp = client.describe_audit_finding({
  finding_id: "FindingId", # required
})

Response structure


resp.finding.finding_id #=> String
resp.finding.task_id #=> String
resp.finding.check_name #=> String
resp.finding.task_start_time #=> Time
resp.finding.finding_time #=> Time
resp.finding.severity #=> String, one of "CRITICAL", "HIGH", "MEDIUM", "LOW"
resp.finding.non_compliant_resource.resource_type #=> String, one of "DEVICE_CERTIFICATE", "CA_CERTIFICATE", "IOT_POLICY", "COGNITO_IDENTITY_POOL", "CLIENT_ID", "ACCOUNT_SETTINGS", "ROLE_ALIAS", "IAM_ROLE"
resp.finding.non_compliant_resource.resource_identifier.device_certificate_id #=> String
resp.finding.non_compliant_resource.resource_identifier.ca_certificate_id #=> String
resp.finding.non_compliant_resource.resource_identifier.cognito_identity_pool_id #=> String
resp.finding.non_compliant_resource.resource_identifier.client_id #=> String
resp.finding.non_compliant_resource.resource_identifier.policy_version_identifier.policy_name #=> String
resp.finding.non_compliant_resource.resource_identifier.policy_version_identifier.policy_version_id #=> String
resp.finding.non_compliant_resource.resource_identifier.account #=> String
resp.finding.non_compliant_resource.resource_identifier.iam_role_arn #=> String
resp.finding.non_compliant_resource.resource_identifier.role_alias_arn #=> String
resp.finding.non_compliant_resource.additional_info #=> Hash
resp.finding.non_compliant_resource.additional_info["String"] #=> String
resp.finding.related_resources #=> Array
resp.finding.related_resources[0].resource_type #=> String, one of "DEVICE_CERTIFICATE", "CA_CERTIFICATE", "IOT_POLICY", "COGNITO_IDENTITY_POOL", "CLIENT_ID", "ACCOUNT_SETTINGS", "ROLE_ALIAS", "IAM_ROLE"
resp.finding.related_resources[0].resource_identifier.device_certificate_id #=> String
resp.finding.related_resources[0].resource_identifier.ca_certificate_id #=> String
resp.finding.related_resources[0].resource_identifier.cognito_identity_pool_id #=> String
resp.finding.related_resources[0].resource_identifier.client_id #=> String
resp.finding.related_resources[0].resource_identifier.policy_version_identifier.policy_name #=> String
resp.finding.related_resources[0].resource_identifier.policy_version_identifier.policy_version_id #=> String
resp.finding.related_resources[0].resource_identifier.account #=> String
resp.finding.related_resources[0].resource_identifier.iam_role_arn #=> String
resp.finding.related_resources[0].resource_identifier.role_alias_arn #=> String
resp.finding.related_resources[0].additional_info #=> Hash
resp.finding.related_resources[0].additional_info["String"] #=> String
resp.finding.reason_for_non_compliance #=> String
resp.finding.reason_for_non_compliance_code #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:finding_id (required, String) —
A unique identifier for a single audit finding. You can use this identifier to apply mitigation actions to the finding.

Returns:

(Types::DescribeAuditFindingResponse) —
Returns a response object which responds to the following methods:
- #finding => Types::AuditFinding

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3212

def describe_audit_finding(params = {}, options = {})
  req = build_request(:describe_audit_finding, params)
  req.send_request(options)
end

#describe_audit_mitigation_actions_task(params = {}) ⇒ `Types::DescribeAuditMitigationActionsTaskResponse`

Gets information about an audit mitigation task that is used to apply mitigation actions to a set of audit findings. Properties include the actions being applied, the audit checks to which they're being applied, the task status, and aggregated task statistics.

Examples:

Request syntax with placeholder values


resp = client.describe_audit_mitigation_actions_task({
  task_id: "AuditMitigationActionsTaskId", # required
})

Response structure


resp.task_status #=> String, one of "IN_PROGRESS", "COMPLETED", "FAILED", "CANCELED"
resp.start_time #=> Time
resp.end_time #=> Time
resp.task_statistics #=> Hash
resp.task_statistics["AuditCheckName"].total_findings_count #=> Integer
resp.task_statistics["AuditCheckName"].failed_findings_count #=> Integer
resp.task_statistics["AuditCheckName"].succeeded_findings_count #=> Integer
resp.task_statistics["AuditCheckName"].skipped_findings_count #=> Integer
resp.task_statistics["AuditCheckName"].canceled_findings_count #=> Integer
resp.target.audit_task_id #=> String
resp.target.finding_ids #=> Array
resp.target.finding_ids[0] #=> String
resp.target.audit_check_to_reason_code_filter #=> Hash
resp.target.audit_check_to_reason_code_filter["AuditCheckName"] #=> Array
resp.target.audit_check_to_reason_code_filter["AuditCheckName"][0] #=> String
resp.audit_check_to_actions_mapping #=> Hash
resp.audit_check_to_actions_mapping["AuditCheckName"] #=> Array
resp.audit_check_to_actions_mapping["AuditCheckName"][0] #=> String
resp.actions_definition #=> Array
resp.actions_definition[0].name #=> String
resp.actions_definition[0].id #=> String
resp.actions_definition[0].role_arn #=> String
resp.actions_definition[0].action_params.update_device_certificate_params.action #=> String, one of "DEACTIVATE"
resp.actions_definition[0].action_params.update_ca_certificate_params.action #=> String, one of "DEACTIVATE"
resp.actions_definition[0].action_params.add_things_to_thing_group_params.thing_group_names #=> Array
resp.actions_definition[0].action_params.add_things_to_thing_group_params.thing_group_names[0] #=> String
resp.actions_definition[0].action_params.add_things_to_thing_group_params.override_dynamic_groups #=> Boolean
resp.actions_definition[0].action_params.replace_default_policy_version_params.template_name #=> String, one of "BLANK_POLICY"
resp.actions_definition[0].action_params.enable_io_t_logging_params.role_arn_for_logging #=> String
resp.actions_definition[0].action_params.enable_io_t_logging_params.log_level #=> String, one of "DEBUG", "INFO", "ERROR", "WARN", "DISABLED"
resp.actions_definition[0].action_params.publish_finding_to_sns_params.topic_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:task_id (required, String) —
The unique identifier for the audit mitigation task.

Returns:

(Types::DescribeAuditMitigationActionsTaskResponse) —
Returns a response object which responds to the following methods:
- #task_status => String
- #start_time => Time
- #end_time => Time
- #task_statistics => Hash<String,Types::TaskStatisticsForAuditCheck>
- #target => Types::AuditMitigationActionsTaskTarget
- #audit_check_to_actions_mapping => Hash<String,Array<String>>
- #actions_definition => Array<Types::MitigationAction>

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3277

def describe_audit_mitigation_actions_task(params = {}, options = {})
  req = build_request(:describe_audit_mitigation_actions_task, params)
  req.send_request(options)
end

#describe_audit_task(params = {}) ⇒ `Types::DescribeAuditTaskResponse`

Gets information about a Device Defender audit.

Examples:

Request syntax with placeholder values


resp = client.describe_audit_task({
  task_id: "AuditTaskId", # required
})

Response structure


resp.task_status #=> String, one of "IN_PROGRESS", "COMPLETED", "FAILED", "CANCELED"
resp.task_type #=> String, one of "ON_DEMAND_AUDIT_TASK", "SCHEDULED_AUDIT_TASK"
resp.task_start_time #=> Time
resp.task_statistics.total_checks #=> Integer
resp.task_statistics.in_progress_checks #=> Integer
resp.task_statistics.waiting_for_data_collection_checks #=> Integer
resp.task_statistics.compliant_checks #=> Integer
resp.task_statistics.non_compliant_checks #=> Integer
resp.task_statistics.failed_checks #=> Integer
resp.task_statistics.canceled_checks #=> Integer
resp.scheduled_audit_name #=> String
resp.audit_details #=> Hash
resp.audit_details["AuditCheckName"].check_run_status #=> String, one of "IN_PROGRESS", "WAITING_FOR_DATA_COLLECTION", "CANCELED", "COMPLETED_COMPLIANT", "COMPLETED_NON_COMPLIANT", "FAILED"
resp.audit_details["AuditCheckName"].check_compliant #=> Boolean
resp.audit_details["AuditCheckName"].total_resources_count #=> Integer
resp.audit_details["AuditCheckName"].non_compliant_resources_count #=> Integer
resp.audit_details["AuditCheckName"].error_code #=> String
resp.audit_details["AuditCheckName"].message #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:task_id (required, String) —
The ID of the audit whose information you want to get.

Returns:

(Types::DescribeAuditTaskResponse) —
Returns a response object which responds to the following methods:
- #task_status => String
- #task_type => String
- #task_start_time => Time
- #task_statistics => Types::TaskStatistics
- #scheduled_audit_name => String
- #audit_details => Hash<String,Types::AuditCheckDetails>

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3325

def describe_audit_task(params = {}, options = {})
  req = build_request(:describe_audit_task, params)
  req.send_request(options)
end

#describe_authorizer(params = {}) ⇒ `Types::DescribeAuthorizerResponse`

Describes an authorizer.

Examples:

Request syntax with placeholder values


resp = client.describe_authorizer({
  authorizer_name: "AuthorizerName", # required
})

Response structure


resp.authorizer_description.authorizer_name #=> String
resp.authorizer_description.authorizer_arn #=> String
resp.authorizer_description.authorizer_function_arn #=> String
resp.authorizer_description.token_key_name #=> String
resp.authorizer_description.token_signing_public_keys #=> Hash
resp.authorizer_description.token_signing_public_keys["KeyName"] #=> String
resp.authorizer_description.status #=> String, one of "ACTIVE", "INACTIVE"
resp.authorizer_description.creation_date #=> Time
resp.authorizer_description.last_modified_date #=> Time
resp.authorizer_description.signing_disabled #=> Boolean

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:authorizer_name (required, String) —
The name of the authorizer to describe.

Returns:

(Types::DescribeAuthorizerResponse) —
Returns a response object which responds to the following methods:
- #authorizer_description => Types::AuthorizerDescription

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3360

def describe_authorizer(params = {}, options = {})
  req = build_request(:describe_authorizer, params)
  req.send_request(options)
end

#describe_billing_group(params = {}) ⇒ `Types::DescribeBillingGroupResponse`

Returns information about a billing group.

Examples:

Request syntax with placeholder values


resp = client.describe_billing_group({
  billing_group_name: "BillingGroupName", # required
})

Response structure


resp.billing_group_name #=> String
resp.billing_group_id #=> String
resp.billing_group_arn #=> String
resp.version #=> Integer
resp.billing_group_properties.billing_group_description #=> String
resp.billing_group_metadata.creation_date #=> Time

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:billing_group_name (required, String) —
The name of the billing group.

Returns:

(Types::DescribeBillingGroupResponse) —
Returns a response object which responds to the following methods:
- #billing_group_name => String
- #billing_group_id => String
- #billing_group_arn => String
- #version => Integer
- #billing_group_properties => Types::BillingGroupProperties
- #billing_group_metadata => Types::BillingGroupMetadata

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3396

def describe_billing_group(params = {}, options = {})
  req = build_request(:describe_billing_group, params)
  req.send_request(options)
end

#describe_ca_certificate(params = {}) ⇒ `Types::DescribeCACertificateResponse`

Describes a registered CA certificate.

Examples:

Request syntax with placeholder values


resp = client.describe_ca_certificate({
  certificate_id: "CertificateId", # required
})

Response structure


resp.certificate_description.certificate_arn #=> String
resp.certificate_description.certificate_id #=> String
resp.certificate_description.status #=> String, one of "ACTIVE", "INACTIVE"
resp.certificate_description.certificate_pem #=> String
resp.certificate_description.owned_by #=> String
resp.certificate_description.creation_date #=> Time
resp.certificate_description.auto_registration_status #=> String, one of "ENABLE", "DISABLE"
resp.certificate_description.last_modified_date #=> Time
resp.certificate_description.customer_version #=> Integer
resp.certificate_description.generation_id #=> String
resp.certificate_description.validity.not_before #=> Time
resp.certificate_description.validity.not_after #=> Time
resp.registration_config.template_body #=> String
resp.registration_config.role_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:certificate_id (required, String) —
The CA certificate identifier.

Returns:

(Types::DescribeCACertificateResponse) —
Returns a response object which responds to the following methods:
- #certificate_description => Types::CACertificateDescription
- #registration_config => Types::RegistrationConfig

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3436

def describe_ca_certificate(params = {}, options = {})
  req = build_request(:describe_ca_certificate, params)
  req.send_request(options)
end

#describe_certificate(params = {}) ⇒ `Types::DescribeCertificateResponse`

Gets information about the specified certificate.

Examples:

Request syntax with placeholder values


resp = client.describe_certificate({
  certificate_id: "CertificateId", # required
})

Response structure


resp.certificate_description.certificate_arn #=> String
resp.certificate_description.certificate_id #=> String
resp.certificate_description.ca_certificate_id #=> String
resp.certificate_description.status #=> String, one of "ACTIVE", "INACTIVE", "REVOKED", "PENDING_TRANSFER", "REGISTER_INACTIVE", "PENDING_ACTIVATION"
resp.certificate_description.certificate_pem #=> String
resp.certificate_description.owned_by #=> String
resp.certificate_description.previous_owned_by #=> String
resp.certificate_description.creation_date #=> Time
resp.certificate_description.last_modified_date #=> Time
resp.certificate_description.customer_version #=> Integer
resp.certificate_description.transfer_data.transfer_message #=> String
resp.certificate_description.transfer_data.reject_reason #=> String
resp.certificate_description.transfer_data.transfer_date #=> Time
resp.certificate_description.transfer_data.accept_date #=> Time
resp.certificate_description.transfer_data.reject_date #=> Time
resp.certificate_description.generation_id #=> String
resp.certificate_description.validity.not_before #=> Time
resp.certificate_description.validity.not_after #=> Time

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:certificate_id (required, String) —
The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

Returns:

(Types::DescribeCertificateResponse) —
Returns a response object which responds to the following methods:
- #certificate_description => Types::CertificateDescription

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3480

def describe_certificate(params = {}, options = {})
  req = build_request(:describe_certificate, params)
  req.send_request(options)
end

#describe_default_authorizer(params = {}) ⇒ `Types::DescribeDefaultAuthorizerResponse`

Describes the default authorizer.

Examples:

Response structure


resp.authorizer_description.authorizer_name #=> String
resp.authorizer_description.authorizer_arn #=> String
resp.authorizer_description.authorizer_function_arn #=> String
resp.authorizer_description.token_key_name #=> String
resp.authorizer_description.token_signing_public_keys #=> Hash
resp.authorizer_description.token_signing_public_keys["KeyName"] #=> String
resp.authorizer_description.status #=> String, one of "ACTIVE", "INACTIVE"
resp.authorizer_description.creation_date #=> Time
resp.authorizer_description.last_modified_date #=> Time
resp.authorizer_description.signing_disabled #=> Boolean

Parameters:

params (Hash) (defaults to: {}) —
({})

Returns:

(Types::DescribeDefaultAuthorizerResponse) —
Returns a response object which responds to the following methods:
- #authorizer_description => Types::AuthorizerDescription

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3506

def describe_default_authorizer(params = {}, options = {})
  req = build_request(:describe_default_authorizer, params)
  req.send_request(options)
end

#describe_domain_configuration(params = {}) ⇒ `Types::DescribeDomainConfigurationResponse`

Gets summary information about a domain configuration.

The domain configuration feature is in public preview and is subject to change.

Examples:

Request syntax with placeholder values


resp = client.describe_domain_configuration({
  domain_configuration_name: "ReservedDomainConfigurationName", # required
})

Response structure


resp.domain_configuration_name #=> String
resp.domain_configuration_arn #=> String
resp.domain_name #=> String
resp.server_certificates #=> Array
resp.server_certificates[0].server_certificate_arn #=> String
resp.server_certificates[0].server_certificate_status #=> String, one of "INVALID", "VALID"
resp.server_certificates[0].server_certificate_status_detail #=> String
resp.authorizer_config.default_authorizer_name #=> String
resp.authorizer_config.allow_authorizer_override #=> Boolean
resp.domain_configuration_status #=> String, one of "ENABLED", "DISABLED"
resp.service_type #=> String, one of "DATA", "CREDENTIAL_PROVIDER", "JOBS"
resp.domain_type #=> String, one of "ENDPOINT", "AWS_MANAGED", "CUSTOMER_MANAGED"

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:domain_configuration_name (required, String) —
The name of the domain configuration.

Returns:

(Types::DescribeDomainConfigurationResponse) —
Returns a response object which responds to the following methods:
- #domain_configuration_name => String
- #domain_configuration_arn => String
- #domain_name => String
- #server_certificates => Array<Types::ServerCertificateSummary>
- #authorizer_config => Types::AuthorizerConfig
- #domain_configuration_status => String
- #service_type => String
- #domain_type => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3555

def describe_domain_configuration(params = {}, options = {})
  req = build_request(:describe_domain_configuration, params)
  req.send_request(options)
end

#describe_endpoint(params = {}) ⇒ `Types::DescribeEndpointResponse`

Returns a unique endpoint specific to the AWS account making the call.

Examples:

Request syntax with placeholder values


resp = client.describe_endpoint({
  endpoint_type: "EndpointType",
})

Response structure


resp.endpoint_address #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:endpoint_type (String) —
The endpoint type. Valid endpoint types include:
- iot:Data - Returns a VeriSign signed data endpoint.
^ ^
- iot:Data-ATS - Returns an ATS signed data endpoint.
^ ^
- iot:CredentialProvider - Returns an AWS IoT credentials provider API endpoint.
^ ^
- iot:Jobs - Returns an AWS IoT device management Jobs API endpoint.
^

Returns:

(Types::DescribeEndpointResponse) —
Returns a response object which responds to the following methods:
- #endpoint_address => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3601

def describe_endpoint(params = {}, options = {})
  req = build_request(:describe_endpoint, params)
  req.send_request(options)
end

#describe_event_configurations(params = {}) ⇒ `Types::DescribeEventConfigurationsResponse`

Describes event configurations.

Examples:

Response structure


resp.event_configurations #=> Hash
resp.event_configurations["EventType"].enabled #=> Boolean
resp.creation_date #=> Time
resp.last_modified_date #=> Time

Parameters:

params (Hash) (defaults to: {}) —
({})

Returns:

(Types::DescribeEventConfigurationsResponse) —
Returns a response object which responds to the following methods:
- #event_configurations => Hash<String,Types::Configuration>
- #creation_date => Time
- #last_modified_date => Time

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3623

def describe_event_configurations(params = {}, options = {})
  req = build_request(:describe_event_configurations, params)
  req.send_request(options)
end

#describe_index(params = {}) ⇒ `Types::DescribeIndexResponse`

Describes a search index.

Examples:

Request syntax with placeholder values


resp = client.describe_index({
  index_name: "IndexName", # required
})

Response structure


resp.index_name #=> String
resp.index_status #=> String, one of "ACTIVE", "BUILDING", "REBUILDING"
resp.schema #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:index_name (required, String) —
The index name.

Returns:

(Types::DescribeIndexResponse) —
Returns a response object which responds to the following methods:
- #index_name => String
- #index_status => String
- #schema => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3653

def describe_index(params = {}, options = {})
  req = build_request(:describe_index, params)
  req.send_request(options)
end

#describe_job(params = {}) ⇒ `Types::DescribeJobResponse`

Describes a job.

Examples:

Request syntax with placeholder values


resp = client.describe_job({
  job_id: "JobId", # required
})

Response structure


resp.document_source #=> String
resp.job.job_arn #=> String
resp.job.job_id #=> String
resp.job.target_selection #=> String, one of "CONTINUOUS", "SNAPSHOT"
resp.job.status #=> String, one of "IN_PROGRESS", "CANCELED", "COMPLETED", "DELETION_IN_PROGRESS"
resp.job.force_canceled #=> Boolean
resp.job.reason_code #=> String
resp.job.comment #=> String
resp.job.targets #=> Array
resp.job.targets[0] #=> String
resp.job.description #=> String
resp.job.presigned_url_config.role_arn #=> String
resp.job.presigned_url_config.expires_in_sec #=> Integer
resp.job.job_executions_rollout_config.maximum_per_minute #=> Integer
resp.job.job_executions_rollout_config.exponential_rate.base_rate_per_minute #=> Integer
resp.job.job_executions_rollout_config.exponential_rate.increment_factor #=> Float
resp.job.job_executions_rollout_config.exponential_rate.rate_increase_criteria.number_of_notified_things #=> Integer
resp.job.job_executions_rollout_config.exponential_rate.rate_increase_criteria.number_of_succeeded_things #=> Integer
resp.job.abort_config.criteria_list #=> Array
resp.job.abort_config.criteria_list[0].failure_type #=> String, one of "FAILED", "REJECTED", "TIMED_OUT", "ALL"
resp.job.abort_config.criteria_list[0].action #=> String, one of "CANCEL"
resp.job.abort_config.criteria_list[0].threshold_percentage #=> Float
resp.job.abort_config.criteria_list[0].min_number_of_executed_things #=> Integer
resp.job.created_at #=> Time
resp.job.last_updated_at #=> Time
resp.job.completed_at #=> Time
resp.job.job_process_details.processing_targets #=> Array
resp.job.job_process_details.processing_targets[0] #=> String
resp.job.job_process_details.number_of_canceled_things #=> Integer
resp.job.job_process_details.number_of_succeeded_things #=> Integer
resp.job.job_process_details.number_of_failed_things #=> Integer
resp.job.job_process_details.number_of_rejected_things #=> Integer
resp.job.job_process_details.number_of_queued_things #=> Integer
resp.job.job_process_details.number_of_in_progress_things #=> Integer
resp.job.job_process_details.number_of_removed_things #=> Integer
resp.job.job_process_details.number_of_timed_out_things #=> Integer
resp.job.timeout_config.in_progress_timeout_in_minutes #=> Integer

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:job_id (required, String) —
The unique identifier you assigned to this job when it was created.

Returns:

(Types::DescribeJobResponse) —
Returns a response object which responds to the following methods:
- #document_source => String
- #job => Types::Job

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3716

def describe_job(params = {}, options = {})
  req = build_request(:describe_job, params)
  req.send_request(options)
end

#describe_job_execution(params = {}) ⇒ `Types::DescribeJobExecutionResponse`

Describes a job execution.

Examples:

Request syntax with placeholder values


resp = client.describe_job_execution({
  job_id: "JobId", # required
  thing_name: "ThingName", # required
  execution_number: 1,
})

Response structure


resp.execution.job_id #=> String
resp.execution.status #=> String, one of "QUEUED", "IN_PROGRESS", "SUCCEEDED", "FAILED", "TIMED_OUT", "REJECTED", "REMOVED", "CANCELED"
resp.execution.force_canceled #=> Boolean
resp.execution.status_details.details_map #=> Hash
resp.execution.status_details.details_map["DetailsKey"] #=> String
resp.execution.thing_arn #=> String
resp.execution.queued_at #=> Time
resp.execution.started_at #=> Time
resp.execution.last_updated_at #=> Time
resp.execution.execution_number #=> Integer
resp.execution.version_number #=> Integer
resp.execution.approximate_seconds_before_timed_out #=> Integer

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:job_id (required, String) —
The unique identifier you assigned to this job when it was created.
:thing_name (required, String) —
The name of the thing on which the job execution is running.
:execution_number (Integer) —
A string (consisting of the digits "0" through "9" which is used to specify a particular job execution on a particular device.

Returns:

(Types::DescribeJobExecutionResponse) —
Returns a response object which responds to the following methods:
- #execution => Types::JobExecution

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3762

def describe_job_execution(params = {}, options = {})
  req = build_request(:describe_job_execution, params)
  req.send_request(options)
end

#describe_mitigation_action(params = {}) ⇒ `Types::DescribeMitigationActionResponse`

Gets information about a mitigation action.

Examples:

Request syntax with placeholder values


resp = client.describe_mitigation_action({
  action_name: "MitigationActionName", # required
})

Response structure


resp.action_name #=> String
resp.action_type #=> String, one of "UPDATE_DEVICE_CERTIFICATE", "UPDATE_CA_CERTIFICATE", "ADD_THINGS_TO_THING_GROUP", "REPLACE_DEFAULT_POLICY_VERSION", "ENABLE_IOT_LOGGING", "PUBLISH_FINDING_TO_SNS"
resp.action_arn #=> String
resp.action_id #=> String
resp.role_arn #=> String
resp.action_params.update_device_certificate_params.action #=> String, one of "DEACTIVATE"
resp.action_params.update_ca_certificate_params.action #=> String, one of "DEACTIVATE"
resp.action_params.add_things_to_thing_group_params.thing_group_names #=> Array
resp.action_params.add_things_to_thing_group_params.thing_group_names[0] #=> String
resp.action_params.add_things_to_thing_group_params.override_dynamic_groups #=> Boolean
resp.action_params.replace_default_policy_version_params.template_name #=> String, one of "BLANK_POLICY"
resp.action_params.enable_io_t_logging_params.role_arn_for_logging #=> String
resp.action_params.enable_io_t_logging_params.log_level #=> String, one of "DEBUG", "INFO", "ERROR", "WARN", "DISABLED"
resp.action_params.publish_finding_to_sns_params.topic_arn #=> String
resp.creation_date #=> Time
resp.last_modified_date #=> Time

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:action_name (required, String) —
The friendly name that uniquely identifies the mitigation action.

Returns:

(Types::DescribeMitigationActionResponse) —
Returns a response object which responds to the following methods:
- #action_name => String
- #action_type => String
- #action_arn => String
- #action_id => String
- #role_arn => String
- #action_params => Types::MitigationActionParams
- #creation_date => Time
- #last_modified_date => Time

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3810

def describe_mitigation_action(params = {}, options = {})
  req = build_request(:describe_mitigation_action, params)
  req.send_request(options)
end

#describe_provisioning_template(params = {}) ⇒ `Types::DescribeProvisioningTemplateResponse`

Returns information about a fleet provisioning template.

Examples:

Request syntax with placeholder values


resp = client.describe_provisioning_template({
  template_name: "TemplateName", # required
})

Response structure


resp.template_arn #=> String
resp.template_name #=> String
resp.description #=> String
resp.creation_date #=> Time
resp.last_modified_date #=> Time
resp.default_version_id #=> Integer
resp.template_body #=> String
resp.enabled #=> Boolean
resp.provisioning_role_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:template_name (required, String) —
The name of the fleet provisioning template.

Returns:

(Types::DescribeProvisioningTemplateResponse) —
Returns a response object which responds to the following methods:
- #template_arn => String
- #template_name => String
- #description => String
- #creation_date => Time
- #last_modified_date => Time
- #default_version_id => Integer
- #template_body => String
- #enabled => Boolean
- #provisioning_role_arn => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3852

def describe_provisioning_template(params = {}, options = {})
  req = build_request(:describe_provisioning_template, params)
  req.send_request(options)
end

#describe_provisioning_template_version(params = {}) ⇒ `Types::DescribeProvisioningTemplateVersionResponse`

Returns information about a fleet provisioning template version.

Examples:

Request syntax with placeholder values


resp = client.describe_provisioning_template_version({
  template_name: "TemplateName", # required
  version_id: 1, # required
})

Response structure


resp.version_id #=> Integer
resp.creation_date #=> Time
resp.template_body #=> String
resp.is_default_version #=> Boolean

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:template_name (required, String) —
The template name.
:version_id (required, Integer) —
The fleet provisioning template version ID.

Returns:

(Types::DescribeProvisioningTemplateVersionResponse) —
Returns a response object which responds to the following methods:
- #version_id => Integer
- #creation_date => Time
- #template_body => String
- #is_default_version => Boolean

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3888

def describe_provisioning_template_version(params = {}, options = {})
  req = build_request(:describe_provisioning_template_version, params)
  req.send_request(options)
end

#describe_role_alias(params = {}) ⇒ `Types::DescribeRoleAliasResponse`

Describes a role alias.

Examples:

Request syntax with placeholder values


resp = client.describe_role_alias({
  role_alias: "RoleAlias", # required
})

Response structure


resp.role_alias_description.role_alias #=> String
resp.role_alias_description.role_alias_arn #=> String
resp.role_alias_description.role_arn #=> String
resp.role_alias_description.owner #=> String
resp.role_alias_description.credential_duration_seconds #=> Integer
resp.role_alias_description.creation_date #=> Time
resp.role_alias_description.last_modified_date #=> Time

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:role_alias (required, String) —
The role alias to describe.

Returns:

(Types::DescribeRoleAliasResponse) —
Returns a response object which responds to the following methods:
- #role_alias_description => Types::RoleAliasDescription

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3920

def describe_role_alias(params = {}, options = {})
  req = build_request(:describe_role_alias, params)
  req.send_request(options)
end

#describe_scheduled_audit(params = {}) ⇒ `Types::DescribeScheduledAuditResponse`

Gets information about a scheduled audit.

Examples:

Request syntax with placeholder values


resp = client.describe_scheduled_audit({
  scheduled_audit_name: "ScheduledAuditName", # required
})

Response structure


resp.frequency #=> String, one of "DAILY", "WEEKLY", "BIWEEKLY", "MONTHLY"
resp.day_of_month #=> String
resp.day_of_week #=> String, one of "SUN", "MON", "TUE", "WED", "THU", "FRI", "SAT"
resp.target_check_names #=> Array
resp.target_check_names[0] #=> String
resp.scheduled_audit_name #=> String
resp.scheduled_audit_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:scheduled_audit_name (required, String) —
The name of the scheduled audit whose information you want to get.

Returns:

(Types::DescribeScheduledAuditResponse) —
Returns a response object which responds to the following methods:
- #frequency => String
- #day_of_month => String
- #day_of_week => String
- #target_check_names => Array<String>
- #scheduled_audit_name => String
- #scheduled_audit_arn => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 3957

def describe_scheduled_audit(params = {}, options = {})
  req = build_request(:describe_scheduled_audit, params)
  req.send_request(options)
end

#describe_security_profile(params = {}) ⇒ `Types::DescribeSecurityProfileResponse`

Gets information about a Device Defender security profile.

Examples:

Request syntax with placeholder values


resp = client.describe_security_profile({
  security_profile_name: "SecurityProfileName", # required
})

Response structure


resp.security_profile_name #=> String
resp.security_profile_arn #=> String
resp.security_profile_description #=> String
resp.behaviors #=> Array
resp.behaviors[0].name #=> String
resp.behaviors[0].metric #=> String
resp.behaviors[0].criteria.comparison_operator #=> String, one of "less-than", "less-than-equals", "greater-than", "greater-than-equals", "in-cidr-set", "not-in-cidr-set", "in-port-set", "not-in-port-set"
resp.behaviors[0].criteria.value.count #=> Integer
resp.behaviors[0].criteria.value.cidrs #=> Array
resp.behaviors[0].criteria.value.cidrs[0] #=> String
resp.behaviors[0].criteria.value.ports #=> Array
resp.behaviors[0].criteria.value.ports[0] #=> Integer
resp.behaviors[0].criteria.duration_seconds #=> Integer
resp.behaviors[0].criteria.consecutive_datapoints_to_alarm #=> Integer
resp.behaviors[0].criteria.consecutive_datapoints_to_clear #=> Integer
resp.behaviors[0].criteria.statistical_threshold.statistic #=> String
resp.alert_targets #=> Hash
resp.alert_targets["AlertTargetType"].alert_target_arn #=> String
resp.alert_targets["AlertTargetType"].role_arn #=> String
resp.additional_metrics_to_retain #=> Array
resp.additional_metrics_to_retain[0] #=> String
resp.version #=> Integer
resp.creation_date #=> Time
resp.last_modified_date #=> Time

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:security_profile_name (required, String) —
The name of the security profile whose information you want to get.

Returns:

(Types::DescribeSecurityProfileResponse) —
Returns a response object which responds to the following methods:
- #security_profile_name => String
- #security_profile_arn => String
- #security_profile_description => String
- #behaviors => Array<Types::Behavior>
- #alert_targets => Hash<String,Types::AlertTarget>
- #additional_metrics_to_retain => Array<String>
- #version => Integer
- #creation_date => Time
- #last_modified_date => Time

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4014

def describe_security_profile(params = {}, options = {})
  req = build_request(:describe_security_profile, params)
  req.send_request(options)
end

#describe_stream(params = {}) ⇒ `Types::DescribeStreamResponse`

Gets information about a stream.

Examples:

Request syntax with placeholder values


resp = client.describe_stream({
  stream_id: "StreamId", # required
})

Response structure


resp.stream_info.stream_id #=> String
resp.stream_info.stream_arn #=> String
resp.stream_info.stream_version #=> Integer
resp.stream_info.description #=> String
resp.stream_info.files #=> Array
resp.stream_info.files[0].file_id #=> Integer
resp.stream_info.files[0].s3_location.bucket #=> String
resp.stream_info.files[0].s3_location.key #=> String
resp.stream_info.files[0].s3_location.version #=> String
resp.stream_info.created_at #=> Time
resp.stream_info.last_updated_at #=> Time
resp.stream_info.role_arn #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:stream_id (required, String) —
The stream ID.

Returns:

(Types::DescribeStreamResponse) —
Returns a response object which responds to the following methods:
- #stream_info => Types::StreamInfo

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4051

def describe_stream(params = {}, options = {})
  req = build_request(:describe_stream, params)
  req.send_request(options)
end

#describe_thing(params = {}) ⇒ `Types::DescribeThingResponse`

Gets information about the specified thing.

Examples:

Request syntax with placeholder values


resp = client.describe_thing({
  thing_name: "ThingName", # required
})

Response structure


resp.default_client_id #=> String
resp.thing_name #=> String
resp.thing_id #=> String
resp.thing_arn #=> String
resp.thing_type_name #=> String
resp.attributes #=> Hash
resp.attributes["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
resp.version #=> Integer
resp.billing_group_name #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_name (required, String) —
The name of the thing.

Returns:

(Types::DescribeThingResponse) —
Returns a response object which responds to the following methods:
- #default_client_id => String
- #thing_name => String
- #thing_id => String
- #thing_arn => String
- #thing_type_name => String
- #attributes => Hash<String,String>
- #version => Integer
- #billing_group_name => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4092

def describe_thing(params = {}, options = {})
  req = build_request(:describe_thing, params)
  req.send_request(options)
end

#describe_thing_group(params = {}) ⇒ `Types::DescribeThingGroupResponse`

Describe a thing group.

Examples:

Request syntax with placeholder values


resp = client.describe_thing_group({
  thing_group_name: "ThingGroupName", # required
})

Response structure


resp.thing_group_name #=> String
resp.thing_group_id #=> String
resp.thing_group_arn #=> String
resp.version #=> Integer
resp.thing_group_properties.thing_group_description #=> String
resp.thing_group_properties.attribute_payload.attributes #=> Hash
resp.thing_group_properties.attribute_payload.attributes["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
resp.thing_group_properties.attribute_payload.merge #=> Boolean
resp.thing_group_metadata.parent_group_name #=> String
resp.thing_group_metadata.root_to_parent_thing_groups #=> Array
resp.thing_group_metadata.root_to_parent_thing_groups[0].group_name #=> String
resp.thing_group_metadata.root_to_parent_thing_groups[0].group_arn #=> String
resp.thing_group_metadata.creation_date #=> Time
resp.index_name #=> String
resp.query_string #=> String
resp.query_version #=> String
resp.status #=> String, one of "ACTIVE", "BUILDING", "REBUILDING"

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_group_name (required, String) —
The name of the thing group.

Returns:

(Types::DescribeThingGroupResponse) —
Returns a response object which responds to the following methods:
- #thing_group_name => String
- #thing_group_id => String
- #thing_group_arn => String
- #version => Integer
- #thing_group_properties => Types::ThingGroupProperties
- #thing_group_metadata => Types::ThingGroupMetadata
- #index_name => String
- #query_string => String
- #query_version => String
- #status => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4143

def describe_thing_group(params = {}, options = {})
  req = build_request(:describe_thing_group, params)
  req.send_request(options)
end

#describe_thing_registration_task(params = {}) ⇒ `Types::DescribeThingRegistrationTaskResponse`

Describes a bulk thing provisioning task.

Examples:

Request syntax with placeholder values


resp = client.describe_thing_registration_task({
  task_id: "TaskId", # required
})

Response structure


resp.task_id #=> String
resp.creation_date #=> Time
resp.last_modified_date #=> Time
resp.template_body #=> String
resp.input_file_bucket #=> String
resp.input_file_key #=> String
resp.role_arn #=> String
resp.status #=> String, one of "InProgress", "Completed", "Failed", "Cancelled", "Cancelling"
resp.message #=> String
resp.success_count #=> Integer
resp.failure_count #=> Integer
resp.percentage_progress #=> Integer

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:task_id (required, String) —
The task ID.

Returns:

(Types::DescribeThingRegistrationTaskResponse) —
Returns a response object which responds to the following methods:
- #task_id => String
- #creation_date => Time
- #last_modified_date => Time
- #template_body => String
- #input_file_bucket => String
- #input_file_key => String
- #role_arn => String
- #status => String
- #message => String
- #success_count => Integer
- #failure_count => Integer
- #percentage_progress => Integer

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4191

def describe_thing_registration_task(params = {}, options = {})
  req = build_request(:describe_thing_registration_task, params)
  req.send_request(options)
end

#describe_thing_type(params = {}) ⇒ `Types::DescribeThingTypeResponse`

Gets information about the specified thing type.

Examples:

Request syntax with placeholder values


resp = client.describe_thing_type({
  thing_type_name: "ThingTypeName", # required
})

Response structure


resp.thing_type_name #=> String
resp.thing_type_id #=> String
resp.thing_type_arn #=> String
resp.thing_type_properties.thing_type_description #=> String
resp.thing_type_properties.searchable_attributes #=> Array
resp.thing_type_properties.searchable_attributes[0] #=> String
resp.thing_type_metadata.deprecated #=> Boolean
resp.thing_type_metadata.deprecation_date #=> Time
resp.thing_type_metadata.creation_date #=> Time

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_type_name (required, String) —
The name of the thing type.

Returns:

(Types::DescribeThingTypeResponse) —
Returns a response object which responds to the following methods:
- #thing_type_name => String
- #thing_type_id => String
- #thing_type_arn => String
- #thing_type_properties => Types::ThingTypeProperties
- #thing_type_metadata => Types::ThingTypeMetadata

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4229

def describe_thing_type(params = {}, options = {})
  req = build_request(:describe_thing_type, params)
  req.send_request(options)
end

#detach_policy(params = {}) ⇒ `Struct`

Detaches a policy from the specified target.

Examples:

Request syntax with placeholder values


resp = client.detach_policy({
  policy_name: "PolicyName", # required
  target: "PolicyTarget", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The policy to detach.
:target (required, String) —
The target from which the policy will be detached.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4253

def detach_policy(params = {}, options = {})
  req = build_request(:detach_policy, params)
  req.send_request(options)
end

#detach_principal_policy(params = {}) ⇒ `Struct`

Removes the specified policy from the specified certificate.

Note: This API is deprecated. Please use DetachPolicy instead.

Examples:

Request syntax with placeholder values


resp = client.detach_principal_policy({
  policy_name: "PolicyName", # required
  principal: "Principal", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The name of the policy to detach.
:principal (required, String) —
The principal.

If the principal is a certificate, specify the certificate ARN. If the principal is an Amazon Cognito identity, specify the identity ID.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4282

def detach_principal_policy(params = {}, options = {})
  req = build_request(:detach_principal_policy, params)
  req.send_request(options)
end

#detach_security_profile(params = {}) ⇒ `Struct`

Disassociates a Device Defender security profile from a thing group or from this account.

Examples:

Request syntax with placeholder values


resp = client.detach_security_profile({
  security_profile_name: "SecurityProfileName", # required
  security_profile_target_arn: "SecurityProfileTargetArn", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:security_profile_name (required, String) —
The security profile that is detached.
:security_profile_target_arn (required, String) —
The ARN of the thing group from which the security profile is detached.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4308

def detach_security_profile(params = {}, options = {})
  req = build_request(:detach_security_profile, params)
  req.send_request(options)
end

#detach_thing_principal(params = {}) ⇒ `Struct`

Detaches the specified principal from the specified thing. A principal can be X.509 certificates, IAM users, groups, and roles, Amazon Cognito identities or federated identities.

This call is asynchronous. It might take several seconds for the detachment to propagate.

Examples:

Request syntax with placeholder values


resp = client.detach_thing_principal({
  thing_name: "ThingName", # required
  principal: "Principal", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:thing_name (required, String) —
The name of the thing.
:principal (required, String) —
If the principal is a certificate, this value must be ARN of the certificate. If the principal is an Amazon Cognito identity, this value must be the ID of the Amazon Cognito identity.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4341

def detach_thing_principal(params = {}, options = {})
  req = build_request(:detach_thing_principal, params)
  req.send_request(options)
end

#disable_topic_rule(params = {}) ⇒ `Struct`

Disables the rule.

Examples:

Request syntax with placeholder values


resp = client.disable_topic_rule({
  rule_name: "RuleName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:rule_name (required, String) —
The name of the rule to disable.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4361

def disable_topic_rule(params = {}, options = {})
  req = build_request(:disable_topic_rule, params)
  req.send_request(options)
end

#enable_topic_rule(params = {}) ⇒ `Struct`

Enables the rule.

Examples:

Request syntax with placeholder values


resp = client.enable_topic_rule({
  rule_name: "RuleName", # required
})

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:rule_name (required, String) —
The name of the topic rule to enable.

Returns:

(Struct) —
Returns an empty response.

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4381

def enable_topic_rule(params = {}, options = {})
  req = build_request(:enable_topic_rule, params)
  req.send_request(options)
end

#get_cardinality(params = {}) ⇒ `Types::GetCardinalityResponse`

Returns the approximate count of unique values that match the query.

Examples:

Request syntax with placeholder values


resp = client.get_cardinality({
  index_name: "IndexName",
  query_string: "QueryString", # required
  aggregation_field: "AggregationField",
  query_version: "QueryVersion",
})

Response structure


resp.cardinality #=> Integer

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:index_name (String) —
The name of the index to search.
:query_string (required, String) —
The search query.
:aggregation_field (String) —
The field to aggregate.
:query_version (String) —
The query version.

Returns:

(Types::GetCardinalityResponse) —
Returns a response object which responds to the following methods:
- #cardinality => Integer

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4419

def get_cardinality(params = {}, options = {})
  req = build_request(:get_cardinality, params)
  req.send_request(options)
end

#get_effective_policies(params = {}) ⇒ `Types::GetEffectivePoliciesResponse`

Gets a list of the policies that have an effect on the authorization behavior of the specified device when it connects to the AWS IoT device gateway.

Examples:

Request syntax with placeholder values


resp = client.get_effective_policies({
  principal: "Principal",
  cognito_identity_pool_id: "CognitoIdentityPoolId",
  thing_name: "ThingName",
})

Response structure


resp.effective_policies #=> Array
resp.effective_policies[0].policy_name #=> String
resp.effective_policies[0].policy_arn #=> String
resp.effective_policies[0].policy_document #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:principal (String) —
The principal.
:cognito_identity_pool_id (String) —
The Cognito identity pool ID.
:thing_name (String) —
The thing name.

Returns:

(Types::GetEffectivePoliciesResponse) —
Returns a response object which responds to the following methods:
- #effective_policies => Array<Types::EffectivePolicy>

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4458

def get_effective_policies(params = {}, options = {})
  req = build_request(:get_effective_policies, params)
  req.send_request(options)
end

#get_indexing_configuration(params = {}) ⇒ `Types::GetIndexingConfigurationResponse`

Gets the indexing configuration.

Examples:

Response structure


resp.thing_indexing_configuration.thing_indexing_mode #=> String, one of "OFF", "REGISTRY", "REGISTRY_AND_SHADOW"
resp.thing_indexing_configuration.thing_connectivity_indexing_mode #=> String, one of "OFF", "STATUS"
resp.thing_indexing_configuration.managed_fields #=> Array
resp.thing_indexing_configuration.managed_fields[0].name #=> String
resp.thing_indexing_configuration.managed_fields[0].type #=> String, one of "Number", "String", "Boolean"
resp.thing_indexing_configuration.custom_fields #=> Array
resp.thing_indexing_configuration.custom_fields[0].name #=> String
resp.thing_indexing_configuration.custom_fields[0].type #=> String, one of "Number", "String", "Boolean"
resp.thing_group_indexing_configuration.thing_group_indexing_mode #=> String, one of "OFF", "ON"
resp.thing_group_indexing_configuration.managed_fields #=> Array
resp.thing_group_indexing_configuration.managed_fields[0].name #=> String
resp.thing_group_indexing_configuration.managed_fields[0].type #=> String, one of "Number", "String", "Boolean"
resp.thing_group_indexing_configuration.custom_fields #=> Array
resp.thing_group_indexing_configuration.custom_fields[0].name #=> String
resp.thing_group_indexing_configuration.custom_fields[0].type #=> String, one of "Number", "String", "Boolean"

Parameters:

params (Hash) (defaults to: {}) —
({})

Returns:

(Types::GetIndexingConfigurationResponse) —
Returns a response object which responds to the following methods:
- #thing_indexing_configuration => Types::ThingIndexingConfiguration
- #thing_group_indexing_configuration => Types::ThingGroupIndexingConfiguration

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4490

def get_indexing_configuration(params = {}, options = {})
  req = build_request(:get_indexing_configuration, params)
  req.send_request(options)
end

#get_job_document(params = {}) ⇒ `Types::GetJobDocumentResponse`

Gets a job document.

Examples:

Request syntax with placeholder values


resp = client.get_job_document({
  job_id: "JobId", # required
})

Response structure


resp.document #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:job_id (required, String) —
The unique identifier you assigned to this job when it was created.

Returns:

(Types::GetJobDocumentResponse) —
Returns a response object which responds to the following methods:
- #document => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4516

def get_job_document(params = {}, options = {})
  req = build_request(:get_job_document, params)
  req.send_request(options)
end

#get_logging_options(params = {}) ⇒ `Types::GetLoggingOptionsResponse`

Gets the logging options.

NOTE: use of this command is not recommended. Use GetV2LoggingOptions instead.

Examples:

Response structure


resp.role_arn #=> String
resp.log_level #=> String, one of "DEBUG", "INFO", "ERROR", "WARN", "DISABLED"

Parameters:

params (Hash) (defaults to: {}) —
({})

Returns:

(Types::GetLoggingOptionsResponse) —
Returns a response object which responds to the following methods:
- #role_arn => String
- #log_level => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4538

def get_logging_options(params = {}, options = {})
  req = build_request(:get_logging_options, params)
  req.send_request(options)
end

#get_ota_update(params = {}) ⇒ `Types::GetOTAUpdateResponse`

Gets an OTA update.

Examples:

Request syntax with placeholder values


resp = client.get_ota_update({
  ota_update_id: "OTAUpdateId", # required
})

Response structure


resp.ota_update_info.ota_update_id #=> String
resp.ota_update_info.ota_update_arn #=> String
resp.ota_update_info.creation_date #=> Time
resp.ota_update_info.last_modified_date #=> Time
resp.ota_update_info.description #=> String
resp.ota_update_info.targets #=> Array
resp.ota_update_info.targets[0] #=> String
resp.ota_update_info.protocols #=> Array
resp.ota_update_info.protocols[0] #=> String, one of "MQTT", "HTTP"
resp.ota_update_info.aws_job_executions_rollout_config.maximum_per_minute #=> Integer
resp.ota_update_info.aws_job_presigned_url_config.expires_in_sec #=> Integer
resp.ota_update_info.target_selection #=> String, one of "CONTINUOUS", "SNAPSHOT"
resp.ota_update_info.ota_update_files #=> Array
resp.ota_update_info.ota_update_files[0].file_name #=> String
resp.ota_update_info.ota_update_files[0].file_version #=> String
resp.ota_update_info.ota_update_files[0].file_location.stream.stream_id #=> String
resp.ota_update_info.ota_update_files[0].file_location.stream.file_id #=> Integer
resp.ota_update_info.ota_update_files[0].file_location.s3_location.bucket #=> String
resp.ota_update_info.ota_update_files[0].file_location.s3_location.key #=> String
resp.ota_update_info.ota_update_files[0].file_location.s3_location.version #=> String
resp.ota_update_info.ota_update_files[0].code_signing.aws_signer_job_id #=> String
resp.ota_update_info.ota_update_files[0].code_signing.start_signing_job_parameter.signing_profile_parameter.certificate_arn #=> String
resp.ota_update_info.ota_update_files[0].code_signing.start_signing_job_parameter.signing_profile_parameter.platform #=> String
resp.ota_update_info.ota_update_files[0].code_signing.start_signing_job_parameter.signing_profile_parameter.certificate_path_on_device #=> String
resp.ota_update_info.ota_update_files[0].code_signing.start_signing_job_parameter.signing_profile_name #=> String
resp.ota_update_info.ota_update_files[0].code_signing.start_signing_job_parameter.destination.s3_destination.bucket #=> String
resp.ota_update_info.ota_update_files[0].code_signing.start_signing_job_parameter.destination.s3_destination.prefix #=> String
resp.ota_update_info.ota_update_files[0].code_signing.custom_code_signing.signature.inline_document #=> String
resp.ota_update_info.ota_update_files[0].code_signing.custom_code_signing.certificate_chain.certificate_name #=> String
resp.ota_update_info.ota_update_files[0].code_signing.custom_code_signing.certificate_chain.inline_document #=> String
resp.ota_update_info.ota_update_files[0].code_signing.custom_code_signing.hash_algorithm #=> String
resp.ota_update_info.ota_update_files[0].code_signing.custom_code_signing.signature_algorithm #=> String
resp.ota_update_info.ota_update_files[0].attributes #=> Hash
resp.ota_update_info.ota_update_files[0].attributes["AttributeKey"] #=> String
resp.ota_update_info.ota_update_status #=> String, one of "CREATE_PENDING", "CREATE_IN_PROGRESS", "CREATE_COMPLETE", "CREATE_FAILED"
resp.ota_update_info.aws_iot_job_id #=> String
resp.ota_update_info.aws_iot_job_arn #=> String
resp.ota_update_info.error_info.code #=> String
resp.ota_update_info.error_info.message #=> String
resp.ota_update_info.additional_parameters #=> Hash
resp.ota_update_info.additional_parameters["AttributeKey"] #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:ota_update_id (required, String) —
The OTA update ID.

Returns:

(Types::GetOTAUpdateResponse) —
Returns a response object which responds to the following methods:
- #ota_update_info => Types::OTAUpdateInfo

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4604

def get_ota_update(params = {}, options = {})
  req = build_request(:get_ota_update, params)
  req.send_request(options)
end

#get_percentiles(params = {}) ⇒ `Types::GetPercentilesResponse`

Groups the aggregated values that match the query into percentile groupings. The default percentile groupings are: 1,5,25,50,75,95,99, although you can specify your own when you call GetPercentiles. This function returns a value for each percentile group specified (or the default percentile groupings). The percentile group "1" contains the aggregated field value that occurs in approximately one percent of the values that match the query. The percentile group "5" contains the aggregated field value that occurs in approximately five percent of the values that match the query, and so on. The result is an approximation, the more values that match the query, the more accurate the percentile values.

Examples:

Request syntax with placeholder values


resp = client.get_percentiles({
  index_name: "IndexName",
  query_string: "QueryString", # required
  aggregation_field: "AggregationField",
  query_version: "QueryVersion",
  percents: [1.0],
})

Response structure


resp.percentiles #=> Array
resp.percentiles[0].percent #=> Float
resp.percentiles[0].value #=> Float

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:index_name (String) —
The name of the index to search.
:query_string (required, String) —
The query string.
:aggregation_field (String) —
The field to aggregate.
:query_version (String) —
The query version.
:percents (Array<Float>) —
The percentile groups returned.

Returns:

(Types::GetPercentilesResponse) —
Returns a response object which responds to the following methods:
- #percentiles => Array<Types::PercentPair>

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4658

def get_percentiles(params = {}, options = {})
  req = build_request(:get_percentiles, params)
  req.send_request(options)
end

#get_policy(params = {}) ⇒ `Types::GetPolicyResponse`

Gets information about the specified policy with the policy document of the default version.

Examples:

Request syntax with placeholder values


resp = client.get_policy({
  policy_name: "PolicyName", # required
})

Response structure


resp.policy_name #=> String
resp.policy_arn #=> String
resp.policy_document #=> String
resp.default_version_id #=> String
resp.creation_date #=> Time
resp.last_modified_date #=> Time
resp.generation_id #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The name of the policy.

Returns:

(Types::GetPolicyResponse) —
Returns a response object which responds to the following methods:
- #policy_name => String
- #policy_arn => String
- #policy_document => String
- #default_version_id => String
- #creation_date => Time
- #last_modified_date => Time
- #generation_id => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4697

def get_policy(params = {}, options = {})
  req = build_request(:get_policy, params)
  req.send_request(options)
end

#get_policy_version(params = {}) ⇒ `Types::GetPolicyVersionResponse`

Gets information about the specified policy version.

Examples:

Request syntax with placeholder values


resp = client.get_policy_version({
  policy_name: "PolicyName", # required
  policy_version_id: "PolicyVersionId", # required
})

Response structure


resp.policy_arn #=> String
resp.policy_name #=> String
resp.policy_document #=> String
resp.policy_version_id #=> String
resp.is_default_version #=> Boolean
resp.creation_date #=> Time
resp.last_modified_date #=> Time
resp.generation_id #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:policy_name (required, String) —
The name of the policy.
:policy_version_id (required, String) —
The policy version ID.

Returns:

(Types::GetPolicyVersionResponse) —
Returns a response object which responds to the following methods:
- #policy_arn => String
- #policy_name => String
- #policy_document => String
- #policy_version_id => String
- #is_default_version => Boolean
- #creation_date => Time
- #last_modified_date => Time
- #generation_id => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4741

def get_policy_version(params = {}, options = {})
  req = build_request(:get_policy_version, params)
  req.send_request(options)
end

#get_registration_code(params = {}) ⇒ `Types::GetRegistrationCodeResponse`

Gets a registration code used to register a CA certificate with AWS IoT.

Examples:

Response structure


resp.registration_code #=> String

Parameters:

params (Hash) (defaults to: {}) —
({})

Returns:

(Types::GetRegistrationCodeResponse) —
Returns a response object which responds to the following methods:
- #registration_code => String

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4759

def get_registration_code(params = {}, options = {})
  req = build_request(:get_registration_code, params)
  req.send_request(options)
end

#get_statistics(params = {}) ⇒ `Types::GetStatisticsResponse`

Returns the count, average, sum, minimum, maximum, sum of squares, variance, and standard deviation for the specified aggregated field. If the aggregation field is of type String, only the count statistic is returned.

Examples:

Request syntax with placeholder values


resp = client.get_statistics({
  index_name: "IndexName",
  query_string: "QueryString", # required
  aggregation_field: "AggregationField",
  query_version: "QueryVersion",
})

Response structure


resp.statistics.count #=> Integer
resp.statistics.average #=> Float
resp.statistics.sum #=> Float
resp.statistics.minimum #=> Float
resp.statistics.maximum #=> Float
resp.statistics.sum_of_squares #=> Float
resp.statistics.variance #=> Float
resp.statistics.std_deviation #=> Float

Parameters:

params (Hash) (defaults to: {}) —
({})

Options Hash (params):

:index_name (String) —
The name of the index to search. The default value is AWS_Things.
:query_string (required, String) —
The query used to search. You can specify "*" for the query string to get the count of all indexed things in your AWS account.
:aggregation_field (String) —
The aggregation field name.
:query_version (String) —
The version of the query used to search.

Returns:

(Types::GetStatisticsResponse) —
Returns a response object which responds to the following methods:
- #statistics => Types::Statistics

# File 'gems/aws-sdk-iot/lib/aws-sdk-iot/client.rb', line 4808

def get_statistics(params = {}, options = {})
  req = build_request(:get_statistics, params)
  req.send_request(options)
end

#get_topic_rule(params = {}) ⇒ `Types::GetTopicRuleResponse`

Gets information about the rule.

Examples:

Request syntax with placeholder values


resp = client.get_topic_rule({
  rule_name: "RuleName", # required
})

Response structure


resp.rule_arn #=> String
resp.rule.rule_name #=> String
resp.rule.sql #=> String
resp.rule.description #=> String
resp.rule.created_at #=> Time
resp.rule.actions #=> Array
resp.rule.actions[0].dynamo_db.table_name #=> String
resp.rule.actions[0].dynamo_db.role_arn #=> String
resp.rule.actions[0].dynamo_db.operation #=> String
resp.rule.actions[0].dynamo_db.hash_key_field #=> String
resp.rule.actions[0].dynamo_db.hash_key_value #=> String
resp.rule.actions[0].dynamo_db.hash_key_type #=> String, one of "STRING", "NUMBER"
resp.rule.actions[0].dynamo_db.range_key_field #=> String
resp.rule.actions[0].dynamo_db.range_key_value #=> String
resp.rule.actions[0].dynamo_db.range_key_type #=> String, one of "STRING", "NUMBER"
resp.rule.actions[0].dynamo_db.payload_field #=> String
resp.rule.actions[0].dynamo_d_bv_2.role_arn #=> String
resp.rule.actions[0].dynamo_d_bv_2.put_item.table_name #=> String
resp.rule.actions[0].lambda.function_arn #=> String
resp.rule.actions[0].sns.target_arn #=> String
resp.rule.actions[0].sns.role_arn #=> String
resp.rule.actions[0].sns.message_format #=> String, one of "RAW", "JSON"
resp.rule.actions[0].sqs.role_arn #=> String
resp.rule.actions[0].sqs.queue_url #=> String
resp.rule.actions[0].sqs.use_base_64 #=> Boolean
resp.rule.actions[0].kinesis.role_arn #=> String
resp.rule.actions[0].kinesis.stream_name #=> String
resp.rule.actions[0].kinesis.partition_key #=> String
resp.rule.actions[0].republish.role_arn #=> String
resp.rule.actions[0].republish.topic #=> String
resp.rule.actions[0].republish.qos #=> Integer
resp.rule.actions[0].s3.role_arn #=> String
resp.rule.actions[0].s3.bucket_name #=> String
resp.rule.actions[0].s3.key #=> String
resp.rule.actions[0].s3.canned_acl #=> String, one of "private", "public-read", "public-read-write", "aws-exec-read", "authenticated-read", "bucket-owner-read", "bucket-owner-full-control", "log-delivery-write"
resp.rule.actions[0].firehose.role_arn #=> String
resp.rule.actions[0].firehose.delivery_stream_name #=> String
resp.rule.actions[0].firehose.separator #=> String
resp.rule.actions[0].cloudwatch_metric.role_arn #=> String
resp.rule.actions[0].cloudwatch_metric.metric_namespace #=> String
resp.rule.actions[0].cloudwatch_metric.metric_name #=> String
resp.rule.actions[0].cloudwatch_metric.metric_value #=> String
resp.rule.actions[0].cloudwatch_metric.metric_unit #=> String
resp.rule.actions[0].cloudwatch_metric.metric_timestamp #=> String
resp.rule.actions[0].cloudwatch_alarm.role_arn #=> String
resp.rule.actions[0].cloudwatch_alarm.alarm_name #=> String
resp.rule.actions[0].cloudwatch_alarm.state_reason #=> String
resp.rule.actions[0].cloudwatch_alarm.state_value #=> String
resp.rule.actions[0].elasticsearch.role_arn #=> String
resp.rule.actions[0].elasticsearch.endpoint #=> String
resp.rule.actions[0].elasticsearch.index #=> String
resp.rule.actions[0].elasticsearch.type #=> String
resp.rule.actions[0].elasticsearch.id #=> String
resp.rule.actions[0].salesforce.token #=> String
resp.rule.actions[0].salesforce.url #=> String
resp.rule.actions[0].iot_analytics.channel_arn #=> String
resp.rule.actions[0].iot_analytics.channel_name #=> String
resp.rule.actions[0].iot_analytics.role_arn #=> String
resp.rule.actions[0].iot_events.input_name #=> String
resp.rule.actions[0].iot_events.message_id #=> String
resp.rule.actions[0].iot_events.role_arn #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries #=> Array
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].entry_id #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].asset_id #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_id #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_alias #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_values #=> Array
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_values[0].value.string_value #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_values[0].value.integer_value #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_values[0].value.double_value #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_values[0].value.boolean_value #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_values[0].timestamp.time_in_seconds #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_values[0].timestamp.offset_in_nanos #=> String
resp.rule.actions[0].iot_site_wise.put_asset_property_value_entries[0].property_values[0].quality #=> String
resp.rule.actions[0].iot_site_wise.role_arn #=> String
resp.rule.actions[0].step_functions.execution_name_prefix #=> String
resp.rule.actions[0].step_functions.state_machine_name #=> String
resp.rule.actions[0].step_functions.role_arn #=> String
resp.rule.actions[0].http.url #=> String
resp.rule.actions[0].http.confirmation_url #=> String
resp.rule.actions[0].http.headers #=> Array
resp.rule.actions[0].http.headers[0].key #=> String
resp.rule.actions[0].http.headers[0].value #=> String
resp.rule.actions[0].http.auth.sigv4.signing_region #=> String
resp.rule.actions[0].http.auth.sigv4.service_name #=> String
resp.rule.actions[0].http.auth.sigv4.role_arn #=> String
resp.rule.rule_disabled #=> Boolean
resp.rule.aws_iot_sql_version #=> String
resp.rule.error_action.dynamo_db.table_name #=> String
resp.rule.error_action.dynamo_db.role_arn #=> String
resp.rule.error_action.dynamo_db.operation #=> String
resp.rule.error_action.dynamo_db.hash_key_field #=> String
resp.rule.error_action.dynamo_db.hash_key_value #=> String
resp.rule.error_action.dynamo_db.hash_key_type #=> String, one of "STRING", "NUMBER"
resp.rule.error_action.dynamo_db.range_key_field #=> String
resp.rule.error_action.dynamo_db.range_key_value #=> String
resp.rule.error_action.dynamo_db.range_key_type #=> String, one of "STRING", "NUMBER"
resp.rule.error_action.dynamo_db.payload_field #=> String
resp.rule.error_action.dynamo_d_bv_2.role_arn #=> String
resp.rule.error_action.dynamo_d_bv_2.put_item.table_name #=> String
resp.rule.error_action.lambda.function_arn #=> String
resp.rule.error_action.sns.target_arn #=> String
resp.rule.error_action.sns.role_arn #=> String
resp.rule.error_action.sns.message_format #=> String, one of "RAW", "JSON"
resp.rule.error_action.sqs.role_arn #=> String
resp.rule.error_action.sqs.queue_url #=> String
resp.rule.error_action.sqs.use_base_64 #=> Boolean
resp.rule.error_action.kinesis.role_arn #=> String
resp.rule.error_action.kinesis.stream_name #=> String
resp.rule.error_action.kinesis.partition_key #=> String
resp.rule.error_action.republish.role_arn #=> String
resp.rule.error_action.republish.topic #=> String
resp.rule.error_action.republish.qos #=> Integer
resp.rule.error_action.s3.role_arn #=> String
resp.rule.error_action.s3.bucket_name #=> String
resp.rule.error_action.s3.key #=> String
resp.rule.error_action.s3.canned_acl #=> String, one of "private", "public-read", "public-read-write", "aws-exec-read", "authenticated-read", "bucket-owner-read", "bucket-owner-full-control", "log-delivery-write"
resp.rule.error_action.firehose.role_arn #=> String
resp.rule.error_action.firehose.delivery_stream_name #=> String
resp.rule.error_action.firehose.separator #=> String
resp.rule.error_action.cloudwatch_metric.role_arn #=> String
resp.rule.error_action.cloudwatch_metric.metric_namespace #=> String
resp.rule.error_action.cloudwatch_metric.metric_name #=> String
resp.rule.error_action.cloudwatch_metric.metric_value #=> String
resp.rule.error_action.cloudwatch_metric.metric_unit #=> String
resp.rule.error_action.cloudwatch_metric.metric_timestamp #=> String
resp.rule.error_action.cloudwatch_alarm.role_arn #=> String
resp.rule.error_action.cloudwatch_alarm.alarm_name #=> String
resp.rule.error_action.cloudwatch_alarm.state_reason #=> String
resp.rule.error_action.cloudwatch_alarm.state_value #=> String
resp.rule.error_action.elasticsearch.role_arn #=> String
resp.rule.error_action.elasticsearch.endpoint #=> String
resp.rule.error_action.elasticsearch.index #=> String
resp.rule.error_action.elasticsearch.type #=> String
resp.rule.error_action.elasticsearch.id #=> String
resp.rule.error_action.salesforce.token #=> String
resp.rule.error_action.salesforce.url #=> String
resp.rule.error_action.iot_analytics.channel_arn #=> String
resp.rule.error_action.iot_analytics.channel_name #=> String
resp.rule.error_action.iot_analytics.role_arn #=> String
resp.rule.error_action.iot_events.input_name #=> String
resp.rule.error_action.iot_events.message_id #=> String
resp.rule.error_action.iot_events.role_arn #=> String
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries #=> Array
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].entry_id #=> String
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].asset_id #=> String
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].property_id #=> String
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].property_alias #=> String
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].property_values #=> Array
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].property_values[0].value.string_value #=> String
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].property_values[0].value.integer_value #=> String
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].property_values[0].value.double_value #=> String
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].property_values[0].value.boolean_value #=> String
resp.rule.error_action.iot_site_wise.put_asset_property_value_entries[0].

Class: Aws::IoT::Client

Instance Attribute Summary

Attributes inherited from Seahorse::Client::Base

API Operations collapse

Instance Method Summary collapse

Methods included from ClientStubs

Methods inherited from Seahorse::Client::Base

Methods included from Seahorse::Client::HandlerBuilder

Constructor Details

#initialize(options) ⇒ Client

Instance Method Details

#accept_certificate_transfer(params = {}) ⇒ Struct

#add_thing_to_billing_group(params = {}) ⇒ Struct

#add_thing_to_thing_group(params = {}) ⇒ Struct

#associate_targets_with_job(params = {}) ⇒ Types::AssociateTargetsWithJobResponse

#attach_policy(params = {}) ⇒ Struct

#attach_principal_policy(params = {}) ⇒ Struct

#attach_security_profile(params = {}) ⇒ Struct

#attach_thing_principal(params = {}) ⇒ Struct

#cancel_audit_mitigation_actions_task(params = {}) ⇒ Struct

#cancel_audit_task(params = {}) ⇒ Struct

#cancel_certificate_transfer(params = {}) ⇒ Struct

#cancel_job(params = {}) ⇒ Types::CancelJobResponse

#cancel_job_execution(params = {}) ⇒ Struct

#clear_default_authorizer(params = {}) ⇒ Struct

#confirm_topic_rule_destination(params = {}) ⇒ Struct

#create_authorizer(params = {}) ⇒ Types::CreateAuthorizerResponse

#create_billing_group(params = {}) ⇒ Types::CreateBillingGroupResponse

#create_certificate_from_csr(params = {}) ⇒ Types::CreateCertificateFromCsrResponse

#create_domain_configuration(params = {}) ⇒ Types::CreateDomainConfigurationResponse

#create_dynamic_thing_group(params = {}) ⇒ Types::CreateDynamicThingGroupResponse

#create_job(params = {}) ⇒ Types::CreateJobResponse

#create_keys_and_certificate(params = {}) ⇒ Types::CreateKeysAndCertificateResponse

#create_mitigation_action(params = {}) ⇒ Types::CreateMitigationActionResponse

#create_ota_update(params = {}) ⇒ Types::CreateOTAUpdateResponse

#create_policy(params = {}) ⇒ Types::CreatePolicyResponse

#create_policy_version(params = {}) ⇒ Types::CreatePolicyVersionResponse

#create_provisioning_claim(params = {}) ⇒ Types::CreateProvisioningClaimResponse

#create_provisioning_template(params = {}) ⇒ Types::CreateProvisioningTemplateResponse

#create_provisioning_template_version(params = {}) ⇒ Types::CreateProvisioningTemplateVersionResponse

#create_role_alias(params = {}) ⇒ Types::CreateRoleAliasResponse

#create_scheduled_audit(params = {}) ⇒ Types::CreateScheduledAuditResponse

#create_security_profile(params = {}) ⇒ Types::CreateSecurityProfileResponse

#create_stream(params = {}) ⇒ Types::CreateStreamResponse

#create_thing(params = {}) ⇒ Types::CreateThingResponse

#create_thing_group(params = {}) ⇒ Types::CreateThingGroupResponse

#create_thing_type(params = {}) ⇒ Types::CreateThingTypeResponse

#create_topic_rule(params = {}) ⇒ Struct

#create_topic_rule_destination(params = {}) ⇒ Types::CreateTopicRuleDestinationResponse

#delete_account_audit_configuration(params = {}) ⇒ Struct

#delete_authorizer(params = {}) ⇒ Struct

#delete_billing_group(params = {}) ⇒ Struct

#delete_ca_certificate(params = {}) ⇒ Struct

#delete_certificate(params = {}) ⇒ Struct

#delete_domain_configuration(params = {}) ⇒ Struct

#delete_dynamic_thing_group(params = {}) ⇒ Struct

#delete_job(params = {}) ⇒ Struct

#delete_job_execution(params = {}) ⇒ Struct

#delete_mitigation_action(params = {}) ⇒ Struct

#delete_ota_update(params = {}) ⇒ Struct

#delete_policy(params = {}) ⇒ Struct

#delete_policy_version(params = {}) ⇒ Struct

#delete_provisioning_template(params = {}) ⇒ Struct

#delete_provisioning_template_version(params = {}) ⇒ Struct

#delete_registration_code(params = {}) ⇒ Struct

#delete_role_alias(params = {}) ⇒ Struct

#delete_scheduled_audit(params = {}) ⇒ Struct

#delete_security_profile(params = {}) ⇒ Struct

#delete_stream(params = {}) ⇒ Struct

#delete_thing(params = {}) ⇒ Struct

#delete_thing_group(params = {}) ⇒ Struct

#delete_thing_type(params = {}) ⇒ Struct

#delete_topic_rule(params = {}) ⇒ Struct

#delete_topic_rule_destination(params = {}) ⇒ Struct

#delete_v2_logging_level(params = {}) ⇒ Struct

#deprecate_thing_type(params = {}) ⇒ Struct

#describe_account_audit_configuration(params = {}) ⇒ Types::DescribeAccountAuditConfigurationResponse

#describe_audit_finding(params = {}) ⇒ Types::DescribeAuditFindingResponse

#describe_audit_mitigation_actions_task(params = {}) ⇒ Types::DescribeAuditMitigationActionsTaskResponse

#describe_audit_task(params = {}) ⇒ Types::DescribeAuditTaskResponse

#initialize(options) ⇒ `Client`

#accept_certificate_transfer(params = {}) ⇒ `Struct`

#add_thing_to_billing_group(params = {}) ⇒ `Struct`

#add_thing_to_thing_group(params = {}) ⇒ `Struct`

#associate_targets_with_job(params = {}) ⇒ `Types::AssociateTargetsWithJobResponse`

#attach_policy(params = {}) ⇒ `Struct`

#attach_principal_policy(params = {}) ⇒ `Struct`

#attach_security_profile(params = {}) ⇒ `Struct`

#attach_thing_principal(params = {}) ⇒ `Struct`

#cancel_audit_mitigation_actions_task(params = {}) ⇒ `Struct`

#cancel_audit_task(params = {}) ⇒ `Struct`

#cancel_certificate_transfer(params = {}) ⇒ `Struct`

#cancel_job(params = {}) ⇒ `Types::CancelJobResponse`

#cancel_job_execution(params = {}) ⇒ `Struct`

#clear_default_authorizer(params = {}) ⇒ `Struct`

#confirm_topic_rule_destination(params = {}) ⇒ `Struct`

#create_authorizer(params = {}) ⇒ `Types::CreateAuthorizerResponse`

#create_billing_group(params = {}) ⇒ `Types::CreateBillingGroupResponse`

#create_certificate_from_csr(params = {}) ⇒ `Types::CreateCertificateFromCsrResponse`

#create_domain_configuration(params = {}) ⇒ `Types::CreateDomainConfigurationResponse`

#create_dynamic_thing_group(params = {}) ⇒ `Types::CreateDynamicThingGroupResponse`

#create_job(params = {}) ⇒ `Types::CreateJobResponse`

#create_keys_and_certificate(params = {}) ⇒ `Types::CreateKeysAndCertificateResponse`

#create_mitigation_action(params = {}) ⇒ `Types::CreateMitigationActionResponse`

#create_ota_update(params = {}) ⇒ `Types::CreateOTAUpdateResponse`

#create_policy(params = {}) ⇒ `Types::CreatePolicyResponse`

#create_policy_version(params = {}) ⇒ `Types::CreatePolicyVersionResponse`

#create_provisioning_claim(params = {}) ⇒ `Types::CreateProvisioningClaimResponse`

#create_provisioning_template(params = {}) ⇒ `Types::CreateProvisioningTemplateResponse`

#create_provisioning_template_version(params = {}) ⇒ `Types::CreateProvisioningTemplateVersionResponse`

#create_role_alias(params = {}) ⇒ `Types::CreateRoleAliasResponse`

#create_scheduled_audit(params = {}) ⇒ `Types::CreateScheduledAuditResponse`

#create_security_profile(params = {}) ⇒ `Types::CreateSecurityProfileResponse`

#create_stream(params = {}) ⇒ `Types::CreateStreamResponse`

#create_thing(params = {}) ⇒ `Types::CreateThingResponse`

#create_thing_group(params = {}) ⇒ `Types::CreateThingGroupResponse`

#create_thing_type(params = {}) ⇒ `Types::CreateThingTypeResponse`

#create_topic_rule(params = {}) ⇒ `Struct`

#create_topic_rule_destination(params = {}) ⇒ `Types::CreateTopicRuleDestinationResponse`

#delete_account_audit_configuration(params = {}) ⇒ `Struct`

#delete_authorizer(params = {}) ⇒ `Struct`

#delete_billing_group(params = {}) ⇒ `Struct`

#delete_ca_certificate(params = {}) ⇒ `Struct`

#delete_certificate(params = {}) ⇒ `Struct`

#delete_domain_configuration(params = {}) ⇒ `Struct`

#delete_dynamic_thing_group(params = {}) ⇒ `Struct`

#delete_job(params = {}) ⇒ `Struct`

#delete_job_execution(params = {}) ⇒ `Struct`

#delete_mitigation_action(params = {}) ⇒ `Struct`

#delete_ota_update(params = {}) ⇒ `Struct`

#delete_policy(params = {}) ⇒ `Struct`

#delete_policy_version(params = {}) ⇒ `Struct`

#delete_provisioning_template(params = {}) ⇒ `Struct`

#delete_provisioning_template_version(params = {}) ⇒ `Struct`

#delete_registration_code(params = {}) ⇒ `Struct`

#delete_role_alias(params = {}) ⇒ `Struct`

#delete_scheduled_audit(params = {}) ⇒ `Struct`

#delete_security_profile(params = {}) ⇒ `Struct`

#delete_stream(params = {}) ⇒ `Struct`

#delete_thing(params = {}) ⇒ `Struct`

#delete_thing_group(params = {}) ⇒ `Struct`

#delete_thing_type(params = {}) ⇒ `Struct`

#delete_topic_rule(params = {}) ⇒ `Struct`

#delete_topic_rule_destination(params = {}) ⇒ `Struct`

#delete_v2_logging_level(params = {}) ⇒ `Struct`

#deprecate_thing_type(params = {}) ⇒ `Struct`

#describe_account_audit_configuration(params = {}) ⇒ `Types::DescribeAccountAuditConfigurationResponse`

#describe_audit_finding(params = {}) ⇒ `Types::DescribeAuditFindingResponse`

#describe_audit_mitigation_actions_task(params = {}) ⇒ `Types::DescribeAuditMitigationActionsTaskResponse`

#describe_audit_task(params = {}) ⇒ `Types::DescribeAuditTaskResponse`

#describe_authorizer(params = {}) ⇒ `Types::DescribeAuthorizerResponse`

#describe_billing_group(params = {}) ⇒ `Types::DescribeBillingGroupResponse`

#describe_ca_certificate(params = {}) ⇒ `Types::DescribeCACertificateResponse`

#describe_certificate(params = {}) ⇒ `Types::DescribeCertificateResponse`

#describe_default_authorizer(params = {}) ⇒ `Types::DescribeDefaultAuthorizerResponse`

#describe_domain_configuration(params = {}) ⇒ `Types::DescribeDomainConfigurationResponse`

#describe_endpoint(params = {}) ⇒ `Types::DescribeEndpointResponse`

#describe_event_configurations(params = {}) ⇒ `Types::DescribeEventConfigurationsResponse`

#describe_index(params = {}) ⇒ `Types::DescribeIndexResponse`

#describe_job(params = {}) ⇒ `Types::DescribeJobResponse`