Compartir a través de

Restricciones y convenciones de nomenclatura

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

En este artículo se describen las reglas de nomenclatura, las convenciones y las restricciones de los componentes de Azure DevOps. Las reglas de nomenclatura, las restricciones y las convenciones ayudan a garantizar una experiencia de usuario coherente y proporcionan compatibilidad con otras aplicaciones.

Consideraciones generales

Las restricciones comunes incluyen no superar la longitud de caracteres de un nombre, no contener caracteres especiales y mantener la unicidad de los nombres dentro de un conjunto de objetos.

Importante

Al usar las API de Azure DevOps en lugar de la interfaz de usuario (UI), puede especificar directamente un nombre que pueda incluir caracteres restringidos en la interfaz de usuario. Para mantener la coherencia y evitar problemas no deseados, siga las restricciones de la interfaz de usuario. Valide los nombres mediante programación y controle los caracteres especiales correctamente.

Nombres reservados del sistema

Evite usar nombres reservados del sistema como los ejemplos siguientes:

  • AUX
  • COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
  • CON
  • DefaultCollection
  • LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
  • NUL
  • PRN
  • SERVIDOR, SignalR
  • Web o WEB

Para obtener más información sobre los nombres reservados, vea Nombres de archivo, rutas de acceso y espacios de nombres.

Azure Artifacts

Los paquetes y fuentes universales de Azure Artifacts deben cumplir las restricciones siguientes:

Tipo de restricción Restricción
Nombre del paquete - Debe estar en minúscula.
- Debe comenzar y terminar con caracteres alfanuméricos.
- Solo puede contener caracteres alfanuméricos y guiones no consecutivos -, caracteres de subrayado _ o puntos ..
Versión del paquete - Debe estar en minúsculas sin metadatos de compilación.
Nombre de la fuente - Debe comenzar y terminar con caracteres alfanuméricos.
- No distingue mayúsculas de minúsculas, pero no puede diferir de otro nombre de flujo de datos solo por diferencia de mayúsculas.
- No se puede comenzar con el punto . o el carácter de subrayado _ ni terminar con el punto ..
- No se puede incluir ninguno de los siguientes caracteres: @~;{}'+=,<>|/\?:&$*"#[]%.

Azure Boards

Azure Boards usa elementos de trabajo para planear y realizar un seguimiento de los proyectos de desarrollo de software. Los elementos de trabajo describen el trabajo que se va a realizar, asignar trabajo, realizar un seguimiento del estado y coordinar los esfuerzos dentro de un equipo. Diferentes tipos de elementos de trabajo, como casos de usuario, tareas, errores y problemas, realizan un seguimiento de diferentes tipos de información. Para más información, consulte la documentación de Azure Boards.

Los objetos de seguimiento de elementos de trabajo están asociados a uno o varios nombres. Todos los objetos excepto los tipos de elementos de trabajo y las listas globales tienen nombres de visualización amigables, que son identificadores únicos visibles para los usuarios de los campos. El uso de nombres descriptivos garantiza la coherencia entre proyectos y tipos de elementos de trabajo en una colección de proyectos.

Los tipos de elementos de trabajo y las listas globales están asociados a nombres de referencia. El sistema usa los nombres de referencia internamente y no se pueden cambiar una vez definidos.

Varios elementos asociados a elementos de trabajo tienen restricciones, incluidos nombres de referencia, nombres descriptivos, nombres de campo y tamaño de datos adjuntos.

Rutas de área y de iteración

Los campos de elemento de trabajo Ruta de acceso de área y Ruta de acceso de iteración proporcionan una jerarquía de estructura de árbol para agrupar el trabajo. Las rutas de acceso de área agrupan elementos de trabajo por producto, función o área de características. Las rutas de iteración agrupan elementos de trabajo en sprints, hitos o períodos de tiempo para tratar el trabajo.

