Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity Gaming Services CLI

v1.6

Legacy
​

GitHub Repository

Unity Gaming Services CLI

v1.6

Legacy
​

​
​
Unity Gaming Services CLI
  • Overview
Get started
  • Install the CLI
  • Set up a Common Configuration
  • Get Authenticated
  • Use Your First Command
Base commands
  • Configuration
  • Deploy
  • Environment
  • Fetch
  • Login
  • Logout
  • Status
Deployment definition
  • What is a Deployment Definition
  • Commands for Deployment Definition
  • Excludes
  • Troubleshooting Deployment Definition
Samples
  • CI/CD Pipeline Usage
  • Deploy Samples
  • File Type Associations
  • Redirecting Command Result to File
Troubleshooting
  • Project Roles
  • Unauthorized (Error 403)
CLI Services Documentation
  • Access
  • Cloud Code
  • Cloud Content Delivery
  • Cloud Save
  • Economy
  • Game Server Hosting
  • Leaderboards
  • Lobby
  • Matchmaker
  • Player
  • Remote Config
  • Scheduler
  • Triggers
  1. Overview

Project Roles

Reference the project roles required to run CLI commands for each UGS module.
Read time 3 minutes
Last updated 3 months ago

Project roles grant access to project-level data, which includes APIs that only apply to individual projects you choose. So to use some of the UGS CLI commands, you need to have the correct project roles linked to your project ID and Service Account. You can link the project roles to your Service Account and project ID under the
Services Accounts
section in the Unity Dashboard. For more information, see Creating a Service Account. The tables below shows the project roles required to execute commands for each module.

Environment module

Project role

Description

Unity Environments Admin
Grants full access to all environments in a project.

Access module

Project role

Description

Unity Environments Admin
Grants full access to all environments in a project.
Player Resource Policy Editor
Grants write access to player-based resource policies.
Player Resource Policy Reader
Grants read access to player-based resource policies.
Project Resource Policy Editor
Grants write access to project-based resource policies.
Project Resource Policy Reader
Grants read access to project-based resource policies.

Cloud Code module

Project role

Description

Unity Environments Admin
Grants full access to all environments in a project.
Cloud Code Editor
Grants permissions necessary for viewing and editing cloud code resources.
Cloud Code Viewer
Grants permissions necessary for viewing cloud code resources.
Cloud Code Script Publisher
Grants permissions necessary for publishing cloud code scripts.

Lobby module

Project role

Description

Unity Environments Admin
Grants full access to all environments in a project.
Remote Config Admin
Grants access to the Remote Config admin API.

Player module

Project role

Description

Authentication Admin
Grants access to all Admin APIs for player authentication.
Authentication Editor
Grants access to all Admin APIs for player authentication.

Deploy Command

Currently Cloud Code, Remote Config and Economy services support the deploy command. To deploy for all services you need the following roles:

Project role

Description

Unity Environments Admin
Grants full access to all environments in a project.
Remote Config Admin
Grants access to the Remote Config admin API.
Cloud Code Script Editor
Grants permissions necessary for editing cloud code scripts.
Cloud Code Script Publisher
Grants permissions necessary for publishing cloud code scripts.
Cloud Code Script Viewer
Grants permissions necessary for viewing cloud code scripts.
Economy Resource Editor
Grants permissions necessary for creating, editing and deleting economy resources.
Economy Resource Publisher
Grants permissions necessary for publishing economy configurations.
Economy Resource Viewer
Grants permissions necessary for listing economy resources.

Fetch Command

Currently Remote Config services support the fetch command. To deploy for supported services you need the following roles:

Project role

Description

Unity Environments Admin
Grants full access to all environments in a project.
Remote Config Admin
Grants access to the Remote Config admin API.

Leaderboard module

Project role

Description

Unity Environments Admin
Grants full access to all environments in a project.
Leaderboards Admin
Grants access to the Leaderboard admin API.

Economy module

Project role

Description

Unity Environments Admin
Grants full access to all environments in a project.
Economy Resource Editor
Grants permissions necessary for creating, editing and deleting economy resources.
Economy Resource Publisher
Grants permissions necessary for publishing economy configurations.
Economy Resource Viewer
Grants permissions necessary for listing economy resources.

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Environment module

    • Access module

    • Cloud Code module

    • Lobby module

    • Player module

    • Deploy Command

    • Fetch Command

    • Leaderboard module

    • Economy module