Compartilhar via

Restrições e convenções de nomenclatura

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

Este artigo descreve as regras de nomenclatura, convenções e restrições para componentes do Azure DevOps. Regras de nomenclatura, restrições e convenções ajudam a garantir uma experiência consistente do usuário e a fornecer compatibilidade com outros aplicativos.

Considerações gerais

As restrições comuns incluem não exceder a quantidade de caracteres de um nome, não conter caracteres especiais e manter a exclusividade dos nomes em um conjunto de objetos.

  • As restrições de comprimento contam o número de caracteres Unicode. Os caracteres substitutos são compostos por dois caracteres Unicode, que contam como dois caracteres na restrição de comprimento. Para obter mais informações, consulte Sobre Unicode e conjuntos de caracteres.

  • Assim como acontece com outros arquivos do sistema operacional, os caracteres de controle ASCII 1-31 e combinações substitutas não são permitidos. Para obter informações gerais sobre as restrições do sistema operacional aplicadas a nomes de arquivo, consulte Nomenclatura de arquivos, caminhos e namespaces.

  • Para obter limites quanto ao número de itens que você pode definir, consulte Acompanhamento de trabalho, processo e limites de projeto.

Importante

Ao usar as APIs do Azure DevOps em vez da interface do usuário (IU), você pode especificar diretamente um nome que pode incluir caracteres restritos na IU. Para manter a consistência e evitar problemas não intencionais, siga as restrições de interface do usuário. Valide nomes programaticamente e manipule caracteres especiais adequadamente.

Nomes reservados do sistema

Evite usar nomes reservados do sistema, como os seguintes exemplos:

  • 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 ou WEB

Para obter mais informações sobre nomes reservados, consulte Nomes de arquivos, caminhos e namespaces.

Azure Artifacts

Os pacotes e feeds universais do Azure Artifacts devem estar em conformidade com as seguintes restrições:

Tipo de restrição Restrição
Nome do pacote - Deve estar em letras minúsculas.
- Deve iniciar e terminar com caracteres alfanuméricos.
- Pode conter apenas caracteres alfanuméricos e hifens não consecutivos -, sublinhados _ ou pontos ..
Versão do pacote - Deve estar em letras minúsculas sem metadados de build.
Nome do feed - Deve iniciar e terminar com caracteres alfanuméricos.
- Não diferencia maiúsculas de minúsculas, mas não pode ser diferente de outro nome de feed somente pelo uso de maiúsculas.
- Não pode começar com ponto . ou sublinhado _ ou terminar com ponto ..
- Não é possível incluir nenhum dos seguintes caracteres: @~;{}'+=,<>|/\?:&$*"#[]%.

Azure Boards

O Azure Boards usa itens de trabalho para planejar e acompanhar projetos de desenvolvimento de software. Os itens de trabalho descrevem o trabalho a ser feito, atribuem tarefas, acompanham o status e coordenam esforços dentro de uma equipe. Diferentes tipos de itens de trabalho, como histórias de usuário, tarefas, bugs e problemas, acompanham diferentes tipos de informações. Para obter mais informações, consulte a documentação do Azure Boards.

Objetos de rastreamento de itens de trabalho são associados a um ou mais nomes. Todos os objetos, exceto tipos de item de trabalho e listas globais, têm nomes de exibição amigáveis, que são identificadores exclusivos e visíveis para o usuário para campos. O uso de nomes amigáveis garante a consistência entre projetos e tipos de itens de trabalho em uma coleção de projetos.

Tipos de item de trabalho e listas globais são associados a nomes de referência. O sistema usa os nomes de referência internamente e você não pode alterá-los uma vez definidos.

Vários elementos associados a itens de trabalho têm restrições, incluindo nomes de referência, nomes amigáveis, nomes de campo e tamanho do anexo.

Caminhos de área e iteração

Os campos de item de trabalho Caminho da Área e Caminho da Iteração fornecem uma hierarquia de estrutura de árvore para o trabalho de agrupamento. Os caminhos de área agrupam itens de trabalho por produto, função ou área de recurso. Caminhos de iteração agrupam itens de trabalho em sprints, marcos ou períodos de tempo para abordar o trabalho.

