Migrations - Update

Dienst:

PostgreSQL

API-Version:

2025-08-01

Aktualisiert eine vorhandene Migration. Der Anforderungstext kann eine bis viele der veränderbaren Eigenschaften enthalten, die in der Migrationsdefinition vorhanden sind. Bestimmte Eigenschaftenupdates initiieren Migrationsstatusübergänge.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
migrationName	path	True	string pattern: ^[a-z][a-z0-9]*$	Name der Migration.
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	Typ	Beschreibung
properties.cancel	Cancel	Gibt an, ob der Abbruch für die gesamte Migration ausgelöst werden muss.
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	MigrateRolesAndPermissions	Gibt an, ob Rollen und Berechtigungen migriert werden müssen.
properties.migrationMode	MigrationMode	Modus, der zum Ausführen der Migration verwendet wird: Online oder Offline.
properties.migrationWindowStartTimeInUtc	string (date-time)	Startzeit (UTC) für das Migrationsfenster.
properties.overwriteDbsInTarget	OverwriteDatabasesOnTargetServer	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	MigrationSecretParametersForPatch	Parameter des Migrationsgeheimnisses.
properties.setupLogicalReplicationOnSourceDbIfNeeded	LogicalReplicationOnSourceServer	Gibt an, ob bei Bedarf die logische Replikation auf dem Quellserver 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.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.startDataMigration	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.triggerCutover	TriggerCutover	Gibt an, ob die Übernahme für die gesamte Migration ausgelöst werden muss.
tags	object	Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren.

Antworten

Name	Typ	Beschreibung
200 OK	Migration	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory 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

Update an existing migration.

Beispielanforderung

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/migrations/examplemigration?api-version=2025-08-01

{
  "properties": {
    "setupLogicalReplicationOnSourceDbIfNeeded": "True"
  }
}

Java

import com.azure.resourcemanager.postgresqlflexibleserver.models.LogicalReplicationOnSourceServer;
import com.azure.resourcemanager.postgresqlflexibleserver.models.Migration;

/**
 * Samples for Migrations Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/postgresql/resource-manager/Microsoft.DBforPostgreSQL/stable/2025-08-01/examples/MigrationsUpdate.
     * json
     */
    /**
     * Sample code: Update an existing migration.
     * 
     * @param manager Entry point to PostgreSqlManager.
     */
    public static void
        updateAnExistingMigration(com.azure.resourcemanager.postgresqlflexibleserver.PostgreSqlManager manager) {
        Migration resource = manager.migrations().getWithResponse("exampleresourcegroup", "exampleserver",
            "examplemigration", com.azure.core.util.Context.NONE).getValue();
        resource.update().withSetupLogicalReplicationOnSourceDbIfNeeded(LogicalReplicationOnSourceServer.TRUE).apply();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.postgresqlflexibleservers import PostgreSQLManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-postgresqlflexibleservers
# USAGE
    python migrations_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = PostgreSQLManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="ffffffff-ffff-ffff-ffff-ffffffffffff",
    )

    response = client.migrations.update(
        resource_group_name="exampleresourcegroup",
        server_name="exampleserver",
        migration_name="examplemigration",
        parameters={"properties": {"setupLogicalReplicationOnSourceDbIfNeeded": "True"}},
    )
    print(response)


