[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-04 (世界標準時間)。"],[],[],null,["# List and view instances\n\nYou can use the gcloud CLI to list all Secure Source Manager\ninstances in your project. For more information on Secure Source Manager\ninstances, see the \\[Secure Source Manager overview\\]\\[ssm-overview\\].\n\nRequired roles\n--------------\n\n\nTo get the permissions that\nyou need to list instances,\n\nask your administrator to grant you the\n\n\n[Secure Source Manager Instance Manager](/iam/docs/roles-permissions/securesourcemanager#securesourcemanager.instanceManager) (`roles/securesourcemanager.instanceManager`)\nIAM role on the instance project.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nFor information on granting Secure Source Manager roles,\nsee [Access control with IAM](/secure-source-manager/docs/access-control) and\n[Grant users instance access](/secure-source-manager/docs/grant-users-instance-access).\n\nList instances in project\n-------------------------\n\nRun the following command to get a list of Secure Source Manager instances\nin your project: \n\n gcloud beta source-manager instances list --region=\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e\n\nReplace \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eREGION\u003c/code\u003e\u003c/var\u003e with the location you want to list the instances\nfrom.\n\nThe response will look like the following: \n\n INSTANCE_ID: my-instance\n LOCATION: us-central1\n STATE: ACTIVE\n CREATE_TIME: 2023-02-27T20:57:52\n UPDATE_TIME: 2023-02-27T21:11:59\n HTML_HOST: my-instance-098765432109.us-central1.sourcemanager.dev\n\nYou can access the instance by entering the value of `HTML_HOST` in a browser\naddress bar.\n\nGet instance details\n--------------------\n\nRun the following command to get details of an instance: \n\n gcloud beta source-manager instances describe \u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e \\\n --region=\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eINSTANCE_ID\u003c/code\u003e\u003c/var\u003e with the name of your instance.\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eREGION\u003c/code\u003e\u003c/var\u003e with the location of your instance. For information on supported locations, see [Locations](/secure-source-manager/docs/locations).\n\nThe response includes details of your instance similar to the following: \n\n createTime: '2023-02-27T20:57:52.310148676Z'\n hostConfig:\n api: my-instance-123456789098-api.us-central1.sourcemanager.dev\n gitHttp: my-instance-123456789098-git.us-central1.sourcemanager.dev\n gitSsh: my-instance-123456789098-ssh.us-central1.sourcemanager.dev\n html: my-instance-123456789098.us-central1.sourcemanager.dev\n name: projects/my-project/locations/us-central1/instances/my-instance\n state: ACTIVE\n updateTime: '2023-02-27T21:11:59.538591815Z'\n\nWhat's next\n-----------\n\n- [Grant users instance access](/secure-source-manager/docs/grant-users-instance-access).\n- [Create and clone a repository](/secure-source-manager/docs/create-clone-repository)."]]