Partilhar via

Restrições e convenções de nomenclatura

Serviços de DevOps do Azure | 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 de usuário consistente e fornecem compatibilidade com outros aplicativos.

Considerações gerais

As restrições comuns incluem não exceder o comprimento de caracteres para um nome, não conter caracteres especiais e manter a exclusividade dos nomes dentro de 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 contra a restrição de comprimento como dois caracteres. Para obter mais informações, consulte Sobre Unicode e conjuntos de caracteres.

  • Tal como acontece com outros ficheiros do sistema operativo, os caracteres de controlo 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 arquivos, consulte Nomeando arquivos, caminhos e namespaces.

  • Para obter limites no número de itens que você pode definir, consulte Limites de controle de trabalho, processo e projeto.

Importante

Ao usar as APIs do Azure DevOps em vez da interface do usuário (UI), você pode especificar diretamente um nome que pode incluir caracteres restritos na interface do usuário. Para manter a consistência e evitar problemas não intencionais, siga as restrições da 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
  • Contra
  • ColeçãoPadrão
  • 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.

Artefactos do Azure

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 ser minúscula.
- Deve começar e terminar com caracteres alfanuméricos.
- Pode conter apenas caracteres alfanuméricos e hífenes - não consecutivos, sublinhados _ ou pontos ..
Versão de pacote - Deve ser minúsculo sem metadados de compilação.
Nome do feed - Deve começar e terminar com caracteres alfanuméricos.
- Não distingue maiúsculas de minúsculas, mas não pode diferir de outro nome de feed apenas pela utilização de maiúsculas ou minúsculas.
- Não pode começar com ponto . ou traço inferior _ ou terminar com ponto ..
- Não é possível incluir nenhum dos seguintes caracteres: @~;{}'+=,<>|/\?:&$*"#[]%.

Azure Boards

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

Os 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 pelo usuário para campos. O uso de nomes amigáveis garante a consistência entre projetos e tipos de item 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 de anexo.

Caminhos de área e iteração

Os campos de itens de trabalho Caminho de Área e Caminho de Iteração fornecem uma hierarquia de estrutura de árvore para agrupar trabalho. Os caminhos de área agrupam itens de trabalho por produto, função ou área de recurso. Os 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 "backslash" \ para denotar a hierarquia de nós dentro da estrutura de árvore. Os nomes atribuídos 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 num 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 Nomeando arquivos, caminhos e namespaces.
Comprimento do caminho Não deve conter mais de 4.000 caracteres Unicode.
Profundidade da hierarquia de caminho Deve ter menos de 14 níveis de profundidade.

Anexos

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

Tipo de restrição Restrição
Tamanho do ficheiro Não deve exceder o tamanho máximo:
- Tamanho máximo padrão: 4.096 kilobytes.
- Tamanho máximo absoluto: 2 gigabytes.

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

Colunas de pranchas e nomes de raias

Um quadro fornece um fluxo visual do trabalho em atraso. À medida que o trabalho progride do planejamento à 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.

É possível personalizar um quadro adicionando, removendo ou renomeando colunas e faixas. As colunas suportam o fluxo de trabalho em todo o tabuleiro, e as raias permitem gerir diferentes trabalhos como faixas horizontais no tabuleiro.

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

Tipo de restrição Restrição
Duração Não deve conter mais de 256 caracteres Unicode.
Singularidade - Os nomes das colunas não devem ser iguais aos de qualquer outro nome de coluna no quadro.
- Os nomes das raias não devem ser iguais aos de qualquer outro nome de raia na prancha.
Carateres especiais Não deve conter caracteres de controle Unicode ou caracteres substitutos.

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 internos, consulte o Índice de campo de item de trabalho.

Os nomes de campo de item de trabalho têm como escopo a coleção de projetos. Se renomeares um campo, isto irá afetar todos os itens de trabalho e tipos de itens de trabalho definidos em todos os projetos na coleção.