# x-ms-original-file: specification/postgresql/resource-manager/Microsoft.DBforPostgreSQL/stable/2025-08-01/examples/MigrationsUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armpostgresqlflexibleservers_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/postgresql/armpostgresqlflexibleservers/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/e96c24570a484cff13d153fb472f812878866a39/specification/postgresql/resource-manager/Microsoft.DBforPostgreSQL/stable/2025-08-01/examples/MigrationsUpdate.json
func ExampleMigrationsClient_Update() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armpostgresqlflexibleservers.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewMigrationsClient().Update(ctx, "exampleresourcegroup", "exampleserver", "examplemigration", armpostgresqlflexibleservers.MigrationResourceForPatch{
		Properties: &armpostgresqlflexibleservers.MigrationPropertiesForPatch{
			SetupLogicalReplicationOnSourceDbIfNeeded: to.Ptr(armpostgresqlflexibleservers.LogicalReplicationOnSourceServerTrue),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Migration = armpostgresqlflexibleservers.Migration{
	// 	Name: to.Ptr("examplemigration"),
	// 	Type: to.Ptr("Microsoft.DBForPostgreSql/flexibleServers/migrations"),
	// 	ID: to.Ptr("/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBForPostgreSql/flexibleServers/exampletarget/migrations/examplemigration"),
	// 	Location: to.Ptr("eastus"),
	// 	Properties: &armpostgresqlflexibleservers.MigrationProperties{
	// 		CurrentStatus: &armpostgresqlflexibleservers.MigrationStatus{
	// 			CurrentSubStateDetails: &armpostgresqlflexibleservers.MigrationSubstateDetails{
	// 				CurrentSubState: to.Ptr(armpostgresqlflexibleservers.MigrationSubstatePerformingPreRequisiteSteps),
	// 			},
	// 			Error: to.Ptr(""),
	// 			State: to.Ptr(armpostgresqlflexibleservers.MigrationStateInProgress),
	// 		},
	// 		DbsToMigrate: []*string{
	// 			to.Ptr("exampledatabase1"),
	// 			to.Ptr("exampledatabase2"),
	// 			to.Ptr("exampledatabase3"),
	// 			to.Ptr("exampledatabase4")},
	// 			MigrateRoles: to.Ptr(armpostgresqlflexibleservers.MigrateRolesAndPermissionsFalse),
	// 			MigrationID: to.Ptr("d3ceacbb-a5fd-43dc-a9db-6022b5154856"),
	// 			MigrationWindowStartTimeInUTC: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2025-06-01T20:30:22.123Z"); return t}()),
	// 			OverwriteDbsInTarget: to.Ptr(armpostgresqlflexibleservers.OverwriteDatabasesOnTargetServerFalse),
	// 			SetupLogicalReplicationOnSourceDbIfNeeded: to.Ptr(armpostgresqlflexibleservers.LogicalReplicationOnSourceServerTrue),
	// 			SourceDbServerMetadata: &armpostgresqlflexibleservers.DbServerMetadata{
	// 				Location: to.Ptr("eastus"),
	// 				SKU: &armpostgresqlflexibleservers.ServerSKU{
	// 					Name: to.Ptr("B_Gen5_2"),
	// 					Tier: to.Ptr(armpostgresqlflexibleservers.SKUTier("Basic")),
	// 				},
	// 				StorageMb: to.Ptr[int32](1024),
	// 				Version: to.Ptr("10"),
	// 			},
	// 			SourceDbServerResourceID: to.Ptr("/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBForPostgreSql/servers/examplesource"),
	// 			StartDataMigration: to.Ptr(armpostgresqlflexibleservers.StartDataMigrationFalse),
	// 			TargetDbServerMetadata: &armpostgresqlflexibleservers.DbServerMetadata{
	// 				Location: to.Ptr("eastus"),
	// 				SKU: &armpostgresqlflexibleservers.ServerSKU{
	// 					Name: to.Ptr("Standard_D4ds_v5"),
	// 					Tier: to.Ptr(armpostgresqlflexibleservers.SKUTierGeneralPurpose),
	// 				},
	// 				StorageMb: to.Ptr[int32](2048),
	// 				Version: to.Ptr("17"),
	// 			},
	// 			TargetDbServerResourceID: to.Ptr("/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBForPostgreSql/flexibleServers/exampletarget"),
	// 			TriggerCutover: to.Ptr(armpostgresqlflexibleservers.TriggerCutoverFalse),
	// 		},
	// 	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { PostgreSQLManagementFlexibleServerClient } = require("@azure/arm-postgresql-flexible");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Updates an existing migration. The request body can contain one to many of the mutable properties present in the migration definition. Certain property updates initiate migration state transitions.
 *
 * @summary Updates an existing migration. The request body can contain one to many of the mutable properties present in the migration definition. Certain property updates initiate migration state transitions.
 * x-ms-original-file: specification/postgresql/resource-manager/Microsoft.DBforPostgreSQL/stable/2025-08-01/examples/MigrationsUpdate.json
 */
async function updateAnExistingMigration() {
  const subscriptionId =
    process.env["POSTGRESQL_SUBSCRIPTION_ID"] || "ffffffff-ffff-ffff-ffff-ffffffffffff";
  const resourceGroupName = process.env["POSTGRESQL_RESOURCE_GROUP"] || "exampleresourcegroup";
  const serverName = "exampleserver";
  const migrationName = "examplemigration";
  const parameters = {
    setupLogicalReplicationOnSourceDbIfNeeded: "True",
  };
  const credential = new DefaultAzureCredential();
  const client = new PostgreSQLManagementFlexibleServerClient(credential, subscriptionId);
  const result = await client.migrations.update(
    resourceGroupName,
    serverName,
    migrationName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.PostgreSql.FlexibleServers.Models;
using Azure.ResourceManager.PostgreSql.FlexibleServers;

// Generated from example definition: specification/postgresql/resource-manager/Microsoft.DBforPostgreSQL/stable/2025-08-01/examples/MigrationsUpdate.json
// this example is just showing the usage of "Migrations_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this PostgreSqlMigrationResource created on azure
// for more information of creating PostgreSqlMigrationResource, please refer to the document of PostgreSqlMigrationResource
string subscriptionId = "ffffffff-ffff-ffff-ffff-ffffffffffff";
string resourceGroupName = "exampleresourcegroup";
string serverName = "exampleserver";
string migrationName = "examplemigration";
ResourceIdentifier postgreSqlMigrationResourceId = PostgreSqlMigrationResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, migrationName);
PostgreSqlMigrationResource postgreSqlMigration = client.GetPostgreSqlMigrationResource(postgreSqlMigrationResourceId);

// invoke the operation
PostgreSqlMigrationPatch patch = new PostgreSqlMigrationPatch
{
    SetupLogicalReplicationOnSourceDbIfNeeded = PostgreSqlMigrationLogicalReplicationOnSourceDb.True,
};
PostgreSqlMigrationResource result = await postgreSqlMigration.UpdateAsync(patch);

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
PostgreSqlMigrationData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:

200

{
  "name": "examplemigration",
  "type": "Microsoft.DBForPostgreSql/flexibleServers/migrations",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBForPostgreSql/flexibleServers/exampletarget/migrations/examplemigration",
  "location": "eastus",
  "properties": {
    "currentStatus": {
      "currentSubStateDetails": {
        "currentSubState": "PerformingPreRequisiteSteps"
      },
      "error": "",
      "state": "InProgress"
    },
    "dbsToMigrate": [
      "exampledatabase1",
      "exampledatabase2",
      "exampledatabase3",
      "exampledatabase4"
    ],
    "migrateRoles": "False",
    "migrationId": "d3ceacbb-a5fd-43dc-a9db-6022b5154856",
    "migrationWindowStartTimeInUtc": "2025-06-01T20:30:22.123456Z",
    "overwriteDbsInTarget": "False",
    "setupLogicalReplicationOnSourceDbIfNeeded": "True",
    "sourceDbServerMetadata": {
      "location": "eastus",
      "sku": {
        "name": "B_Gen5_2",
        "tier": "Basic"
      },
      "storageMb": 1024,
      "version": "10"
    },
    "sourceDbServerResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBForPostgreSql/servers/examplesource",
    "startDataMigration": "False",
    "targetDbServerMetadata": {
      "location": "eastus",
      "sku": {
        "name": "Standard_D4ds_v5",
        "tier": "GeneralPurpose"
      },
      "storageMb": 2048,
      "version": "17"
    },
    "targetDbServerResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBForPostgreSql/flexibleServers/exampletarget",
    "triggerCutover": "False"
  }
}

Definitionen

Name	Beschreibung
AdminCredentials	Anmeldeinformationen von Administratorbenutzern für Quell- und Zielserver.
AdminCredentialsForPatch	Anmeldeinformationen von Administratorbenutzern für Quell- und Zielserver.
Cancel	Gibt an, ob der Abbruch für die gesamte Migration ausgelöst werden muss.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DatabaseMigrationState	Migrationsstatus einer Datenbank.
DbLevelValidationStatus	Zusammenfassung des Validierungsstatus für eine Datenbank.
DbServerMetadata	Datenbankservermetadaten.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
LogicalReplicationOnSourceServer	Gibt an, ob bei Bedarf die logische Replikation auf dem Quellserver eingerichtet werden soll.
MigrateRolesAndPermissions	Gibt an, ob Rollen und Berechtigungen migriert werden müssen.
Migration	Eigenschaften einer Migration.
MigrationDatabaseState	Migrationsstatus einer Datenbank.
MigrationMode	Modus, der zum Ausführen der Migration verwendet wird: Online oder Offline.
MigrationOption	Unterstützte Option für eine Migration
MigrationResourceForPatch	Migration.
MigrationSecretParameters	Parameter des Migrationsgeheimnisses.
MigrationSecretParametersForPatch	Parameter des Migrationsgeheimnisses.
MigrationState	Stand der Migration.
MigrationStatus	Stand der Migration.
MigrationSubstate	Teilstaat der Migration.
MigrationSubstateDetails	Details zum Unterzustand der Migration.
OverwriteDatabasesOnTargetServer	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 von Informationen eines Servers.
SkuTier	Ebene der Compute, die einem Server zugewiesen 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".
StartDataMigration	Gibt an, ob die Datenmigration sofort gestartet werden muss.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
TriggerCutover	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

Objekt

Anmeldeinformationen von Administratorbenutzern für Quell- und Zielserver.

Name	Typ	Beschreibung
sourceServerPassword	string (password)	Kennwort für den Benutzer des Quellservers.
targetServerPassword	string (password)	Kennwort für den Benutzer des Zielservers.

AdminCredentialsForPatch

Objekt

Anmeldeinformationen von Administratorbenutzern für Quell- und Zielserver.

Name	Typ	Beschreibung
sourceServerPassword	string (password)	Kennwort für den Benutzer des Quellservers.
targetServerPassword	string (password)	Kennwort für den Benutzer des Zielservers.

Cancel

Enumeration

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

Wert	Beschreibung
True
False

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DatabaseMigrationState

Objekt

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	MigrationDatabaseState	Migrationsstatus einer Datenbank.
startedOn	string (date-time)	Startzeit eines Migrationszustands.

DbLevelValidationStatus

Objekt

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.

DbServerMetadata

Objekt

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

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

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

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

LogicalReplicationOnSourceServer

Enumeration

Gibt an, ob bei Bedarf die logische Replikation auf dem Quellserver eingerichtet werden soll.

Wert	Beschreibung
True
False

MigrateRolesAndPermissions

Enumeration

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

Wert	Beschreibung
True
False

Migration

Objekt

Eigenschaften einer 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	Cancel	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	MigrateRolesAndPermissions	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	OverwriteDatabasesOnTargetServer	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	LogicalReplicationOnSourceServer	Gibt an, ob bei Bedarf die logische Replikation auf dem Quellserver 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	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	DbServerMetadata	Metadaten des Zieldatenbankservers.
properties.targetDbServerResourceId	string	Kennung der Serverressource der Zieldatenbank.
properties.triggerCutover	TriggerCutover	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"

MigrationDatabaseState

Enumeration

Migrationsstatus einer Datenbank.

Wert	Beschreibung
InProgress
WaitingForCutoverTrigger
Failed
Canceled
Succeeded
Canceling

MigrationMode

Enumeration

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

Wert	Beschreibung
Offline
Online

MigrationOption

Enumeration

Unterstützte Option für eine Migration

Wert	Beschreibung
Validate
Migrate
ValidateAndMigrate

MigrationResourceForPatch

Objekt

Migration.

Name	Typ	Beschreibung
properties.cancel	Cancel	Gibt an, ob der Abbruch für die gesamte Migration ausgelöst werden muss.
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	MigrateRolesAndPermissions	Gibt an, ob Rollen und Berechtigungen migriert werden müssen.
properties.migrationMode	MigrationMode	Modus, der zum Ausführen der Migration verwendet wird: Online oder Offline.
properties.migrationWindowStartTimeInUtc	string (date-time)	Startzeit (UTC) für das Migrationsfenster.
properties.overwriteDbsInTarget	OverwriteDatabasesOnTargetServer	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	MigrationSecretParametersForPatch	Parameter des Migrationsgeheimnisses.
properties.setupLogicalReplicationOnSourceDbIfNeeded	LogicalReplicationOnSourceServer	Gibt an, ob bei Bedarf die logische Replikation auf dem Quellserver 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.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.startDataMigration	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.triggerCutover	TriggerCutover	Gibt an, ob die Übernahme für die gesamte Migration ausgelöst werden muss.
tags	object	Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren.

MigrationSecretParameters

Objekt

Parameter des Migrationsgeheimnisses.

Name	Typ	Beschreibung
adminCredentials	AdminCredentials (password)	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.

MigrationSecretParametersForPatch

Objekt

Parameter des Migrationsgeheimnisses.

Name	Typ	Beschreibung
adminCredentials	AdminCredentialsForPatch (password)	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

Enumeration

Stand der Migration.

Wert	Beschreibung
InProgress
WaitingForUserAction
Canceled
Failed
Succeeded
ValidationFailed
CleaningUp

MigrationStatus

Objekt

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

Enumeration

Teilstaat der Migration.

Wert	Beschreibung
PerformingPreRequisiteSteps
WaitingForLogicalReplicationSetupRequestOnSourceDB
WaitingForDBsToMigrateSpecification
WaitingForTargetDBOverwriteConfirmation
WaitingForDataMigrationScheduling
WaitingForDataMigrationWindow
MigratingData
WaitingForCutoverTrigger
CompletingMigration
Completed
CancelingRequestedDBMigrations
ValidationInProgress

MigrationSubstateDetails

Objekt

Details zum Unterzustand der Migration.

Name	Typ	Beschreibung
currentSubState	MigrationSubstate	Teilstaat der Migration.
dbDetails	<string,  DatabaseMigrationState>
validationDetails	ValidationDetails	Details zur Validierung für die Migration.

OverwriteDatabasesOnTargetServer

Enumeration

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
True
False

ServerSku

Objekt

Berechnen von Informationen eines 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 Server zugewiesen ist.

SkuTier

Enumeration

Ebene der Compute, die einem Server zugewiesen ist.

Wert	Beschreibung
Burstable
GeneralPurpose
MemoryOptimized

SourceType

Enumeration

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
OnPremises
AWS
GCP
AzureVM
PostgreSQLSingleServer
AWS_RDS
AWS_AURORA
AWS_EC2
GCP_CloudSQL
GCP_AlloyDB
GCP_Compute
EDB
EDB_Oracle_Server
EDB_PostgreSQL
PostgreSQLFlexibleServer
PostgreSQLCosmosDB
Huawei_RDS
Huawei_Compute
Heroku_PostgreSQL
Crunchy_PostgreSQL
ApsaraDB_RDS
Digital_Ocean_Droplets
Digital_Ocean_PostgreSQL
Supabase_PostgreSQL

SslMode

Enumeration

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

StartDataMigration

Enumeration

Gibt an, ob die Datenmigration sofort gestartet werden muss.

Wert	Beschreibung
True
False

systemData

Objekt

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.

TriggerCutover

Enumeration

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

Wert	Beschreibung
True
False

ValidationDetails

Objekt

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

Objekt der Validierungsnachricht.

Name	Typ	Beschreibung
message	string	Zeichenfolge der Validierungsmeldung.
state	ValidationState	Schweregrad der Validierungsmeldung.

ValidationState

Enumeration

Validierungsstatus für die Migration.

Wert	Beschreibung
Failed
Succeeded
Warning

ValidationSummaryItem

Objekt

Validierungszusammenfassungsobjekt.

Name	Typ	Beschreibung
messages	ValidationMessage[]	Validierungsmeldungen.
state	ValidationState	Validierungsstatus für die Migration.
type	string	Typ der Validierung.