Estos campos de varios nodos usan el carácter de barra invertida \ para indicar la jerarquía de nodos dentro de la estructura de árbol. Los nombres que asigne a los nodos secundarios deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Longitud de nodo No debe contener más de 255 caracteres.
Nombres reservados - No debe constar únicamente de un período . o de dos puntos ...
- No debe ser un nombre reservado por el sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON o AUX. Para obtener más información sobre los nombres reservados, vea Nombres de archivo, rutas de acceso y espacios de nombres.
Caracteres especiales de los nodos - No debe contener caracteres de control Unicode.
- No debe contener ninguno de los siguientes caracteres: \ / : * ? " < > | # $ & * +.
- No debe contener caracteres prohibidos por el sistema de archivos local. Para obtener más información sobre las restricciones de caracteres de Windows, vea Asignar nombres a archivos, rutas de acceso y espacios de nombres.
Longitud de la ruta de acceso No debe contener más de 4000 caracteres Unicode.
Profundidad de jerarquía de la ruta de acceso Debe tener menos de 14 niveles de profundidad.

Datos adjuntos

Los archivos adjuntos a los elementos de trabajo deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Tamaño de archivo No debe superar el tamaño máximo:
- Tamaño máximo predeterminado: 4096 kilobytes.
- Tamaño máximo absoluto: 2 gigabytes.

Para obtener más información, consulte Cambio del tamaño máximo de datos adjuntos para los elementos de trabajo.

Nombres de columnas y calles del tablero

Una placa proporciona un flujo visual del trabajo pendiente. A medida que avanza el trabajo desde la planeación hasta la finalización, se actualizan los elementos de la placa. Cada columna representa una fase de trabajo y cada tarjeta representa un elemento de trabajo en esa fase de trabajo.

Puede personalizar un panel agregando, quitando o cambiando el nombre de columnas y swimlanes. Las columnas admiten el flujo de trabajo a través del tablero, y los carriles permiten gestionar diferentes trabajos como carriles horizontales en el tablero.

Los nombres de columnas y calles de nado deben cumplir las siguientes restricciones.

Tipo de restricción Restricción
Largura No debe contener más de 256 caracteres Unicode.
Unicidad - Los nombres de columna no deben ser iguales que cualquier otro nombre de columna en la placa.
- Los nombres de las calles de navegación no deben coincidir con ningún otro nombre de calle de navegación del tablero.
Caracteres especiales No deben contener caracteres de control Unicode ni caracteres suplentes.

Nombres de campo

Cada tipo de elemento de trabajo contiene uno o varios campos que definen la información almacenada para ese tipo de elemento de trabajo. Cada campo de elemento de trabajo tiene un nombre de referencia de campo asociado que identifica de forma única el campo y no se puede cambiar una vez asignado. Para obtener más información sobre los campos de elementos de trabajo integrados, consulte el índice de campos de trabajo.

Los nombres de los campos de elementos de trabajo se asignan a la colección del proyecto. Si cambia el nombre de un campo, lo hará para todos los elementos de trabajo y los tipos de elementos de trabajo definidos en todos los proyectos de la colección.

Los nombres de campo del elemento de trabajo deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Largura No debe contener más de 128 caracteres Unicode.
Unicidad Debe ser único dentro de la organización o la colección de proyectos.
Caracteres especiales - Debe contener al menos un carácter alfabético.
- No debe contener ninguno de los siguientes caracteres: .,;':~\/*?"&%$!+=()[]{}<>-|.
- No debe contener espacios iniciales ni finales.
- No debe contener dos o más espacios consecutivos.

Nombres de referencia de campo

El lenguaje de definición de tipo de elemento de trabajo incluye el concepto de un nombre de referencia de campo. Los nombres de referencia de campo pueden ayudarle a migrar definiciones entre colecciones de proyectos de Team Foundation y permitir que las integraciones que no son de Microsoft busquen y hagan referencia a campos específicos. Estos nombres, como los espacios de nombres de las aplicaciones de .NET Framework, son únicos globalmente.

Los campos siguientes se definen en una definición de tipo de elemento de trabajo de las plantillas de proceso:

  • El espacio de nombres Sistema solo se utiliza para definir todos los campos del sistema principal que son obligatorios para las funciones del sistema de Team Foundation. No puede crear su propio System.X campo, ya que podría impedir la funcionalidad.

  • El espacio de nombres de Microsoft se usa para definir campos de seguimiento de elementos de trabajo. Aunque puede crear su propio Microsoft.X campo, no se recomienda porque podría impedir la funcionalidad o la capacidad de actualizar correctamente un proyecto después de una actualización.

Los clientes y asociados pueden crear sus propios espacios de nombres de campo para tipos de elementos de trabajo personalizados. Para obtener descripciones de los campos y campos del sistema definidos en las plantillas de proceso predeterminadas, vea el índice de los campos del elemento de trabajo.