Esses campos de vários nós usam o caractere de barra \ invertida para indicar a hierarquia de nós dentro da estrutura da árvore. Os nomes que você atribuir aos nós filhos devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento do nó Não deve conter mais de 255 caracteres.
Nomes reservados - Não deve consistir apenas em um período . ou dois períodos ...
– Não deve ser um nome reservado ao sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON ou AUX. Para obter mais informações sobre nomes reservados, consulte Nomes de arquivos, caminhos e namespaces.
Caracteres especiais para nós – Não deve conter caracteres de controle Unicode.
- Não deve conter nenhum dos seguintes caracteres: \ / : * ? " < > | # $ & * +.
– Não deve conter caracteres proibidos pelo sistema de arquivos local. Para obter mais informações sobre restrições de caracteres do Windows, consulte Nomenclatura de arquivos, caminhos e namespaces.
Comprimento do caminho Não deve conter mais de 4.000 caracteres Unicode.
Profundidade da hierarquia do caminho Deve ter menos de 14 níveis de profundidade.

Anexos

Os arquivos anexados a itens de trabalho devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Tamanho do arquivo Não deve exceder o tamanho máximo:
- Tamanho máximo padrão: 4.096 KB.
- Tamanho máximo absoluto: 2 GB.

Para mais informações, consulte Alterar o tamanho máximo do anexo para itens de trabalho.

Nomes de raias e colunas do quadro

Uma quadro fornece um fluxo visual de trabalho pendente. À medida que o trabalho progride do planejamento até a conclusão, você atualiza os itens no quadro. Cada coluna representa um estágio de trabalho e cada cartão representa um item de trabalho nesse estágio de trabalho.

Você pode personalizar um quadro ao adicionar, remover ou renomear colunas e swimlanes. Os colunas suportam o fluxo de trabalho em todo o quadro, e as raias permitem que você gerencie diferentes tipos de trabalho como faixas horizontais no quadro.

Os nomes das colunas e raias devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 256 caracteres Unicode.
Exclusividade - Os nomes das colunas não devem ser iguais a qualquer outro nome de coluna no quadro.
- Os nomes das raias não devem ser iguais a de qualquer outro nome de raia no quadro.
Caracteres especiais Não deve conter caracteres de controle Unicode ou caracteres alternativos.

Nomes de campo

Cada tipo de item de trabalho contém um ou mais campos que definem as informações armazenadas para esse tipo de item de trabalho. Cada campo de item de trabalho tem um nome de referência de campo associado que identifica exclusivamente o campo e não pode ser alterado uma vez atribuído. Para obter mais informações sobre campos de item de trabalho padrão, consulte o índice de campos de itens de trabalho.

Os nomes de campo de item de trabalho têm como escopo a coleção de projetos. Se você renomear um campo, a mudança será aplicada a todos os itens de trabalho e tipos de itens definidos em todos os projetos da coleção.

Os nomes de campo de item de trabalho devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 128 caracteres Unicode.
Exclusividade Deve ser exclusivo dentro da organização ou coleção de projetos.
Caracteres especiais - Deve conter pelo menos um caractere alfabético.
- Não deve conter nenhum dos seguintes caracteres: .,;':~\/*?"&%$!+=()[]{}<>-|.
- Não deve conter espaços à esquerda ou à direita.
- Não deve conter dois ou mais espaços consecutivos.

Nomes de referência de campo

A linguagem de definição do tipo de item de trabalho inclui o conceito de um nome de referência de campo. Os nomes de referência de campo podem ajudá-lo a portar definições entre coleções de projetos do Team Foundation e permitir que integrações que não sejam da Microsoft localizem e se refiram a campos específicos. Esses nomes, como namespaces em aplicativos .NET Framework, são globalmente exclusivos.

Os campos a seguir são definidos em uma definição de tipo de item de trabalho dos modelos de processo:

  • O namespace Sistema é usado apenas para definir todos os campos principais do sistema que são obrigatórios para as funções do sistema da Team Foundation. Você não pode criar seu próprio System.X campo, pois ele pode impedir a funcionalidade.

  • O namespace Microsoft é usado para definir campos de acompanhamento de item de trabalho. Embora você possa criar seu próprio Microsoft.X campo, ele não é recomendado porque ele pode impedir a funcionalidade ou a capacidade de atualizar um projeto com êxito após uma atualização.

