접속 호스트(Host) API (V2)

Host는 Foundry 플랫폼 인스턴스에 접속할 수 있는 호스트 이름입니다. 응답 모델에는 필수 문자열 hostName이 있습니다.

List Hosts에 플랫폼 인스턴스 RID를 지정하면 해당 인스턴스의 호스트 목록을 조회합니다. api:admin-read OAuth 권한 범위가 필요합니다. 이 API는 미리보기 기능이므로 preview=true를 지정해야 하며 언제든 변경되거나 제거될 수 있습니다.

페이지 조회

첫 요청에는 pageToken을 넣지 않습니다. 실제 반환 개수는 요청한 pageSize보다 작거나 클 수 있습니다. 결과가 더 있으면 nextPageToken이 채워지므로 다음 요청에 전달합니다. 응답에 다음 토큰이 없으면 마지막 페이지입니다.

다른 호스트 설정과 구분

이 목록은 플랫폼 인스턴스에 접속할 수 있는 호스트를 나타냅니다. 조직의 host는 해당 조직 사용자의 URL을 만들 때 사용할 기본 호스트입니다.

인증 제공자의 supportedHosts는 그 제공자를 사용할 수 있는 호스트 범위입니다. 플랫폼 호스트 목록, 조직 기본 호스트와 인증 제공자의 지원 호스트는 서로 다른 설정입니다.