Migrations - List By Target Server
Listet alle Migrationen eines flexiblen Zielservers auf.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{targetDbServerName}/migrations?api-version=2024-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{targetDbServerName}/migrations?api-version=2024-08-01&migrationListFilter={migrationListFilter}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string pattern: ^[-a-z0-9A-Z._()]+[^.]$ |
Name der Ressourcengruppe des Zieldatenbankservers. |
subscription
|
path | True |
string pattern: ([a-z0-9]){8,8}[-]([a-z0-9]){4,4}[-]([a-z0-9]){4,4}[-]([a-z0-9]){4,4}[-]([a-z0-9]){12,12} |
Kennung des Abonnements des Zieldatenbankservers. |
target
|
path | True |
string pattern: ([-a-z0-9]){3,63} |
Name des Zieldatenbankservers. |
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
migration
|
query |
Migrationslistenfilter. Ruft entweder aktive Migrationen oder alle Migrationen ab. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolg |
|
Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Sicherheit
azure_auth
Microsoft Entra OAuth2-Fluss
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
List all migrations of a target flexible server.
Beispielanforderung
Beispiel für eine Antwort
{
"value": [
{
"properties": {
"migrationId": "d3ceacbb-a5fd-43dc-a9db-6022b5154856",
"currentStatus": {
"state": "InProgress",
"error": "",
"currentSubStateDetails": {
"currentSubState": "PerformingPreRequisiteSteps"
}
},
"sourceDbServerMetadata": {
"location": "westus",
"version": "10",
"storageMb": 1024,
"sku": {
"name": "B_Gen5_2",
"tier": "Basic"
}
},
"targetDbServerMetadata": {
"location": "westus",
"version": "16",
"storageMb": 2048,
"sku": {
"tier": "GeneralPurpose",
"name": "Standard_D4ds_v5"
}
},
"sourceDbServerResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBForPostgreSql/servers/examplesource",
"targetDbServerResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBForPostgreSql/flexibleServers/exampletarget",
"dbsToMigrate": [
"exampledatabase1",
"exampledatabase2",
"exampledatabase3",
"exampledatabase4"
],
"setupLogicalReplicationOnSourceDbIfNeeded": "False",
"overwriteDbsInTarget": "False",
"migrationWindowStartTimeInUtc": "2024-08-01T20:30:22.123456Z",
"startDataMigration": "False",
"triggerCutover": "False",
"migrateRoles": "False"
},
"location": "westus",
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBForPostgreSql/flexibleServers/exampletarget/migrations/examplemigration",
"name": "examplemigration",
"type": "Microsoft.DBForPostgreSql/flexibleServers/migrations"
}
]
}
Definitionen
Name | Beschreibung |
---|---|
Admin |
Anmeldeinformationen von Administratorbenutzern für Quell- und Zielserver. |
Cancel |
Gibt an, ob der Abbruch für die gesamte Migration ausgelöst werden muss. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Db |
Zusammenfassung des Validierungsstatus für eine Datenbank. |
Db |
Migrationsstatus einer Datenbank. |
Db |
Datenbankservermetadaten. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
Logical |
Gibt an, ob LogicalReplicationOnSourceDb bei Bedarf eingerichtet werden soll. |
Migrate |
Gibt an, ob Rollen und Berechtigungen migriert werden müssen. |
Migration |
Migrationsstatus einer Datenbank. |
Migration |
Migrationslistenfilter. Ruft entweder aktive Migrationen oder alle Migrationen ab. |
Migration |
Modus, der zum Ausführen der Migration verwendet wird: Online oder Offline. |
Migration |
Unterstützte Option für eine Migration |
Migration |
Migration. |
Migration |
Liste der Migrationen. |
Migration |
Parameter des Migrationsgeheimnisses. |
Migration |
Stand der Migration. |
Migration |
Stand der Migration. |
Migration |
Teilstaat der Migration. |
Migration |
Details zum Unterzustand der Migration. |
Overwrite |
Gibt an, ob Datenbanken auf dem Zielserver überschrieben werden können, wenn sie bereits vorhanden sind. Wenn der Wert auf "False" festgelegt ist, wartet der Migrationsworkflow auf eine Bestätigung, wenn er erkennt, dass die Datenbank bereits auf dem Zielserver vorhanden ist. |
Server |
Berechnen Sie die Informationen eines flexiblen Servers. |
Sku |
Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. |
Source |
Für die Migration verwendeter Quellservertyp: ApsaraDB_RDS, AWS, AWS_AURORA, AWS_EC2, AWS_RDS, AzureVM, Crunchy_PostgreSQL, Digital_Ocean_Droplets, Digital_Ocean_PostgreSQL, EDB, EDB_Oracle_Server, EDB_PostgreSQL, GCP, GCP_AlloyDB, GCP_CloudSQL, GCP_Compute, Heroku_PostgreSQL, Huawei_Compute, Huawei_RDS, OnPremises, PostgreSQLCosmosDB, PostgreSQLFlexibleServer, PostgreSQLSingleServer oder Supabase_PostgreSQL |
Ssl |
SSL-Modus, der von einer Migration verwendet wird. Der Standard-SSL-Modus für 'PostgreSQLSingleServer' ist 'VerifyFull'. Der Standard-SSL-Modus für andere Quelltypen ist "Bevorzugen". |
Start |
Gibt an, ob die Datenmigration sofort gestartet werden muss. |
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
Trigger |
Gibt an, ob die Übernahme für die gesamte Migration ausgelöst werden muss. |
Validation |
Details zur Validierung für die Migration. |
Validation |
Objekt der Validierungsnachricht. |
Validation |
Validierungsstatus für die Migration. |
Validation |
Validierungszusammenfassungsobjekt. |
AdminCredentials
Anmeldeinformationen von Administratorbenutzern für Quell- und Zielserver.
Name | Typ | Beschreibung |
---|---|---|
sourceServerPassword |
string |
Kennwort für den Benutzer des Quellservers. |
targetServerPassword |
string |
Kennwort für den Benutzer des Zielservers. |
CancelEnum
Gibt an, ob der Abbruch für die gesamte Migration ausgelöst werden muss.
Wert | Beschreibung |
---|---|
False | |
True |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Wert | Beschreibung |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
DbLevelValidationStatus
Zusammenfassung des Validierungsstatus für eine Datenbank.
Name | Typ | Beschreibung |
---|---|---|
databaseName |
string |
Name der Datenbank |
endedOn |
string (date-time) |
Endzeit einer Validierung auf Datenbankebene. |
startedOn |
string (date-time) |
Startzeit einer Validierung auf Datenbankebene. |
summary |
Zusammenfassung der Validierungen auf Datenbankebene. |
DbMigrationStatus
Migrationsstatus einer Datenbank.
Name | Typ | Beschreibung |
---|---|---|
appliedChanges |
integer (int32) |
Zähler für angewendete Change Data Capture-Änderungen. |
cdcDeleteCounter |
integer (int32) |
Ändern des Data Capture-Löschindikators. |
cdcInsertCounter |
integer (int32) |
Ändern des Data Capture-Einfügeindikators. |
cdcUpdateCounter |
integer (int32) |
Ändern des Data Capture-Aktualisierungsindikators. |
databaseName |
string |
Name der Datenbank |
endedOn |
string (date-time) |
Endzeit eines Migrationsstatus. |
fullLoadCompletedTables |
integer (int32) |
Anzahl der Tabellen, die während der Migration einer Datenbank geladen wurden. |
fullLoadErroredTables |
integer (int32) |
Anzahl der Tabellen, bei denen während der Migration einer Datenbank Fehler aufgetreten sind. |
fullLoadLoadingTables |
integer (int32) |
Anzahl der Tabellen, die während der Migration einer Datenbank geladen werden. |
fullLoadQueuedTables |
integer (int32) |
Anzahl der Tabellen, die für die Migration einer Datenbank in die Warteschlange eingereiht werden. |
incomingChanges |
integer (int32) |
Zähler für eingehende Änderungen von Change Data Capture. |
latency |
integer (int32) |
Verzögerung in Sekunden zwischen Quelle und Ziel während der Online-Phase. |
message |
string |
Fehlermeldung, falls vorhanden, für den Migrationsstatus. |
migrationOperation |
string |
Migrationsvorgang einer Datenbank. |
migrationState |
Migrationsstatus einer Datenbank. |
|
startedOn |
string (date-time) |
Startzeit eines Migrationszustands. |
DbServerMetadata
Datenbankservermetadaten.
Name | Typ | Beschreibung |
---|---|---|
location |
string |
Standort des Datenbankservers. |
sku |
Computeebene und Größe des Datenbankservers. Dieses Objekt ist für einen Azure Database for PostgreSQL-Einzelserver leer. |
|
storageMb |
integer (int32) |
Speichergröße (in MB) für den Datenbankserver. |
version |
string |
Hauptversion der PostgreSQL-Datenbank-Engine. |
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 |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
LogicalReplicationOnSourceDbEnum
Gibt an, ob LogicalReplicationOnSourceDb bei Bedarf eingerichtet werden soll.
Wert | Beschreibung |
---|---|
False | |
True |
MigrateRolesEnum
Gibt an, ob Rollen und Berechtigungen migriert werden müssen.
Wert | Beschreibung |
---|---|
False | |
True |
MigrationDbState
Migrationsstatus einer Datenbank.
Wert | Beschreibung |
---|---|
Canceled | |
Canceling | |
Failed | |
InProgress | |
Succeeded | |
WaitingForCutoverTrigger |
MigrationListFilter
Migrationslistenfilter. Ruft entweder aktive Migrationen oder alle Migrationen ab.
Wert | Beschreibung |
---|---|
Active | |
All |
MigrationMode
Modus, der zum Ausführen der Migration verwendet wird: Online oder Offline.
Wert | Beschreibung |
---|---|
Offline | |
Online |
MigrationOption
Unterstützte Option für eine Migration
Wert | Beschreibung |
---|---|
Migrate | |
Validate | |
ValidateAndMigrate |
MigrationResource
Migration.
Name | Typ | Beschreibung |
---|---|---|
id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
name |
string |
Der Name der Ressource |
properties.cancel |
Gibt an, ob der Abbruch für die gesamte Migration ausgelöst werden muss. |
|
properties.currentStatus |
Aktueller Status einer Migration. |
|
properties.dbsToCancelMigrationOn |
string[] |
Wenn Sie einen Abbruch für bestimmte Datenbanken auslösen möchten, legen Sie 'triggerCutover' auf 'True' und die Namen der spezifischen Datenbanken in diesem Array fest. |
properties.dbsToMigrate |
string[] |
Namen der zu migrierenden Datenbanken. |
properties.dbsToTriggerCutoverOn |
string[] |
Wenn Sie eine Übernahme für bestimmte Datenbanken auslösen möchten, legen Sie 'triggerCutover' auf 'True' und die Namen der spezifischen Datenbanken in diesem Array fest. |
properties.migrateRoles |
Gibt an, ob Rollen und Berechtigungen migriert werden müssen. |
|
properties.migrationId |
string |
Kennung einer Migration. |
properties.migrationInstanceResourceId |
string (arm-id) |
Bezeichner der Migrationsinstanz für private Endpunkte. |
properties.migrationMode |
Modus, der zum Ausführen der Migration verwendet wird: Online oder Offline. |
|
properties.migrationOption |
Unterstützte Option für eine Migration. |
|
properties.migrationWindowEndTimeInUtc |
string (date-time) |
Endzeit (UTC) für das Migrationsfenster. |
properties.migrationWindowStartTimeInUtc |
string (date-time) |
Startzeit (UTC) für das Migrationsfenster. |
properties.overwriteDbsInTarget |
Gibt an, ob Datenbanken auf dem Zielserver überschrieben werden können, wenn sie bereits vorhanden sind. Wenn der Wert auf "False" festgelegt ist, wartet der Migrationsworkflow auf eine Bestätigung, wenn er erkennt, dass die Datenbank bereits auf dem Zielserver vorhanden ist. |
|
properties.secretParameters |
Parameter des Migrationsgeheimnisses. |
|
properties.setupLogicalReplicationOnSourceDbIfNeeded |
Gibt an, ob LogicalReplicationOnSourceDb bei Bedarf eingerichtet werden soll. |
|
properties.sourceDbServerFullyQualifiedDomainName |
string |
Vollqualifizierter Domänenname (FQDN) oder IP-Adresse des Quellservers. Diese Eigenschaft ist optional. Wenn angegeben, wird sie vom Migrationsdienst immer verwendet, um eine Verbindung mit dem Quellserver herzustellen. |
properties.sourceDbServerMetadata |
Metadaten des Quelldatenbankservers. |
|
properties.sourceDbServerResourceId |
string |
Kennung der Quelldatenbankserverressource, wenn 'sourceType' 'PostgreSQLSingleServer' ist. Für andere Quelltypen muss dies auf ipaddress:port@username oder hostname:port@username gesetzt werden. |
properties.sourceType |
Für die Migration verwendeter Quellservertyp: ApsaraDB_RDS, AWS, AWS_AURORA, AWS_EC2, AWS_RDS, AzureVM, Crunchy_PostgreSQL, Digital_Ocean_Droplets, Digital_Ocean_PostgreSQL, EDB, EDB_Oracle_Server, EDB_PostgreSQL, GCP, GCP_AlloyDB, GCP_CloudSQL, GCP_Compute, Heroku_PostgreSQL, Huawei_Compute, Huawei_RDS, OnPremises, PostgreSQLCosmosDB, PostgreSQLFlexibleServer, PostgreSQLSingleServer oder Supabase_PostgreSQL |
|
properties.sslMode |
SSL-Modus, der von einer Migration verwendet wird. Der Standard-SSL-Modus für 'PostgreSQLSingleServer' ist 'VerifyFull'. Der Standard-SSL-Modus für andere Quelltypen ist "Bevorzugen". |
|
properties.startDataMigration |
Gibt an, ob die Datenmigration sofort gestartet werden muss. |
|
properties.targetDbServerFullyQualifiedDomainName |
string |
Vollqualifizierter Domänenname (FQDN) oder IP-Adresse des Zielservers. Diese Eigenschaft ist optional. Wenn angegeben, wird sie vom Migrationsdienst immer verwendet, um eine Verbindung mit dem Zielserver herzustellen. |
properties.targetDbServerMetadata |
Metadaten des Zieldatenbankservers. |
|
properties.targetDbServerResourceId |
string |
Kennung der Serverressource der Zieldatenbank. |
properties.triggerCutover |
Gibt an, ob die Übernahme für die gesamte Migration ausgelöst werden muss. |
|
systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
MigrationResourceListResult
Liste der Migrationen.
Name | Typ | Beschreibung |
---|---|---|
nextLink |
string |
Link, der zum Abrufen der nächsten Ergebnisseite verwendet wird. |
value |
Liste der Migrationen. |
MigrationSecretParameters
Parameter des Migrationsgeheimnisses.
Name | Typ | Beschreibung |
---|---|---|
adminCredentials |
Anmeldeinformationen von Administratorbenutzern für Quell- und Zielserver. |
|
sourceServerUsername |
string |
Ruft den Namen des Benutzers für den Quellserver ab oder legt diesen fest. Dieser Benutzer muss kein Administrator sein. |
targetServerUsername |
string |
Ruft den Namen des Benutzers für den Zielserver ab oder legt diesen fest. Dieser Benutzer muss kein Administrator sein. |
MigrationState
Stand der Migration.
Wert | Beschreibung |
---|---|
Canceled | |
CleaningUp | |
Failed | |
InProgress | |
Succeeded | |
ValidationFailed | |
WaitingForUserAction |
MigrationStatus
Stand der Migration.
Name | Typ | Beschreibung |
---|---|---|
currentSubStateDetails |
Details zum aktuellen Migrationsunterstatus. |
|
error |
string |
Fehlermeldung, falls vorhanden, für den Migrationsstatus. |
state |
Stand der Migration. |
MigrationSubState
Teilstaat der Migration.
Wert | Beschreibung |
---|---|
CancelingRequestedDBMigrations | |
Completed | |
CompletingMigration | |
MigratingData | |
PerformingPreRequisiteSteps | |
ValidationInProgress | |
WaitingForCutoverTrigger | |
WaitingForDBsToMigrateSpecification | |
WaitingForDataMigrationScheduling | |
WaitingForDataMigrationWindow | |
WaitingForLogicalReplicationSetupRequestOnSourceDB | |
WaitingForTargetDBOverwriteConfirmation |
MigrationSubStateDetails
Details zum Unterzustand der Migration.
Name | Typ | Beschreibung |
---|---|---|
currentSubState |
Teilstaat der Migration. |
|
dbDetails |
<string,
Db |
|
validationDetails |
Details zur Validierung für die Migration. |
OverwriteDbsInTargetEnum
Gibt an, ob Datenbanken auf dem Zielserver überschrieben werden können, wenn sie bereits vorhanden sind. Wenn der Wert auf "False" festgelegt ist, wartet der Migrationsworkflow auf eine Bestätigung, wenn er erkennt, dass die Datenbank bereits auf dem Zielserver vorhanden ist.
Wert | Beschreibung |
---|---|
False | |
True |
ServerSku
Berechnen Sie die Informationen eines flexiblen Servers.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Computeebene und Größe des Datenbankservers. Dieses Objekt ist für einen Azure Database for PostgreSQL-Einzelserver leer. |
tier |
Ebene der Compute, die einem flexiblen Server zugewiesen ist. |
SkuTier
Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist.
Wert | Beschreibung |
---|---|
Basic | |
Free | |
Premium | |
Standard |
SourceType
Für die Migration verwendeter Quellservertyp: ApsaraDB_RDS, AWS, AWS_AURORA, AWS_EC2, AWS_RDS, AzureVM, Crunchy_PostgreSQL, Digital_Ocean_Droplets, Digital_Ocean_PostgreSQL, EDB, EDB_Oracle_Server, EDB_PostgreSQL, GCP, GCP_AlloyDB, GCP_CloudSQL, GCP_Compute, Heroku_PostgreSQL, Huawei_Compute, Huawei_RDS, OnPremises, PostgreSQLCosmosDB, PostgreSQLFlexibleServer, PostgreSQLSingleServer oder Supabase_PostgreSQL
Wert | Beschreibung |
---|---|
AWS | |
AWS_AURORA | |
AWS_EC2 | |
AWS_RDS | |
AzureVM | |
EDB | |
GCP | |
GCP_AlloyDB | |
GCP_CloudSQL | |
GCP_Compute | |
OnPremises | |
PostgreSQLSingleServer |
SslMode
SSL-Modus, der von einer Migration verwendet wird. Der Standard-SSL-Modus für 'PostgreSQLSingleServer' ist 'VerifyFull'. Der Standard-SSL-Modus für andere Quelltypen ist "Bevorzugen".
Wert | Beschreibung |
---|---|
Prefer | |
Require | |
VerifyCA | |
VerifyFull |
StartDataMigrationEnum
Gibt an, ob die Datenmigration sofort gestartet werden muss.
Wert | Beschreibung |
---|---|
False | |
True |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
TriggerCutoverEnum
Gibt an, ob die Übernahme für die gesamte Migration ausgelöst werden muss.
Wert | Beschreibung |
---|---|
False | |
True |
ValidationDetails
Details zur Validierung für die Migration.
Name | Typ | Beschreibung |
---|---|---|
dbLevelValidationDetails |
Details zu Validierungen auf Serverebene. |
|
serverLevelValidationDetails |
Details zu Validierungen auf Serverebene. |
|
status |
Validierungsstatus für die Migration. |
|
validationEndTimeInUtc |
string (date-time) |
Endzeit (UTC) für die Validierung. |
validationStartTimeInUtc |
string (date-time) |
Startzeit (UTC) für die Validierung. |
ValidationMessage
Objekt der Validierungsnachricht.
Name | Typ | Beschreibung |
---|---|---|
message |
string |
Zeichenfolge der Validierungsmeldung. |
state |
Schweregrad der Validierungsmeldung. |
ValidationState
Validierungsstatus für die Migration.
Wert | Beschreibung |
---|---|
Failed | |
Succeeded | |
Warning |
ValidationSummaryItem
Validierungszusammenfassungsobjekt.
Name | Typ | Beschreibung |
---|---|---|
messages |
Validierungsmeldungen. |
|
state |
Validierungsstatus für die Migration. |
|
type |
string |
Typ der Validierung. |