Predefined IAM roles

This page applies to Apigee and Apigee hybrid.

Predefined roles give granular access to specific Google Cloud resources. These roles are created and maintained by Google. Google automatically updates their permissions as necessary, such as when Google Cloud adds new features or services.

The following table lists all the predefined IAM roles for API hub:

IAM role Granted permissions
Role Permissions

(roles/apihub.admin)

Full access to all API hub resources.

apihub.*

  • apihub.apiHubInstances.create
  • apihub.apiHubInstances.delete
  • apihub.apiHubInstances.get
  • apihub.apiHubInstances.list
  • apihub.apiOperations.create
  • apihub.apiOperations.delete
  • apihub.apiOperations.get
  • apihub.apiOperations.list
  • apihub.apiOperations.update
  • apihub.apis.create
  • apihub.apis.createTagBinding
  • apihub.apis.delete
  • apihub.apis.deleteTagBinding
  • apihub.apis.get
  • apihub.apis.list
  • apihub.apis.listEffectiveTags
  • apihub.apis.listTagBindings
  • apihub.apis.update
  • apihub.attributes.create
  • apihub.attributes.delete
  • apihub.attributes.get
  • apihub.attributes.list
  • apihub.attributes.update
  • apihub.curations.create
  • apihub.curations.delete
  • apihub.curations.get
  • apihub.curations.list
  • apihub.curations.update
  • apihub.definitions.get
  • apihub.definitions.list
  • apihub.definitions.update
  • apihub.dependencies.create
  • apihub.dependencies.delete
  • apihub.dependencies.get
  • apihub.dependencies.list
  • apihub.dependencies.update
  • apihub.deployments.create
  • apihub.deployments.createTagBinding
  • apihub.deployments.delete
  • apihub.deployments.deleteTagBinding
  • apihub.deployments.get
  • apihub.deployments.list
  • apihub.deployments.listEffectiveTags
  • apihub.deployments.listTagBindings
  • apihub.deployments.update
  • apihub.discoveredApiObservations.get
  • apihub.discoveredApiObservations.list
  • apihub.discoveredApiOperations.get
  • apihub.discoveredApiOperations.list
  • apihub.externalApis.create
  • apihub.externalApis.delete
  • apihub.externalApis.get
  • apihub.externalApis.list
  • apihub.externalApis.update
  • apihub.hostProjectRegistrations.create
  • apihub.hostProjectRegistrations.delete
  • apihub.hostProjectRegistrations.get
  • apihub.hostProjectRegistrations.list
  • apihub.hostProjectRegistrations.register
  • apihub.llmEnablements.deregister
  • apihub.llmEnablements.get
  • apihub.llmEnablements.list
  • apihub.llmEnablements.register
  • apihub.locations.collectApiData
  • apihub.locations.searchResources
  • apihub.locations2.searchResources
  • apihub.operations.cancel
  • apihub.operations.delete
  • apihub.operations.get
  • apihub.operations.list
  • apihub.plugininstances.applyConfig
  • apihub.plugininstances.create
  • apihub.plugininstances.delete
  • apihub.plugininstances.disable
  • apihub.plugininstances.enable
  • apihub.plugininstances.execute
  • apihub.plugininstances.get
  • apihub.plugininstances.list
  • apihub.plugininstances.update
  • apihub.plugins.create
  • apihub.plugins.delete
  • apihub.plugins.disable
  • apihub.plugins.enable
  • apihub.plugins.get
  • apihub.plugins.list
  • apihub.runTimeProjectAttachments.attach
  • apihub.runTimeProjectAttachments.create
  • apihub.runTimeProjectAttachments.delete
  • apihub.runTimeProjectAttachments.get
  • apihub.runTimeProjectAttachments.list
  • apihub.runTimeProjectAttachments.lookup
  • apihub.specs.create
  • apihub.specs.delete
  • apihub.specs.get
  • apihub.specs.lint
  • apihub.specs.list
  • apihub.specs.update
  • apihub.styleGuides.get
  • apihub.styleGuides.update
  • apihub.versions.create
  • apihub.versions.delete
  • apihub.versions.get
  • apihub.versions.list
  • apihub.versions.update

resourcemanager.projects.get

resourcemanager.projects.list

(roles/apihub.attributeAdmin)

Full access to all Cloud API hub attribute's resources.

