AWS IoT 1-Click
Devices API Reference

Finalize Claim

Finalizes a device claim request initiated by a InitiateDeviceClaim operation.

URI

/devices/ deviceId /finalize-claim

HTTP Methods

PUT

Operation ID: FinalizeDeviceClaim

Given a device ID, finalizes the claim request for the associated device.

Note

Claiming a device consists of initiating a claim, then publishing a device event, and finalizing the claim. For a device of type button, a device event can be published by simply clicking the device.

Path Parameters

Name Type Required Description
deviceId String True

The unique identifier of the device.

Responses

Status Code Response Model Description
200 DeviceClaimResponse

200 response

400 InvalidRequestException

400 response

404 ResourceNotFoundException

404 response

409 ResourceConflictException

409 response

412 PreconditionFailedException

412 response

500 InternalFailureException

500 response

See Also

OPTIONS

Responses

Status Code Response Model Description
200 None

200 response

Schemas

Response Bodies

Example DeviceClaimResponse

{ "state": "string" }

Example InvalidRequestException

{ "code": "string", "message": "string" }

Example ResourceNotFoundException

{ "code": "string", "message": "string" }

Example ResourceConflictException

{ "code": "string", "message": "string" }

Example PreconditionFailedException

{ "code": "string", "message": "string" }

Example InternalFailureException

{ "code": "string", "message": "string" }

Properties

DeviceClaimResponse

Property Type Required Description
state

string

False

The device's final claim state.

See Also

InternalFailureException

Property Type Required Description
code

string

False

500

message

string

False

The 500 error message returned by the web server.

See Also

InvalidRequestException

Property Type Required Description
code

string

False

400

message

string

False

The 400 error message returned by the web server.

See Also

PreconditionFailedException

Property Type Required Description
code

string

False

412

message

string

False

An error message explaining the error or its remedy.

See Also

ResourceConflictException

Property Type Required Description
code

string

False

409

message

string

False

An error message explaining the error or its remedy.

See Also

ResourceNotFoundException

Property Type Required Description
code

string

False

404

message

string

False

The requested device could not be found.

See Also