VPC Identity API 변경 내역

IBM Cloud® Virtual Private Cloud (VPC) Identity API의 업데이트 및 개선 사항에 대해 알아보려면 API 변경 내역을 확인하세요. 변경 로그 공지사항은 게시된 날짜 순으로 정렬됩니다. 기존 API 버전에 대한 변경사항은 기존 클라이언트 애플리케이션과 호환되도록 설계되었습니다.

백엔드 호환 불가능 변경사항이 있는 새 기능은 기능 릴리스 이후 날짜의 버전에만 적용되도록 디자인되어 있습니다. 이전 버전의 API에 적용되는 변경사항은 기존 애플리케이션 및 코드와 호환성을 유지하도록 디자인되었습니다. 이전 버전과 호환되지 않는 변경 사항으로 인해 특정 API 버전을 사용하기 위해 클라이언트 코드를 상당히 수정해야 하는 경우, API 변경 내역에는 클라이언트 코드를 업데이트하는 방법에 대한 안내, 팁 또는 모범 사례로 연결되는 링크가 제공될 수 있습니다.

새로운 응답 속성이나 새로운 선택적 요청 매개변수와 같은 일부 변경 사항은 이전 버전과 호환되는 것으로 간주됩니다. 새 필수 요청 매개변수와 같은 다른 변경사항은 이전 버전과 호환되지 않습니다. API 변경으로 인한 중단을 방지하려면 API를 호출할 때 다음 우수 사례를 사용하십시오.

  • 4xx 또는 5xx HTTP 상태 코드 및 포함된 trace 특성을 발견하여 기록합니다.
  • 3xx HTTP 상태 코드에 대해 HTTP 경로 재지정 규칙을 따릅니다.
  • 애플리케이션이 작동하는 데 필요한 리소스와 속성만 사용하십시오
  • 명시적으로 문서화되지 않은 동작에 의존하지 않습니다.

2026년 6월 23일

모든 버전 날짜

타사 라이선스 및 이용 권한 서비스. VPC Identity 서비스는 이제 인스턴스 ID 토큰을 생성할 때 선택 사항인 nonce 매개변수를 지원합니다. 요청에 nonce 값을 지정하면, 이 값이 서명된 토큰 응답에 포함되며, 이를 통해 공급업체 소프트웨어는 해당 소프트웨어가 IBM Cloud 에서 실행 중인지, 그리고 토큰이 최근에 생성된 것인지 확인할 수 있습니다. 이 인증 메커니즘을 통해 공급업체는 자사 소프트웨어가 승인된 IBM Cloud 환경에서 실행되고 있는지 확인할 수 있습니다.

자세한 내용은 ‘인스턴스 식별자 작업’을 참조하십시오.

2025년 8월 26일

모든 버전 날짜

베어 메탈 서버 지원. 이제 베어메탈 서버에서 VPC Identity API에 액세스할 수 있습니다. 새 ID 토큰 만들기 메서드를 사용하여 베어메탈 서버에 대한 ID 토큰을 만들고 해당 토큰을 새 ID 인증서 만들기 메서드로 전달합니다. 또는 해당 토큰을 IAM 액세스 토큰 만들기 메서드에 전달한 다음 해당 토큰을 사용하여 IAM 지원 서비스에 액세스할 수 있습니다. 가상 서버 인스턴스에서도 이러한 새로운 방법을 사용할 수 있습니다. 자세한 내용은 VPC Identity API 를 참조하십시오.

2025-08-26 이상의 버전의 경우

인스턴스 ID 메서드. 또는 이후 2025-08-26 버전의 쿼리 version 매개변수가 사용될 경우, 해당 /instance_identity 메서드들이 제거되었기 때문에 요청이 실패하며 HTTP404 응답 코드 404가 반환됩니다. 클라이언트는 새로운 /identity 메서드로 마이그레이션해야 합니다. 자세한 내용은 2025-08-26 API 버전 마이그레이션 가이드를 참조하세요. 버추얼 서버 인스턴스에서 버전 쿼리 매개변수 `` 2025-08-25 또는 이전 버전이 사용될 때 동작은 변경되지 않습니다.

자세한 내용은 VPC 신원 확인 API 알려진 문제를 참조하세요.