API를 사용하여 멤버 역할 업데이트

기존 조직의 멤버를 새 역할로 마이그레이션하려면 API를 사용해야 합니다. 이 문서의 각 섹션의 단계를 따르십시오.

Snyk은 속도 제한기(rate limiters)를 초과하지 않도록 제한된 동시성으로 배치(batches)하여 이러한 업데이트를 실행할 것을 권장합니다. 최적으로는 한 번에 10개의 동시 요청으로 업데이트를 수행하십시오.

1단계: 그룹의 역할 목록 가져오기

요청: GET https://api.snyk.io/v1/group/{groupId}/roles

엔드포인트: 그룹의 모든 역할 나열

이 호출은 사용자 정의 역할 및 비사용자 정의(예: 기본) 역할을 설명하는 객체 배열을 반환합니다. 기본 역할은 customRole: false 속성으로 표시됩니다. 사용자에게 할당하려는 각 역할의 publicId를 저장합니다.

요청: GET https://api.snyk.io/v1/org/{orgId}/members

엔드포인트: 멤버 목록

이 호출은 조직의 모든 비관리자 멤버 배열을 반환합니다. 새 역할을 가져야 하는 각 사용자의 id를 저장합니다.

서비스 계정은 멤버 목록 엔드포인트에 의해 반환되지 않습니다. 서비스 계정 설정 페이지에서 각 서비스 계정의 publicID를 가져와야 합니다:

**서비스 계정 설정(Service Accounts Settings)**에서 publicID를 얻으려는 서비스 계정의 **이름(name)**을 선택합니다.
계정 이름 편집(Edit account name) 창이 열리면 URL 끝에 있는 문자열을 복사합니다. 이것이 서비스 계정의 publicID입니다.

요청: PUT https://api.snyk.io/v1/org/{orgId}/members/update/{userId}

엔드포인트: 조직에서 멤버 역할 업데이트

각 사용자에 대해 이전에 수집한 사용자 ID 및 역할 ID를 사용하여 조직에서 멤버 역할을 업데이트하는 엔드포인트를 호출하여 멤버의 새 역할을 설정합니다.

JSON 형식의 요청 본문에 rolePublicId를 전달합니다. 이것이 1단계에서 저장한 역할의 publicId입니다.

요청이 성공하면 응답은 200 OK입니다.

(사람의 경우) 조직 멤버 페이지에서 변경 사항을 확인하거나 (로봇의 경우) 서비스 계정 설정 페이지에서 변경 사항을 확인할 수 있습니다.

Last updated 11 days ago