# API Gateway API 키 파일 형식
<a name="api-key-file-format"></a>

API Gateway는 쉼표로 분리된 값(CSV) 형식의 외부 파일에서 API 키를 가져온 다음, 가져온 키를 하나 이상의 사용량 계획과 연결할 수 있습니다. 가져온 파일에는 `Name` 및 `Key`열이 포함되어 있어야 합니다. 다음 예에서 보듯 열 헤더 이름은 대/소문자를 구분하지 않으며, 열 순서는 상관없습니다.

```
Key,name
apikey1234abcdefghij0123456789,MyFirstApiKey
```

`Key` 값은 20\$1128자여야 합니다. `Name` 값은 1024자를 초과할 수 없습니다.

또한 API 키 파일은 다음과 같이 `Description`열, `Enabled` 열 또는 `UsagePlanIds`열을 포함할 수 있습니다.

```
Name,key,description,Enabled,usageplanIds
MyFirstApiKey,apikey1234abcdefghij0123456789,An imported key,TRUE,c7y23b
```

키 1개가 둘 이상의 사용량 계획과 연결된 경우, 다음 예에서 보듯 `UsagePlanIds` 값은 큰따옴표나 작은따옴표로 묶인 사용량 계획 ID를 쉼표로 구분한 문자열입니다.

```
Enabled,Name,key,UsageplanIds
true,MyFirstApiKey,apikey1234abcdefghij0123456789,"c7y23b,glvrsr"
```

인식할 수 없는 열도 사용할 수 있지만 무시됩니다. 기본값은 빈 문자열 또는 `true` 부울 값입니다.

최신 버전으로 이전 버전을 덮어쓰면 동일한 API 키를 여러 번 가져올 수 있습니다. `key` 값이 동일한 경우 두 API 키는 동일합니다.

**참고**  
고려해야 할 모범 사례는 [API 키 및 사용량 계획의 위한 모범 사례](api-gateway-api-usage-plans.md#apigateway-usage-plans-best-practices) 섹션을 참조하세요.