ebeb15460c
Asciidoc may fail to render link attributes for external links supposed to open in a new window correctly. This change adds :linkattrs: to the beginning of such files to force parsing link attributes correctly. Bug: Issue 12068 Change-Id: If18be60de646ff78f672239dd4fa435fd4fd92ab
52 lines
1.9 KiB
Plaintext
52 lines
1.9 KiB
Plaintext
:linkattrs:
|
|
= Gerrit Code Review - Quota
|
|
|
|
Gerrit does not provide out of the box quota enforcement. However, it does
|
|
support an extension mechanism for plugins to hook into to provide this
|
|
functionality. The most prominent plugin is the
|
|
link:https://gerrit.googlesource.com/plugins/quota/[Quota Plugin,role=external,window=_blank].
|
|
|
|
This documentation is intended to be read by plugin developers. It contains all
|
|
quota requests implemented in Gerrit-core as well as the metadata that they have
|
|
associated.
|
|
|
|
== Quota Groups
|
|
|
|
The following quota groups are defined in core Gerrit:
|
|
|
|
=== REST API
|
|
[[rest-api]]
|
|
|
|
The REST API enforces quota after the resource was parsed (if applicable) and before the
|
|
endpoint's logic is executed. This enables quota enforcer implementations to throttle calls
|
|
to specific endpoints while knowing the general context (user and top-level entity such as
|
|
change, project or account).
|
|
|
|
If the quota enforcer wants to throttle HTTP requests, they should use
|
|
link:quota.html#http-requests[HTTP Requests] instead.
|
|
|
|
The quota groups used for checking follow the exact definition of the endoint in the REST
|
|
API, but remove all IDs. The schema is:
|
|
|
|
/restapi/<ENDPOINT>:<HTTP-METHOD>
|
|
|
|
Examples:
|
|
|
|
[options="header",cols="1,6"]
|
|
|=======================
|
|
|HTTP call |Quota Group |Metadata
|
|
|GET /a/changes/1/revisions/current/detail |/changes/revisions/detail:GET |CurrentUser, Change.Id, Project.NameKey
|
|
|POST /a/changes/ |/changes/:POST |CurrentUser
|
|
|GET /a/accounts/self/detail |/accounts/detail:GET |CurrentUser, Account.Id
|
|
|=======================
|
|
|
|
The user provided in the check's metadata is always the calling user (having the
|
|
impersonation bit and real user set in case the user is impersonating another user).
|
|
|
|
GERRIT
|
|
------
|
|
Part of link:index.html[Gerrit Code Review]
|
|
|
|
SEARCHBOX
|
|
---------
|