You can use the gcloud CLI to list all Secure Source Manager instances in your project. For more information on Secure Source Manager instances, see the [Secure Source Manager overview][ssm-overview].
Required roles
To get the permissions that
you need to list instances,
ask your administrator to grant you the Secure Source Manager Instance Manager
( roles/securesourcemanager.instanceManager
)
IAM role on the instance project.
For more information about granting roles, see Manage access to projects, folders, and organizations
.
You might also be able to get the required permissions through custom roles or other predefined roles .
For information on granting Secure Source Manager roles, see Access control with IAM and Grant users instance access .
List instances in project
Run the following command to get a list of Secure Source Manager instances in your project:
gcloud
beta
source-manager
instances
list
--region =
REGION
Replace REGION
with the location you want to list the instances
from.
The response will look like the following:
INSTANCE_ID: my-instance
LOCATION: us-central1
STATE: ACTIVE
CREATE_TIME: 2023-02-27T20:57:52
UPDATE_TIME: 2023-02-27T21:11:59
HTML_HOST: my-instance-098765432109.us-central1.sourcemanager.dev
You can access the instance by entering the value of HTML_HOST
in a browser
address bar.
Get instance details
Run the following command to get details of an instance:
gcloud
beta
source-manager
instances
describe
INSTANCE_ID
\
--region =
REGION
Replace the following:
-
INSTANCE_IDwith the name of your instance. -
REGIONwith the location of your instance. For information on supported locations, see Locations .
The response includes details of your instance similar to the following:
createTime: '2023-02-27T20:57:52.310148676Z'
hostConfig:
api: my-instance-123456789098-api.us-central1.sourcemanager.dev
gitHttp: my-instance-123456789098-git.us-central1.sourcemanager.dev
gitSsh: my-instance-123456789098-ssh.us-central1.sourcemanager.dev
html: my-instance-123456789098.us-central1.sourcemanager.dev
name: projects/my-project/locations/us-central1/instances/my-instance
state: ACTIVE
updateTime: '2023-02-27T21:11:59.538591815Z'
