Migrations - Check Name Availability

Überprüfen Sie die Gültigkeit und Verfügbarkeit des angegebenen Namens, um ihn einer neuen Migration zuzuweisen.
Überprüft, ob ein vorgeschlagener Migrationsname gültig und verfügbar ist.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}/checkMigrationNameAvailability?api-version=2025-08-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

serverName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*

Name des Servers

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
name True

string

Name der Migration, die auf Gültigkeit und Verfügbarkeit überprüft werden soll.

type True

string

Ressourcentyp.

Antworten

Name Typ Beschreibung
200 OK

MigrationNameAvailability

Azure-Operation erfolgreich abgeschlossen.

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Check the validity and availability of the given name, to assign it to a new migration.

Beispielanforderung

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"
}

Beispiel für eine Antwort

{
  "name": "naexamplemigration",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers/migrations",
  "message": null,
  "nameAvailable": true,
  "reason": null
}

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

MigrationNameAvailability

Verfügbarkeit eines Migrationsnamens.

MigrationNameAvailabilityReason

Ursache für die Verfügbarkeit des Migrationsnamens.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

MigrationNameAvailability

Verfügbarkeit eines Migrationsnamens.

Name Typ Beschreibung
message

string

Verfügbarkeitsmeldung des Migrationsnamens.

name

string

Name der Migration, die auf Gültigkeit und Verfügbarkeit überprüft werden soll.

nameAvailable

boolean

Gibt an, ob der Migrationsname verfügbar ist.

reason

MigrationNameAvailabilityReason

Ursache für die Verfügbarkeit des Migrationsnamens.

type

string

Ressourcentyp.

MigrationNameAvailabilityReason

Ursache für die Verfügbarkeit des Migrationsnamens.

Wert Beschreibung
Invalid

Der Name der Migration ist ungültig.

AlreadyExists

Der Name der Migration ist bereits vorhanden.