Service Management API Access Control

The Service Management API uses Cloud Identity and Access Management to control access to services and their child resources. This page explains the IAM roles and permissions used with the Service Management API, and how to use them to control access.

Resource model

Cloud IAM applies IAM policies on resources to control who can perform what actions on the resources. The Service Management API uses the following resources to provide its functionality:

You typically need all permissions to managed services and their child resources, so you can create services, service configurations, and rollouts.

Users need the permission on your service in order to see and enable it.

IAM permissions

Calls to the Service Management API require the caller to have the necessary IAM permissions on the resources that the call is accessing.

The following table lists the permissions that apply to services:

Permission Description Delete services. Read services. Create new services in projects. List services in projects. Update services. View and enable the service on projects the caller controls. Set IAM access policy for services. Read IAM access policy for services. Check service consumer status. See services.check Allocate quota for a service consumer. See services.allocateQuota Report service usage. See

The following table shows the required permissions for each Service Management API method, where applicable. This information is also documented in the API Reference:

Method Required Permission(s)
services.delete on the specified service_name.
services.disable On the project:
services.enable On the project:
On the service:
services.get on the specified service_name.
services.getConfig on the specified service_name.
services.undelete on the specified service_name.
services.configs.create on the specified service_name.
services.configs.get on the specified service_name.
services.configs.list on the specified service_name.
services.configs.submit on the specified service_name.
services.rollouts.create on the specified service_name.
services.rollouts.get on the specified service_name.
services.rollouts.list on the specified service_name.

IAM roles

With Cloud Identity and Access Management, permissions are granted by binding users to roles. See Understanding Roles for details.

The following table lists the roles that apply to services:

Role Permissions
roles/editor All permissions of roles/viewer, plus
roles/owner All permissions of roles/editor, plus

Managing policies

Cloud IAM evaluates policies hierarchically: a child resource always inherits the policy of its parent. For the Service Management API, each managed service is a child resource of its service producer project. Therefore the roles granted on the service producer project apply to all managed services that belong to the project. See Managing Policies for the instructions for granting roles at the project level.

You can also manage the IAM policy for an individual service. The following sections describe how to manage service-level roles using Google Cloud Console, Service Management API, and Google Cloud SDK.

Managing access using Google Cloud Console

  1. Open the Endpoints page in the Google Cloud Console.

    Open the Endpoints page

  2. Click the service that you want to manage access for.
  3. Click the "PERMISSIONS" link at the top of the page. This toggles the info panel on and off.
  4. From the info panel, you can view the list of current members, add new members, and remove members, for any service-level role.

Managing access using the Service Management API

The Service Management API includes the IAM Policy API for managing service-level policies. You can use the gcurl command to experiment with the API methods. See Getting Started for the initial setup steps.

For example:

# View the current IAM policy on service "".
gcurl -d '{}'

Managing access using Cloud SDK

Cloud SDK includes the following commands to manage IAM policies for managed services:

  • endpoints services get-iam-policy
    • Show the IAM policy of the service.
  • endpoints services add-iam-policy-binding
    • Add a member to a role.
  • endpoints services remove-iam-policy-binding
    • Remove a member from a role.

For example:

# Show the IAM policy of service "".
gcloud endpoints services get-iam-policy

# The above command may produce an output similar to this:
- members:
  role: roles/servicemanagement.serviceConsumer

# Add a user to "roles/servicemanagement.serviceConsumer" role.
gcloud endpoints services add-iam-policy-binding --member "" --role "roles/servicemanagement.serviceConsumer"

# Add a group to "roles/servicemanagement.serviceConsumer" role.
gcloud endpoints services add-iam-policy-binding --member "" --role "roles/servicemanagement.serviceConsumer"

# Remove a user from "roles/servicemanagement.serviceConsumer" role.
gcloud endpoints services remove-iam-policy-binding --member "" --role "roles/servicemanagement.serviceConsumer"

# Remove a group from "roles/servicemanagement.serviceConsumer" role.
gcloud endpoints services remove-iam-policy-binding --member "" --role "roles/servicemanagement.serviceConsumer"