

# Manage tracker resources with Amazon Location
<a name="managing-trackers"></a>

You can manage your trackers using the Amazon Location console, the AWS CLI, or the Amazon Location APIs.

Review and complete the following tutorials to manage tracker resounces.

**Topics**
+ [Tutorial: List your trackers](viewing-trackers.md)
+ [Tutorial: Disconnect a tracker from a geofence collection](disassociate-tracker.md)
+ [Tutorial: Get tracker details with Amazon Location](get-tracker-details.md)
+ [Tutorial: Delete a tracker with Amazon Location](delete-tracker.md)

# Tutorial: List your trackers
<a name="viewing-trackers"></a>

You can view your trackers list using the Amazon Location console, the AWS CLI, or the Amazon Location APIs:

------
#### [ Console ]

**To view a list of existing trackers using the Amazon Location console**

1. Open the Amazon Location console at [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Choose** Trackers** from the left navigation.

1. View a list of your tracker resources under **My trackers**.

------
#### [ API ]

Use the `[ListTrackers](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_ListTrackers.html)` operation from the Amazon Location Trackers APIs. 

The following example is an API request to get a list of trackers in your AWS account. 

```
POST /tracking/v0/list-trackers
```

The following is an example response for `[ListTrackers](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_ListTrackers.html)`:

```
{
   "Entries": [ 
      { 
         "CreateTime": 2020-10-02T19:09:07.327Z,
         "Description": "string",
         "TrackerName": "ExampleTracker",
         "UpdateTime": 2020-10-02T19:10:07.327Z
      }
   ],
   "NextToken": "1234-5678-9012"
}
```

------
#### [ CLI ]

Use the `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)` command.

The following example is an AWS CLI to get a list of trackers in your AWS account. 

```
aws location list-trackers
```

------

# Tutorial: Disconnect a tracker from a geofence collection
<a name="disassociate-tracker"></a>

You can disconnect a tracker from a geofence collection using the Amazon Location console, the AWS CLI, or the Amazon Location APIs:

------
#### [ Console ]

**To disassociate a tracker from an associated geofence collection using the Amazon Location console**

1. Open the Amazon Location console at [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Choose **Trackers** from the left navigation pane.

1. Under **My trackers**, select the name link of the target tracker.

1. Under **Linked Geofence Collections**, select a geofence collection with a **Linked** status.

1. Choose **Unlink**.

------
#### [ API ]

Use the `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_DisassociateTrackerConsumer.html)` operation from the Amazon Location Trackers APIs. 

The following example is an API request to disassociate a tracker from an associated geofence collection. 

```
DELETE /tracking/v0/trackers/ExampleTracker/consumers/arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection
```

The following is an example response for `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_DisassociateTrackerConsumer.html)`: 

```
HTTP/1.1 200
```

------
#### [ CLI ]

Use the `[disassociate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/disassociate-tracker-consumer.html)` command.

The following example is an AWS CLI command to disassociate a tracker from an associated geofence collection. 

```
aws location disassociate-tracker-consumer \
    --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection" \
    --tracker-name "ExampleTracker"
```

------

# Tutorial: Get tracker details with Amazon Location
<a name="get-tracker-details"></a>

You can get details about any tracker in your AWS account by using the Amazon Location console, the AWS CLI, or the Amazon Location APIs.

------
#### [ Console ]

**To view tracker details by using the Amazon Location console**

1. Open the Amazon Location console at [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Choose **Trackers** from the left navigation.

1. Under **My trackers**, select the name link of the target tracker.

1. View the tracker details under **Information**.

------
#### [ API ]

Use the `[DescribeTracker](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_DescribeTracker.html)` operation from the Amazon Location Tracker APIs.

The following example is an API request to get the tracker details for *ExampleTracker*.

```
GET /tracking/v0/trackers/ExampleTracker
```

The following is an example response for `[DescribeTracker](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_DescribeTracker.html)`:

```
{
   "CreateTime": 2020-10-02T19:09:07.327Z,
   "Description": "string",
   "EventBridgeEnabled": false,
   "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
   "PositionFiltering": "TimeBased",
   "Tags": { 
      "Tag1" : "Value1" 
   },
   "TrackerArn": "arn:aws:geo:us-west-2:123456789012:tracker/ExampleTracker",
   "TrackerName": "ExampleTracker",
   "UpdateTime": 2020-10-02T19:10:07.327Z
}
```

------
#### [ CLI ]

Use the `[describe-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/describe-tracker.html)` command.

The following example is an AWS CLI command to get tracker details for *ExampleTracker*.

```
aws location describe-tracker \
    --tracker-name "ExampleTracker"
```

------

# Tutorial: Delete a tracker with Amazon Location
<a name="delete-tracker"></a>

You can delete a tracker from your AWS account using the Amazon Location console, the AWS CLI, or the Amazon Location APIs:

------
#### [ Console ]

**To delete an existing map resource using the Amazon Location console**

**Warning**  
This operation deletes the resource permanently. If the tracker resource is in use, you may encounter an error. Make sure that the target resource isn't a dependency for your applications. 

1. Open the Amazon Location console at [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Choose **Trackers** from the left navigation pane.

1. Under **My trackers**, select the target tracker.

1. Choose **Delete tracker**.

------
#### [ API ]

Use the `[DeleteTracker](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_DeleteTracker.html)` operation from the Amazon Location Tracker APIs. 

The following example is an API request to delete the tracker *ExampleTracker*.

```
DELETE /tracking/v0/trackers/ExampleTracker
```

The following is an example response for `[DeleteTracker](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_DeleteTracker.html)`: 

```
HTTP/1.1 200
```

------
#### [ CLI ]

Use the `[delete-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/delete-tracker.html)` command.

The following example is an AWS CLI command to delete the tracker *ExampleTracker*.

```
aws location delete-tracker \
    --tracker-name "ExampleTracker"
```

------