Clientes e parceiros podem criar seus próprios namespaces de campo para tipos de item de trabalho personalizados. Para obter descrições de campos e campos do sistema definidos nos modelos de processo padrão, consulte o índice de campos de item de trabalho.

Importante

Você não pode alterar nomes de referência de campo. Por exemplo, se você alterar o nome do campo Título para Cabeçalho, o nome de referência de campo desse campo não será alterado. Integrações e representações internas de campos devem usar o nome de referência de campo em vez do nome do campo.

Exemplos de nome de referência de campo

Os exemplos a seguir mostram nomes de referência de campo válidos em vários namespaces.

Exemplos de namespace do sistema Exemplos de namespace da Microsoft Outros exemplos de namespace
System.Id, Sistema.Título, Sistema.CriadoPor, Sistema.DataDeCriação, Sistema.AlteradoPor, Sistema.DataDeAlteração, Sistema.Estado, Sistema.Motivo 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.Comum.Severidade, FabrikamFiber.Comum.Fase, FabrikamFiber.GestãoDeRisco.TipoDeRisco, FabrikamFiber.GestãoDeRisco.Resolução

Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase

Texto de ajuda de campo

O sistema exibe texto de ajuda em runtime para ajudar os usuários a saber o que inserir no campo. O texto de ajuda tem como escopo um tipo de item de trabalho específico em um projeto específico.

Para o processo de herança, você deve especificar o texto de ajuda de um campo na caixa de diálogo Editar campo, guia Definição, Descrição. Consulte Adicionar um campo personalizado a um tipo de item de trabalho. Para o processo XML local, especifique o texto de ajuda usando o HELPTEXT elemento. Consulte Adicionar ou modificar um campo para acompanhamento de trabalho.

O texto de ajuda que você adiciona deve estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 255 caracteres Unicode.

Listas globais

Ao definir tipos de item de trabalho, você pode descobrir que alguns campos de item de trabalho compartilham o mesmo conjunto de valores permitidos ou sugeridos. Uma lista global é um conjunto de valores de item de lista que você pode definir uma vez e usar globalmente em todas as coleções de projetos em uma instância do Azure DevOps Server local.

Uma lista global definida usando o GLOBALLIST elemento contém um ou mais itens de lista especificados usando o LISTITEM elemento. Para obter detalhes, consulte Definir listas globais.

As listas globais devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Exclusividade A lista global deve ser exclusiva na instância do Servidor do Azure DevOps.
Número de itens Não deve estar vazio. A lista global deve conter pelo menos um elemento LISTITEM.

LISTITEM nomes devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento - Não deve conter mais de 254 caracteres Unicode.
- Não deve ficar vazio.
Caracteres especiais - Não deve conter espaço em branco à esquerda ou à direita.
- Não deve conter dois espaços consecutivos.
- Não deve conter o caractere de barra \ invertida.
Scope Como as listas globais estão disponíveis entre todos os projetos, elas não devem conter elementos definidos no nível do projeto, como definições de conta de grupo específicas do projeto.

Defina um nome de referência ao adicionar ou criar um tipo de link ou categoria.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 70 caracteres Unicode.
Exclusividade - Não deve ser o mesmo que qualquer outro nome de referência de campo dentro da coleção de projetos.
- Não deve ser idêntico a nenhum outro nome de referência de campo depois que o sistema processa os nomes para substituir todos os períodos . por sublinhados _. Por exemplo, os nomes de referência de campo, My._Field e My..Field, seriam ambos processados como o mesmo nome: My__Field.
Caracteres especiais - Pode usar caracteres alfanuméricos, sublinhados, hifens e períodos.
- Não pode conter hifens consecutivos --.
- Deve conter pelo menos um período ., mas não pode iniciar ou terminar com um período.
- Não é possível começar com um numeral ou sublinhado _.

Nomes de consulta de item de trabalho