Importante

No se pueden cambiar los nombres de referencia de campo. Por ejemplo, si cambia el nombre de campo Título a Encabezado, el nombre de referencia de campo de ese campo no cambia. Las integraciones y las representaciones internas de los campos deben usar el nombre de referencia de campo en lugar del nombre del campo.

Ejemplos de nombres de referencia de campo

En los ejemplos siguientes se muestran nombres de referencia de campo válidos en varios espacios de nombres.

Ejemplos de espacios de nombres del sistema Ejemplos de espacios de nombres de Microsoft Otros ejemplos de espacios de nombres
Sistema.Id, Sistema.Título, Sistema.CreadoPor, Sistema.FechaCreada, Sistema.ModificadoPor, Sistema.FechaModificada, Sistema.Estado, Sistema.Razón Microsoft.VSTS.Build.FoundIn, Microsoft.VSTS.Common.Activity, Microsoft.VSTS.Common.Discipline, Microsoft.VSTS.Common.Priority, Microsoft.VSTS.CMMI.TaskType, Microsoft.VSTS.TCM.AutomationStatus, Microsoft.VSTS.TCM.TestSuiteType FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

Contoso.Common.PrioridadDeNegocio, Contoso.Bug.EncontradoEnFase, Contoso.Bug.ArregladoEnFase

Texto de ayuda de campo

El sistema muestra texto de ayuda en tiempo de ejecución para ayudar a los usuarios a saber qué escribir en el campo. El texto de ayuda tiene como ámbito un tipo de elemento de trabajo específico en un proyecto específico.

Para el proceso de Herencia, se especifica texto de ayuda para un campo a través del cuadro de diálogo Editar campo, pestaña Definición, Descripción. Consulte Agregar un campo personalizado a un tipo de elemento de trabajo. Para el proceso XML local, especifique texto de ayuda mediante el HELPTEXT elemento . Consulte Agregar o modificar un campo para el seguimiento del trabajo.

El texto de ayuda que agregue debe cumplir las restricciones siguientes.

Tipo de restricción Restricción
Largura No debe contener más de 255 caracteres Unicode.

Listas globales

A medida que defina los tipos de elementos de trabajo, es posible que encuentre que algunos campos de elemento de trabajo comparten el mismo conjunto de valores permitidos o sugeridos. Una lista global es un conjunto de valores de elemento de lista que puede definir una vez y usar globalmente en todas las colecciones de proyectos dentro de una instancia de Azure DevOps Server local.

Una lista global definida mediante el GLOBALLIST elemento contiene uno o varios elementos de lista especificados mediante el LISTITEM elemento . Para obtener más información, consulte Definir listas globales.

Las listas globales deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Unicidad La lista global debe ser única dentro de la instancia de Azure DevOps Server.
Número de artículos No debe estar vacío. La lista global debe contener al menos un elemento LISTITEM.

Los nombres LISTITEM deben cumplir las siguientes restricciones.

Tipo de restricción Restricción
Largura - No debe contener más de 254 caracteres Unicode.
- No debe estar vacía.
Caracteres especiales - No debe contener espacios en blanco ni al principio ni al final.
- No debe contener dos espacios consecutivos.
- No debe contener el carácter de barra invertida \.
Ámbito Dado que las listas globales están disponibles entre todos los proyectos, no deben contener elementos definidos en el nivel de proyecto, como definiciones de cuentas de grupo específicas del proyecto.

Defina un nombre de referencia al agregar o crear un tipo de vínculo o una categoría.

Tipo de restricción Restricción
Largura No debe contener más de 70 caracteres Unicode.
Unicidad : no debe ser el mismo que cualquier otro nombre de referencia de campo dentro de la colección de proyectos.
- No debe ser idéntico a ningún otro nombre de referencia de campo después de que el sistema procese los nombres para reemplazar todos los períodos . por caracteres de _subrayado . Por ejemplo, los nombres de referencia de campo My._Field y My..Field serían procesados como el mismo nombre: My__Field.
Caracteres especiales - Puede usar caracteres alfanuméricos, caracteres de subrayado, guiones y puntos.
- No se pueden usar guiones consecutivos --.
- Debe contener al menos un punto ., pero no puede iniciar ni terminar con un punto.
- No se puede empezar con un número o un carácter de subrayado _.

