Rozwiązywanie problemów z uprawnieniami Azure DevOps

Ten artykuł wyjaśnia, jak identyfikować i rozwiązywać typowe błędy związane z uprawnieniami w Azure DevOps poprzez interpretację kodów błędów i komunikatów API.

Podczas wykonywania operacji backupu lub przywracania w Azure DevOps możesz sporadycznie napotkać błędy odmowy dostępu. Choć niektóre komunikaty są ogólne, Azure DevOps często dostarcza specyficzne kody błędów i opisy, które wskazują bezpośrednio na brakujące uprawnienie.

---

Zrozumienie błędów uprawnień

Jeśli zadanie zakończy się niepowodzeniem z powodu niewystarczających uprawnień, Xopero ONE wyświetli błąd zwrócony przez API Azure DevOps w podsumowaniu zadania. Komunikaty te zazwyczaj mają strukturę zawierającą pole message oraz typeName.

Kod błędu / Typ	Przykład komunikatu	Rozwiązanie
TF401027	You need the Git 'CreateRepository' permission to perform this action.	Kontu brakuje uprawnienia Create repository na poziomie repozytoriów.
VS402356	You do not have the permissions required to perform the attempted operation on this process.	Kontu brakuje uprawnienia Create process lub Edit process na poziomie organizacji.
TF50309	The following permissions are needed to perform this operation: Create new projects.	Kontu brakuje uprawnienia Create new projects na poziomie organizacji.
VS800075	The project with id 'proj' does not exist, or you do not have permission to access it.	Błąd ogólny: Występuje, gdy konto w ogóle nie ma dostępu do projektu. Zweryfikuj poziom dostępu użytkownika (User Access Level) oraz członkostwo w projekcie.

---

Rozwiązywanie błędów uprawnień

Jeśli napotkasz jeden z powyższych błędów, wykonaj poniższe kroki, aby dostosować konfigurację:

1

Zidentyfikuj zakres (scope) — sprawdź w komunikacie o błędzie, czy zakres dotyczy projektu, organizacji, czy repozytorium.

2

Zweryfikuj tożsamość — upewnij się, że tożsamość wymieniona w błędzie (np. identity '...\\[email protected]') zgadza się z kontem użytym do integracji z Xopero ONE.

3

Dostosuj ustawienia w Azure DevOps:

• Przejdź do Project Settings lub Organization Settings w panelu Azure DevOps.

• Otwórz kartę Permissions lub Security.

• Znajdź użytkownika lub grupę, do której należy i ustaw brakujące uprawnienie (np. Create new projects) na Allow.

4

Ponów zadanie — Po zaktualizowaniu uprawnień wróć do panelu Xopero ONE i uruchom ponownie przerwane zadanie.

Podobnie jak w przypadku integracji z GitHub, Xopero ONE dynamicznie przetwarza te komunikaty, aby pomóc zidentyfikować dokładnie to uprawnienie, które należy dodać w panelu Azure DevOps. Zawsze sprawdzaj Podsumowanie zadania, aby uzyskać szczegółową listę wymaganych uprawnień.