

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Gerencie o rastreador do Amazon Location Service
<a name="managing-trackers"></a>

Você pode gerenciar seus rastreadores usando o console de localização da Amazon AWS CLI, o ou o Amazon Location. APIs

## Faça uma lista dos seus rastreadores
<a name="viewing-trackers"></a>

Você pode ver sua lista de rastreadores usando o console de localização da Amazon AWS CLI, o ou o Amazon Location: APIs

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

**Para ver uma lista de rastreadores existentes usando o console Amazon Location**

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Selecione **Rastreadores** na barra de navegação à esquerda.

1. Veja uma lista dos seus recursos de rastreador em **Meus rastreadores**.

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

Use a `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)` operação dos Amazon Location Trackers APIs. 

O exemplo a seguir é uma solicitação de API para obter uma lista de rastreadores em sua AWS conta. 

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

Este é um exemplo de resposta para `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_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 o comando `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`.

O exemplo a seguir é AWS CLI para obter uma lista de rastreadores em sua AWS conta. 

```
aws location list-trackers
```

------

## Desconectando um rastreador de uma coleção de geocercas
<a name="disassociate-tracker"></a>

Você pode desconectar um rastreador de uma coleção de cercas geográficas usando o console de localização da Amazon, o AWS CLI ou o Amazon Location: APIs

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

**Para desassociar um rastreador de uma coleção associada de geocercas usando o console do Amazon Location**

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Selecione **Rastreadores** no painel de navegação à esquerda.

1. Em **Meus rastreadores**, selecione o link do nome do rastreador de destino.

1. Em **Coleções de geocercas vinculadas**, selecione uma coleção de geocercas com status **Vinculada**.

1. Selecione **Desvincular**.

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

Use a `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)` operação dos Amazon Location Trackers APIs. 

O exemplo a seguir é uma solicitação de API para desassociar um rastreador de uma coleção de geocercas associada. 

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

Este é um exemplo de resposta para `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)`: 

```
HTTP/1.1 200
```

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

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

O exemplo a seguir é um AWS CLI comando para desassociar um rastreador de uma coleção de cercas geográficas associada. 

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

------

## Obtenha detalhes do rastreador
<a name="get-tracker-details"></a>

Você pode obter detalhes sobre qualquer rastreador em sua AWS conta usando o console de localização da Amazon AWS CLI, o ou o Amazon Location APIs.

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

**Para visualizar os detalhes do rastreador usando o console do Amazon Location**

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Selecione **Rastreadores** na barra de navegação à esquerda.

1. Em **Meus rastreadores**, selecione o link do nome do rastreador de destino.

1. Veja os detalhes do rastreador em **Informações**.

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

Use a `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)` operação do Amazon Location Tracker APIs.

O exemplo a seguir é uma solicitação de API para obter os detalhes do rastreador. {{ExampleTracker}}

```
GET /tracking/v0/trackers/{{ExampleTracker}}
```

Este é um exemplo de resposta para `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_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 o comando `[describe-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/describe-tracker.html)`.

O exemplo a seguir é um AWS CLI comando para obter detalhes do rastreador. {{ExampleTracker}}

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

------

## Exclua um rastreador
<a name="delete-tracker"></a>

Você pode excluir um rastreador da sua AWS conta usando o console de localização da Amazon AWS CLI, o ou o Amazon Location: APIs

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

**Para excluir um recurso de mapa existente usando o console do Amazon Location**

**Atenção**  
Essa operação exclui o recurso permanentemente. Se o recurso do rastreador estiver em uso, você poderá encontrar um erro. Confira se o recurso de destino não é uma dependência para seus aplicativos. 

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Selecione **Rastreadores** no painel de navegação à esquerda.

1. Em **Meus rastreadores**, selecione o rastreador de destino.

1. Selecione **Excluir rastreador**.

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

Use a `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)` operação do Amazon Location Tracker APIs. 

O exemplo a seguir é uma solicitação de API para excluir o rastreador{{ExampleTracker}}.

```
DELETE /tracking/v0/trackers/{{ExampleTracker}}
```

Este é um exemplo de resposta para `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)`: 

```
HTTP/1.1 200
```

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

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

O exemplo a seguir é um AWS CLI comando para excluir o rastreador{{ExampleTracker}}.

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

------