General Settings - Update
更新管線一般設定。
PATCH https://dev.azure.com/{organization}/{project}/_apis/build/generalsettings?api-version=7.1URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 組織的名稱。 |
|
project
|
path | True |
string |
項目識別碼或項目名稱 |
|
api-version
|
query | True |
string |
要使用的 API 版本。 這應該設定為 『7.1』 以使用此版本的 API。 |
要求本文
| 名稱 | 類型 | Description |
|---|---|---|
| auditEnforceSettableVar |
boolean |
如果啟用，每當有人將管線執行排入佇列，並定義未標示為「在佇列時間設定」的變數時，就會產生稽核記錄。 |
| buildsEnabledForForks |
boolean |
啟用分叉存放庫以建置提取要求。 |
| disableClassicBuildPipelineCreation |
boolean |
停用傳統建置管線建立。 |
| disableClassicPipelineCreation |
boolean |
停用傳統管線建立。 |
| disableClassicReleasePipelineCreation |
boolean |
停用傳統發行管線的建立。 |
| enableShellTasksArgsSanitizing |
boolean |
啟用殼層工作自理。 |
| enableShellTasksArgsSanitizingAudit |
boolean |
啟用殼層工作自理預覽。 |
| enforceJobAuthScope |
boolean |
如果已啟用，則所有非發行管線的存取範圍會減少至目前的專案。 |
| enforceJobAuthScopeForForks |
boolean |
為分支存放庫的組建強制執行作業驗證範圍。 |
| enforceJobAuthScopeForReleases |
boolean |
如果啟用，所有發行管線的存取範圍會縮減為目前的專案。 |
| enforceNoAccessToSecretsFromForks |
boolean |
針對分岔存放庫的組建，強制不存取秘密。 |
| enforceReferencedRepoScopedToken |
boolean |
將所有管線的存取範圍限制為只有管線明確參考的存放庫。 |
| enforceSettableVar |
boolean |
如果啟用，只有明確標示為「在佇列時間設定」的變數，才能在佇列時間設定。 |
| forkProtectionEnabled |
boolean |
啟用可強制執行特定層級保護的設定，以從全域分叉建置提取要求。 |
| isCommentRequiredForPullRequest |
boolean |
提出所有提取要求中組建所需的批注。 |
| publishPipelineMetadata |
boolean |
允許管線記錄元數據。 |
| requireCommentsForNonTeamMemberAndNonContributors |
boolean |
提出需要有來自非小組成員和非參與者之提取要求中的組建批注。 |
| requireCommentsForNonTeamMembersOnly |
boolean |
提出需要批注，才能從非小組成員取得提取要求。 |
| statusBadgesArePrivate |
boolean |
除非啟用此選項，否則匿名使用者可以存取所有管線的狀態徽章 API。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
成功作業 |
安全性
oauth2
類型:
oauth2
Flow:
accessCode
授權 URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
權杖 URL:
https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer
範圍
| 名稱 | Description |
|---|---|
| vso.project_write | 授與讀取和更新專案及團隊的權限。 |
定義
PipelineGeneralSettings
包含管線一般設定。
| 名稱 | 類型 | Description |
|---|---|---|
| auditEnforceSettableVar |
boolean |
如果啟用，每當有人將管線執行排入佇列，並定義未標示為「在佇列時間設定」的變數時，就會產生稽核記錄。 |
| buildsEnabledForForks |
boolean |
啟用分叉存放庫以建置提取要求。 |
| disableClassicBuildPipelineCreation |
boolean |
停用傳統建置管線建立。 |
| disableClassicPipelineCreation |
boolean |
停用傳統管線建立。 |
| disableClassicReleasePipelineCreation |
boolean |
停用傳統發行管線的建立。 |
| enableShellTasksArgsSanitizing |
boolean |
啟用殼層工作自理。 |
| enableShellTasksArgsSanitizingAudit |
boolean |
啟用殼層工作自理預覽。 |
| enforceJobAuthScope |
boolean |
如果已啟用，則所有非發行管線的存取範圍會減少至目前的專案。 |
| enforceJobAuthScopeForForks |
boolean |
為分支存放庫的組建強制執行作業驗證範圍。 |
| enforceJobAuthScopeForReleases |
boolean |
如果啟用，所有發行管線的存取範圍會縮減為目前的專案。 |
| enforceNoAccessToSecretsFromForks |
boolean |
針對分岔存放庫的組建，強制不存取秘密。 |
| enforceReferencedRepoScopedToken |
boolean |
將所有管線的存取範圍限制為只有管線明確參考的存放庫。 |
| enforceSettableVar |
boolean |
如果啟用，只有明確標示為「在佇列時間設定」的變數，才能在佇列時間設定。 |
| forkProtectionEnabled |
boolean |
啟用可強制執行特定層級保護的設定，以從全域分叉建置提取要求。 |
| isCommentRequiredForPullRequest |
boolean |
提出所有提取要求中組建所需的批注。 |
| publishPipelineMetadata |
boolean |
允許管線記錄元數據。 |
| requireCommentsForNonTeamMemberAndNonContributors |
boolean |
提出需要有來自非小組成員和非參與者之提取要求中的組建批注。 |
| requireCommentsForNonTeamMembersOnly |
boolean |
提出需要批注，才能從非小組成員取得提取要求。 |
| statusBadgesArePrivate |
boolean |
除非啟用此選項，否則匿名使用者可以存取所有管線的狀態徽章 API。 |