Configurazione delle quote

Questa pagina descrive come configurare le quote per la tua API in Cloud Endpoints Frameworks. Per una panoramica delle funzionalità fornite dalle quote, consulta Informazioni sulle quote.

Java

Nella procedura riportata di seguito si presuppone che tu abbia già:

Per configurare le quote nell'API:

  1. Nel file che contiene le annotazioni con ambito API, aggiungi quanto segue all'annotazione @Api:

    limitDefinitions = {
      @ApiLimitMetric(
        name = "YOUR_METRIC_NAME",
        displayName = "YOUR_METRIC_DISPLAY_NAME",
        limit = YOUR_QUOTA_LIMIT)
}
    • Sostituisci YOUR_METRIC_NAME con un nome che descriva il contatore delle richieste API.
    • Sostituisci YOUR_METRIC_DISPLAY_NAME con il testo visualizzato nella pagina Endpoint > Servizi > Quote per identificare la quota.

    • Sostituisci YOUR_QUOTA_LIMIT con un valore intero. È il numero di richieste che un'applicazione associata a un progetto di un consumatore può effettuare in un minuto. Google Cloud Ad esempio:

        @Api(
      name = "echo",
      version = "v1",
      namespace =
        @ApiNamespace(
          ownerDomain = "echo.example.com",
          ownerName = "echo.example.com",
          packagePath = ""
        ),
      limitDefinitions = {
        @ApiLimitMetric(
          name = "read-requests",
          displayName = "Read requests",
          limit = 1000),
        @ApiLimitMetric(
          name = "list-requests",
          displayName = "List requests",
          limit = 100),
        @ApiLimitMetric(
          name = "write-requests",
          displayName = "Write requests",
          limit = 50),
      }
  )

  2. Per ogni metodo a cui vuoi applicare una quota, aggiungi quanto segue all'annotazione @ApiMethod:

    metricCosts = {
             @ApiMetricCost(
               name ="YOUR_METRIC_NAME",
               cost = YOUR_COST)
}
    • Sostituisci YOUR_METRIC_NAME con un nome specificato nel parametro limitDefinitions nell'annotazione @Api.

    • Sostituisci YOUR_COST con un valore intero che specifichi il costo per ogni richiesta.

      Ad esempio:

        @ApiMethod(name = "echo",
             metricCosts = {
               @ApiMetricCost(
                 name = "read-requests",
                 cost = 1)
             })
  public Message echo(Message message, @Named("n") @Nullable Integer n) {
    // ...function code here...
  }

  3. Distribuisci l'API .

Consulta quanto riportato di seguito per ulteriori informazioni sulle annotazioni utilizzate nelle quote:

Python

Nella procedura riportata di seguito si presuppone che tu abbia già:

Per configurare le quote nell'API:

  1. Nel file che contiene il decoratore API, crea un elenco di istanze LimitDefinition, simile al seguente:

    quota_limits = [
  endpoints.LimitDefinition(
    "YOUR_METRIC_NAME",
    "YOUR_METRIC_DISPLAY_NAME",
    limit)
]
    • Sostituisci YOUR_METRIC_NAME con un nome che descriva il contatore delle richieste API.
    • Sostituisci YOUR_METRIC_DISPLAY_NAME con il testo visualizzato nella pagina Endpoint > Servizi > Quote per identificare la quota.

    • Sostituisci limit con un valore intero. Numero di richieste che un'applicazione associata a un progetto Google Cloud di un consumer può effettuare in un minuto. Ad esempio:

        quota_limits = [
    endpoints.LimitDefinition('read-requests', 'Read Requests', 1000),
    endpoints.LimitDefinition('list-requests', 'List Requests', 100),
    endpoints.LimitDefinition('write-requests', 'Write Requests', 50),
  ]

  2. Aggiungi la quota al decoratore API assegnandola all'argomento limit_definitions. Ad esempio:

      @endpoints.api(name='bookstore',
                 version='v1',
                 limit_definitions=quota_limits)

  3. Per ogni metodo a cui vuoi applicare una quota, assegna un dizionario all'argomento METRIC_COSTS del decoratore del metodo. La chiave deve essere un nome specificato nell'argomento limit_definitions del decoratore API e il valore è un numero intero che specifica il costo per ogni richiesta. Ad esempio:

      @endpoints.method(path='shelves/{shelf}',
                    http_method='GET',
                    metric_costs={'read-requests': 1})
  def get_shelf(self, request):
  # ...function code here...

  4. Distribuisci l'API .

Consulta quanto riportato di seguito per ulteriori informazioni sui decorator utilizzati nelle quote: