Freigeben über


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
resourceGroupName
path True

string

pattern: ^[-a-z0-9A-Z._()]+[^.]$

Name der Ressourcengruppe des Zieldatenbankservers.

subscriptionId
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.

targetDbServerName
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.

migrationListFilter
query

MigrationListFilter

Migrationslistenfilter. Ruft entweder aktive Migrationen oder alle Migrationen ab.

Antworten

Name Typ Beschreibung
200 OK

MigrationResourceListResult

Erfolg

Other Status Codes

ErrorResponse

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

GET https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampletarget/migrations?api-version=2024-08-01&migrationListFilter=All

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
AdminCredentials

Anmeldeinformationen von Administratorbenutzern für Quell- und Zielserver.

CancelEnum

Gibt an, ob der Abbruch für die gesamte Migration ausgelöst werden muss.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

DbLevelValidationStatus

Zusammenfassung des Validierungsstatus für eine Datenbank.

DbMigrationStatus

Migrationsstatus einer Datenbank.

DbServerMetadata

Datenbankservermetadaten.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

LogicalReplicationOnSourceDbEnum

Gibt an, ob LogicalReplicationOnSourceDb bei Bedarf eingerichtet werden soll.

MigrateRolesEnum

Gibt an, ob Rollen und Berechtigungen migriert werden müssen.

MigrationDbState

Migrationsstatus einer Datenbank.

MigrationListFilter

Migrationslistenfilter. Ruft entweder aktive Migrationen oder alle Migrationen ab.

MigrationMode

Modus, der zum Ausführen der Migration verwendet wird: Online oder Offline.

MigrationOption

Unterstützte Option für eine Migration

MigrationResource

Migration.

MigrationResourceListResult

Liste der Migrationen.

MigrationSecretParameters

Parameter des Migrationsgeheimnisses.

MigrationState

Stand der Migration.

MigrationStatus

Stand der Migration.

MigrationSubState

Teilstaat der Migration.

MigrationSubStateDetails

Details zum Unterzustand der 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.

ServerSku

Berechnen Sie die Informationen eines flexiblen Servers.

SkuTier

Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist.

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

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

StartDataMigrationEnum

Gibt an, ob die Datenmigration sofort gestartet werden muss.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

TriggerCutoverEnum

Gibt an, ob die Übernahme für die gesamte Migration ausgelöst werden muss.

ValidationDetails

Details zur Validierung für die Migration.

ValidationMessage

Objekt der Validierungsnachricht.

ValidationState

Validierungsstatus für die Migration.

ValidationSummaryItem

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

ValidationSummaryItem[]

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

MigrationDbState

Migrationsstatus einer Datenbank.

startedOn

string (date-time)

Startzeit eines Migrationszustands.

DbServerMetadata

Datenbankservermetadaten.

Name Typ Beschreibung
location

string

Standort des Datenbankservers.

sku

ServerSku

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

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.

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

CancelEnum

Gibt an, ob der Abbruch für die gesamte Migration ausgelöst werden muss.

properties.currentStatus

MigrationStatus

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

MigrateRolesEnum

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

MigrationMode

Modus, der zum Ausführen der Migration verwendet wird: Online oder Offline.

properties.migrationOption

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

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.

properties.secretParameters

MigrationSecretParameters

Parameter des Migrationsgeheimnisses.

properties.setupLogicalReplicationOnSourceDbIfNeeded

LogicalReplicationOnSourceDbEnum

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

DbServerMetadata

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

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

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

StartDataMigrationEnum

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

DbServerMetadata

Metadaten des Zieldatenbankservers.

properties.targetDbServerResourceId

string

Kennung der Serverressource der Zieldatenbank.

properties.triggerCutover

TriggerCutoverEnum

Gibt an, ob die Übernahme für die gesamte Migration ausgelöst werden muss.

systemData

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

MigrationResource[]

Liste der Migrationen.

MigrationSecretParameters

Parameter des Migrationsgeheimnisses.

Name Typ Beschreibung
adminCredentials

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

MigrationSubStateDetails

Details zum aktuellen Migrationsunterstatus.

error

string

Fehlermeldung, falls vorhanden, für den Migrationsstatus.

state

MigrationState

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

MigrationSubState

Teilstaat der Migration.

dbDetails

<string,  DbMigrationStatus>

validationDetails

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

SkuTier

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

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

createdByType

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

DbLevelValidationStatus[]

Details zu Validierungen auf Serverebene.

serverLevelValidationDetails

ValidationSummaryItem[]

Details zu Validierungen auf Serverebene.

status

ValidationState

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

ValidationState

Schweregrad der Validierungsmeldung.

ValidationState

Validierungsstatus für die Migration.

Wert Beschreibung
Failed
Succeeded
Warning

ValidationSummaryItem

Validierungszusammenfassungsobjekt.

Name Typ Beschreibung
messages

ValidationMessage[]

Validierungsmeldungen.

state

ValidationState

Validierungsstatus für die Migration.

type

string

Typ der Validierung.