

AWS IoT FleetWise는 2026년 4월 30일부터 신규 고객에게 더 이상 공개되지 않습니다. 기존 AWS IoT FleetWise 고객은 서비스를 계속 사용할 수 있습니다. [의 Connected Mobility 지침은 AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) AWS IoT FleetWise와 동등한 기능을 달성하는 데 사용할 수 있는 커넥티드 모빌리티 솔루션을 위한 모듈식 서비스를 개발하고 배포하는 방법에 대한 지침을 제공합니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS IoT FleetWise 차량 생성
<a name="create-vehicle"></a>

**중요**  
특정 AWS IoT FleetWise 기능에 대한 액세스는 현재 게이트됩니다. 자세한 내용은 [AWS AWS IoT FleetWise의 리전 및 기능 가용성](fleetwise-regions.md) 단원을 참조하십시오.

 AWS IoT FleetWise 콘솔 또는 API를 사용하여 차량을 생성할 수 있습니다.

**중요**  
시작하기 전에 다음 사항에 유의하세요.  
차량 모델이 있어야 하고 차량 모델이 `ACTIVE` 상태여야 합니다. 자세한 내용은 [Manage AWS IoT FleetWise 차량 모델차량 모델](vehicle-models.md) 단원을 참조하십시오.
차량 모델은 디코더 매니페스트와 연결되어야 하고 디코더 매니페스트는 `ACTIVE` 상태여야 합니다. 자세한 내용은 [Manage AWS IoT FleetWise 디코더 매니페스트](decoder-manifests.md) 단원을 참조하십시오.

