ApiUsagePlan

決定此用量計劃的設定方式。有效值為 PER_API、SHARED 和 NONE。

PER_API 會建立此 API 特有AWS::ApiGateway::UsagePlanKey的 AWS::ApiGateway::ApiKey、 AWS::ApiGateway::UsagePlan和資源。這些資源的邏輯 IDs 分別為 <api-logical-id>UsagePlanKey、 <api-logical-id>UsagePlan<api-logical-id>ApiKey和 。

SHARED 會建立 AWS::ApiGateway::UsagePlan、 AWS::ApiGateway::ApiKey和 AWS::ApiGateway::UsagePlanKey 資源，這些資源會在相同 AWS SAM 範本CreateUsagePlan: SHARED中也有 的任何 API 之間共用。這些資源的邏輯 IDs 分別為 ServerlessUsagePlanKey、 ServerlessUsagePlanServerlessApiKey和 。如果您使用此選項，我們建議您在單一 API 資源上僅新增此用量計劃的其他組態，以避免定義衝突和不確定狀態。

NONE 會停用用量計劃的建立或與此 API 的關聯。只有在 中指定 PER_API SHARED或 時，才需要這樣做範本的 AWS SAM 全域區段。

有效值：PER_API、SHARED 與 NONE

類型：字串

必要：是

CloudFormation 相容性：此屬性對 是唯一的 AWS SAM ，並且沒有 CloudFormation 同等的。

用量計劃的描述。

類型：字串

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::ApiGateway::UsagePlan 資源的 Description 屬性。

設定使用者可在指定間隔內發出的請求數。

類型：QuotaSettings

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::ApiGateway::UsagePlan 資源的 Quota 屬性。

要與用量計劃關聯的任意標籤陣列 (金鑰值對)。

此屬性使用 CloudFormation 標籤類型。

類型：清單

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::ApiGateway::UsagePlan 資源的 Tags 屬性。

設定整體請求速率 (每秒平均請求數) 和高載容量。

類型：ThrottleSettings

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::ApiGateway::UsagePlan 資源的 Throttle 屬性。

用量計劃的名稱。

類型：字串

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::ApiGateway::UsagePlan 資源的 UsagePlanName 屬性。