What values can I use for _entity_access in a configuration entity I am developing?

Question

Looking at search.routing.yml, I noticed it contains the following code.

entity.search_page.enable:
  path: '/admin/config/search/pages/manage/{search_page}/enable'
  defaults:
    _controller: '\Drupal\search\Controller\SearchController::performOperation'
    op: 'enable'
  requirements:
    _entity_access: 'search_page.update'
    _csrf_token: 'TRUE'

entity.search_page.disable:
  path: '/admin/config/search/pages/manage/{search_page}/disable'
  defaults:
    _controller: '\Drupal\search\Controller\SearchController::performOperation'
    op: 'disable'
  requirements:
    _entity_access: 'search_page.disable'
    _csrf_token: 'TRUE'

While it's clear that the first part of the _entity_access value is the ID of the configuration entity used in the annotation for the class implementing it, I don't understand what I can use as part after the dot. Is it restricted to a set of values (e.g. add, update, use, delete), or is it a value the access controller class for that entity handle?

Answer 1

According to the Drupal 8 documentation:

_entity_access: In the case where an entity is part of a route, can check a certain access level before granting access (e.g., _entity_access: 'node.view').

The part after the dot is the type of access you want to check on the entity. To find the full set of possible values, you have to look at the code of the entity (in your case, in \Drupal\search\Entity\SearchPage). The default possible values are view, update, delete, create. Entities implemented by SearchPage can also be disabled and enabled. (See search.routing.yml and SearchController.)

See also EntityAccessCheck::access().