API Gateway API金鑰檔案格式 - Amazon API Gateway

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

API Gateway API金鑰檔案格式

API Gateway 可以從逗號分隔值 (CSV) 格式的外部檔案匯入API金鑰,然後將匯入的金鑰與一或多個使用計畫建立關聯。匯入的檔案必須包含 NameKey 欄位。欄標頭名稱不區分大小寫,各欄順序任意排列,如以下範例所示:

Key,name apikey1234abcdefghij0123456789,MyFirstApiKey

Key 值必須介於 20 到 128 個字元之間。Name 值不能超過 1024 個字元。

API 金鑰檔案也可以具有 DescriptionEnabledUsagePlanIds資料欄,如下列範例所示:

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

當索引鍵與多個使用計畫相關聯時,該UsagePlanIds值是使用計畫 的逗號分隔字串IDs,以雙引號或單引號括住,如下列範例所示:

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

允許無法識別的欄位,但會被忽略。預設值為空白字串或 true 布林值。

相同的API金鑰可以匯入多次,最新版本會覆寫先前的金鑰。如果兩個API索引鍵具有相同的key值,則它們是相同的。

注意

如需考量最佳實務,請參閱 API 金鑰和用量計畫的最佳實務