apihub.attributes.*

  • apihub.attributes.create
  • apihub.attributes.delete
  • apihub.attributes.get
  • apihub.attributes.list
  • apihub.attributes.update

resourcemanager.projects.get

resourcemanager.projects.list

(roles/apihub.editor)

Edit access to most of Cloud API Hub resources.

apihub.apiHubInstances.get

apihub.apiHubInstances.list

apihub.apiOperations.*

  • apihub.apiOperations.create
  • apihub.apiOperations.delete
  • apihub.apiOperations.get
  • apihub.apiOperations.list
  • apihub.apiOperations.update

apihub.apis.*

  • apihub.apis.create
  • apihub.apis.createTagBinding
  • apihub.apis.delete
  • apihub.apis.deleteTagBinding
  • apihub.apis.get
  • apihub.apis.list
  • apihub.apis.listEffectiveTags
  • apihub.apis.listTagBindings
  • apihub.apis.update

apihub.attributes.get

apihub.attributes.list

apihub.curations.get

apihub.curations.list

apihub.definitions.*

  • apihub.definitions.get
  • apihub.definitions.list
  • apihub.definitions.update

apihub.dependencies.*

  • apihub.dependencies.create
  • apihub.dependencies.delete
  • apihub.dependencies.get
  • apihub.dependencies.list
  • apihub.dependencies.update

apihub.deployments.*

  • apihub.deployments.create
  • apihub.deployments.createTagBinding
  • apihub.deployments.delete
  • apihub.deployments.deleteTagBinding
  • apihub.deployments.get
  • apihub.deployments.list
  • apihub.deployments.listEffectiveTags
  • apihub.deployments.listTagBindings
  • apihub.deployments.update

apihub.discoveredApiObservations.*

  • apihub.discoveredApiObservations.get
  • apihub.discoveredApiObservations.list

apihub.discoveredApiOperations.*

  • apihub.discoveredApiOperations.get
  • apihub.discoveredApiOperations.list

apihub.externalApis.*

  • apihub.externalApis.create
  • apihub.externalApis.delete
  • apihub.externalApis.get
  • apihub.externalApis.list
  • apihub.externalApis.update

apihub.hostProjectRegistrations.get

apihub.hostProjectRegistrations.list

apihub.llmEnablements.*

  • apihub.llmEnablements.deregister
  • apihub.llmEnablements.get
  • apihub.llmEnablements.list
  • apihub.llmEnablements.register

apihub.locations.*

  • apihub.locations.collectApiData
  • apihub.locations.searchResources

apihub.operations.get

apihub.operations.list

apihub.plugininstances.get

apihub.plugininstances.list

apihub.plugins.get

apihub.plugins.list

apihub.runTimeProjectAttachments.get

apihub.runTimeProjectAttachments.list

apihub.specs.*

  • apihub.specs.create
  • apihub.specs.delete
  • apihub.specs.get
  • apihub.specs.lint
  • apihub.specs.list
  • apihub.specs.update

apihub.styleGuides.get

apihub.versions.*

  • apihub.versions.create
  • apihub.versions.delete
  • apihub.versions.get
  • apihub.versions.list
  • apihub.versions.update

resourcemanager.projects.get

resourcemanager.projects.list

(roles/apihub.pluginAdmin)

Full access to all Cloud API hub plugin's resources.

apihub.curations.*

  • apihub.curations.create
  • apihub.curations.delete
  • apihub.curations.get
  • apihub.curations.list
  • apihub.curations.update

apihub.locations.collectApiData

apihub.operations.*

  • apihub.operations.cancel
  • apihub.operations.delete
  • apihub.operations.get
  • apihub.operations.list

apihub.plugininstances.*

  • apihub.plugininstances.applyConfig
  • apihub.plugininstances.create
  • apihub.plugininstances.delete
  • apihub.plugininstances.disable
  • apihub.plugininstances.enable
  • apihub.plugininstances.execute
  • apihub.plugininstances.get
  • apihub.plugininstances.list
  • apihub.plugininstances.update

apihub.plugins.*

  • apihub.plugins.create
  • apihub.plugins.delete
  • apihub.plugins.disable
  • apihub.plugins.enable
  • apihub.plugins.get
  • apihub.plugins.list

apihub.specs.lint

apihub.styleGuides.*

  • apihub.styleGuides.get
  • apihub.styleGuides.update

resourcemanager.projects.get