Os nomes dos campos de item de trabalho devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Duração Não deve conter mais de 128 caracteres Unicode.
Singularidade Deve ser exclusivo dentro da organização ou coleção de projetos.
Carateres 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 de tipo de item de trabalho inclui o conceito de um nome de referência de campo. 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 façam referência 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 System é usado apenas para definir todos os campos principais do sistema que são obrigatórios para as funções do sistema Team Foundation. Não é possível criar seu próprio System.X campo, porque ele pode impedir a funcionalidade.

  • O namespace da Microsoft é usado para definir campos de controle de item de trabalho. Embora você possa criar seu próprio Microsoft.X campo, ele não é recomendado porque pode impedir a funcionalidade ou a capacidade de atualizar com êxito um projeto 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 do sistema e campos definidos nos modelos de processo padrão, consulte o Índice de campos de item de trabalho.

Importante

Não é possível 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. As integrações e representações internas de campos devem usar o nome de referência de campo em vez do nome de campo.

Exemplos de nomes 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, System.Título, System.CriadoPor, System.DataDeCriação, System.AlteradoPor, System.DataDeAlteração, System.Estado, System.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.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

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

Texto de ajuda do campo

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

Para o processo de herança, especifique o texto de ajuda para um campo através da 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 adicionado deve estar em conformidade com as restrições a seguir.

Tipo de restrição Restrição
Duração 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 seguintes restrições.

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

LISTITEM Os nomes devem respeitar as seguintes restrições:

Tipo de restrição Restrição
Duração - Não deve conter mais de 254 caracteres Unicode.
- Não deve estar vazio.
Carateres 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.
Âmbito 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 ou categoria de link.

Tipo de restrição Restrição
Duração Não deve conter mais de 70 caracteres Unicode.
Singularidade - 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 qualquer outro nome de referência de campo após o sistema processar os nomes para substituir todos os pontos . por sublinhados _. Por exemplo, os nomes de referência de campo My._Field e My..Field seriam processados como o mesmo nome: My__Field.
Carateres especiais - Pode usar caracteres alfanuméricos, sublinhados, hífenes e pontos.
- Não pode conter hífenes --consecutivas.
- Deve conter pelo menos um período ., mas não pode começar ou terminar com um período.
- Não pode começar com um numeral ou sublinhado _.

Nomes de itens de trabalho para consulta

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
Duração Não deve conter mais de 255 caracteres Unicode.
Carateres especiais - Não pode estar vazio.
- Não deve conter nenhum dos seguintes caracteres: /\<>*?"+|:.
Singularidade - Deve estar contido em uma pasta e ser nomeado exclusivamente dentro da pasta.

Nomes de tags de item de trabalho

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

Os nomes das tags devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Duração - Não deve conter mais de 400 caracteres Unicode.
- Não deve ser nulo ou vazio.
Carateres especiais - Não deve conter os caracteres separadores , ou ;.
- Não deve conter caracteres de controle ou formato Unicode, como feeds de linha, separadores de parágrafo, retornos de carro ou outros caracteres substitutos incompatíveis.

Azure Pipelines (Pipelines do Azure)

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 minúsculo ou maiúsculo ou sublinhado, seguido por caracteres alfabéticos minúsculos ou maiúsculos, algarismos ou sublinhados _.
Variáveis - Deve conter apenas caracteres alfanuméricos, pontos ., e caracteres de sublinhado _.
- Não pode começar com os prefixos reservados endpoint, input, secret, path ou securefile, sem distinção entre maiúsculas e minúsculas.
Estágios - O nome artístico deve conter apenas caracteres alfanuméricos e sublinhados _.
- O nome não deve começar com um número.
Trabalhos e trabalhos de implementação - O nome do trabalho deve conter apenas caracteres alfanuméricos e sublinhados _.
- O nome não deve começar com um número.
- O nome não pode conter palavras-chave como deploy.
Estratégia matricial de trabalho - 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 - Alias ou nome do artefato de construção deve conter apenas caracteres alfanuméricos, hífens - e sublinhados _.
Recursos do contêiner - O ID do contêiner deve conter apenas caracteres alfanuméricos, hífenes -e sublinhados _.
Recursos do pacote - O alias do artefato do pacote deve conter apenas caracteres alfanuméricos, hífens - e sublinhados _.
Recursos de Canalização - O ID do pipeline deve conter apenas caracteres alfanuméricos, hífenes -e sublinhados _.
Recursos do repositório - O alias do repositório deve conter apenas caracteres alfanuméricos, hífenes -e sublinhados _.
Recursos do Webhook - O nome do Webhook deve conter apenas caracteres alfanuméricos, hífenes -e sublinhados _.
Passos - O ID do nome da etapa deve conter apenas caracteres alfanuméricos, hífenes -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 Controle de Versão do Team Foundation (TFVC).

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

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