Você pode usar consultas de item de trabalho para listar itens de trabalho com base nos critérios de campo especificados. Para obter mais informações, consulte Sobre consultas gerenciadas.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 255 caracteres Unicode.
Caracteres especiais - Não pode estar vazio.
- Não deve conter nenhum dos seguintes caracteres: /\<>*?"+|:.
Exclusividade - Deve estar contido em uma pasta e ser nomeado exclusivamente dentro da pasta.

Nomes de etiquetas de item de trabalho

As marcas de item de trabalho consistem em uma ou duas palavras-chave que filtram ou definem ferramentas de acompanhamento de trabalho, como listas de pendências, quadros e consultas. Para obter mais informações, consulte Adicionar marcas de itens de trabalho para classificar e filtrar listas e quadros.

Os nomes de marcas devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento - Não deve conter mais de 400 caracteres Unicode.
- Não deve ser nula nem estar vazia.
Caracteres especiais - Não deve conter caracteres separadores , ou ;.
- Não deve conter caracteres de controle Unicode ou de formato, como alimentação de linha, separadores de parágrafo, retorno de carro ou outros caracteres substitutos incompatíveis.

Azure Pipelines

Os objetos do Azure Pipeline devem estar em conformidade com as seguintes restrições de nomenclatura.

Tipo de objeto Restrição
Expressões - Deve começar com um caractere alfabético em letras minúsculas ou maiúsculas ou sublinhado, seguido por caracteres alfabéticos minúsculos ou maiúsculos, numerais ou sublinhados _.
Variáveis - Deve conter apenas caracteres alfanuméricos, períodos .e sublinhados _.
- Não é possível começar com os prefixos reservados endpoint, input, secret, path ou securefile, sem diferenciar maiúsculas de minúsculas.
Estágios - O nome do estágio deve conter apenas caracteres alfanuméricos e sublinhados _.
- O nome não deve começar com um numeral.
Tarefas e tarefas de implantação - O nome do trabalho deve conter apenas caracteres alfanuméricos e sublinhados _.
- O nome não deve começar com um numeral.
- O nome não pode conter palavras-chave como deploy.
Estratégia de trabalho de matriz - O nome da configuração da matriz deve conter apenas caracteres alfanuméricos e sublinhados _.
- O nome deve começar com um caractere alfabético.
- Comprimento máximo: 100 caracteres.
Criar recurso - O alias ou o nome do artefato de build deve conter apenas caracteres alfanuméricos, hifens -e sublinhados _.
Recursos do contêiner - A ID do contêiner deve conter apenas caracteres alfanuméricos, hifens -e sublinhados _.
Recursos do pacote - O alias do artefato do pacote deve conter apenas caracteres alfanuméricos, hifens -e sublinhados _.
Recursos de pipeline - A ID do pipeline deve conter apenas caracteres alfanuméricos, hifens -e sublinhados _.
Recursos do repositório - O alias do repositório deve conter apenas caracteres alfanuméricos, hifens -e sublinhados _.
Recursos do Webhook - O nome do webhook deve conter apenas caracteres alfanuméricos, hifens -e sublinhados _.
Etapas - A ID do nome da etapa deve conter apenas caracteres alfanuméricos, hifens -e sublinhados _.

Para obter mais informações, consulte a documentação do Azure Pipelines.

Azure Repos

Os repositórios do Azure Repos podem ser baseados em Git ou no TFVC (Team Foundation Version Control).

Cada projeto do Azure DevOps pode conter vários repositórios Git. Para obter mais informações, consulte a documentação do Git do Azure Repos.

Os nomes do repositório Git devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 64 caracteres Unicode.
Exclusividade Não deve ser idêntico a nenhum outro nome de repositório Git no projeto.
Caracteres especiais – Não deve conter caracteres de controle Unicode ou caracteres alternativos.
- Não deve conter os seguintes caracteres imprimíveis: \/:*?"<>;#$*{},+=[]|.
- Não deve começar com um sublinhado _.
- Não deve iniciar ou terminar com um período ..
- Não deve ser um nome reservado do sistema.
- Importante: embora você possa incluir espaços em nomes de repositório, não é recomendável.

Para obter informações sobre restrições de nomenclatura para outros itens do Git, como branches e marcas, consulte git check-ref-format.

Nomes de computadores