Nombres de consulta de elemento de trabajo

Puede usar consultas de elementos de trabajo para enumerar elementos de trabajo en función de los criterios de campo que especifique. Para más información, consulte Acerca de las consultas administradas.

Tipo de restricción Restricción
Largura No debe contener más de 255 caracteres Unicode.
Caracteres especiales - No puede estar vacío.
- No debe contener ninguno de los siguientes caracteres: /\<>*?"+|:.
Unicidad - Debe estar contenido en una carpeta y tener un nombre único dentro de la carpeta.

Nombres de etiqueta de elemento de trabajo

Las etiquetas de elemento de trabajo constan de una o dos palabras clave que filtran o definen herramientas de seguimiento de trabajo, como trabajos pendientes, paneles y consultas. Para obtener más información sobre las etiquetas, consulte Adición de etiquetas de elemento para categorizar y filtrar listas y paneles.

Los nombres de etiquetas deben cumplir las siguientes restricciones.

Tipo de restricción Restricción
Largura - No debe contener más de 400 caracteres Unicode.
- No debe ser nulo ni estar vacío.
Caracteres especiales - No debe contener caracteres separadores , ni ;.
- No debe contener caracteres de formato o control Unicode, como fuentes de línea, separadores de párrafos, devoluciones de carro u otros caracteres suplentes no coincidentes.

Azure Pipelines (Canales de Azure)

Los objetos de Azure Pipeline deben cumplir las siguientes restricciones de nomenclatura.

Tipo de objeto Restricción
Expresiones - Debe comenzar con un carácter alfabético o en minúsculas o mayúsculas, seguido de caracteres alfabéticos en minúsculas o mayúsculas, números o caracteres _de subrayado.
Variables - Debe contener solo caracteres alfanuméricos, puntos .y caracteres _de subrayado.
- No se puede comenzar con los prefijos reservados endpoint, input, secret, path o securefile, sin distinción entre mayúsculas y minúsculas.
Etapas - El nombre de la fase debe contener solo caracteres alfanuméricos y caracteres _de subrayado.
- El nombre no debe comenzar con un número.
Trabajos y trabajos de despliegue - El nombre del trabajo solo debe contener caracteres alfanuméricos y caracteres _de subrayado.
- El nombre no debe comenzar con un número.
- El nombre no puede contener palabras clave como deploy.
Estrategia de trabajo de matriz - El nombre de configuración de matriz debe contener solo caracteres alfanuméricos y caracteres _de subrayado.
- El nombre debe comenzar con un carácter alfabético.
- Longitud máxima: 100 caracteres.
Generación de recursos - El alias o el nombre del artefacto de compilación deben contener solo caracteres alfanuméricos, guiones y caracteres -_de subrayado .
Recursos de contenedor - El identificador de contenedor solo debe contener caracteres alfanuméricos, guiones y caracteres -_de subrayado.
Recursos del paquete - El alias de artefacto del paquete solo debe contener caracteres alfanuméricos, guiones-, y caracteres de subrayado_.
Recursos de canalización - El identificador de canalización solo debe contener caracteres alfanuméricos, guiones -, y caracteres de subrayado _.
Recursos del repositorio - El alias del repositorio solo debe contener caracteres alfanuméricos, guiones - y caracteres de subrayado _.
Recursos de webhook - El nombre del webhook solo debe contener caracteres alfanuméricos, guiones - y caracteres de subrayado _.
Pasos - El identificador de nombre del paso debe contener solo caracteres alfanuméricos, guiones y caracteres -_de subrayado.

Para más información, consulte la documentación de Azure Pipelines.

Azure Repos

Los repositorios de Azure Repos pueden basarse en Git o en control de versiones de Team Foundation (TFVC).

Cada proyecto Azure DevOps puede contener repositorios Git múltiples. Para más información, consulte la documentación de Git de Azure Repos.

Los nombres de repositorio de Git deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Largura No debe contener más de 64 caracteres Unicode.
Unicidad No debe ser idéntico a ningún otro nombre de repositorio de Git en el proyecto.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: \/:*?"<>;#$*{},+=[]|.
- No debe comenzar con un guion bajo _.
- No debe comenzar ni terminar con un punto ..
- No debe ser un nombre reservado del sistema.
- Importante: Aunque puede incluir espacios en los nombres de repositorio, no se recomienda.

