az repos pr
注意
此參考是 Azure CLI 的 azure-devops 延伸模組的一部分(2.30.0 版或更高版本)。 擴充功能會在您第一次執行 az repos pr 命令時自動安裝。 深入了解擴充功能。
管理提取要求。
命令
名稱 | Description | 類型 | 狀態 |
---|---|---|---|
az repos pr checkout |
如果沒有任何本機變更,請在本機簽出 PR 來源分支。 |
副檔名 | GA |
az repos pr create |
建立提取要求。 |
副檔名 | GA |
az repos pr list |
列出提取要求。 |
副檔名 | GA |
az repos pr policy |
管理提取要求原則。 |
副檔名 | GA |
az repos pr policy list |
列出提取要求的原則。 |
副檔名 | GA |
az repos pr policy queue |
將提取要求的原則評估排入佇列。 |
副檔名 | GA |
az repos pr reviewer |
管理提取要求檢閱者。 |
副檔名 | GA |
az repos pr reviewer add |
將一或多個檢閱者新增至提取要求。 |
副檔名 | GA |
az repos pr reviewer list |
列出提取要求的檢閱者。 |
副檔名 | GA |
az repos pr reviewer remove |
從提取要求中移除一或多個檢閱者。 |
副檔名 | GA |
az repos pr set-vote |
對提取要求進行投票。 |
副檔名 | GA |
az repos pr show |
取得提取要求的詳細數據。 |
副檔名 | GA |
az repos pr update |
更新提取要求。 |
副檔名 | GA |
az repos pr work-item |
管理與提取要求相關聯的工作專案。 |
副檔名 | GA |
az repos pr work-item add |
將一或多個工作項目連結至提取要求。 |
副檔名 | GA |
az repos pr work-item list |
列出提取要求的連結工作專案。 |
副檔名 | GA |
az repos pr work-item remove |
從提取要求取消連結一或多個工作專案。 |
副檔名 | GA |
az repos pr checkout
如果沒有任何本機變更,請在本機簽出 PR 來源分支。
az repos pr checkout --id
[--remote-name]
必要參數
提取要求的標識碼。
選擇性參數
引發PR的 git 遠端名稱。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az repos pr create
建立提取要求。
az repos pr create [--auto-complete {false, true}]
[--bypass-policy {false, true}]
[--bypass-policy-reason]
[--delete-source-branch {false, true}]
[--description]
[--detect {false, true}]
[--draft {false, true}]
[--labels]
[--merge-commit-message]
[--open]
[--optional-reviewers]
[--org]
[--project]
[--repository]
[--required-reviewers]
[--source-branch]
[--squash {false, true}]
[--target-branch]
[--title]
[--transition-work-items {false, true}]
[--work-items]
選擇性參數
設定提取要求,以在所有原則通過且來源分支可以合併至目標分支時自動完成。
略過必要的原則(如果有的話),並在合併提取要求後完成。
略過必要原則的原因。
在提取要求完成並合併至目標分支之後,刪除來源分支。
新提取要求的描述。 可以包含 Markdown。 傳送至這個自變數的每個值都會是新行。 例如:--description “First Line” “Second Line”。
自動偵測組織。
使用此旗標在草稿/工作進行模式中建立提取要求。
與提取要求相關聯的標籤。 以空格分隔。
合併認可時所顯示的訊息。
在網頁瀏覽器中開啟提取要求。
要包含在新提取要求上做為選擇性檢閱者的其他使用者或群組。 以空格分隔。
Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/。
項目的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設,或透過 git 組態挑選,則為必要專案。
要用來建立提取要求之存放庫的名稱或標識碼。
要包含在新提取要求上作為必要檢閱者的其他使用者或群組。 以空格分隔。
來源分支的名稱。 範例:“dev”。
合併至目標分支時,將來源分支中的認可壓縮。
目標分支的名稱。 如果未指定,則會預設為目標存放庫的預設分支。
新提取要求的標題。
將連結至提取要求的任何工作項目轉換為下一個邏輯狀態。 (例如作用中 -> 已解決)。
要連結至新提取要求之工作項目的標識碼。 以空格分隔。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az repos pr list
列出提取要求。
az repos pr list [--creator]
[--detect {false, true}]
[--include-links]
[--org]
[--project]
[--repository]
[--reviewer]
[--skip]
[--source-branch]
[--status {abandoned, active, all, completed}]
[--target-branch]
[--top]
選擇性參數
限制結果以提取此使用者所建立的要求。
自動偵測組織。
針對每個提取要求包含_links。
Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/。
項目的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設,或透過 git 組態挑選,則為必要專案。
存放庫的名稱或標識碼。
限制結果以提取此用戶為檢閱者的要求。
要略過的提取要求數目。
限制結果以提取源自此來源分支的要求。
將結果限製為具有此狀態的提取要求。
將結果限製為以這個分支為目標的提取要求。
要列出之提取要求的數目上限。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az repos pr set-vote
對提取要求進行投票。
az repos pr set-vote --id
--vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
[--detect {false, true}]
[--org]
必要參數
提取要求的標識碼。
提取要求的新投票值。
選擇性參數
自動偵測組織。
Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az repos pr show
取得提取要求的詳細數據。
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
必要參數
提取要求的標識碼。
選擇性參數
自動偵測組織。
在網頁瀏覽器中開啟提取要求。
Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az repos pr update
更新提取要求。
az repos pr update --id
[--auto-complete {false, true}]
[--bypass-policy {false, true}]
[--bypass-policy-reason]
[--delete-source-branch {false, true}]
[--description]
[--detect {false, true}]
[--draft {false, true}]
[--merge-commit-message]
[--org]
[--squash {false, true}]
[--status {abandoned, active, completed}]
[--title]
[--transition-work-items {false, true}]
必要參數
提取要求的標識碼。
選擇性參數
設定提取要求,以在所有原則通過且來源分支可以合併至目標分支時自動完成。
略過必要的原則(如果有的話),並在合併提取要求後完成。
略過必要原則的原因。
在提取要求完成並合併至目標分支之後,刪除來源分支。
提取要求的新描述。 可以包含 Markdown。 傳送至這個自變數的每個值都會是新行。 例如:--description “First Line” “Second Line”。
自動偵測組織。
發佈 PR 或轉換成草稿模式。
合併認可時所顯示的訊息。
Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/。
合併至目標分支時,將來源分支中的認可壓縮。
設定提取要求的新狀態。
提取要求的新標題。
將連結至提取要求的任何工作項目轉換為下一個邏輯狀態。 (例如作用中 -> 已解決)。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。