roles set-grant-scopes

Command: roles set-grant-scopes

The roles set-grant-scopes command lets you set the complete set of grant scopes on a role. You can specify multiple grant scopes per role.

Example

This example sets the complete set of grant scopes on a role with the ID r_1234567890 in the current scope and any children scopes:

$ boundary roles set-grant-scopes -id r_1234567890 -grant-scope-id "this" -grant-scope-id "children"

Usage

$ boundary roles set-grant-scopes [options] [args]

Command options

• -grant-scope-id=<string> - The scope IDs that inherit grants set on the role. You can specify the following values:

  • this - Applies to the current scope.
  • children - Applies to all direct children of the scope and can only be used with global and org scopes.
  • descendants - Applies to all descendants of the scope and can only be used with the global scope.

  Boundary does not allow you to create redudnant grant scopes. For example, if an org scope inherits a grant from the global scope, you cannot apply the same grant directly to the org scope.

• -id=<string> - The ID of the role you want to set grant scopes on.

• -version=<int> The version of the role to set grant scopes on. If you do not specify a version, the command performs a check-and-set automatically.