O nome do computador no qual você instala o Azure DevOps está associado ao nome do servidor. O sistema operacional e o Active Directory impõem determinadas restrições aos nomes de computador, conforme descrito nos seguintes artigos:

Compilação do Team Foundation

O Team Foundation Build permite que você gerencie todos os aspectos do processo de compilação em um único computador. Usando o Team Foundation Build, você pode sincronizar fontes, compilar o aplicativo, executar testes de unidade associados, executar análise de código, compilações de versão em um servidor de arquivos e publicar relatórios de build.

Computador de compilação

O Team Foundation Build é uma instalação separada da camada de aplicativo Azure DevOps Server, da camada de dados ou do cliente do Visual Studio. Você pode escolher um computador separado ou instalar o build lado a lado no computador cliente ou servidores.

Seu computador de compilação local deve estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Espaço em disco Deve conter espaço suficiente para a compilação porque o espaço insuficiente leva a builds falhados.
Diretório de compilação Deve ser um caminho local, como C:\BuildDirectory.
Diretório de local de descarte Deve ser um caminho UNC, como \server\share*.
Revogar permissões de localização Cada build gerado deve ser colocado em um novo diretório na pasta suspensa.
- A conta do Serviço do Team Foundation Server, por exemplo Domain\TFSSERVICE, deve ter acesso de Controle Total ao local de descarte UNC.
- O local de destino UNC deve ser uma pasta compartilhada.
Conta do Team Foundation Build Service Se você alterar a conta de Serviço do TFS após a instalação inicial, verifique se:
- A conta é membro do grupo Build Services.
- A conta tem permissões de leitura/gravação para as pastas temporárias e a pasta temporária ASP.NET.
- A conta tem permissão de Controle Total para o diretório de build e o local de descarte.
Firewall Se o computador de build estiver habilitado para firewall, verifique se o programa tfsbuildservice está na lista de exceções.

Tipos de build

Os tipos de build são as condições para criar uma única solução ou um conjunto de soluções em um projeto. Para executar um build, você pode criar um novo tipo de build ou usar um tipo de build existente.

Os nomes de tipo de build devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Exclusividade Não deve ser igual a qualquer outro nome de tipo de compilação no projeto.
Caracteres especiais Não deve conter o sinal de dólar caractere $.

Qualidade do build

A qualidade do build permite adicionar um nível de qualidade ou estado de conclusão a um build concluído. Para obter uma lista dos valores padrão de qualidade de build, veja Avalie a qualidade de um build concluído. O Team Foundation Build também permite criar novos valores para o tipo de qualidade da compilação.

Os nomes de qualidade do build devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 256 caracteres Unicode.
Exclusividade Não deve ser o mesmo que qualquer outro nome de qualidade de build no computador do Team Foundation Build.

Nomes de coleção de projetos

A coleção de projetos é a estrutura organizadora que você usa para definir e controlar um grupo de projetos para o Azure DevOps Server. A coleção de projetos identifica um grupo de projetos e seus recursos. O nome da coleção de projetos também faz parte da cadeia de conexão usada para conectar membros da equipe a projetos.

O nome da coleção padrão atribuído a uma coleção de projetos corresponde a DefaultCollection. Para obter mais informações, consulte Gerenciar coleções de projetos.

Os nomes da coleção de projetos devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 64 caracteres Unicode.
Exclusividade - Não deve ser idêntico a nenhum outro nome de coleção em sua implantação local.
- Se sua implantação incluir Produtos do SharePoint ou SQL Server Reporting Services, seus nomes não poderão ser idênticos ao nome e ao caminho completo de um site do SharePoint, servidor de relatório ou site do Reporting Services existente.
Caracteres especiais – Não deve conter caracteres de controle Unicode ou caracteres alternativos.
- Não deve conter os seguintes caracteres imprimíveis: \/:*?"<>;#$*{},+=[]|.
- Não deve conter reticências ... ou ponto duplo ...
- Não deve começar com um sublinhado _.
- Não deve iniciar ou terminar com um período ..
Não deve ser um nome reservado do sistema.

Nomes de organização

A organização é a estrutura organizadora que você usa para definir e controlar um grupo de projetos para o Azure DevOps Services. A organização identifica um grupo de projetos e seus recursos.

