Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
この記事では、Azure DevOps コンポーネントの名前付け規則、規則、および制限について説明します。 名前付け規則、制限事項、および規則は、一貫性のあるユーザー エクスペリエンスを保証し、他のアプリケーションとの互換性を提供するのに役立ちます。
一般的な考慮事項
一般的な制限には、名前の文字長を超えない、特殊文字を含まない、オブジェクト セット内の名前の一意性の維持などがあります。
長さの制限は、Unicode 文字の数をカウントします。 サロゲート文字は 2 つの Unicode 文字で構成され、長さの制限に対して 2 文字としてカウントされます。 詳細については、「 Unicode と文字セットについて」を参照してください。
他のオペレーティング システム ファイルと同様に、ASCII 制御文字 1 から 31 とサロゲートの組み合わせは許可されません。 ファイル名に適用されるオペレーティング システムの制限に関する一般的な情報については、「 ファイル、パス、および名前空間の名前付け」を参照してください。
定義できる項目数の制限については、「作業の追跡、プロセス、およびプロジェクトの制限」を参照してください。
重要
ユーザー インターフェイス (UI) ではなく Azure DevOps API を使用する場合は、UI に制限された文字を含む名前を直接指定できます。 一貫性を維持し、意図しない問題を防ぐには、UI の制限に従います。 プログラムによって名前を検証し、特殊文字を適切に処理します。
システム予約済み名
次の例のように、システム予約名を使用しないでください。
- AUX
- COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10
- CON
- DefaultCollection
- LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9
- NUL
- PRN
- SERVER、SignalR
- Web または WEB
予約済み名の詳細については、「ファイル名、パス、および名前空間」を参照してください。
Azure Artifacts
Azure Artifacts ユニバーサル パッケージとフィードは、次の制限に準拠している必要があります。
| 制限の種類 | 制限 |
|---|---|
| パッケージ名 | - 小文字で指定する必要があります。 - 英数字で開始および終了する必要があります。 - -_英数字と非連続ハイフン、アンダースコア.、またはピリオドのみを含めることができます。 |
| パッケージ バージョン | - ビルド メタデータを使用せずに小文字にする必要があります。 |
| フィード名 | - 英数字で開始および終了する必要があります。 - 大文字と小文字は区別されませんが、大文字と小文字を区別するだけでは別のフィード名と異なることはできません。 - ピリオド . またはアンダースコア _ で始めたり、ピリオド .で終わったりすることはできません。- 次の文字を含めることはできません: @~;{}'+=,<>|/\?:&$*"#[]%。 |
Azure Boards
Azure Boards では、作業項目を使用して、ソフトウェア開発プロジェクトを計画および追跡します。 作業項目には、実行する作業の説明、作業の割り当て、状態の追跡、チーム内の作業の調整が含まれます。 ユーザー ストーリー、タスク、バグ、問題など、さまざまな種類の作業項目は、さまざまな種類の情報を追跡します。 詳細については、 Azure Boards のドキュメントを参照してください。
作業項目追跡オブジェクトは、1 つ以上の名前に関連付けられます。 作業項目の種類とグローバル リストを除くすべてのオブジェクトには、フィールドの一意のユーザー表示識別子であるフレンドリ表示名があります。 フレンドリ名を使用することで、プロジェクト コレクション内のプロジェクトや作業項目の種類全体で一貫性が保たれます。
作業項目の種類とグローバル リストは、参照名に関連付けられます。 システムは内部的に参照名を使用し、定義後に変更することはできません。
作業項目に関連付けられているいくつかの要素には、参照名、フレンドリ名、フィールド名、添付ファイル のサイズなど、制限があります。
領域パスとイテレーション パス
[区分パス] フィールドと [反復パス] 作業項目フィールドには、作業をグループ化するためのツリー構造階層が用意されています。 エリア パスは、製品、機能、または機能領域ごとに作業項目をグループ化します。 イテレーション パスは、作業項目をスプリント、マイルストーン、または作業に対処するための期間にグループ化します。
これらのマルチノード フィールドでは、円記号 \ 文字を使用して、ツリー構造内のノードの階層を示します。 子ノードに割り当てる名前は、次の制限に準拠している必要があります。
| 制限の種類 | 制限 |
|---|---|
| ノード名の長さ | 255 文字以内で指定します。 |
| 予約済みの名前 | - 1 つのピリオド .、または 2 つのピリオド .. のみを名前として指定することはできません。- PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON、AUX などのシステム予約済み名を使用することはできません。 予約済み名の詳細については、「ファイル名、パス、および名前空間」を参照してください。 |
| ノードで使用できない特殊文字 | - Unicode 制御文字は使用できません。 - 次の文字は使用できません: \ / : * ? " < > | # $ & * +。- ローカル ファイル システムで禁止されている文字は使用できません。 Windows の文字制限の詳細については、「 ファイル、パス、および名前空間の名前付け」を参照してください。 |
| パス名の長さ | 4,000 Unicode 文字を超えてはなりません。 |
| パスの階層の深さ | 深さは 14 レベル未満で指定します。 |
添付ファイル
作業項目に添付されるファイルには、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| ファイル サイズ | 最大サイズを超えてはなりません - 既定の最大サイズ: 4,096 KB。 - 絶対最大サイズ: 2 GB |
詳細については、作業項目の添付ファイルの最大サイズの変更に関する記事を参照してください。
ボードの列とスイムレーン名
ボードは、バックログ作業の視覚的なフローを提供します。 作業が計画から完了に進むにつれて、ボード上の項目を更新します。 各列は作業ステージを表し、各カードはその作業ステージの作業項目を表します。
ボードをカスタマイズするには、 列 と スイムレーンを追加、削除、または名前変更します。 列はボード全体の作業フローをサポートし、スイムレーンを使用すると、ボード上の水平レーンとしてさまざまな作業を管理できます。
列名とスイムレーン名には、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| Length | 256 Unicode 文字を超えてはなりません。 |
| 一意性 | - 列名は、ボード上の他の列名と重複してはなりません。 - スイムレーン名は、ボード上の他のスイムレーン名と重複してはなりません。 |
| 特殊文字 | - Unicode 制御文字またはサロゲート文字は使用できません。 |
フィールド名
各作業項目の種類には、その作業項目の種類に格納されている情報を定義する 1 つ以上のフィールドが含まれています。 各作業項目フィールドには、フィールドを一意に識別するフィールド参照名が関連付けられています。割り当てられた後は変更できません。 組み込みの作業項目フィールドの詳細については、 作業項目フィールドのインデックスを参照してください。
作業項目フィールド名は、プロジェクト コレクションのスコープ内で管理されます。 フィールド名の名前を変更する場合は、コレクション内のすべてのプロジェクトで定義されているすべての作業項目と作業項目の種類に対して変更します。
作業項目フィールド名には、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| Length | 128 Unicode 文字を超えてはなりません。 |
| 一意性 | 組織またはプロジェクト コレクション内で一意でなければなりません。 |
| 特殊文字 | - 少なくとも 1 つの英字を含む必要があります。 - 次の文字を含めてはなりません: .,;':~\/*?"&%$!+=()[]{}<>-|。- 先頭または末尾にスペースは使用できません。 - 2 つ以上の連続するスペースは使用できません。 |
フィールド参照名
作業項目の種類定義言語には、フィールド参照名の概念が含まれています。 フィールド参照名は、Team Foundation プロジェクト コレクション間で定義を移植するのに役立ち、Microsoft 以外の統合で特定のフィールドを検索して参照することができます。 これらの名前 (.NET Framework アプリケーションの名前空間など) は、グローバルに一意です。
プロセス テンプレートの作業項目タイプ定義では、次のフィールドが定義されています。
System 名前空間は、Team Foundation システム関数に必須のすべてのコア システム フィールドを定義するためにのみ使用されます。 独自の
System.Xフィールドを作成することはできません。これは機能を妨げる可能性があるためです。Microsoft 名前空間は、作業項目追跡用のフィールドを定義するために使用されます。 独自の
Microsoft.Xフィールドを作成することはできますが、アップグレード後に機能やプロジェクトを正常に更新できなくなる可能性があるため、推奨されません。
お客様やパートナーは、カスタムの作業項目の種類に対応する独自のフィールド名前空間を作成できます。 既定のプロセス テンプレートで定義されているシステム フィールドとフィールドの説明については、 作業項目フィールドのインデックスを参照してください。
重要
フィールド参照名は変更できません。 たとえば、フィールド名 Title を ヘッダーに変更しても、そのフィールドのフィールド参照名は変更されません。 フィールドの統合と内部表現では、フィールド名の代わりにフィールド参照名を使用する必要があります。
フィールド参照名の例
次の例は、さまざまな名前空間の有効なフィールド参照名を示しています。
| System 名前空間の例 | Microsoft 名前空間の例 | その他の名前空間の例 |
|---|---|---|
| System.Id、System.Title、System.CreatedBy、System.CreatedDate、System.ChangedBy、System.ChangedDate、System.State、System.Reason | 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 |
フィールドのヘルプ テキスト
実行時にヘルプ テキストが表示され、ユーザーがフィールドに入力する内容を把握しやすくなります。 ヘルプ テキストは、特定のプロジェクト内の特定の作業項目の種類に対してスコープが設定されます。
継承プロセスlで、フィールドのヘルプ テキストを指定するには、[編集フィールド] ダイアログボックスの [既定] タブにある [説明] を使用します。 「作業項目の種類にユーザー設定フィールドを追加する」を参照してください。 オンプレミスの XML プロセスでは、 HELPTEXT 要素を使用してヘルプ テキストを指定します。 「作業追跡用のフィールドを追加または変更する」を参照してください。
追加するヘルプ テキストには、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| Length | 255 Unicode 文字を超えてはなりません。 |
グローバル リスト
作業項目の種類を定義していくと、いくつかのフィールドが同じ許容値や推奨値を共有する場合があります。 グローバル リストは、1 回定義し、オンプレミスの Azure DevOps Server のインスタンス内のすべてのプロジェクト コレクションでグローバルに使用できるリスト アイテム値のセットです。
GLOBALLIST要素を使用して定義されたグローバル リストには、LISTITEM要素を使用して指定された 1 つ以上のリスト アイテムが含まれています。 詳細については、「グローバル リストの定義」を参照してください。
グローバル リストには以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| 一意性 | グローバル リストは、Azure DevOps Server インスタンス内で一意である必要があります。 |
| 項目数 | 空にすることはできません。 グローバル リストには、少なくとも 1 つの LISTITEM 要素が含まれている必要があります。 |
LISTITEM 名には、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| Length | - 254 Unicode 文字を超えてはなりません。 - 空にしないでください。 |
| 特殊文字 | - 先頭または末尾にスペースは使用できません。 - 2 つの連続するスペースは使用できません。 - バックスラッシュ \ 文字を含めてはなりません。 |
| Scope | グローバル リストはすべてのプロジェクトで共有されるため、プロジェクト レベルで定義された要素 (プロジェクト固有のグループ アカウント定義など) を含めることはできません。 |
リンクの種類またはカテゴリ参照名
リンクの種類またはカテゴリを追加または作成するときに参照名を定義します。
| 制限の種類 | 制限 |
|---|---|
| Length | 70 Unicode 文字を超えてはなりません。 |
| 一意性 | - プロジェクト コレクション内の他のフィールド参照名と同じにすることはできません。 - システムが名前を処理して、 . すべてのピリオドをアンダースコア _に置き換えた後は、他のフィールド参照名と同じにすることはできません。 たとえば、フィールド参照名 My._Field と My..Field はどちらも同じ名前 ( My__Field) として処理されます。 |
| 特殊文字 | - 英数字、アンダースコア、ハイフン、ピリオドを使用できます。 - 連続するハイフン --を含めることはできません。- .少なくとも 1 つの期間を含める必要がありますが、ピリオドで開始または終了することはできません。- 数字またはアンダースコアの _で始めることはできません。 |
作業項目のクエリ名
作業項目クエリを使用すると、指定したフィールド条件に基づいて作業項目を一覧表示できます。 詳細については、「 マネージド クエリについてを参照してください。
| 制限の種類 | 制限 |
|---|---|
| Length | 255 Unicode 文字を超えてはなりません。 |
| 特殊文字 | - 空にすることはできません。 - /\<>*?"+|:のいずれかの文字を含めてはなりません。 |
| 一意性 | - フォルダーに含まれている必要があり、フォルダー内で一意に名前を付ける必要があります。 |
作業項目タグ名
作業項目タグは、バックログ、ボード、クエリなどの作業追跡ツールをフィルター処理または定義する 1 つまたは 2 つのキーワードで構成されます。 詳細については、「Azure Boards でサンプルの作業項目テンプレートを表示する」を参照してください。
タグ名には、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| Length | - 400 Unicode 文字を超えてはなりません。 - null または空は使用できません。 |
| 特殊文字 | - 区切り文字 , または ;を含めてはなりません。- Unicode コントロールまたは書式設定文字 (改行、段落区切り、復帰、その他の不一致のサロゲート文字など) を含めてはなりません。 |
Azure Pipelines
Azure Pipeline オブジェクトは、次の名前付け制限に準拠している必要があります。
| オブジェクトの種類 | 制限 |
|---|---|
| 式 | - 小文字または大文字の英字またはアンダースコアで始まり、その後に小文字または大文字の英字、数字、アンダースコアが続く必要 _。 |
| 変数 | - 英数字、ピリオド .、アンダースコア _のみを含める必要があります。- 予約済みのプレフィックス endpoint、 input、 secret、 path、または securefileで始めることはできません。大文字と小文字は区別されません。 |
| 段階 | - ステージ名には、英数字とアンダースコア _のみを含める必要があります。- 名前は数字で始めてはなりません。 |
| ジョブとデプロイメントジョブ | - ジョブ名には、英数字とアンダースコア _のみを含める必要があります。- 名前は数字で始めてはなりません。 - 名前に deployなどのキーワードを含めることはできません。 |
| マトリックス ジョブ戦略 | - マトリックス構成名には、英数字とアンダースコア _のみを含める必要があります。- 名前は英字で始まる必要があります。 - 最大長: 100 文字。 |
| リソースのビルド | - ビルド成果物のエイリアスまたは名前には、英数字、ハイフン -、アンダースコアのみを含めなければなりません _。 |
| コンテナー リソース | - コンテナー ID には、英数字、ハイフン -、アンダースコア _のみを含める必要があります。 |
| パッケージ リソース | - パッケージアーティファクトエイリアスには、英数字、ハイフン -、アンダースコア _のみを含める必要があります。 |
| パイプライン リソース | - パイプライン ID には、英数字、ハイフン -、アンダースコア _のみを含める必要があります。 |
| リポジトリ リソース | - リポジトリエイリアスには、英数字、ハイフン -、アンダースコア _のみを含める必要があります。 |
| Webhook リソース | - Webhook 名には、英数字、ハイフン -、アンダースコア _のみを含める必要があります。 |
| ステップス | - ステップ名 ID には、英数字、ハイフン -、アンダースコア _のみを含める必要があります。 |
詳細については、Azure Pipelines のドキュメントを参照してください。
Azure Repos
Azure Repos リポジトリには、Git ベースまたは Team Foundation バージョン管理 (TFVC) ベースを使用できます。
各 Azure DevOps プロジェクトには複数の Git リポジトリを含めることができます。 詳細については、 Azure Repos Git のドキュメントを参照してください。
Git リポジトリ名は、次の制限に準拠している必要があります。
| 制限の種類 | 制限 |
|---|---|
| Length | 64 Unicode 文字を超えてはなりません。 |
| 一意性 | プロジェクト内で他の Git リポジトリ名と重複してはなりません。 |
| 特殊文字 | - Unicode 制御文字またはサロゲート文字は使用できません。 - 次の印刷可能な文字を含めてはなりません: \/:*?"<>;#$*{},+=[]|。- 先頭にアンダースコア _ を使用してはなりません。- 先頭または末尾にピリオド . を使用することはできません。- システム予約済み名を使用することはできません。 - 重要: リポジトリ名にはスペースを含めることができますが、推奨されません。 |
ブランチやタグなどの他の Git 項目の名前付け制限については、 git check-ref-format を参照してください。
コンピューター名
Azure DevOps をインストールしたコンピューター名は、サーバー名と関連付けられます。 オペレーティング システムと Active Directory の両方で、次の記事で説明するように、コンピューター名に特定の制限が適用されます。
Team Foundation ビルド
Team Foundation Build を使用すると、ビルド プロセスのすべての側面を 1 台のコンピューターで管理できます。 Team Foundation Build を使用すると、ソースの同期、アプリケーションのコンパイル、関連する単体テストの実行、コード分析の実行、ファイル サーバーでのビルドのリリース、ビルド レポートの発行を行うことができます。
コンピューターのビルド
Team Foundation Build は、Azure DevOps Server アプリケーション層、データ層、または Visual Studio クライアントとは別のインストールです。 別のコンピューターを選択することも、クライアント コンピューターまたはサーバーにビルドをサイド バイ サイドでインストールすることもできます。
オンプレミスのビルド コンピューターには、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| ディスク領域 | 空き領域が不足するとビルドが失敗するため、ビルドに十分な領域を含める必要があります。 |
| ビルド ディレクトリ | C:\BuildDirectory などのローカル パスである必要があります。 |
| ドロップ場所ディレクトリ | \server\share* などの UNC パスである必要があります。 |
| 場所のアクセス許可を削除する | 生成された各ビルドは、ドロップ フォルダー内の新しいディレクトリに配置する必要があります。 - Team Foundation Server Service アカウント ( Domain\TFSSERVICE など) には、UNC ドロップ場所への フル コントロール アクセス権が必要です。- UNC ドロップ場所は共有フォルダーである必要があります。 |
| Team Foundation Build Service アカウント | 最初のインストール後に TFS サービス アカウントを変更する場合は、次の点を確認する必要があります。 - アカウントが Build Services グループのメンバーであること。 - アカウントに一時フォルダーおよび ASP.NET の一時フォルダーへの読み取り/書き込みアクセス許可があること。 - アカウントには、ビルド ディレクトリとドロップ場所に対する フル コントロール アクセス許可があります。 |
| Firewall | ビルド コンピューターでファイアウォールが有効になっている場合は、プログラム tfsbuildservice が例外リストに含まれていることを確認します。 |
Build 型
ビルドの種類は、1 つのソリューションまたはプロジェクト内の一連のソリューションをビルドするための条件です。 ビルドを実行するには、新しいビルドの種類を作成するか、既存の ビルドの種類を使用します。
ビルドの種類の名前には、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| 一意性 | プロジェクト内の他のビルドの種類の名前と重複してはなりません。 |
| 特殊文字 | ドル記号 $ 文字を含めてはなりません。 |
Build 品質
ビルド品質を使用すると、完了したビルドに品質レベルまたは完了状態を関連付けることができます。 既定のビルド品質値の一覧については、「 完了したビルドの品質を評価する」を参照してください。 Team Foundation Build では、ビルド品質の種類に対して新しい値を作成することもできます。
Build 品質名には、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| Length | 256 Unicode 文字を超えてはなりません。 |
| 一意性 | Team Foundation Build コンピューター上の他のビルド品質名と同じにすることはできません。 |
プロジェクトコレクション名
プロジェクト コレクションは、Azure DevOps Server のプロジェクトのグループを定義および制御するために使用する編成構造です。 プロジェクト コレクションは、プロジェクトとそのリソースのグループを識別します。 プロジェクト コレクション名は、チーム メンバーをプロジェクトに接続するために使用される接続文字列の一部でもあります。
プロジェクト コレクションに割り当てられる既定のコレクション名は DefaultCollection に対応します。 詳細については、「 Manage プロジェクト コレクション」を参照してください。
プロジェクト コレクション名は、次の制限に従う必要があります。
| 制限の種類 | 制限 |
|---|---|
| Length | 64 Unicode 文字を超えてはなりません。 |
| 一意性 | - オンプレミスのデプロイ内の他のコレクション名と重複してはなりません。 - 展開に SharePoint 製品または SQL Server Reporting Services が含まれている場合、その名前を既存の SharePoint サイト、レポート サーバー、または Reporting Services Web サイトの名前と完全パスと同じにすることはできません。 |
| 特殊文字 | - Unicode 制御文字またはサロゲート文字は使用できません。 - 次の印刷可能な文字を含めてはなりません: \/:*?"<>;#$*{},+=[]|。 - 省略記号 ... または二重ピリオド .. は使用できません。- 先頭にアンダースコア _ を使用してはなりません。- 先頭または末尾にピリオド . を使用することはできません。システム予約済み名を使用することはできません。 |
組織名
組織は、Azure DevOps Services のプロジェクト のグループを定義および制御するために使用する組織構造です。 組織は、プロジェクトのグループとそのリソースを識別します。
重要
組織名を作成するときは、次のガイドラインに従います。
- 英語のアルファベットの文字のみを使用します
- 組織名の先頭には、文字または数字を使用します。
- 最初の文字の後には、文字、数字、またはハイフンを使用します
- 組織名は 50 Unicode 文字以内とします
- 末尾には文字または数字を使用します。
許可されていない文字のいずれかを使用すると、次のエラー メッセージが表示されます: VS850015: 指定した名前は使用できません: {組織名}。
プロセス テンプレートとプロセス テンプレート
プロセスは、プロジェクトに接続した後にアクセスできる作業項目追跡システムおよびその他のサブシステムの構成要素を定義します。 プロセス テンプレートとプロセス テンプレートはどちらも、プロジェクトの作成に使用される相互に依存するファイル のセットを指します。 既定のプロセスの詳細については、「 プロセスとプロセス テンプレートについて」を参照してください。
定義またはカスタマイズするプロセスには、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| Length | 256 Unicode 文字を超えてはなりません。 |
| 一意性 | - Azure DevOps 全体で一意である必要があります。 既存のテンプレートと同じ名前のテンプレートをアップロードすると、既存のテンプレートが上書きされます。 |
| プロセス テンプレート ファイルのサイズ | 2 ギガバイトを超えてはなりません。 |
プロジェクト名
プロジェクトでは、ソース コード用のリポジトリと、チームが進捗状況を計画、追跡、共同作業するための場所を確立します。 プロジェクトの名前は、チーム メンバーをプロジェクトに接続するために使用される接続文字列の一部です。
作成するプロジェクトに割り当てる名前には、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| Length | 64 Unicode 文字を超えてはなりません。 |
| 一意性 | コレクションの組織、プロジェクト コレクション、SharePoint Web アプリケーションまたは SQL Server レポート内の他の名前と同じにすることはできません。 |
| 予約済みの名前 | - システム予約済み名を使用することはできません。 - IIS 要求フィルター処理に使用される、 App_Browsers、App_code、App_Data、App_GlobalResources、App_LocalResources、App_Themes、App_WebResources、bin、web.configの非表示のセグメントのいずれかであってはなりません。 |
| 特殊文字 | - Unicode 制御文字またはサロゲート文字は使用できません。 - 印刷可能な文字を含めてはなりません: \/:*?"'<>;#$*{},+=[]|。 - 先頭にアンダースコア _ を使用してはなりません。- 先頭または末尾にピリオド . を使用することはできません。 |
セキュリティ グループ
Azure DevOps セキュリティ グループを使用して、特定の権限またはアクセス許可をユーザーのグループに適用できます。 グループは、Microsoft Entra ID または Active Directory アカウント、Azure DevOps セキュリティ グループ、Windows ユーザーまたはグループ アカウント、または組み合わせで構成される場合があります。 詳細については、「 Active Directory/Microsoft Entra ユーザーまたはグループを組み込みのセキュリティ グループに追加する」を参照してください。
セキュリティ グループには、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| セキュリティ グループ アカウント名の長さ | 256 Unicode 文字を超えてはなりません。 |
| 一意性 | - プロジェクト レベルのグループ アカウントは、同じプロジェクト内の他のグループ名と重複してはなりません。 - 組織レベルまたはコレクション レベルのグループ アカウントは、組織またはプロジェクト コレクション内のグループ アカウントの他の名前と一致してはなりません。 |
| 予約済みグループ名 | プロジェクト レベルまたはサーバー レベルで、$NAMESPACE を名前として使用してはなりません。 |
| 特殊文字 | - Unicode 制御文字またはサロゲート文字は使用できません。 - 印刷可能な文字を含めてはなりません: ,/\[]:<>+=;?*|。 - ASCII 値の 1 から 31 の範囲に印刷できない文字は使用できません。 - ピリオド . で終わることはできません。 |
チーム名
チーム名は、プロジェクトでチームとして連携する個人またはグループのグループを識別します。 チーム メンバーは、この名前を使用してチームに接続したり、チームに対して定義されたメンバーに対してクエリを実行したりします。 チーム名は、有効な URL の一部として表示できる形式に従う必要があります。
各チーム名は 1 つのプロジェクト内で一意である必要がありますが、組織またはプロジェクト コレクション内の異なるプロジェクトで同じチーム名を使用する場合に制限はありません。 詳細については、「別のチームまたはチームの階層を追加する」を参照してください。
チーム名には、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| Length | 64 Unicode 文字を超えてはなりません。 |
| 一意性 | プロジェクト内の他のチーム名と同じにすることはできません。 |
| 予約済みの名前 | システム予約済み名を使用することはできません。 |
| 特殊文字 | - Unicode 制御文字またはサロゲート文字は使用できません。 - 次の印刷可能な文字を含めてはなりません: \/:*?"<>;#$*{},+=[]|。- 省略記号 ... または二重ピリオド .. は使用できません。- 先頭にアンダースコア _ を使用してはなりません。- 先頭または末尾にピリオド . を使用することはできません。 |
ユーザー アカウント名
ユーザー アカウントは、プロジェクトまたはプロジェクト コレクションに追加されたユーザーを識別します。 ユーザー アカウントは、Active Directory、Microsoft Entra ID、または Windows サーバー グループ内のエントリに対応している場合があります。
プロジェクトにユーザー アカウントを追加するには、「プロジェクトまたはチームへのユーザーの追加」を参照してください。 組織またはコレクションに追加するユーザー アカウントには、以下の制限が適用されます。
| 制限の種類 | 制限 |
|---|---|
| アカウント名の長さ | 256 Unicode 文字を超えてはなりません。 |
| 一意性 | 組織またはプロジェクト コレクション内の他のユーザー アカウントと一致してはなりません。 |
| 予約済みグループ名 | プロジェクト レベルまたはサーバー レベルで、$NAMESPACE を名前として使用してはなりません。 |
| 特殊文字 | - 次の印刷可能な文字を含めてはなりません: ,"/\[]:<>+=;?*|.- ASCII 値の 1 から 31 の範囲に印刷できない文字を含めてはなりません。 -末尾にピリオド . またはドル記号 $ を使用してはなりません。- LineSeparator、 ParagraphSeparator、 Control、 Format、 OtherNotAssignedの Unicode カテゴリを含めてはなりません。 |
Wiki ページとファイル名
各 Wiki ページは、Wiki Git リポジトリ内のファイルに対応しています。 ページ ファイル名とファイル サイズには、次の制限が適用されます。
ファイル名: ページ ファイルの名前を選択するときは、ファイルの完全修飾パスが 235 文字以下である必要があることに注意してください。 ページへの完全なパスは、リポジトリ URL、ページ ファイルへのフォルダー パス、およびページ ファイル名で構成されます。 たとえば、
https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.mdのようにします。一意性: ページ ファイル名は、Wiki リポジトリ階層内のフォルダーの場所内で一意である必要があります。 名前の大文字と小文字は区別されます。
特殊文字: ページ ファイル名には、次の特殊文字に関する制限があります。
- Unicode 制御文字またはサロゲート文字なし
- 表示可能文字は使用できません: スラッシュ
/、バックスラッシュ\、ハッシュ記号# - 名前の先頭または末尾にピリオド
.記号がありません
ファイル サイズ: ページ ファイルの最大サイズは 18 MB です。
添付ファイルのサイズ: ページ ファイルへの添付ファイルの最大サイズは 19 MB です。
使用できる特殊文字
ページ ファイル名には、コロン : やハイフン -など、いくつかの特殊文字を使用できます。 たとえば、マークダウン ファイルに FAQ:0525 または Setup-Guide という名前を付けることができます。
重要
ページ構文とブラウザー ナビゲーションでエラーが発生しないようにするには、ページ ファイル名にスペース文字 ( ) を使用しないでください。 ページ タイトルに基づいてページ ファイルに名前を付け、ページ タイトル内のスペースをファイル名にハイフン (-) で置き換えます。
次の表に、Wiki ページ ファイル名で使用できる特殊文字と、対応する URI でエンコードされた文字列を示します。
| 文字 | 記号 | URI 文字列 |
|---|---|---|
| コロン | : |
%3A |
| 左山かっこ | < |
%3C |
| 終わり山かっこ | > |
%3E |
| アスタリスク (ワイルドカード) | * |
%2A |
| 疑問符 | ? |
%3F |
| パイプ | | |
%7C |
| ハイフン (ダッシュ) | - |
%2D |
| 二重引用符 | " |
%22 |
たとえば、ファイル名 FAQ:0525 は FAQ%3A0525としてエンコードされます。