az repos pr

管理提取要求。

命令

az repos pr checkout

如果沒有本機變更,請在本機簽出 PR 來源分支。

az repos pr create

建立提取要求。

az repos pr list

列出提取要求。

az repos pr policy

管理提取要求原則。

az repos pr policy list

列出提取要求的原則。

az repos pr policy queue

將原則評估排入佇列以取得提取要求。

az repos pr reviewer

管理提取要求檢閱者。

az repos pr reviewer add

將一或多個檢閱者新增至提取要求。

az repos pr reviewer list

列出提取要求的檢閱者。

az repos pr reviewer remove

從提取要求中移除一或多個檢閱者。

az repos pr set-vote

對提取要求投票。

az repos pr show

取得提取要求的詳細資料。

az repos pr update

更新提取要求。

az repos pr work-item

管理與提取要求相關聯的工作專案。

az repos pr work-item add

將一或多個工作專案連結至提取要求。

az repos pr work-item list

列出提取要求的連結工作專案。

az repos pr work-item remove

從提取要求取消連結一或多個工作專案。

az repos pr checkout

如果沒有本機變更,請在本機簽出 PR 來源分支。

az repos pr checkout --id
                     [--remote-name]

必要參數

--id

提取要求的識別碼。

選擇性參數

--remote-name

引發 PR 的 git 遠端名稱。

預設值: origin

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}]
                   [--merge-commit-message]
                   [--open]
                   [--org]
                   [--project]
                   [--repository]
                   [--reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

選擇性參數

--auto-complete

設定提取要求,以在傳遞所有原則且來源分支可以合併至目標分支時自動完成。

接受的值: false, true
--bypass-policy

如果有任何) 並完成提取要求,請略過必要的原則 (一旦合併。

接受的值: false, true
--bypass-policy-reason

略過必要原則的原因。

--delete-source-branch

在提取要求完成併合並到目標分支之後,刪除來源分支。

接受的值: false, true
--description -d

新提取要求的描述。 可以包含 Markdown。 傳送至這個引數的每個值都會是新的一行。 例如:--description 「First Line」 「Second Line」。

--detect

自動偵測組織。

接受的值: false, true
--draft

使用此旗標在草稿/工作進行模式中建立提取要求。

接受的值: false, true
--merge-commit-message

合併認可時所顯示的訊息。

--open

在網頁瀏覽器中開啟提取要求。

--org --organization

Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL來設定預設組織。 如果未設定為預設值,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/

--project -p

專案的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID來設定預設專案。 如果未設定為預設值,或透過 git 組態挑選,則為必要專案。

--repository -r

要建立提取要求之存放庫的名稱或識別碼。

--reviewers

其他使用者或群組,以在新的提取要求上加入為檢閱者。 空格分隔。

--source-branch -s

來源分支的名稱。 範例:「dev」。

--squash

合併至目標分支時,清除來源分支中的認可。

接受的值: false, true
--target-branch -t

目標分支的名稱。 如果未指定,預設為目標存放庫的預設分支。

--title

新提取要求的標題。

--transition-work-items

將連結至提取要求的任何工作專案轉換為下一個邏輯狀態。 (例如作用中 - > 已解析) 。

接受的值: false, true
--work-items

要連結至新提取要求的工作專案識別碼。 空格分隔。

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]

選擇性參數

--creator

限制結果以提取此使用者所建立的要求。

--detect

自動偵測組織。

接受的值: false, true
--include-links

針對每個提取要求包含_links。

--org --organization

Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL來設定預設組織。 如果未設定為預設值,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/

--project -p

專案的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID來設定預設專案。 如果未設定為預設值,或透過 git 組態挑選,則為必要專案。

--repository -r

存放庫的名稱或識別碼。

--reviewer

限制結果以提取此使用者為檢閱者的要求。

--skip

要略過的提取要求數目。

--source-branch -s

限制結果以提取源自此來源分支的要求。

--status

限制結果以提取具有此狀態的要求。

接受的值: abandoned, active, all, completed
--target-branch -t

限制結果以提取以這個分支為目標的要求。

--top

要列出之提取要求的數目上限。

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]

必要參數

--id

提取要求的識別碼。

--vote

提取要求的新投票值。

接受的值: approve, approve-with-suggestions, reject, reset, wait-for-author

選擇性參數

--detect

自動偵測組織。

接受的值: false, true
--org --organization

Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL來設定預設組織。 如果未設定為預設值,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/

az repos pr show

取得提取要求的詳細資料。

az repos pr show --id
                 [--detect {false, true}]
                 [--open]
                 [--org]

必要參數

--id

提取要求的識別碼。

選擇性參數

--detect

自動偵測組織。

接受的值: false, true
--open

在網頁瀏覽器中開啟提取要求。

--org --organization

Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL來設定預設組織。 如果未設定為預設值,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/

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}]

必要參數

--id

提取要求的識別碼。

選擇性參數

--auto-complete

設定提取要求,以在傳遞所有原則且來源分支可以合併至目標分支時自動完成。

接受的值: false, true
--bypass-policy

如果有任何) 並完成提取要求,請略過必要的原則 (一旦合併。

接受的值: false, true
--bypass-policy-reason

略過必要原則的原因。

--delete-source-branch

在提取要求完成併合並到目標分支之後,刪除來源分支。

接受的值: false, true
--description -d

提取要求的新描述。 可以包含 Markdown。 傳送至這個引數的每個值都會是新的一行。 例如:--description 「First Line」 「Second Line」。

--detect

自動偵測組織。

接受的值: false, true
--draft

發佈 PR 或轉換為草稿模式。

接受的值: false, true
--merge-commit-message

合併認可時所顯示的訊息。

--org --organization

Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/

--squash

合併至目標分支時,將來源分支中的認可壓縮。

接受的值: false, true
--status

設定提取要求的新狀態。

接受的值: abandoned, active, completed
--title

提取要求的新標題。

--transition-work-items

將連結至提取要求的任何工作專案轉換為下一個邏輯狀態。 (例如作用中 - > 已解決) 。

接受的值: false, true