ApiUsagePlan - AWS Serverless Application Model
SyntaxEigenschaftenBeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

ApiUsagePlan

Konfiguriert einen Nutzungsplan für eine API-Gateway-API. Weitere Informationen zu Nutzungsplänen finden Sie unter Nutzungspläne mit API-Schlüsseln erstellen und verwenden im API Gateway Developer Guide.

Syntax

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) zu deklarieren.

Eigenschaften

CreateUsagePlan

Legt fest, wie dieser Nutzungsplan konfiguriert ist. Gültige Werte sind PER_API, SHARED und NONE.

PER_APIerstellt AWS::ApiGateway::UsagePlan, AWS::ApiGateway::ApiKey, und AWS::ApiGateway::UsagePlanKeyRessourcen, die für diese API spezifisch sind. Diese Ressourcen haben IDs den logischen Wert von <api-logical-id>UsagePlan <api-logical-id>ApiKey<api-logical-id>UsagePlanKey, und.

SHAREDerzeugt AWS::ApiGateway::UsagePlan, AWS::ApiGateway::ApiKey, und AWS::ApiGateway::UsagePlanKeyRessourcen, die von allen APIs gemeinsam genutzt werden, die auch CreateUsagePlan: SHARED in derselben AWS SAM Vorlage enthalten sind. Diese Ressourcen haben IDs den logischen Wert von ServerlessUsagePlan ServerlessApiKeyServerlessUsagePlanKey, und. Wenn Sie diese Option verwenden, empfehlen wir, zusätzliche Konfigurationen für diesen Nutzungsplan nur für eine API-Ressource hinzuzufügen, um widersprüchliche Definitionen und einen unsicheren Status zu vermeiden.

NONEdeaktiviert die Erstellung oder Verknüpfung eines Nutzungsplans mit dieser API. Dies ist nur erforderlich, wenn SHARED oder in der Abschnitt „Globals“ der Vorlage AWS SAM angegeben PER_API ist.

Zulässige Werte: PER_API, SHARED und NONE

Typ: Zeichenfolge

Erforderlich: Ja

CloudFormation Kompatibilität: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

Description

Eine Beschreibung des Nutzungsplans.

Typ: Zeichenfolge

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Description Eigenschaft einer AWS::ApiGateway::UsagePlan Ressource übergeben.

Quota

Konfiguriert die Anzahl von Anforderungen, die Benutzer innerhalb eines bestimmten Intervalls vornehmen können.

Typ: QuotaSettings

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Quota Eigenschaft einer AWS::ApiGateway::UsagePlan Ressource übergeben.

Tags

Ein Array an beliebigen Tags (Schlüssel-Wert-Paaren), die dem Nutzungsplan zugewiesen werden sollen.

Diese Eigenschaft verwendet den CloudFormation Tag-Typ.

Typ: Liste

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Tags Eigenschaft einer AWS::ApiGateway::UsagePlan Ressource übergeben.

Throttle

Konfiguriert die gesamte Anforderungsrate (durchschnittliche Anforderungen pro Sekunde) und die Steigerungskapazität.

Typ: ThrottleSettings

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Throttle Eigenschaft einer AWS::ApiGateway::UsagePlan Ressource übergeben.

UsagePlanName

Ein Name für den Nutzungsplan.

Typ: Zeichenfolge

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die UsagePlanName Eigenschaft einer AWS::ApiGateway::UsagePlan Ressource übergeben.

Beispiele

UsagePlan

Im Folgenden finden Sie ein Beispiel für einen Nutzungsplan.

YAML

Auth:
  UsagePlan:
    CreateUsagePlan: PER_API
    Description: Usage plan for this API
    Quota:
      Limit: 500
      Period: MONTH
    Throttle:
      BurstLimit: 100
      RateLimit: 50
    Tags:
      - Key: TagName
        Value: TagValue