Microsoft Foundry 모델의 Azure OpenAI는 다양한 기능과 가격표가 있는 다양한 모델 집합에 의해 구동됩니다. 모델 가용성은 지역에 따라 다릅니다.
Models List API 사용하여 Azure OpenAI 리소스에서 유추 및 미세 조정 모두에 사용할 수 있는 모델 목록을 가져올 수 있습니다.
이 문서에서는 다음 방법을 보여줍니다.
- 자동 모델 업데이트를 구성합니다.
- 배포의 버전 업그레이드 정책을 보고 업데이트합니다.
- Azure Resource Manager API를 사용하여 배포된 모델 버전을 업데이트합니다.
- 프로비전된 배포를 다른 모델 버전 또는 제품군으로 마이그레이션합니다.
필수 구성 요소
- Azure OpenAI 모델을 포함하는 Azure 구독입니다.
모델 업데이트
Azure OpenAI는 선택한 모델 배포에 대한 자동 업데이트를 지원합니다. 자동 업데이트 지원을 사용할 수 있는 모델에서는 모델 버전 업그레이드 정책 드롭다운을 사용할 수 있습니다.
Azure OpenAI 모델 버전 및 작동 방식에 대해 Azure OpenAI 모델 버전 문서에서 자세히 알아볼 수 있습니다.
참고
자동 모델 업데이트는 표준 배포 유형에 대해서만 지원됩니다. 프로비전된 배포 유형에서 모델 업데이트 및 마이그레이션을 관리하는 방법에 대한 자세한 내용은 프로비전된 배포 유형에 대한 모델 관리 섹션을 참조하세요.
기본값으로 자동 업데이트
배포를 기본값으로 자동 업데이트로 설정하면 기본 버전이 변경된 후 2주 이내에 모델 배포가 자동으로 업데이트됩니다. 미리 보기 버전의 경우 새 미리 보기 버전이 릴리스된 후 2주 후에 새 미리 보기 버전을 사용할 수 있게 되면 자동으로 업데이트됩니다.
유추 모델에 대한 초기 테스트 단계에 있는 경우 자동 업데이트가 있는 모델을 사용할 수 있을 때마다 기본값 으로 설정하는 것이 좋습니다.
특정 모델 버전
Azure OpenAI의 사용이 진화하고 애플리케이션을 빌드하고 통합하기 시작하면 모델 업데이트를 수동으로 제어할 수 있습니다. 먼저 업그레이드하기 전에 애플리케이션 동작이 사용 사례에 대해 일관된지 테스트하고 유효성을 검사할 수 있습니다.
배포에 대한 특정 모델 버전을 선택하면 수동으로 업데이트하도록 선택하거나 모델의 사용 중지 날짜에 도달할 때까지 이 버전이 선택된 상태로 유지됩니다. 사용 중지 날짜에 도달하면 모델은 사용 중지 시 자동으로 기본 버전으로 업그레이드됩니다.
모델 배포 업그레이드 구성
REST, Azure CLI 및 Azure PowerShell 및 Foundry 포털을 사용하여 이전에 배포된 모델에 대해 설정된 모델 업그레이드 옵션을 확인할 수 있습니다.
해당 속성은 RESTAzure PowerShell 및 Azure CLI 통해 액세스할 수도 있습니다.
| 옵션 | 읽기 | 업데이트 |
|---|---|---|
| REST | 예.
versionUpgradeOption가 반환되지 않으면, 이는 null을(를) 의미합니다 |
예 |
| Azure PowerShell | 예.
VersionUpgradeOption에서 $null를 확인할 수 있습니다. |
예 |
| Azure CLI | 예. 설정되지 않은 경우 null 표시됩니다versionUpgradeOption. |
아니요. 현재 버전 업그레이드 옵션을 업데이트할 수 없습니다. |
세 가지 고유한 모델 배포 업그레이드 옵션이 있습니다.
| 이름 | 설명 |
|---|---|
OnceNewDefaultVersionAvailable |
새 버전이 기본값으로 지정되면 모델 배포는 해당 지정이 변경된 후 2주 이내에 자동으로 기본 버전으로 업그레이드됩니다. |
OnceCurrentVersionExpired |
사용 중지 날짜에 도달하면 모델 배포가 자동으로 현재 기본 버전으로 업그레이드됩니다. |
NoAutoUpgrade |
모델 배포는 자동으로 업그레이드되지 않습니다. 사용 중지 날짜에 도달하면 모델 배포가 작동을 중지합니다. 존재하지 않는 모델 배포를 가리키도록 해당 배포를 참조하는 코드를 업데이트해야 합니다. |
참고
null 는 .에 해당합니다 OnceCurrentVersionExpired.
버전 업데이트 정책 옵션이 모델 업그레이드를 지원하는 모델의 속성에 없는 경우 값이 현재null임을 나타냅니다. 이 값을 명시적으로 수정하면 REST API뿐만 아니라 스튜디오 속성 페이지에도 속성이 표시됩니다.
예제
Azure PowerShell getting started guide 검토하여 로컬로 Azure PowerShell 설치하거나 Azure Cloud Shell 사용할 수 있습니다.
아래 단계에서는 옵션 속성을 확인하고 업데이트하는 VersionUpgradeOption 방법을 보여 줍니다.
# Step 1: Get deployment
$deployment = Get-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName}
# Step 2: Show VersionUpgradeOption
$deployment.Properties.VersionUpgradeOption
# VersionUpgradeOption can be null. One way to check is:
$null -eq $deployment.Properties.VersionUpgradeOption
# Step 3: Update VersionUpgradeOption
$deployment.Properties.VersionUpgradeOption = "NoAutoUpgrade"
New-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName} -Properties $deployment.Properties -Sku $deployment.Sku
# Repeat steps 1 and 2 to confirm the change.
# If you aren't sure about the deployment name, list all deployments under an account:
Get-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName}
# Update to a new model version
# Step 1: Get deployment
$deployment = Get-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName}
# Step 2: Show the current model version
$deployment.Properties.Model.Version
# Step 3: Update the model version
$deployment.Properties.Model.Version = "0613"
New-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName} -Properties $deployment.Properties -Sku $deployment.Sku
# Repeat steps 1 and 2 to confirm the change.
API를 통해 모델 업데이트 및 배포
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2025-06-01
경로 매개 변수
| 매개 변수 | 형식 | 필수? | 설명 |
|---|---|---|---|
accountName |
문자열 | 필수 | Azure OpenAI 리소스의 이름입니다. |
deploymentName |
문자열 | 필수 | 기존 모델을 배포할 때 선택한 배포 이름 또는 새 모델 배포를 포함하려는 이름입니다. |
resourceGroupName |
문자열 | 필수 | 이 모델 배포에 연결된 리소스 그룹의 이름입니다. |
subscriptionId |
문자열 | 필수 | 연결된 구독에 대한 구독 ID입니다. |
api-version |
문자열 | 필수 | 이 작업에 사용할 API 버전입니다. 이는 YYYY-MM-DD 형식을 따릅니다. |
지원되는 버전
-
2025-06-01Swagger 사양
요청 본문
이는 사용 가능한 요청 본문 매개 변수의 하위 집합일 뿐입니다. 매개 변수의 전체 목록은 REST API 참조 설명서를 참조할 수 있습니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| 버전 업그레이드 옵션 | String | 배포 모델 버전 업그레이드 옵션:OnceNewDefaultVersionAvailableOnceCurrentVersionExpiredNoAutoUpgrade |
| 용량 | 정수 | 이 배포에 할당하는 할당량 의 양을 나타냅니다. 값 1은 TPM(분당 1,000개 토큰)과 같습니다. |
요청 예제
curl -X PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resource-group-temp/providers/Microsoft.CognitiveServices/accounts/docs-openai-test-001/deployments/gpt-35-turbo?api-version=2025-06-01 \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
-d '{"sku":{"name":"Standard","capacity":120},"properties": {"model": {"format": "OpenAI","name": "gpt-35-turbo","version": "0613"},"versionUpgradeOption":"OnceCurrentVersionExpired"}}'
참고
권한 부여 토큰을 생성하는 방법에는 여러 가지가 있습니다. 초기 테스트를 위한 가장 쉬운 방법은 Azure 포털 Cloud Shell 시작하는 것입니다. 그런 다음, .를 실행합니다 az account get-access-token. 이 토큰을 API 테스트를 위한 임시 권한 부여 토큰으로 사용할 수 있습니다.
응답 예제
{
"id": "/subscriptions/{subscription-id}/resourceGroups/resource-group-temp/providers/Microsoft.CognitiveServices/accounts/docs-openai-test-001/deployments/gpt-35-turbo",
"type": "Microsoft.CognitiveServices/accounts/deployments",
"name": "gpt-35-turbo",
"sku": {
"name": "Standard",
"capacity": 120
},
"properties": {
"model": {
"format": "OpenAI",
"name": "gpt-35-turbo",
"version": "0613"
},
"versionUpgradeOption": "OnceCurrentVersionExpired",
"capabilities": {
"chatCompletion": "true"
},
"provisioningState": "Succeeded",
"rateLimits": [
{
"key": "request",
"renewalPeriod": 10,
"count": 120
},
{
"key": "token",
"renewalPeriod": 60,
"count": 120000
}
]
},
"systemData": {
"createdBy": "docs@contoso.com",
"createdByType": "User",
"createdAt": "2023-02-28T02:57:15.8951706Z",
"lastModifiedBy": "docs@contoso.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2023-10-31T15:35:53.082912Z"
},
"etag": "\"GUID\""
}
프로비전된 배포 유형에 대한 모델 관리
프로비전된 배포는 고유한 모델 관리 사례를 지원합니다. 프로비전된 배포 모델 관리 방법은 모델 버전과 모델 패밀리 간에 마이그레이션하는 시기와 방법을 가장 명확하게 제어할 수 있도록 하기 위한 것입니다. 현재 프로비전된 배포에서 모델을 관리하는 데 사용할 수 있는 두 가지 방법은 (1) 현재 위치 마이그레이션 및 (2) 다중 배포 마이그레이션입니다.
필수 구성 요소
- 대상 모델 버전 또는 모델 패밀리가 기존 배포 유형에 대해 지원되고 있는지 확인합니다. 마이그레이션은 동일한 배포 유형의 프로비전된 배포 간에만 발생할 수 있습니다. 배포 유형에 대한 자세한 내용은 배포 유형 설명서를 검토하세요.
- 마이그레이션을 시도하기 전에 대상 모델 버전 또는 모델 제품군에 대한 용량 가용성의 유효성을 검사합니다. 용량 가용성 확인에 대한 자세한 내용은 용량 투명성 설명서를 검토하세요.
- 다중 배포 마이그레이션의 경우 여러 배포를 동시에 지원하기에 충분한 할당량이 있는지 확인합니다. 프로비전된 각 배포 유형에 대한 할당량의 유효성을 검사하는 방법에 대한 자세한 내용은 프로비전된 처리량 비용 설명서를 검토하세요.
프로비전된 배포에 대한 현장 마이그레이션
현재 위치 마이그레이션을 사용하면 해당 배포에 할당된 모델 버전 또는 모델 패밀리를 변경하는 동안 동일한 프로비전된 배포 이름과 크기를 유지할 수 있습니다. 현재 위치 마이그레이션을 사용하면 Azure OpenAI는 20~30분 동안 마이그레이션하는 동안 모델 버전 또는 모델 패밀리 간에 기존 트래픽을 마이그레이션합니다. 마이그레이션 기간 내내 프로비저닝된 배포 환경이 "업데이트 중" 상태로 표시됩니다. 프로비전된 배포를 정상적으로 계속 사용할 수 있습니다. 현재 위치 마이그레이션이 완료되면 프로비전된 상태가 "성공"으로 업데이트되어 모든 트래픽이 대상 모델 버전 또는 모델 패밀리로 마이그레이션되었음을 나타냅니다.
현재 위치 마이그레이션: 모델 버전 업데이트
기존 프로비전된 배포를 동일한 모델 패밀리 내의 새 모델 버전으로 업데이트하는 것을 대상으로 하는 현재 위치 마이그레이션은 Foundry, REST API 및 Azure CLI 통해 지원됩니다. Foundry 내에서 모델 버전 업데이트를 대상으로 하는 현재 위치 마이그레이션을 수행하려면 배포 이름 열에서 배포를 선택하여 > 마이그레이션하려는 프로비전된 배포의 배포 이름을 선택합니다.
배포 이름을 선택하면 모델 배포의 속성 이 열립니다. 이 보기에서 편집 단추를 선택하면 배포 대화 상자 업데이트 가 표시됩니다. 모델 버전 드롭다운을 선택하여 프로비전된 배포에 대한 새 모델 버전을 설정합니다. 설명한 대로 프로비전 상태는 마이그레이션 중에 "업데이트"로 변경되고 마이그레이션이 완료되면 "성공"으로 되돌아갑니다.
현재 위치 마이그레이션: 모델 제품군 변경
기존 프로비전된 배포를 새 모델 패밀리로 업데이트하는 것을 대상으로 하는 현재 위치 마이그레이션은 REST API 및 Azure CLI 통해 지원됩니다. 모델 패밀리 변경을 대상으로 하는 현재 위치 마이그레이션을 수행하려면 아래 예제 요청을 가이드로 사용합니다. 요청에서 마이그레이션할 대상 모델의 모델 이름 및 모델 버전을 업데이트해야 합니다.
curl -X PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resource-group-temp/providers/Microsoft.CognitiveServices/accounts/docs-openai-test-001/deployments/gpt-4o-ptu-deployment?api-version=2024-10-01 \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
-d '{"sku":{"name":"GlobalProvisionedManaged","capacity":100},"properties": {"model": {"format": "OpenAI","name": "gpt-4o-mini","version": "2024-07-18"}}}'
응답 예제
{
"id": "/subscriptions/{subscription-id}/resourceGroups/resource-group-temp/providers/Microsoft.CognitiveServices/accounts/docs-openai-test-001/deployments/gpt-4o-ptu-deployment",
"type": "Microsoft.CognitiveServices/accounts/deployments",
"name": "gpt-4o-ptu-deployment",
"sku": {
"name": "GlobalProvisionedManaged",
"capacity": 100
},
"properties": {
"model": {
"format": "OpenAI",
"name": "gpt-4o-mini",
"version": "2024-07-18"
},
"versionUpgradeOption": "OnceCurrentVersionExpired",
"currentCapacity": 100,
"capabilities": {
"area": "EUR",
"chatCompletion": "true",
"jsonObjectResponse": "true",
"maxContextToken": "128000",
"maxOutputToken": "16834",
"assistants": "true"
},
"provisioningState": "Updating",
"rateLimits": [
{
"key": "request",
"renewalPeriod": 10,
"count": 300
}
]
},
"systemData": {
"createdBy": "docs@contoso.com",
"createdByType": "User",
"createdAt": "2025-01-28T02:57:15.8951706Z",
"lastModifiedBy": "docs@contoso.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2025-01-29T15:35:53.082912Z"
},
"etag": "\"GUID\""
}
참고
권한 부여 토큰을 생성하는 방법에는 여러 가지가 있습니다. 초기 테스트를 위한 가장 쉬운 방법은 Azure 포털 Cloud Shell 시작하는 것입니다. 그런 다음, .를 실행합니다 az account get-access-token. 이 토큰을 API 테스트를 위한 임시 권한 부여 토큰으로 사용할 수 있습니다.
프로비전된 배포에 대한 다중 배포 마이그레이션
다중 배포 마이그레이션을 사용하면 모델 마이그레이션 프로세스를 보다 세세하게 제어할 수 있습니다. 다중 배포 마이그레이션을 사용하면 프로비전된 새 배포에서 기존 트래픽을 대상 모델 버전 또는 모델 패밀리로 마이그레이션하는 데 얼마나 빨리 마이그레이션할지 결정할 수 있습니다. 다중 배포 마이그레이션 방법을 사용하여 새 모델 버전 또는 모델 패밀리로 마이그레이션하는 프로세스는 다음과 같습니다.
- 새 프로비저닝된 배포를 만듭니다. 이 새 배포의 경우 기존 배포와 동일한 프로비전된 배포 유형을 유지 관리하거나 원하는 경우 새 배포 유형을 선택할 수 있습니다.
- 원래 배포에서 모든 트래픽이 오프로드될 때까지 기존 프로비전된 배포에서 대상 모델 버전 또는 모델 패밀리를 사용하여 새로 만든 프로비전된 배포로 트래픽을 전환합니다.
- 트래픽이 새 배포로 마이그레이션되면 Azure OpenAI 요청 메트릭에 새 배포로 마이그레이션되는 유추 트래픽이 5-10분 이내에 수행된 API 호출을 표시하지 않도록 하여 이전에 프로비전된 배포에서 처리 중인 유추 요청이 없는지 확인합니다. 이 메트릭에 대한 자세한 내용은 See the Monitor Azure OpenAI documentation.
- 유추 호출이 발생하지 않은 것을 확인하면 프로비전된 원래 배포를 삭제합니다.
문제 해결
Azure Resource Manager API에서 401 또는 403 응답을 받습니다.
- 유효하고 만료되지 않은 액세스 토큰인지 확인합니다.
- 리소스에 대한 배포를 읽고 업데이트할 수 있는 권한이 있는지 확인합니다.