resourcemanager.projects.list

(roles/apihub.provisioningAdmin)

Full access to Cloud API hub provisioning related resources.

apihub.apiHubInstances.*

  • apihub.apiHubInstances.create
  • apihub.apiHubInstances.delete
  • apihub.apiHubInstances.get
  • apihub.apiHubInstances.list

apihub.hostProjectRegistrations.*

  • apihub.hostProjectRegistrations.create
  • apihub.hostProjectRegistrations.delete
  • apihub.hostProjectRegistrations.get
  • apihub.hostProjectRegistrations.list
  • apihub.hostProjectRegistrations.register

apihub.operations.*

  • apihub.operations.cancel
  • apihub.operations.delete
  • apihub.operations.get
  • apihub.operations.list

apihub.runTimeProjectAttachments.*

  • apihub.runTimeProjectAttachments.attach
  • apihub.runTimeProjectAttachments.create
  • apihub.runTimeProjectAttachments.delete
  • apihub.runTimeProjectAttachments.get
  • apihub.runTimeProjectAttachments.list
  • apihub.runTimeProjectAttachments.lookup

resourcemanager.projects.get

resourcemanager.projects.list

(roles/apihub.runTimeProjectAttachmentsEditor)

Access to add/delete project as a runtime project attachment to API hub host project.

apihub.runTimeProjectAttachments.attach

(roles/apihub.runtimeProjectServiceAgent)

Gives API-Hub Service Account access to runtime project resources.

apigee.deployments.list

apigee.envgroupattachments.list

apigee.envgroups.list

apigee.environments.get

apigee.organizations.create

apigee.organizations.delete

apigee.organizations.get

apigee.organizations.update

apigee.proxies.get

apigee.proxyrevisions.get

apihub.apiOperations.delete

apihub.apiOperations.list

apihub.apis.create

apihub.apis.delete

apihub.apis.list

apihub.apis.update

apihub.attributes.create

apihub.attributes.list

apihub.attributes.update

apihub.curations.list

apihub.definitions.list

apihub.dependencies.delete

apihub.dependencies.list

apihub.deployments.create

apihub.deployments.delete

apihub.deployments.list

apihub.deployments.update

apihub.externalApis.list

apihub.hostProjectRegistrations.list

apihub.operations.list

apihub.plugininstances.create

apihub.plugininstances.delete

apihub.plugininstances.list

apihub.plugins.create

apihub.plugins.delete

apihub.plugins.list

apihub.runTimeProjectAttachments.list

apihub.specs.create

apihub.specs.delete

apihub.specs.list

apihub.specs.update

apihub.versions.create

apihub.versions.delete

apihub.versions.list

apihub.versions.update

(roles/apihub.viewer)

View access to all Cloud API hub resources.

apihub.apiHubInstances.get

apihub.apiHubInstances.list

apihub.apiOperations.get

apihub.apiOperations.list

apihub.apis.get

apihub.apis.list

apihub.apis.listEffectiveTags

apihub.apis.listTagBindings

apihub.attributes.get

apihub.attributes.list

apihub.curations.get

apihub.curations.list

apihub.definitions.get

apihub.definitions.list

apihub.dependencies.get

apihub.dependencies.list

apihub.deployments.get

apihub.deployments.list

apihub.deployments.listEffectiveTags

apihub.deployments.listTagBindings

apihub.discoveredApiObservations.*

  • apihub.discoveredApiObservations.get
  • apihub.discoveredApiObservations.list

apihub.discoveredApiOperations.*

  • apihub.discoveredApiOperations.get
  • apihub.discoveredApiOperations.list

apihub.externalApis.get

apihub.externalApis.list

apihub.hostProjectRegistrations.get

apihub.hostProjectRegistrations.list

apihub.llmEnablements.get

apihub.llmEnablements.list

apihub.locations.searchResources

apihub.operations.get

apihub.operations.list

apihub.plugininstances.get

apihub.plugininstances.list

apihub.plugins.get

apihub.plugins.list

apihub.runTimeProjectAttachments.get

apihub.runTimeProjectAttachments.list

apihub.specs.get

apihub.specs.list

apihub.styleGuides.get

apihub.versions.get

apihub.versions.list

resourcemanager.projects.get

resourcemanager.projects.list

For more information about predefined roles, see Roles and permissions. For help choosing the most appropriate predefined roles, see Choose predefined roles.