@@ -112,7 +112,8 @@ az repos show --org https://dev.azure.com/myorg/ --project MyProject --repositor
112112```
113113
114114Example output:
115- ```
115+
116+ ``` text
116117b3e18946-5b39-40ca-8e2f-d0eb683d8a85
117118```
118119
@@ -343,6 +344,7 @@ az devops migrations resume --detect false --repository-id <GUID> --validate-onl
343344** Symptom:** ` Request failed with status 401 ` or ` 403 ` .
344345
345346** Fix:**
347+
3463481 . Run ` az login ` (AAD) or ` az devops login ` (PAT).
3473492 . Ensure the token/account has permission to the organization.
3483503 . Verify ` --org ` points to the correct Azure DevOps org URL.
@@ -352,6 +354,7 @@ az devops migrations resume --detect false --repository-id <GUID> --validate-onl
352354** Symptom:** ` Request failed with status 404 ` .
353355
354356** Fix:**
357+
3553581 . Verify ` --org ` is correct (e.g., ` https://dev.azure.com/myorg ` ).
3563592 . Verify the ` --repository-id ` is a valid GUID that exists in the organization.
357360
@@ -360,6 +363,7 @@ az devops migrations resume --detect false --repository-id <GUID> --validate-onl
360363** Symptom:** ` Request failed with status 400 ` or ` JsonReaderException ` .
361364
362365** Fix:**
366+
3633671 . Check date values are valid ISO 8601 strings (e.g., ` 2030-12-31T11:59:00Z ` ).
3643682 . Ensure ` --target-repository ` is a valid URL.
3653693 . Ensure ` --agent-pool ` matches a pool name the service recognizes.
@@ -380,6 +384,7 @@ az devops migrations create --detect false --repository-id <GUID> --target-repos
380384```
381385
382386Supported policy names:
387+
383388- ` None `
384389- ` ActivePullRequestCount `
385390- ` PullRequestDeltaSize `
@@ -397,26 +402,28 @@ Supported policy names:
397402** Symptom:** ` resume --migration ` does not proceed, or returns a state error.
398403
399404** Fix:**
405+
4004061 . Confirm current state first:
401407
402408``` powershell
403409az devops migrations status --detect false --repository-id <GUID> -o json
404410```
405411
406- 2 . If migration is active, pause then retry:
412+ 1 . If migration is active, pause then retry:
407413
408414``` powershell
409415az devops migrations pause --detect false --repository-id <GUID>
410416az devops migrations resume --detect false --repository-id <GUID> --migration
411417```
412418
413- 3 . If migration already succeeded as full migration, abandon and recreate if needed.
419+ 1 . If migration already succeeded as full migration, abandon and recreate if needed.
414420
415421### 406 Not Acceptable
416422
417423** Symptom:** ` Request failed with status 406 ` .
418424
419425** Fix:**
426+
4204271 . Verify ` --org ` is correct.
4214282 . Confirm you are using the latest CLI extension version.
4224293 . Contact your admin if it persists.
@@ -426,6 +433,7 @@ az devops migrations resume --detect false --repository-id <GUID> --migration
426433** Symptom:** ` Max retries exceeded with url: ... (Caused by ResponseError('too many 500 error responses')) ` .
427434
428435** Fix:**
436+
4294371 . Check if the requests are going to the ** wrong host** (e.g., ` codedev.ms ` instead of your org URL).
430438 - Run ` az devops configure -l ` to check your default org.
431439 - Fix with ` az devops configure -d organization=https://dev.azure.com/<your-org> ` .
0 commit comments