Migrations - Check Name Availability
Verificare la validità e la disponibilità del nome dato, per assegnarlo a una nuova migrazione.
Controlla se il nome di una migrazione proposta è valido e disponibile.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}/checkMigrationNameAvailability?api-version=2025-08-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. |
|
server
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* |
Il nome del server. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| name | True |
string |
Nome della migrazione per verificarne la validità e la disponibilità. |
| type | True |
string |
Tipo di risorsa. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Operazione Azure completata con successo. |
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
Check the validity and availability of the given name, to assign it to a new migration.
Esempio di richiesta
POST https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/checkMigrationNameAvailability?api-version=2025-08-01
{
"name": "examplemigration",
"type": "Microsoft.DBforPostgreSQL/flexibleServers/migrations"
}
Risposta di esempio
{
"name": "naexamplemigration",
"type": "Microsoft.DBforPostgreSQL/flexibleServers/migrations",
"message": null,
"nameAvailable": true,
"reason": null
}
Definizioni
| Nome | Descrizione |
|---|---|
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
Migration |
Disponibilità di un nome di migrazione. |
|
Migration |
Motivo della disponibilità del nome della migrazione. |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| additionalInfo |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
MigrationNameAvailability
Disponibilità di un nome di migrazione.
| Nome | Tipo | Descrizione |
|---|---|---|
| message |
string |
Messaggio di disponibilità del nome della migrazione. |
| name |
string |
Nome della migrazione per verificarne la validità e la disponibilità. |
| nameAvailable |
boolean |
Indica se il nome della migrazione è disponibile. |
| reason |
Motivo della disponibilità del nome della migrazione. |
|
| type |
string |
Tipo di risorsa. |
MigrationNameAvailabilityReason
Motivo della disponibilità del nome della migrazione.
| Valore | Descrizione |
|---|---|
| Invalid |
Il nome della migrazione non è valido. |
| AlreadyExists |
Il nome della migrazione esiste già. |