Importante

Siga estas diretrizes ao criar o nome da sua organização:

  • Use apenas letras do alfabeto inglês
  • Inicie o nome da sua organização com uma letra ou um número
  • Use letras, números ou hífens após o caractere inicial
  • Manter o nome da sua organização abaixo de 50 caracteres Unicode
  • Termine com uma letra ou um número

Se você usar caracteres não permitidos, a seguinte mensagem de erro será exibida: VS850015: O nome especificado não poderá ser usado: {Nome da organização}.

Processo e modelos de processo

Um processo define os blocos de construção do sistema de acompanhamento de item de trabalho e outros subsistemas que você pode acessar depois de se conectar a um projeto. O modelo de processo e de processo referem-se a um conjunto interdependente de arquivos usados para criar um projeto. Para obter informações sobre os processos padrão, consulte Sobre processos e modelos de processo.

Os processos que você define ou personaliza devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 256 caracteres Unicode.
Exclusividade - Deve ser exclusivo em todo o Azure DevOps. Se você carregar um modelo com o mesmo nome de um modelo existente, o modelo existente será substituído.
Tamanho do arquivo de modelo de processo Não deve exceder 2 gigabytes.

Nomes de projetos

Um projeto estabelece um repositório para o código-fonte e um local para as equipes planejarem, acompanharem o progresso e colaborarem. O nome do projeto faz parte da cadeia de conexão usada para conectar membros da equipe a projetos.

Os nomes atribuídos aos projetos criados devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 64 caracteres Unicode.
Exclusividade Não deve ser idêntico a nenhum outro nome na organização, coleção de projetos ou aplicativo Web do SharePoint ou relatório do SQL Server para a coleção.
Nomes reservados - Não deve ser um nome reservado do sistema.
- Não deve ser um dos segmentos ocultos usados para filtragem de solicitações do IIS, comoApp_Browsers, App_code, , App_DataApp_GlobalResources, App_LocalResources, App_Themes, App_WebResources, binou web.config.
Caracteres especiais – Não deve conter caracteres de controle Unicode ou caracteres alternativos.
- Não deve conter os seguintes caracteres imprimíveis: \/:*?"'<>;#$*{},+=[]|.
- Não deve começar com um sublinhado _.
- Não deve iniciar ou terminar com um período ..

Grupos de segurança

Você pode usar grupos de segurança do Azure DevOps para aplicar determinados direitos ou permissões a um grupo de usuários. Os grupos podem consistir em contas do Microsoft Entra ID ou do Active Directory, grupos de segurança do Azure DevOps, contas de usuário ou grupo do Windows ou uma combinação. Para obter mais informações, consulte Adicionar usuários ou grupos do Active Directory/Microsoft Entra a um grupo de segurança interno.

Os grupos de segurança devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento do nome da conta do grupo de segurança Não deve conter mais de 256 caracteres Unicode.
Exclusividade - As contas de grupo no nível do projeto não devem corresponder a nenhum outro nome de grupo no mesmo projeto.
- As contas de grupo no nível da organização ou da coleção não devem corresponder a nenhum outro nome de uma conta de grupo na organização ou na coleção de projetos.
Nomes de grupos reservados Não devem ser nomeados com um $NAMESPACE no nível do projeto ou do servidor.
Caracteres especiais – Não deve conter caracteres de controle Unicode ou caracteres alternativos.
- Não deve conter os seguintes caracteres imprimíveis: ,/\[]:<>+=;?*|.
- Não deve incluir caracteres não imprimíveis no intervalo de valores ASCII de 1 a 31.
- Não deve terminar com um ponto ..

Nomes da equipe

Os nomes de equipe identificam um grupo de indivíduos ou grupos que trabalham juntos como uma equipe em um projeto. Os membros da equipe usam esse nome para se conectar à equipe ou consultar membros definidos para uma equipe. Os nomes da equipe precisam estar em conformidade com as convenções que permitem que eles sejam renderizados como parte de um URL válido.

Cada nome de equipe deve ser exclusivo em um único projeto, mas não há restrições para usar o mesmo nome de equipe em projetos diferentes em uma organização ou coleção de projetos. Para obter mais informações, consulte Adicionar outra equipe ou uma hierarquia de equipes.

