버전 관리 및 지원

이 문서에서는 다양한 프로그래밍 도구에 대한 버전 관리 및 주요 변경 정책에 대한 개요를 제공합니다.

지원 및 지원 중단 정보

Power Platform API는 PowerShell, Management Connectors, Power Platform CLI와 같은 다른 SDK보다 먼저 새로운 버전과 기능을 수신하는 최초의 프로그래밍 도구입니다. REST API의 새 버전이 출시됨에 따라 이전 버전은 폐기됩니다. Microsoft API를 폐기하기 최소 12개월 전에 해당 버전을 더 이상 사용할 수 없게 선언합니다. 끝점. 버전이 더 이상 사용되지 않는 경우에도 그대로 지원됩니다. 해당 버전에 문제가 있는 경우 현재 일반적으로 사용 가능한 버전으로 이동하도록 요청할 것입니다. 버전이 폐기되면 지원되지 않으며 곧 종료됩니다.

API의 버전 번호를 증가시키면(예: 2021-10-01에서 2022-04-01로), Microsoft 이전에 일반적으로 출시된 버전(이 예에서는 2021-10-01)이 즉시 더 이상 지원되지 않으며, 발표 후 12개월 후에 서비스가 중단될 것임을 알립니다. 공개 프리뷰 버전에 대해서도 동일한 처리가 적용됩니다. Microsoft 서비스 상태 및 보안 문제로 인해 이 정책에 대한 예외가 있을 수 있습니다.

PowerShell cmdlet의 경우 사소한 버그 수정을 해결하기 위해 증분 버전을 사용할 수 있습니다. 주요 버전은 발생하는 새 API 버전과 일치하도록 증분됩니다.

호환성 및 호환성이 손상되는 변경

Microsoft 릴리스 계획의 프로그래밍 변경 사항에 대한 세부 정보를 제공합니다. 본질적인 호환성이 손상되지 않는 변경의 경우 API 버전은 동일하게 유지되고 PowerShell 버전은 마이너 버전 증분을 받습니다. 변경 사항이 본질적으로 손상되는 경우 Microsoft API 버전과 PowerShell 주요 버전이 증가합니다.

다음은 호환성이 손상되는 변경의 예입니다.

• URL 또는 기본 요청/응답이 변경되었습니다.
• 선언된 속성이 제거되거나 이름이 변경되거나 그 유형이 변경됩니다.
• API 또는 API 매개 변수가 제거되거나 이름이 변경됩니다.
• 필요한 요청 매개 변수가 추가되었습니다.

다음은 호환성이 손상되지 않는 변경의 예입니다.

• nullable이거나 기본값이 있는 속성이 추가됩니다.
• 구성원이 열거에 추가됩니다.
• 기존 컬렉션에 페이징이 도입되었습니다.
• 오류 코드가 변경됩니다.
• 요청 또는 응답의 속성 순서가 변경됩니다.

사용 가능 버전

다음 단계

이제 버전 관리 및 지원 전략을 이해했으므로 Microsoft Power Platform API로 인증하는 방법을 살펴보겠습니다.

• 인증 (프리뷰) - 공개 프리뷰 릴리스용
• 인증(레거시) - 일반적으로 사용 가능한 릴리스용