Assigning a role for a registry

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id.

If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

yc cloud-registry registry add-access-binding <registry_name_or_ID> \
  --role <role> \
  --subject <subject_type>:<subject_ID>

Where:

• --role: Role you want to assign.

• --subject: Subject getting the role.

  Subject designations

  To indicate a subject, use the --subject parameter in <subject_type>:<ID> format. For some subject types, the Yandex Cloud CLI provides separate parameters instead of --subject, where you only need to specify the subject name or ID without the type. Possible subject designations and matching CLI parameters:

  Subject type	Subject designation	Yandex Cloud CLI parameter
  userAccount	userAccount:<user_ID>	--user-account-id or --user-yandex-login
  serviceAccount	serviceAccount:<service_account_ID>	--service-account-id or --service-account-name
  federatedUser	federatedUser:<user_ID>	--user-account-id
  group	group:<group_ID>	--group-members
  system	system:allAuthenticatedUsers (All authenticated users group)	--all-authenticated-users
  	system:allUsers (All users group)	—
  	system:group:organization:<organization_ID>:users (All users in organization X group)	--organization-users
  	system:group:federation:<federation_ID>:users (All users in federation N group)	--federation-users
  	system:group:userpool:<pool_ID>:users (All users in userpool P group)	—

To revoke all registry roles and assign new ones right away, use the yc cloud-registry registry set-access-bindings command.

Example

In the example below, we are assigning the cloud-registry.admin role for my-first-registry to a user.

yc cloud-registry registry add-access-binding my-first-registry \
  --role cloud-registry.admin \
  --user-account-id ajeugsk5ubk6********

Result:

done (4s)

Use the updateAccessBindings REST API method for the Registry resource or the RegistryService/UpdateAccessBindings gRPC API call. In the request body, set the action property to ADD and specify the subject type and ID under subject.