Virtual Machine Scale Sets - Convert To Single Placement Group
Converte la proprietà SinglePlacementGroup in false per un set di scalabilità di macchine virtuali esistente.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/convertToSinglePlacementGroup?api-version=2026-04-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
subscription
|
path | True |
string minLength: 1 |
ID della sottoscrizione di destinazione. |
|
vm
|
path | True |
string |
Nome del set di scalabilità di macchine virtuali. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| activePlacementGroupId |
string |
ID del gruppo di posizionamento in cui si desidera posizionare le istanze future della macchina virtuale. Per eseguire query su ID gruppo di posizionamento, usare l'API Get delle macchine virtuali del set di scalabilità di macchine virtuali. Se non specificato, la piattaforma sceglierà una con il numero massimo di istanze di macchine virtuali. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
La richiesta ha avuto esito positivo. |
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | impersonare il tuo account utente |
Esempio
|
Virtual |
|
Virtual |
VirtualMachineScaleSet_ConvertToSinglePlacementGroup_MaximumSet_Gen
Esempio di richiesta
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/convertToSinglePlacementGroup?api-version=2026-04-01
{
"activePlacementGroupId": "aaaaaaaaaaaaaaaaaaaaaaaaaaa"
}
Risposta di esempio
VirtualMachineScaleSet_ConvertToSinglePlacementGroup_MinimumSet_Gen
Esempio di richiesta
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaa/convertToSinglePlacementGroup?api-version=2026-04-01
{}
Risposta di esempio
Definizioni
| Nome | Descrizione |
|---|---|
|
Api |
Errore API. |
|
Api |
Base di errore API. |
|
Cloud |
Risposta di errore dal servizio di calcolo. |
|
Inner |
Dettagli dell'errore interno. |
|
VMScale |
ApiError
Errore API.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore Api |
|
| innererror |
L'errore interno dell'API |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore specifico. |
ApiErrorBase
Base di errore API.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Codice di errore. |
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore specifico. |
CloudError
Risposta di errore dal servizio di calcolo.
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Errore API. |
InnerError
Dettagli dell'errore interno.
| Nome | Tipo | Descrizione |
|---|---|---|
| errordetail |
string |
Messaggio di errore interno o dump di eccezione. |
| exceptiontype |
string |
Tipo di eccezione. |
VMScaleSetConvertToSinglePlacementGroupInput
| Nome | Tipo | Descrizione |
|---|---|---|
| activePlacementGroupId |
string |
ID del gruppo di posizionamento in cui si desidera posizionare le istanze future della macchina virtuale. Per eseguire query su ID gruppo di posizionamento, usare l'API Get delle macchine virtuali del set di scalabilità di macchine virtuali. Se non specificato, la piattaforma sceglierà una con il numero massimo di istanze di macchine virtuali. |