Listar objetos de repositorio
Finalidad
El submandato scm list
lista objetos, incluidas áreas de proyecto, áreas de equipo, corrientes, espacios
de trabajo, archivos y colaboradores (usuarios) del repositorio especificado. El alias de scm list es scm ls.
Sinopsis
- Para ejecutar scm list después de haber utilizado scm login para
crear credenciales almacenadas:
scm list [ -r | --repository-uri ] URI de repositorio o apodo { [ -c | --contrib ] nombre [ -v | --verbose ] --depth niveles} tipo de objeto {opciones específicas de tipo de objeto}
- Para ejecutar scm list facilitando credenciales en la línea
de mandatos:
scm list [ -r | --repository-uri ] URI de repositorio [ -u | --username ] ID de usuario de repositorio [ -P | --password ] contraseña de ID de usuario de repositorio { [ -c | --contrib ] nombre [ -v | --verbose ] --depth niveles } tipo de objeto {opciones específicas de tipo de objeto}
Opciones y argumentos
- [ -c | --contrib ] nombre
- Un ID de usuario válido en el repositorio especificado. Si se facilita esta
opción, la lista de tipos de elemento se limita a elementos que
son propiedad del colaborador especificado. Si se omite esta opción, el valor
predeterminado de nombre es el ID de usuario del usuario que
ejecuta scm list. No se aplica si se listan áreas de
proyecto, colaboradores, componentes y archivos remotos.
- --depth niveles
- Si se listan archivos remotos, niveles especifica
la profundidad máxima de recurrencia. Si no se especifica, el valor
predeterminado de niveles es 3, listando los tres
primeros niveles de contenido de carpetas del componente especificado.
Al especificar niveles como – se listan todos los
archivos remotos del componente especificado. No se aplica a otros
tipos de objeto.
- [ -P | --password ] contraseña de ID de usuario de repositorio
- La contraseña del ID de usuario especificado en el repositorio
nombrado. Si esta opción no se incluye en la línea de mandatos, se le solicita
una contraseña. Si ha especificado un URI de repositorio o apodo para el cual ha
almacenado credenciales mediante el mandato scm login, se
ignora esta opción.
- [ -r | --repository-uri ] URI de repositorio
- Especifica el repositorio en el que se debe llevar a cabo esta acción.
Si ha almacenado credenciales de repositorio mediante el mandato scm login,
puede utilizar el apodo que facilitó para estas credenciales almacenadas
- [ -u | --username ] ID de usuario de repositorio
- Especifica un ID de usuario que existe en el repositorio nombrado.
Si ha especificado un URI de repositorio o apodo para el cual ha
almacenado credenciales mediante el mandato scm login, se
ignora esta opción.
- [ -v | --verbose ]
- Proporcionar mensajes informativos adicionales al operar. Al listar componentes, mostrar
también las líneas base.
- tipo de objeto
- El tipo de elemento que se debe listar. Uno de:
- components
- Listar todos los componentes a los que tiene acceso el colaborador especificado.
- contributors
- Listar los ID de usuario de todos los colaboradores que tienen cuentas en
el repositorio especificado.
- project-areas
- Listar todas las áreas de proyecto del repositorio.
- streams
- Listar las corrientes de todas las áreas de equipo a las que pertenece el
colaborador especificado.
- remotefiles
- Listar los archivos remotos de un espacio de trabajo, componente o proyecto. Las opciones específicas de tipo de objeto para este tipo de objeto son:
- componente de espacio de trabajo
- El nombre de un espacio de trabajo y un componente en ese espacio de trabajo. Separe los nombres por un espacio. El componente especificado debe
existir en el espacio de trabajo especificado.
- vía de acceso remota
- Un nombre de vía de acceso dentro del componente especificado. Esta
opción es opcional. Utilícela para restringir la lista de vías de acceso remotas
que figuran en un componente.
- team-areas
- Listar todas las áreas de equipo a las que pertenece el colaborador
especificado.
- workspaces
- Listar todos los espacios de trabajo propiedad del colaborador especificado.
Ejemplos
Listar los espacios de trabajo propiedad del
usuario asociado a credenciales almacenadas para el repositorio apodado jazzhost:
C:\>scm list workspaces -r jazzhost
(1000) "Espacio de trabajo del sitio de la comunidad"
(1101) "HelloJazz"
(1068) "UA-CLI"
(1113) "HelloJazz2"
(1109) "REST-svc-dev"
(1141) "Espacio de trabajo de prueba de Rob"
Listar los
espacios de trabajo propiedad del usuario brc del repositorio apodado jazzhost:
C:\>scm list workspaces -c brc -r jazzhost
(1141) "Espacio de trabajo de prueba de Rob"
(1109) "REST-svc-dev"