Tipo de restrição Restrição
Duração Não deve conter mais de 64 caracteres Unicode.
Singularidade Não deve ser idêntico a qualquer outro nome de repositório Git no projeto.
Carateres especiais - Não pode conter carateres de controlo Unicode ou carateres de substituição.
- Não deve conter os seguintes caracteres imprimíveis: \/:*?"<>;#$*{},+=[]|.
- Não deve começar com um sublinhado _.
- Não deve começar ou terminar com um período ..
- Não deve ser um nome reservado do sistema.
- Importante: Embora você possa incluir espaços nos nomes dos repositórios, isso não é recomendado.

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

Nomes de computadores

O nome do computador onde você instala o Azure DevOps está associado ao nome do servidor. Tanto o sistema operacional quanto o Ative Directory impõem certas restrições aos nomes dos computadores, conforme descrito nos seguintes artigos:

Construção do Team Foundation

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

Construir computador

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

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

Tipo de restrição Restrição
Espaço em disco Deve conter espaço suficiente para a compilação, pois a falta de espaço leva a compilações falhadas.
Construir diretório Deve ser um caminho local, como C:\BuildDirectory.
Diretório de local de descarte Deve ser um caminho UNC, como \server\share*.
Permissões de local de descarte Cada compilação gerada deve ser colocada em um novo diretório na pasta drop.
- A conta de serviço do Team Foundation Server, por exemplo Domain\TFSSERVICE, deve ter acesso de controle total ao local de descarte UNC.
- O local de entrega UNC deve ser uma pasta compartilhada.
Conta do Serviço Team Foundation Build Se você alterar a conta do Serviço TFS após a instalação inicial, deverá certificar-se de que:
- 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 local de colocação.
Firewall Se o computador de compilação estiver habilitado para firewall, verifique se o programa tfsbuildservice está na lista de exceções.

Tipos de compilação

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

Os nomes de tipo de compilação devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Singularidade Não deve ser o mesmo que qualquer outro nome de tipo de compilação no projeto.
Carateres especiais Não deve incluir o caractere "$" $.

Qualidade de construção

A qualidade de compilação permite anexar um nível de qualidade ou estado de conclusão a uma compilação concluída. Para obter uma lista dos valores de qualidade de compilação padrão, consulte Classificar a qualidade de uma compilação concluída. Team Foundation Build também permite que você crie novos valores para o tipo de qualidade de compilação.

Os nomes de qualidade de compilação devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Duração Não deve conter mais de 256 caracteres Unicode.
Singularidade Não deve ser o mesmo que qualquer outro nome de qualidade de compilação no computador Team Foundation Build.

Nomes das coleções de projetos

A coleção de projetos é a estrutura de organização 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 os membros da equipe aos projetos.

O nome de 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 das coleções de projetos devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Duração Não deve conter mais de 64 caracteres Unicode.
Singularidade - Não deve ser idêntico a qualquer 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 existente do SharePoint, servidor de relatório ou site do Reporting Services.
Carateres especiais - Não pode conter carateres de controlo Unicode ou carateres de substituição.
- Não deve conter os seguintes caracteres imprimíveis: \/:*?"<>;#$*{},+=[]|.
- Não deve conter reticências ... ou períodos duplos ...
- Não deve começar com um sublinhado _.
- Não deve começar ou terminar com um período ..
Não deve ser um nome reservado do sistema.

Nomes da organização

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

Importante

Siga estas orientações 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 número
  • Use letras, números ou hífenes após o caractere inicial
  • Mantenha o nome da sua organização abaixo de 50 caracteres Unicode
  • Terminar com uma letra ou número

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

Modelos de processos e processos

Um processo define os blocos de construção do sistema de controle de item de trabalho e outros subsistemas que você pode acessar depois de se conectar a um projeto. O modelo de processo e o modelo 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
Duração Não deve conter mais de 256 caracteres Unicode.
Singularidade - Deve ser exclusivo no 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 dos 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 os membros da equipe aos projetos.

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