Para obtener información sobre las restricciones de nomenclatura de otros elementos de Git, como ramas y etiquetas, consulte git check-ref-format.

Nombres de equipo

El nombre del equipo en el que se instala Azure DevOps está asociado al nombre del servidor. Tanto el sistema operativo como Active Directory imponen ciertas restricciones en los nombres de equipo, como se describe en los artículos siguientes:

Construcción de Team Foundation

Team Foundation Build le permite administrar todos los aspectos del proceso de compilación en un solo equipo. Con Team Foundation Build, puede sincronizar orígenes, compilar la aplicación, ejecutar pruebas unitarias asociadas, realizar análisis de código, publicar compilaciones en un servidor de archivos y publicar informes de compilación.

Compilar equipo

Team Foundation Build es una instalación independiente del nivel de aplicación de Azure DevOps Server, el nivel de datos o el cliente de Visual Studio. Puede elegir un equipo independiente o instalar la compilación en paralelo en el equipo cliente o los servidores.

El equipo de compilación local debe cumplir las siguientes restricciones.

Tipo de restricción Restricción
Espacio en disco Debe contener espacio suficiente para la compilación porque el espacio insuficiente conduce a compilaciones con errores.
Directorio de compilación Debe ser una ruta de acceso local como C:\BuildDirectory.
Quitar directorio de ubicación Debe ser una ruta de acceso UNC como \server\share*.
Quitar permisos de ubicación Cada compilación generada debe colocarse en un directorio nuevo en la carpeta drop.
- La cuenta de servicio de Team Foundation Server, por ejemplo Domain\TFSSERVICE, debe tener acceso de control total a la ubicación de colocación de UNC.
- La ubicación de colocación UNC debe ser una carpeta compartida.
Cuenta del servicio Team Foundation Build Si cambia la cuenta de servicio de TFS después de la instalación inicial, debe asegurarse de que:
- La cuenta es miembro del grupo Servicios de compilación.
- La cuenta tiene permisos de lectura y escritura en las carpetas temporales y la carpeta temporal ASP.NET.
- La cuenta tiene permiso control total para el directorio de compilación y la ubicación de entrega.
Firewall Si el equipo de compilación está habilitado para el firewall, asegúrese de que el programa tfsbuildservice está en la lista de excepciones.

Tipos de compilación

Los tipos de compilación son las condiciones para crear una única solución o un conjunto de soluciones en un proyecto. Para ejecutar una compilación, puede crear un nuevo tipo de compilación o usar un tipo de compilación existente.

Los nombres de los tipos de compilación deben cumplir las siguientes restricciones.

Tipo de restricción Restricción
Unicidad No debe ser el mismo que cualquier otro nombre de tipo de compilación en el proyecto.
Caracteres especiales No debe contener el carácter $ signo de dólar.

Calidad de compilación

La calidad de compilación le permite adjuntar un estado de nivel de calidad o finalización a una compilación completada. Para obtener una lista de los valores de calidad de compilación predeterminados, consulte Evaluar la calidad de una compilación completada. Team Foundation Build también le permite crear nuevos valores para el tipo de calidad de compilación.

Los nombres de calidad de compilación deben cumplir las siguientes restricciones.

Tipo de restricción Restricción
Largura No debe contener más de 256 caracteres Unicode.
Unicidad No debe coincidir con ningún otro nombre de calidad de compilación en el equipo de Team Foundation Build.

Nombres de colección de proyectos

La colección de proyectos es la estructura de organización que se usa para definir y controlar un grupo de proyectos para Azure DevOps Server. La colección de proyectos identifica un grupo de proyectos y sus recursos. El nombre de la colección de proyectos también forma parte de la cadena de conexión que se usa para conectar miembros del equipo a proyectos.

El nombre de colección predeterminado asignado a una colección de proyectos corresponde a DefaultCollection. Para obtener más información, consulte Administración de colecciones de proyectos.