Os nomes da equipe devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento Não deve conter mais de 64 caracteres Unicode.
Exclusividade Não deve ser idêntico a nenhum outro nome de equipe no projeto.
Nomes reservados Não deve ser um nome reservado do sistema.
Caracteres especiais – Não deve conter caracteres de controle Unicode ou caracteres alternativos.
- Não deve conter os seguintes caracteres imprimíveis: \/:*?"<>;#$*{},+=[]|.
- Não deve conter reticências ... ou ponto duplo ...
- Não deve começar com um sublinhado _.
- Não deve iniciar ou terminar com um período ..

Nomes de contas de usuário

As contas de usuário identificam os usuários adicionados a um projeto ou coleção de projetos. As contas de usuário podem corresponder a entradas no Active Directory, na ID do Microsoft Entra ou no grupo de servidores do Windows.

Para adicionar as contas de usuário a um projeto, confira Adicionar usuários a um projeto ou uma equipe. As contas de usuário que você adiciona a uma organização ou coleção devem estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Comprimento do nome da conta Não deve conter mais de 256 caracteres Unicode.
Exclusividade Não deve corresponder a nenhuma outra conta de usuário na organização ou coleção de projetos.
Nomes de grupos reservados Não devem ser nomeados com um $NAMESPACE no nível do projeto ou do servidor.
Caracteres especiais - Não deve incluir os seguintes caracteres imprimíveis: ,."/\[]:<>+=;?*|
- Não deve incluir caracteres não imprimíveis no intervalo de valores ASCII de 1 a 31.
- Não deve terminar em um ponto . ou um cifrão $.
- Não deve incluir as seguintes categorias Unicode: LineSeparator, , ParagraphSeparator, Control, , FormatOtherNotAssigned.

Página wiki e nomes de arquivos

Cada página wiki corresponde a um arquivo no repositório Git wiki. As seguintes restrições se aplicam aos nomes de arquivo de página e ao tamanho do arquivo:

  • Nome do arquivo: ao escolher um nome para o arquivo de página, tenha em mente que o caminho totalmente qualificado para o arquivo deve ter 235 caracteres ou menos. O caminho completo para a página consiste na URL do repositório, no caminho da pasta para o arquivo de página e no nome do arquivo de página. Por exemplo, https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.

  • Exclusividade: o nome do arquivo de página deve ser exclusivo em seu local de pasta na hierarquia de repositório wiki. O nome diferencia maiúsculas de minúsculas.

  • Caracteres especiais: o nome do arquivo de página tem restrições sobre os seguintes caracteres especiais:

    • Sem caracteres de controle Unicode ou caracteres alternativos
    • Sem caracteres imprimíveis: barra /, barra invertida \, hash #
    • Nenhum símbolo de ponto . no início ou no final do nome

  • Tamanho do arquivo: o tamanho máximo do arquivo de página é de 18 MB.

  • Tamanho do arquivo de anexo: o tamanho máximo de qualquer anexo a um arquivo de página é de 19 MB.

Caracteres especiais permitidos

São permitidos diversos caracteres especiais no nome de arquivo de uma página, como dois-pontos : e hífen -. Por exemplo, você pode nomear um arquivo Markdown como Perguntas Frequentes:0525 ou Guia de Instalação.

Importante

Para evitar erros na sintaxe da página e na navegação do navegador, não use o caractere de espaço ( ) em nomes de arquivo de página. Se você nomear seus arquivos de página com base no título da página, substitua todos os espaços no título da página por um hífen (-) no nome do arquivo.

A tabela a seguir lista os caracteres especiais permitidos em nomes de arquivo de página wiki e a cadeia de caracteres codificada em URI correspondente:

Caractere Símbolo Cadeia de caracteres de URI
Dois-pontos : %3A
Colchete angular esquerdo < %3C
Colchete angular direito > %3E
Asterisco (curinga) * %2A
Ponto de interrogação ? %3F
Tubo | %7C
Hífen (traço) - %2D
Aspas duplas " %22

Por exemplo, o nome do arquivo FAQ:0525 é codificado como FAQ%3A0525.

Conteúdo relacionado

  • Last updated on