Tipo de restrição Restrição
Duração Não deve conter mais de 64 caracteres Unicode.
Singularidade Não deve ser idêntico a qualquer 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 como App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin, ou web.config.
Carateres especiais - Não pode conter carateres de controlo Unicode ou carateres de substituição.
- Não deve conter os seguintes caracteres imprimíveis: \/:*?"'<>;#$*{},+=[]|.
- Não deve começar com um sublinhado _.
- Não deve começar ou terminar com um período ..

Grupos de segurança

Você pode usar os 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 Ative 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 Ative Directory / Microsoft Entra a um grupo de segurança interno.

Os grupos de segurança devem respeitar as seguintes restrições.

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.
Singularidade - 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 deve ser nomeado com um $NAMESPACE no nível do projeto ou do servidor.
Carateres especiais - Não pode conter carateres de controlo Unicode ou carateres de substituição.
- 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-31.
- Não deve terminar em um período ..

Nomes das equipas

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 para consultar membros definidos para uma equipe. Os nomes de equipe devem estar em conformidade com as convenções que permitem que eles sejam renderizados como parte de uma URL válida.

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

Os nomes das equipas devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Duração Não deve conter mais de 64 caracteres Unicode.
Singularidade Não deve ser idêntico a qualquer outro nome de equipe no projeto.
Nomes reservados Não deve ser um nome reservado do sistema.
Carateres especiais - Não pode conter carateres de controlo Unicode ou carateres de substituição.
- Não deve conter os seguintes caracteres imprimíveis: \/:*?"<>;#$*{},+=[]|.
- Não deve conter reticências ... ou períodos duplos ...
- Não deve começar com um sublinhado _.
- Não deve começar ou terminar com um período ..

Nomes de contas de utilizador

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 Ative Directory, Microsoft Entra ID ou grupo de servidores do Windows.

Para adicionar contas de usuário a um projeto, consulte Adicionar usuários a um projeto ou equipe. As contas de usuário adicionadas a uma organização ou coleção devem estar em conformidade com as seguintes restrições.

Tipo de restrição Restrição
Comprimento do nome da conta Não deve conter mais de 256 caracteres Unicode.
Singularidade 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 deve ser nomeado com um $NAMESPACE no nível do projeto ou do servidor.
Carateres 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-31.
- Não deve terminar em um período . ou um cifrão $.
- Não deve incluir as seguintes categorias Unicode: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned.

Nomes de páginas e ficheiros Wiki

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

  • Nome do arquivo: Ao escolher um nome para o arquivo de paginação, lembre-se de que o caminho totalmente qualificado para o arquivo deve ter 235 caracteres ou menos. O caminho completo para a página consiste no URL do repositório, no caminho da pasta para o arquivo de paginação 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 paginação deve ser exclusivo dentro de seu local de pasta na hierarquia de repositório wiki. O nome é sensível a maiúsculas e minúsculas.

  • Caracteres especiais: O nome do arquivo de paginação tem restrições sobre os seguintes caracteres especiais:

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

  • Tamanho do ficheiro: O tamanho máximo do ficheiro de paginação é de 18 MB.

  • Tamanho do ficheiro anexo: O tamanho máximo de qualquer anexo a um ficheiro de paginação é de 19 MB.

Caracteres especiais permitidos

Vários carateres especiais são permitidos num nome de ficheiro de página, como os dois pontos : e o hífen -. Por exemplo, você pode nomear um arquivo Markdown como FAQ:0525 ou Setup-Guide.

Importante

Para evitar erros na sintaxe da página e na navegação do navegador, não use o caractere de espaço ( ) nos nomes dos arquivos de página. Se você nomear seus arquivos de página com base no título da página, substitua quaisquer 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 por URI correspondente:

Caráter Símbolo Cadeia de caracteres URI
Cólon : %3A
Colchete angular esquerdo < %3C
Colchete angular reto > %3E
Asterisco (curinga) * %2A
Ponto de interrogação ? %3F
Tubo | %7C
Hífen (traço) - %2D
Citação dupla " 22%

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

Conteúdo relacionado

  • Last updated on