Los nombres de colección de proyectos deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Largura No debe contener más de 64 caracteres Unicode.
Unicidad - No deben ser idénticos a ningún otro nombre de colección de su implantación local.
- Si la implementación incluye Productos de SharePoint o SQL Server Reporting Services, sus nombres no pueden ser idénticos al nombre y la ruta de acceso completa de un sitio de SharePoint, servidor de informes o sitio web de Reporting Services existente.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: \/:*?"<>;#$*{},+=[]|.
- No deben contener una elipsis ... ni un punto doble ...
- No debe comenzar con un guion bajo _.
- No debe comenzar ni terminar con un punto ..
No debe ser un nombre reservado del sistema.

Nombres de organización

La organización es la estructura de organización que se usa para definir y controlar un grupo de proyectos para Azure DevOps Services. La organización identifica un grupo de proyectos y sus recursos.

Importante

Siga estas instrucciones al crear el nombre de la organización:

  • Usar solo letras del alfabeto inglés
  • Inicie el nombre de la organización con una letra o un número.
  • Deben utilizar letras, números o guiones después del carácter inicial.
  • Mantenga el nombre de la organización con menos de 50 caracteres Unicode
  • Termine con una letra o un número

Si usa caracteres no permitidos, se muestra el siguiente mensaje de error: VS850015: No se permite usar el nombre especificado: {Nombre de la organización}.

Plantillas de proceso y proceso

Un proceso define los bloques de creación del sistema de seguimiento de elementos de trabajo y otros subsistemas a los que puede acceder después de conectarse a un proyecto. Tanto la plantilla de proceso como la plantilla de proceso hacen referencia a un conjunto interdependente de archivos que se usan para crear un proyecto. Para obtener información sobre los procesos predeterminados, vea Acerca de los procesos y las plantillas de proceso.

Los procesos que defina o personalice deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Largura No debe contener más de 256 caracteres Unicode.
Unicidad - Debe ser único globalmente en Azure DevOps. Si carga una plantilla con el mismo nombre que una plantilla existente, se sobrescribe la plantilla existente.
Tamaño del archivo de plantilla de proceso No debe superar los 2 gigabytes.

Nombres de proyecto

Un proyecto establece un repositorio para el código fuente y un lugar para que los equipos planeen, realicen un seguimiento del progreso y colaboren. El nombre del proyecto forma parte del cadena de conexión que se usa para conectar miembros del equipo a proyectos.

Los nombres que asigne a los proyectos que cree deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Largura No debe contener más de 64 caracteres Unicode.
Unicidad No debe ser idéntico a ningún otro nombre de la organización, colección de proyectos o aplicación web de SharePoint o informe de SQL Server para la colección.
Nombres reservados - No debe ser un nombre reservado del sistema.
- No debe ser uno de los segmentos ocultos utilizados para el filtrado de solicitudes IIS como App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin o web.config.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: \/:*?"'<>;#$*{},+=[]|.
- No debe comenzar con un guion bajo _.
- No debe comenzar ni terminar con un punto ..

Grupos de seguridad

Puede usar grupos de seguridad de Azure DevOps para aplicar determinados derechos o permisos a un grupo de usuarios. Los grupos pueden constar de cuentas de Microsoft Entra o active Directory, grupos de seguridad de Azure DevOps, cuentas de usuario o grupo de Windows o una combinación. Para obtener más información, vea Agregar usuarios o grupos de Active Directory/ Microsoft Entra a un grupo de seguridad integrado.

Los grupos de seguridad deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Longitud del nombre de la cuenta del grupo de seguridad No debe contener más de 256 caracteres Unicode.
Unicidad - Las cuentas de grupo de nivel de proyecto no deben coincidir con ningún otro nombre de grupo en el mismo proyecto.
- Las cuentas de grupo de nivel de organización o colección no deben coincidir con ningún otro nombre de una cuenta de grupo en la organización o colección de proyectos.
Nombres de grupo reservados No debe estar nombrado con un $NAMESPACE ni a nivel de proyecto ni a nivel de servidor.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: ,/\[]:<>+=;?*|.
- No debe incluir caracteres no imprimibles en el intervalo de valores ASCII de 1 a 31.
- No debe terminar en un punto ..

Nombres del equipo

Los nombres de equipo identifican un grupo de individuos o grupos que trabajan juntos como un equipo de un proyecto. Los miembros del equipo utilizan este nombre para conectarse al equipo o para consultar a los miembros definidos para un equipo. Los nombres de equipo deben cumplir con las convenciones que les permitan representarse como parte de una dirección URL válida.