**Topics**
+ [차량 생성 (콘솔)](#create-vehicle-console)
+ [차량 생성(AWS CLI)](#create-vehicle-cli)

## 차량 생성 (콘솔)
<a name="create-vehicle-console"></a>

 AWS IoT FleetWise 콘솔을 사용하여 차량을 생성할 수 있습니다.

**차량을 생성하려는 경우**

1. [AWS IoT FleetWise 콘솔](https://console.aws.amazon.com/iotfleetwise)을 엽니다.

1. 탐색 창에서 **차량**을 선택합니다.

1. 차량 요약 페이지에서 **차량 생성**을 선택하고 다음 단계를 수행합니다.

**Topics**
+ [1단계: 차량 속성 정의](#define-vehicle-properties-console)
+ [2단계: 차량 인증서 구성](#define-vehicle-certificate-console)
+ [3단계: 인증서에 정책 연결](#attach-vehicle-policy-console)
+ [4단계: 검토 및 생성](#review-and-create-vehicle-console)

### 1단계: 차량 속성 정의
<a name="define-vehicle-properties-console"></a>

이 단계에서는 차량 이름을 지정하고 모델 매니페스트 및 디코더 매니페스트와 연결합니다.

1. 차량의 고유한 이름을 입력합니다.
**중요**  
차량은 AWS IoT 사물에 해당합니다. 해당 이름의 사물이 이미 있는 경우 **차량을 IoT 사물에 연결**을 선택하여 헤딩 차량으로 사물을 업데이트합니다. 또는 다른 차량 이름을 선택하면 AWS IoT FleetWise가 차량에 대한 새 사물을 자동으로 생성합니다.

1. 목록에서 차량 모델(모델 매니페스트)을 선택합니다.

1. 목록에서 디코더 매니페스트를 선택합니다. 디코더 매니페스트는 차량 모델과 연결됩니다.

1. (선택 사항) 차량 속성을 연결하려면 **속성 추가**를 선택합니다. 이 단계를 건너뛰면 차량이 생성된 후 속성을 추가해야 캠페인에 배포할 수 있습니다.

1. (선택 사항) 태그를 차량에 연결하려면 **새 태그 추가**를 선택합니다. 차량을 만든 후에도 태그를 추가할 수 있습니다.

1. **다음**을 선택합니다.

### 2단계: 차량 인증서 구성
<a name="define-vehicle-certificate-console"></a>

차량을 AWS IoT 사물로 사용하려면 정책이 연결된 차량 인증서를 구성해야 합니다. 이 단계를 건너뛰면 차량이 생성된 후 인증서를 구성해야 캠페인에 배포할 수 있습니다.

1. **신규 인증서 자동 생성(권장)**을 선택합니다.

1. **다음**을 선택합니다.

### 3단계: 인증서에 정책 연결
<a name="attach-vehicle-policy-console"></a>

이전 단계에서 구성한 인증서에 정책을 연결합니다.

1. **정책**의 경우 기존 정책 이름을 입력합니다. 새 정책을 생성하려면, **정책 생성**을 선택합니다.

1. **다음**을 선택합니다.

### 4단계: 검토 및 생성
<a name="review-and-create-vehicle-console"></a>

차량 구성을 확인한 다음 **차량 생성**을 선택합니다.

**중요**  
차량을 생성한 후에는 인증서와 키를 다운로드해야 합니다. 인증서와 프라이빗 키를 사용하여 Edge Agent for AWS IoT FleetWise 소프트웨어에서 차량을 연결합니다.

## 차량 생성(AWS CLI)
<a name="create-vehicle-cli"></a>

차량을 만들 때는 디코더 매니페스트와 연결된 차량 모델을 사용해야 합니다. [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html) API 작업을 사용하여 차량을 생성할 수도 있습니다. 다음 예제에서는 AWS CLI를 사용합니다.

차량을 생성하려면 다음 명령을 실행합니다.

*file-name*을 차량 구성이 포함된 .json 파일의 이름으로 바꿉니다.

```
aws iotfleetwise create-vehicle --cli-input-json file://file-name.json
```

**Example - 차량 구성**  
+ (선택 사항) `associationBehavior` 값은 다음 중 하나일 수 있습니다.
  + `CreateIotThing` - 차량이 생성되면 AWS IoT FleetWise는 차량의 차량 ID 이름으로 AWS IoT 사물을 자동으로 생성합니다.
  + `ValidateIotThingExists`— 기존 사물을 사용하여 AWS IoT 차량을 만들 수 있습니다.

     AWS IoT 사물을 생성하려면 다음 명령을 실행합니다. *사물 이름*을 만들고 싶은 사물의 이름으로 바꾸세요.

    ```
    aws iot create-thing --thing-name thing-name
    ```

  지정하지 않으면 AWS IoT FleetWise가 차량에 대한 AWS IoT 사물을 자동으로 생성합니다.
**중요**  
차량이 생성된 후 AWS IoT 사물이 프로비저닝되었는지 확인합니다. 자세한 내용은 [Provision AWS IoT FleetWise 차량](provision-vehicles.md) 단원을 참조하십시오.
+ *vehicle-name*을 다음 중 하나로 바꾸세요.
  + 가 로 구성된 경우 AWS IoT 사물의 이름`associationBehavior`입니다`ValidateIotThingExists`.
  + `associationBehavior`가 `CreateIotThing`으로 구성된 경우 생성할 차량 ID입니다.

    차량 ID는 1\$1100자일 수 있습니다. 유효한 문자: a–z, A–Z, 0–9, 대쉬 (‐), 밑줄 (\$1), 및 콜론 (:).
+ *model-manifest-ARN*을 차량 모델(모델 매니페스트)의 ARN으로 교체합니다.
+ *decoder-manifest-ARN*을 지정된 차량 모델과 관련된 디코더 매니페스트의 ARN으로 교체합니다.
+ (선택 사항) 속성을 추가하여 이 차량을 동일한 차량 모델에서 만든 다른 차량과 구별할 수 있습니다. 예를 들어 전기 자동차를 사용하는 경우 속성에 다음 값을 지정할 수 있습니다: `{"fuelType": "electric"}`.
**중요**  <a name="update-attributes-requirement"></a>
속성을 개별 차량에 추가하려면 먼저 관련 차량 모델에서 속성을 정의해야 합니다.

```
{
    "associationBehavior": "associationBehavior",
    "vehicleName": "vehicle-name", 
    "modelManifestArn": "model-manifest-ARN",
    "decoderManifestArn": "decoder-manifest-ARN",           
    "attributes": {
        "key": "value"
    }
}
```

**Example - 상태 템플릿을 차량과 연결**  
[상태 템플릿을](state-templates.md) 차량과 연결하여 `stateTemplates` 필드를 사용하여 클라우드의 차량에서 상태 업데이트를 수집할 수 있습니다.  
이 예제에서는 다음 중 하나일 `stateTemplateUpdateStrategy` 수 있습니다.  
+ `periodic`: Edge Agent 소프트웨어가 클라우드에 신호 업데이트를 전송하는 고정 속도를 지정할 수 있습니다(Edge Agent 소프트웨어는 업데이트 간에 신호 값이 변경되지 않은 경우에도 업데이트를 전송합니다).
+ `onChange`: Edge Agent 소프트웨어는 신호가 변경될 때마다 신호 업데이트를 전송합니다.

```
aws iotfleetwise create-vehicle --cli-input-json file://create-vehicle.json
```
`create-vehicle.json` 파일에 포함된 위치(예:):  

```
{
    "associationBehavior": "associationBehavior",
    "vehicleName": "vehicle-name", 
    "modelManifestArn": "model-manifest-ARN",
    "decoderManifestArn": "decoder-manifest-ARN",           
    "attributes": {
        "key": "value"
    },
    "stateTemplates": [ 
        {
            "identifier": "state-template-name",
            "stateTemplateUpdateStrategy": {
                "periodic": {
                    "stateTemplateUpdateRate": {
                        "unit": "SECOND",
                        "value": 10
                    }
                }
            }
        }
    ]
}
```

고객 관리형 AWS KMS 키를 사용하여 [암호화를 활성화](key-management.md)한 경우 역할이 `CreateVehicle` 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"
            ]
        }
    ]
}
```

------