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 frotas na IoT AWS FleetWise
Uma frota representa um grupo de veículos. Uma frota sem veículos associados é uma entidade vazia. Antes de poder usar a frota para gerenciar vários veículos ao mesmo tempo, você deve associar os veículos à frota. Um veículo pode pertencer a várias frotas. Você pode controlar quais dados coletar de uma frota de veículos e quando coletar dados implantando uma campanha. Para obter mais informações, consulte [Colete FleetWise dados de AWS IoT com campanhas](campaigns.md).
Uma frota contém as seguintes informações.
`fleetId`
O ID da frota.
(Optional) `description`
Uma descrição que ajuda você a encontrar a frota.
`signalCatalogArn`
O nome de recurso da Amazon (ARN) do catálogo de sinais.
AWS A IoT FleetWise fornece as seguintes operações de API que você pode usar para criar e gerenciar frotas.
+ [CreateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateFleet.html)— Cria um grupo de veículos que contêm o mesmo grupo de sinais.
+ [AssociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_AssociateVehicle.html)— Associa um veículo a uma frota.
+ [DisassociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DisassociateVehicle.html)— Desassocia um veículo de uma frota.
+ [UpdateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateFleet.html)— Atualiza a descrição de uma frota existente.
+ [DeleteFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteFleet.html)— Exclui uma frota existente.
+ [ListFleets](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleets.html)— Recupera uma lista paginada de resumos de todas as frotas.
+ [ListFleetsForVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleetsForVehicle.html)— Recupera uma lista paginada IDs de todas as frotas às quais o veículo pertence.
+ [ListVehiclesInFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehiclesInFleet.html)— Recupera uma lista paginada de resumos de todos os veículos em uma frota.
+ [GetFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetFleet.html)— Recupera informações sobre uma frota.
**Topics**
+ [Crie uma frota AWS de IoT FleetWise](create-fleet-cli.md)
+ [Associe um FleetWise veículo de AWS IoT a uma frota](associate-vehicle-cli.md)
+ [Desassociar um veículo AWS de FleetWise IoT de uma frota](disassociate-vehicle-cli.md)
+ [Atualize uma frota AWS de IoT FleetWise](update-fleet-cli.md)
+ [Excluir uma frota AWS de IoT FleetWise](delete-fleet-cli.md)
+ [Obtenha informações sobre AWS a frota de IoT FleetWise](get-fleet-information-cli.md)
# Crie uma frota AWS de IoT FleetWise
Você pode usar a operação [CreateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateFleet.html)da API para criar uma frota de veículos. O exemplo a seguir usa AWS CLI.
**Importante**
Você deve ter um catálogo de sinais antes de poder criar uma frota. Para obter mais informações, consulte [Crie um catálogo de AWS sinais de IoT FleetWise](create-signal-catalog.md).
Para criar uma frota, execute o seguinte comando.
+ *fleet-id*Substitua pela ID da frota que você está criando.
O ID da frota deve ser exclusivo e ter de 1 a 100 caracteres. Caracteres válidos: letras (A–Z e a–z), números (0–9), dois pontos (:), hífens (-) e sublinhados (\$1).
+ (Opcional) *description* Substitua por uma descrição.
A descrição pode conter de 1 a 2.048 caracteres.
+ *signal-catalog-arn*Substitua pelo ARN do catálogo de sinais.
```
aws iotfleetwise create-fleet \
--fleet-id fleet-id \
--description description \
--signal-catalog-arn signal-catalog-arn
```
Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `CreateFleet` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Associe um FleetWise veículo de AWS IoT a uma frota
Você pode usar a operação [AssociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_AssociateVehicle.html)da API para associar um veículo a uma frota. O exemplo a seguir usa AWS CLI.
**Importante**
Você deve ter um veículo e uma frota antes de poder associar um veículo a uma frota. Para obter mais informações, consulte [Gerencie AWS veículos de IoT FleetWise](vehicles.md).
Se você associar um veículo a uma frota que é alvo de uma campanha, a AWS IoT implanta FleetWise automaticamente a campanha no veículo.
Para associar um veículo a uma frota, execute o seguinte comando.
+ *fleet-id*Substitua pelo ID da frota.
+ *vehicle-name*Substitua pela ID do veículo.
```
aws iotfleetwise associate-vehicle-fleet --fleet-id fleet-id --vehicle-name vehicle-name
```
Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `AssociateVehicleFleet` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Desassociar um veículo AWS de FleetWise IoT de uma frota
Você pode usar a operação [DisassociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DisassociateVehicle.html)da API para desassociar um veículo de uma frota. O exemplo a seguir usa AWS CLI.
Para desassociar um veículo de uma frota, execute o seguinte comando.
+ *fleet-id*Substitua pelo ID da frota.
+ *vehicle-name*Substitua pela ID do veículo.
```
aws iotfleetwise disassociate-vehicle-fleet --fleet-id fleet-id --vehicle-name vehicle-name
```
Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `DisassociateVehicleFleet` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Atualize uma frota AWS de IoT FleetWise
Você pode usar a operação [UpdateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateFleet.html)da API para atualizar a descrição de uma frota. O exemplo a seguir usa AWS CLI.
Para atualizar uma frota, execute o comando a seguir.
+ *fleet-id*Substitua pela ID da frota que você está atualizando.
+ *description*Substitua por uma nova descrição.
A descrição pode conter de 1 a 2.048 caracteres.
```
aws iotfleetwise update-fleet --fleet-id fleet-id --description description
```
Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `UpdateFleet` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Excluir uma frota AWS de IoT FleetWise
Você pode usar a operação [DeleteFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteFleet.html)da API para excluir uma frota. O exemplo a seguir usa AWS CLI.
**Importante**
Antes de excluir uma frota, confirme se ela não tem veículos associados. Para obter instruções sobre como desassociar um veículo de uma frota, consulte [Desassociar um veículo AWS de FleetWise IoT de uma frota](disassociate-vehicle-cli.md).
Para excluir uma frota, execute o comando a seguir.
*fleet-id*Substitua pela ID da frota que você está excluindo.
```
aws iotfleetwise delete-fleet --fleet-id fleet-id
```
## Verificar a exclusão da frota
Você pode usar a operação [ListFleets](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleets.html)da API para verificar se uma frota foi excluída. O exemplo a seguir usa a AWS CLI.
Para recuperar uma lista paginada de resumos de todas as frotas, execute o comando a seguir.
```
aws iotfleetwise list-fleets
```
Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `ListFleets` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Obtenha informações sobre AWS a frota de IoT FleetWise
Você pode usar a operação da [ListFleetsForVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleetsForVehicle.html)API para recuperar uma lista paginada IDs de todas as frotas às quais o veículo pertence. O exemplo a seguir usa a AWS CLI.
Para recuperar uma lista paginada IDs de todas as frotas às quais o veículo pertence, execute o comando a seguir.
*vehicle-name*Substitua pela ID do veículo.
```
aws iotfleetwise list-fleets-for-vehicle \
--vehicle-name vehicle-name
```
Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `ListFleetsForVehicle` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
Você pode usar a operação da [ListVehiclesInFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehiclesInFleet.html)API para recuperar uma lista paginada de resumos de todos os veículos em uma frota. O exemplo a seguir usa a AWS CLI.
Para recuperar uma lista paginada de resumos de todos os veículos de uma frota, execute o seguinte comando.
*fleet-id*Substitua pelo ID da frota.
```
aws iotfleetwise list-vehicles-in-fleet \
--fleet-id fleet-id
```
Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `ListVehiclesInFleet` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
Você pode usar a operação [GetFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetFleet.html)da API para recuperar informações da frota. O exemplo a seguir usa a AWS CLI.
Para recuperar os metadados de uma frota, execute o comando a seguir.
*fleet-id*Substitua pelo ID da frota.
```
aws iotfleetwise get-fleet \
--fleet-id fleet-id
```
**nota**
Essa operação é [eventualmente consistente](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). Em outras palavras, as alterações na frota podem não ser refletidas imediatamente.
Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `GetFleet` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------