Cada nombre de equipo debe ser único dentro de un único proyecto, pero no hay restricciones en el uso del mismo nombre de equipo en proyectos diferentes dentro de una organización o colección de proyectos. Para obtener más información, consulte Agregar otro equipo o una jerarquía de equipos.

Los nombres de equipo deben cumplir las siguientes restricciones.

Tipo de restricción Restricción
Largura No debe contener más de 64 caracteres Unicode.
Unicidad No debe ser idéntico a ningún otro nombre de equipo del proyecto.
Nombres reservados No debe ser un nombre reservado del sistema.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: \/:*?"<>;#$*{},+=[]|.
- No deben contener una elipsis ... ni un punto doble ...
- No debe comenzar con un guion bajo _.
- No debe comenzar ni terminar con un punto ..

Nombres de cuenta de usuario

Las cuentas de usuario identifican a los usuarios agregados a un proyecto o colección de proyectos. Las cuentas de usuario pueden corresponder a entradas dentro de Active Directory, Microsoft Entra ID o grupo de servidores de Windows.

Para agregar cuentas de usuario a un proyecto, vea Incorporación de usuarios a un proyecto o equipo. Las cuentas de usuario que agregue a una organización o colección deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Longitud del nombre de la cuenta No debe contener más de 256 caracteres Unicode.
Unicidad No debe coincidir con ninguna otra cuenta de usuario de la organización o colección de proyectos.
Nombres de grupo reservados No debe estar nombrado con un $NAMESPACE ni a nivel de proyecto ni a nivel de servidor.
Caracteres especiales - No debe incluir los siguientes caracteres imprimibles: ,."/\[]:<>+=;?*|
- No debe incluir caracteres no imprimibles en el intervalo de valores ASCII de 1 a 31.
- No debe terminar en un punto . o un signo de dólar $.
- No debe incluir las siguientes categorías Unicode: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned.

Nombres de páginas y archivos wiki

Cada página wiki corresponde a un archivo en el repositorio de Git wiki. Las restricciones siguientes se aplican a los nombres de archivo de página y al tamaño del archivo:

  • Nombre de archivo: al elegir un nombre para el archivo de página, tenga en cuenta que la ruta de acceso completa al archivo debe tener 235 caracteres o menos. La ruta de acceso completa a la página consta de la dirección URL del repositorio, la ruta de acceso de carpeta al archivo de página y el nombre del archivo de página. Por ejemplo: https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.

  • Unicidad: el nombre del archivo de página debe ser único dentro de su ubicación de carpeta en la jerarquía del repositorio wiki. El nombre distingue mayúsculas de minúsculas.

  • Caracteres especiales: el nombre del archivo de página tiene restricciones sobre los siguientes caracteres especiales:

    • Sin caracteres de control Unicode ni caracteres suplentes
    • Sin caracteres imprimibles: barra diagonal /, barra diagonal inversa \, hash #
    • Ningún símbolo de punto . al principio o al final del nombre

  • Tamaño del archivo: el tamaño máximo del archivo de página es de 18 MB.

  • Tamaño del archivo adjunto: el tamaño máximo de los datos adjuntos a un archivo de página es de 19 MB.

Caracteres especiales permitidos

En un nombre de archivo de página se pueden incluir varios caracteres especiales, como los dos puntos : y el guion -. Por ejemplo, podría asignar un nombre a un archivo Markdown como faq:0525 o Setup-Guide.

Importante

Para evitar errores en la sintaxis de página y la navegación del explorador, no use el carácter de espacio ( ) en los nombres de archivo de página. Si asigna un nombre a los archivos de página en función del título de la página, reemplace los espacios del título de la página por un guion (-) en el nombre de archivo.

En la tabla siguiente se enumeran los caracteres especiales permitidos en los nombres de archivo de página wiki y la cadena codificada en URI correspondiente:

Carácter Símbolo Cadena de URI
Colon : %3A
Corchete angular izquierdo < %3C
Corchete angular derecho > %3E
Asterisco (comodín) * %2A
Signo de interrogación ? %3F
Barra vertical | %7C
Guion (guion corto) - %2D
Comillas dobles " %22

Por ejemplo, el nombre de archivo FAQ:0525 se codifica como FAQ%3A0525.

Contenido relacionado

  • Last updated on