Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Gestione flotas en IoT AWS FleetWise
Una flota representa un grupo de vehículos. Una flota sin vehículos asociados es una entidad vacía. Antes de poder utilizar una flota para administrar varios vehículos al mismo tiempo, debe asociar los vehículos a dicha flota. Un vehículo puede pertenecer a varias flotas. Puede controlar qué datos se recopilarán de una flota de vehículos y cuándo deberán recopilarse mediante la implementación de una campaña. Para obtener más información, consulte [Recopile FleetWise datos de AWS IoT con campañas](campaigns.md).
Una flota contiene la siguiente información:
`fleetId`
El ID de la flota.
(Opcional) `description`
Una descripción para ayudarlo a encontrar la flota.
`signalCatalogArn`
El nombre de recurso de Amazon (ARN) del catálogo de señales.
AWS El IoT FleetWise proporciona las siguientes operaciones de API que puede usar para crear y administrar flotas.
+ [CreateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateFleet.html)— Crea un grupo de vehículos que contienen el mismo grupo de señales.
+ [AssociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_AssociateVehicle.html)— Asocia un vehículo a una flota.
+ [DisassociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DisassociateVehicle.html)— Disocia un vehículo de una flota.
+ [UpdateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateFleet.html)— Actualiza la descripción de una flota existente.
+ [DeleteFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteFleet.html)— Elimina una flota existente.
+ [ListFleets](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleets.html)— Recupera una lista paginada de resúmenes de todas las flotas.
+ [ListFleetsForVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleetsForVehicle.html)— Recupera una lista paginada de todas las flotas a IDs las que pertenece el vehículo.
+ [ListVehiclesInFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehiclesInFleet.html)— Recupera una lista paginada de resúmenes de todos los vehículos de una flota.
+ [GetFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetFleet.html)— Recupera información sobre una flota.
**Topics**
+ [Cree una FleetWise flota AWS de IoT](create-fleet-cli.md)
+ [Asocie un FleetWise vehículo de AWS IoT a una flota](associate-vehicle-cli.md)
+ [Disociar un FleetWise vehículo de AWS IoT de una flota](disassociate-vehicle-cli.md)
+ [Actualice una FleetWise flota AWS de IoT](update-fleet-cli.md)
+ [Eliminar una FleetWise flota AWS de IoT](delete-fleet-cli.md)
+ [Obtenga información sobre la FleetWise flota de AWS IoT](get-fleet-information-cli.md)
# Cree una FleetWise flota AWS de IoT
Puede utilizar la operación de la [CreateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateFleet.html)API para crear una flota de vehículos. En el siguiente ejemplo se utiliza AWS CLI.
**importante**
Para poder crear una flota, debe disponer de un catálogo de señales. Para obtener más información, consulte [Cree un catálogo AWS de FleetWise señales de IoT](create-signal-catalog.md).
Para crear una flota, ejecute el siguiente comando:
+ *fleet-id*Reemplácelo por el ID de la flota que está creando.
El ID de la flota debe ser único y debe tener entre 1 y 100 caracteres. Caracteres válidos: letras (A-Z y a-z), números (0-9), dos puntos (:), guiones (-) y guiones bajos (\$1).
+ (Opcional) *description* Sustitúyalo por una descripción.
La descripción puede contener entre 1 y 2048 caracteres.
+ *signal-catalog-arn*Sustitúyalo por el ARN del catálogo de señales.
```
aws iotfleetwise create-fleet \
--fleet-id fleet-id \
--description description \
--signal-catalog-arn signal-catalog-arn
```
Si [habilitó el cifrado](key-management.md) mediante una AWS KMS clave administrada por el cliente, incluya la siguiente declaración de política para que su función pueda invocar la operación de la `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"
]
}
]
}
```
------
# Asocie un FleetWise vehículo de AWS IoT a una flota
Puede utilizar la operación de la [AssociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_AssociateVehicle.html)API para asociar un vehículo a una flota. En el siguiente ejemplo se utiliza AWS CLI.
**importante**
Para poder asociar un vehículo a una flota, debe disponer de un vehículo y de una flota. Para obtener más información, consulte [Administre FleetWise vehículos de AWS IoT](vehicles.md).
Si asocias un vehículo a una flota a la que apunta una campaña, el AWS IoT despliega FleetWise automáticamente la campaña en el vehículo.
Para asociar un vehículo a una flota, ejecute el siguiente comando:
+ *fleet-id*Sustitúyala por el identificador de la flota.
+ *vehicle-name*Sustitúyalo por el identificador del vehículo.
```
aws iotfleetwise associate-vehicle-fleet --fleet-id fleet-id --vehicle-name vehicle-name
```
Si has [activado el cifrado](key-management.md) mediante una AWS KMS clave gestionada por el cliente, incluye la siguiente declaración de política para que tu función pueda invocar la operación de la `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"
]
}
]
}
```
------
# Disociar un FleetWise vehículo de AWS IoT de una flota
Puede utilizar la operación de la [DisassociateVehicleFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DisassociateVehicle.html)API para desvincular un vehículo de una flota. En el siguiente ejemplo se utiliza AWS CLI.
Para anular la asociación de un vehículo a una flota, ejecute el siguiente comando:
+ *fleet-id*Sustitúyalo por el identificador de la flota.
+ *vehicle-name*Sustitúyalo por el identificador del vehículo.
```
aws iotfleetwise disassociate-vehicle-fleet --fleet-id fleet-id --vehicle-name vehicle-name
```
Si has [activado el cifrado](key-management.md) mediante una AWS KMS clave gestionada por el cliente, incluye la siguiente declaración de política para que tu función pueda invocar la operación de la `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"
]
}
]
}
```
------
# Actualice una FleetWise flota AWS de IoT
Puede utilizar la operación de la [UpdateFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateFleet.html)API para actualizar la descripción de una flota. El siguiente ejemplo utiliza AWS CLI.
Para actualizar una flota, ejecute el siguiente comando:
+ *fleet-id*Sustitúyala por el ID de la flota que estás actualizando.
+ *description*Sustitúyala por una nueva descripción.
La descripción puede contener entre 1 y 2048 caracteres.
```
aws iotfleetwise update-fleet --fleet-id fleet-id --description description
```
Si has [activado el cifrado](key-management.md) mediante una AWS KMS clave gestionada por el cliente, incluye la siguiente declaración de política para que tu función pueda invocar la operación de la `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"
]
}
]
}
```
------
# Eliminar una FleetWise flota AWS de IoT
Puede utilizar la operación de la [DeleteFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteFleet.html)API para eliminar una flota. En el siguiente ejemplo se utiliza AWS CLI.
**importante**
Antes de eliminar una flota, asegúrese de que no tenga vehículos asociados. Para obtener instrucciones acerca de cómo anular la asociación de un vehículo a una flota, consulte [Disociar un FleetWise vehículo de AWS IoT de una flota](disassociate-vehicle-cli.md).
Para eliminar una flota, ejecute el siguiente comando:
*fleet-id*Sustitúyalo por el identificador de la flota que vas a eliminar.
```
aws iotfleetwise delete-fleet --fleet-id fleet-id
```
## Verifica la eliminación de la flota
Puedes usar la operación de la [ListFleets](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleets.html)API para verificar si se ha eliminado una flota. El siguiente ejemplo utiliza AWS CLI.
Para recuperar una lista paginada de resúmenes de todas las flotas, ejecute el siguiente comando:
```
aws iotfleetwise list-fleets
```
Si has [activado el cifrado](key-management.md) mediante una AWS KMS clave gestionada por el cliente, incluye la siguiente declaración de política para que tu función pueda invocar la operación de la `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"
]
}
]
}
```
------
# Obtenga información sobre la FleetWise flota de AWS IoT
Puedes usar la operación de la [ListFleetsForVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListFleetsForVehicle.html)API para recuperar una lista paginada IDs de todas las flotas a las que pertenece el vehículo. El siguiente ejemplo utiliza AWS CLI.
Para recuperar una lista paginada IDs de todas las flotas a las que pertenece el vehículo, ejecuta el siguiente comando.
*vehicle-name*Sustitúyala por la ID del vehículo.
```
aws iotfleetwise list-fleets-for-vehicle \
--vehicle-name vehicle-name
```
Si has [activado el cifrado](key-management.md) mediante una AWS KMS clave gestionada por el cliente, incluye la siguiente declaración de política para que tu función pueda invocar la operación de la `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"
]
}
]
}
```
------
Puede utilizar la operación de la [ListVehiclesInFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehiclesInFleet.html)API para recuperar una lista paginada de resúmenes de todos los vehículos de una flota. El siguiente ejemplo utiliza AWS CLI.
Para recuperar una lista paginada de resúmenes de todos los vehículos de una flota, ejecute el siguiente comando:
*fleet-id*Sustitúyala por la ID de la flota.
```
aws iotfleetwise list-vehicles-in-fleet \
--fleet-id fleet-id
```
Si has [activado el cifrado](key-management.md) mediante una AWS KMS clave gestionada por el cliente, incluye la siguiente declaración de política para que tu función pueda invocar la operación de la `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"
]
}
]
}
```
------
Puedes usar la operación de la [GetFleet](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetFleet.html)API para recuperar la información de la flota. El siguiente ejemplo utiliza AWS CLI.
Para recuperar los metadatos de una flota, ejecute el siguiente comando:
*fleet-id*Sustitúyala por la ID de la flota.
```
aws iotfleetwise get-fleet \
--fleet-id fleet-id
```
**nota**
Esta operación es [a largo plazo coherente](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). En otras palabras, los cambios que se hagan en la flota podrían no reflejarse inmediatamente.
Si has [activado el cifrado](key-management.md) mediante una AWS KMS clave gestionada por el cliente, incluye la siguiente declaración de política para que tu función pueda invocar la operación de la `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"
]
}
]
}
```
------