本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
API Gateway API金鑰檔案格式
API Gateway 可以從逗號分隔值 (CSV) 格式的外部檔案匯入API金鑰,然後將匯入的金鑰與一或多個使用計畫建立關聯。匯入的檔案必須包含 Name
與 Key
欄位。欄標頭名稱不區分大小寫,各欄順序任意排列,如以下範例所示:
Key,name apikey1234abcdefghij0123456789,MyFirstApiKey
Key
值必須介於 20 到 128 個字元之間。Name
值不能超過 1024 個字元。
API 金鑰檔案也可以具有 Description
、 Enabled
或 UsagePlanIds
資料欄,如下列範例所示:
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 金鑰和用量計畫的最佳實務。