Migrations - Update

Servizio:

PostgreSQL

Versione API:

2025-08-01

Aggiorna una migrazione esistente. Il corpo della richiesta può contenere una o più delle proprietà modificabili presenti nella definizione della migrazione. Alcuni aggiornamenti delle proprietà avviano transizioni di stato di migrazione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
migrationName	path	True	string pattern: ^[a-z][a-z0-9]*$	Nome della migrazione.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
serverName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*	Il nome del server.
subscriptionId	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	Tipo	Descrizione
properties.cancel	Cancel	Indica se l'annullamento deve essere attivato per l'intera migrazione.
properties.dbsToCancelMigrationOn	string[]	Quando si desidera attivare l'annullamento per database specifici, impostare 'triggerCutover' su 'True' e i nomi dei database specifici in questo array.
properties.dbsToMigrate	string[]	Nomi dei database di cui eseguire la migrazione.
properties.dbsToTriggerCutoverOn	string[]	Quando si desidera attivare il cutover per database specifici, impostare 'triggerCutover' su 'True' e i nomi dei database specifici in questo array.
properties.migrateRoles	MigrateRolesAndPermissions	Indica se è necessario eseguire la migrazione di ruoli e autorizzazioni.
properties.migrationMode	MigrationMode	Modalità utilizzata per eseguire la migrazione: Online o Offline.
properties.migrationWindowStartTimeInUtc	string (date-time)	Ora di inizio (UTC) per la finestra di migrazione.
properties.overwriteDbsInTarget	OverwriteDatabasesOnTargetServer	Indica se i database nel server di destinazione possono essere sovrascritti quando sono già presenti. Se impostato su 'False', quando il flusso di lavoro di migrazione rileva che il database esiste già sul server di destinazione, attenderà una conferma.
properties.secretParameters	MigrationSecretParametersForPatch	Parametri del segreto di migrazione.
properties.setupLogicalReplicationOnSourceDbIfNeeded	LogicalReplicationOnSourceServer	Indica se configurare la replica logica nel server di origine, se necessario.
properties.sourceDbServerFullyQualifiedDomainName	string	Nome di dominio completo (FQDN) o indirizzo IP del server di origine. Questa proprietà è facoltativa. Quando fornito, il servizio di migrazione lo utilizzerà sempre per connettersi al server di origine.
properties.sourceDbServerResourceId	string	Identificatore della risorsa del server di database di origine, quando 'sourceType' è 'PostgreSQLSingleServer'. Per altri tipi di origine questo deve essere impostato su ipaddress:port@username o hostname:port@username.
properties.startDataMigration	StartDataMigration	Indica se la migrazione dei dati deve essere avviata immediatamente.
properties.targetDbServerFullyQualifiedDomainName	string	Nome di dominio completo (FQDN) o indirizzo IP del server di destinazione. Questa proprietà è facoltativa. Quando viene fornito, il servizio di migrazione lo utilizzerà sempre per connettersi al server di destinazione.
properties.triggerCutover	TriggerCutover	Indica se il cutover deve essere attivato per l'intera migrazione.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

Risposte

Nome	Tipo	Descrizione
200 OK	Migration	L'operazione di Azure è stata completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Update an existing migration.

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
AdminCredentials	Credenziali degli utenti amministratori per i server di origine e di destinazione.
AdminCredentialsForPatch	Credenziali degli utenti amministratori per i server di origine e di destinazione.
Cancel	Indica se l'annullamento deve essere attivato per l'intera migrazione.
createdByType	Tipo di identità che ha creato la risorsa.
DatabaseMigrationState	Stato di migrazione di un database.
DbLevelValidationStatus	Riepilogo dello stato di convalida per un database.
DbServerMetadata	Metadati del server di database.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
LogicalReplicationOnSourceServer	Indica se configurare la replica logica nel server di origine, se necessario.
MigrateRolesAndPermissions	Indica se è necessario eseguire la migrazione di ruoli e autorizzazioni.
Migration	Proprietà di una migrazione.
MigrationDatabaseState	Stato di migrazione di un database.
MigrationMode	Modalità utilizzata per eseguire la migrazione: Online o Offline.
MigrationOption	Opzione supportata per una migrazione
MigrationResourceForPatch	Migration.
MigrationSecretParameters	Parametri del segreto di migrazione.
MigrationSecretParametersForPatch	Parametri del segreto di migrazione.
MigrationState	Stato di migrazione.
MigrationStatus	Stato di migrazione.
MigrationSubstate	Sottostato della migrazione.
MigrationSubstateDetails	Dettagli del sottostato di migrazione.
OverwriteDatabasesOnTargetServer	Indica se i database nel server di destinazione possono essere sovrascritti quando sono già presenti. Se impostato su 'False', quando il flusso di lavoro di migrazione rileva che il database esiste già sul server di destinazione, attenderà una conferma.
ServerSku	Calcola le informazioni di un server.
SkuTier	Livello di calcolo assegnato a un server.
SourceType	Tipo di server di origine usato per la migrazione: 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 o Supabase_PostgreSQL
SslMode	Modalità SSL utilizzata da una migrazione. La modalità SSL predefinita per 'PostgreSQLSingleServer' è 'VerifyFull'. La modalità SSL predefinita per altri tipi di origine è "Preferisci".
StartDataMigration	Indica se la migrazione dei dati deve essere avviata immediatamente.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TriggerCutover	Indica se il cutover deve essere attivato per l'intera migrazione.
ValidationDetails	Dettagli per la convalida per la migrazione.
ValidationMessage	Oggetto messaggio di convalida.
ValidationState	Stato di convalida per la migrazione.
ValidationSummaryItem	Oggetto di riepilogo della convalida.

AdminCredentials

Oggetto

Credenziali degli utenti amministratori per i server di origine e di destinazione.

Nome	Tipo	Descrizione
sourceServerPassword	string (password)	Password per l'utente del server di origine.
targetServerPassword	string (password)	Password per l'utente del server di destinazione.

AdminCredentialsForPatch

Oggetto

Credenziali degli utenti amministratori per i server di origine e di destinazione.

Nome	Tipo	Descrizione
sourceServerPassword	string (password)	Password per l'utente del server di origine.
targetServerPassword	string (password)	Password per l'utente del server di destinazione.

Cancel

Enumerazione

Indica se l'annullamento deve essere attivato per l'intera migrazione.

Valore	Descrizione
True
False

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DatabaseMigrationState

Oggetto

Stato di migrazione di un database.

Nome	Tipo	Descrizione
appliedChanges	integer (int32)	Contatore delle modifiche applicate da Change Data Capture.
cdcDeleteCounter	integer (int32)	Contatore di eliminazione Change Data Capture.
cdcInsertCounter	integer (int32)	Contatore di inserimento Change Data Capture.
cdcUpdateCounter	integer (int32)	Contatore degli aggiornamenti di Change Data Capture.
databaseName	string	Nome del database.
endedOn	string (date-time)	Ora di fine di uno stato di migrazione.
fullLoadCompletedTables	integer (int32)	Numero di tabelle caricate durante la migrazione di un database.
fullLoadErroredTables	integer (int32)	Numero di tabelle che riscontrano errori durante la migrazione di un database.
fullLoadLoadingTables	integer (int32)	Numero di tabelle caricate durante la migrazione di un database.
fullLoadQueuedTables	integer (int32)	Numero di tabelle accodate per la migrazione di un database.
incomingChanges	integer (int32)	Contatore delle modifiche in ingresso Change Data Capture.
latency	integer (int32)	Ritardo in secondi tra l'origine e la destinazione durante la fase online.
message	string	Messaggio di errore, se presente, per lo stato di migrazione.
migrationOperation	string	Operazione di migrazione di un database.
migrationState	MigrationDatabaseState	Stato di migrazione di un database.
startedOn	string (date-time)	Ora di inizio di uno stato di migrazione.

DbLevelValidationStatus

Oggetto

Riepilogo dello stato di convalida per un database.

Nome	Tipo	Descrizione
databaseName	string	Nome del database.
endedOn	string (date-time)	Ora di fine di una convalida a livello di database.
startedOn	string (date-time)	Ora di inizio di una convalida a livello di database.
summary	ValidationSummaryItem[]	Riepilogo delle convalide a livello di database.

DbServerMetadata

Oggetto

Metadati del server di database.

Nome	Tipo	Descrizione
location	string	Ubicazione del server di database.
sku	ServerSku	Livello di calcolo e dimensioni del server di database. Questo oggetto è vuoto per un server singolo di Database di Azure per PostgreSQL.
storageMb	integer (int32)	Dimensioni di archiviazione (in MB) per il server di database.
version	string	Versione principale del motore di database PostgreSQL.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

LogicalReplicationOnSourceServer

Enumerazione

Indica se configurare la replica logica nel server di origine, se necessario.

Valore	Descrizione
True
False

MigrateRolesAndPermissions

Enumerazione

Indica se è necessario eseguire la migrazione di ruoli e autorizzazioni.

Valore	Descrizione
True
False

Migration

Oggetto

Proprietà di una migrazione.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.cancel	Cancel	Indica se l'annullamento deve essere attivato per l'intera migrazione.
properties.currentStatus	MigrationStatus	Stato corrente di una migrazione.
properties.dbsToCancelMigrationOn	string[]	Quando si desidera attivare l'annullamento per database specifici, impostare 'triggerCutover' su 'True' e i nomi dei database specifici in questo array.
properties.dbsToMigrate	string[]	Nomi dei database di cui eseguire la migrazione.
properties.dbsToTriggerCutoverOn	string[]	Quando si desidera attivare il cutover per database specifici, impostare 'triggerCutover' su 'True' e i nomi dei database specifici in questo array.
properties.migrateRoles	MigrateRolesAndPermissions	Indica se è necessario eseguire la migrazione di ruoli e autorizzazioni.
properties.migrationId	string	Identificatore di una migrazione.
properties.migrationInstanceResourceId	string (arm-id)	Identificatore dell'istanza di migrazione dell'endpoint privato.
properties.migrationMode	MigrationMode	Modalità utilizzata per eseguire la migrazione: Online o Offline.
properties.migrationOption	MigrationOption	Opzione supportata per una migrazione.
properties.migrationWindowEndTimeInUtc	string (date-time)	Ora di fine (UTC) per la finestra di migrazione.
properties.migrationWindowStartTimeInUtc	string (date-time)	Ora di inizio (UTC) per la finestra di migrazione.
properties.overwriteDbsInTarget	OverwriteDatabasesOnTargetServer	Indica se i database nel server di destinazione possono essere sovrascritti quando sono già presenti. Se impostato su 'False', quando il flusso di lavoro di migrazione rileva che il database esiste già sul server di destinazione, attenderà una conferma.
properties.secretParameters	MigrationSecretParameters	Parametri del segreto di migrazione.
properties.setupLogicalReplicationOnSourceDbIfNeeded	LogicalReplicationOnSourceServer	Indica se configurare la replica logica nel server di origine, se necessario.
properties.sourceDbServerFullyQualifiedDomainName	string	Nome di dominio completo (FQDN) o indirizzo IP del server di origine. Questa proprietà è facoltativa. Quando fornito, il servizio di migrazione lo utilizzerà sempre per connettersi al server di origine.
properties.sourceDbServerMetadata	DbServerMetadata	Metadati del server di database di origine.
properties.sourceDbServerResourceId	string	Identificatore della risorsa del server di database di origine, quando 'sourceType' è 'PostgreSQLSingleServer'. Per altri tipi di origine questo deve essere impostato su ipaddress:port@username o hostname:port@username.
properties.sourceType	SourceType	Tipo di server di origine usato per la migrazione: 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 o Supabase_PostgreSQL
properties.sslMode	SslMode	Modalità SSL utilizzata da una migrazione. La modalità SSL predefinita per 'PostgreSQLSingleServer' è 'VerifyFull'. La modalità SSL predefinita per altri tipi di origine è "Preferisci".
properties.startDataMigration	StartDataMigration	Indica se la migrazione dei dati deve essere avviata immediatamente.
properties.targetDbServerFullyQualifiedDomainName	string	Nome di dominio completo (FQDN) o indirizzo IP del server di destinazione. Questa proprietà è facoltativa. Quando viene fornito, il servizio di migrazione lo utilizzerà sempre per connettersi al server di destinazione.
properties.targetDbServerMetadata	DbServerMetadata	Metadati del server di database di destinazione.
properties.targetDbServerResourceId	string	Identificatore della risorsa del server di database di destinazione.
properties.triggerCutover	TriggerCutover	Indica se il cutover deve essere attivato per l'intera migrazione.
systemData	systemData	Metadati di Azure Resource Manager contenenti informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

MigrationDatabaseState

Enumerazione

Stato di migrazione di un database.

Valore	Descrizione
InProgress
WaitingForCutoverTrigger
Failed
Canceled
Succeeded
Canceling

MigrationMode

Enumerazione

Modalità utilizzata per eseguire la migrazione: Online o Offline.

Valore	Descrizione
Offline
Online

MigrationOption

Enumerazione

Opzione supportata per una migrazione

Valore	Descrizione
Validate
Migrate
ValidateAndMigrate

MigrationResourceForPatch

Oggetto

Migration.

Nome	Tipo	Descrizione
properties.cancel	Cancel	Indica se l'annullamento deve essere attivato per l'intera migrazione.
properties.dbsToCancelMigrationOn	string[]	Quando si desidera attivare l'annullamento per database specifici, impostare 'triggerCutover' su 'True' e i nomi dei database specifici in questo array.
properties.dbsToMigrate	string[]	Nomi dei database di cui eseguire la migrazione.
properties.dbsToTriggerCutoverOn	string[]	Quando si desidera attivare il cutover per database specifici, impostare 'triggerCutover' su 'True' e i nomi dei database specifici in questo array.
properties.migrateRoles	MigrateRolesAndPermissions	Indica se è necessario eseguire la migrazione di ruoli e autorizzazioni.
properties.migrationMode	MigrationMode	Modalità utilizzata per eseguire la migrazione: Online o Offline.
properties.migrationWindowStartTimeInUtc	string (date-time)	Ora di inizio (UTC) per la finestra di migrazione.
properties.overwriteDbsInTarget	OverwriteDatabasesOnTargetServer	Indica se i database nel server di destinazione possono essere sovrascritti quando sono già presenti. Se impostato su 'False', quando il flusso di lavoro di migrazione rileva che il database esiste già sul server di destinazione, attenderà una conferma.
properties.secretParameters	MigrationSecretParametersForPatch	Parametri del segreto di migrazione.
properties.setupLogicalReplicationOnSourceDbIfNeeded	LogicalReplicationOnSourceServer	Indica se configurare la replica logica nel server di origine, se necessario.
properties.sourceDbServerFullyQualifiedDomainName	string	Nome di dominio completo (FQDN) o indirizzo IP del server di origine. Questa proprietà è facoltativa. Quando fornito, il servizio di migrazione lo utilizzerà sempre per connettersi al server di origine.
properties.sourceDbServerResourceId	string	Identificatore della risorsa del server di database di origine, quando 'sourceType' è 'PostgreSQLSingleServer'. Per altri tipi di origine questo deve essere impostato su ipaddress:port@username o hostname:port@username.
properties.startDataMigration	StartDataMigration	Indica se la migrazione dei dati deve essere avviata immediatamente.
properties.targetDbServerFullyQualifiedDomainName	string	Nome di dominio completo (FQDN) o indirizzo IP del server di destinazione. Questa proprietà è facoltativa. Quando viene fornito, il servizio di migrazione lo utilizzerà sempre per connettersi al server di destinazione.
properties.triggerCutover	TriggerCutover	Indica se il cutover deve essere attivato per l'intera migrazione.
tags	object	Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

MigrationSecretParameters

Oggetto

Parametri del segreto di migrazione.

Nome	Tipo	Descrizione
adminCredentials	AdminCredentials (password)	Credenziali degli utenti amministratori per i server di origine e di destinazione.
sourceServerUsername	string	Ottiene o imposta il nome dell'utente per il server di origine. Non è necessario che l'utente sia un amministratore.
targetServerUsername	string	Ottiene o imposta il nome dell'utente per il server di destinazione. Non è necessario che l'utente sia un amministratore.

MigrationSecretParametersForPatch

Oggetto

Parametri del segreto di migrazione.

Nome	Tipo	Descrizione
adminCredentials	AdminCredentialsForPatch (password)	Credenziali degli utenti amministratori per i server di origine e di destinazione.
sourceServerUsername	string	Ottiene o imposta il nome dell'utente per il server di origine. Non è necessario che l'utente sia un amministratore.
targetServerUsername	string	Ottiene o imposta il nome dell'utente per il server di destinazione. Non è necessario che l'utente sia un amministratore.

MigrationState

Enumerazione

Stato di migrazione.

Valore	Descrizione
InProgress
WaitingForUserAction
Canceled
Failed
Succeeded
ValidationFailed
CleaningUp

MigrationStatus

Oggetto

Stato di migrazione.

Nome	Tipo	Descrizione
currentSubStateDetails	MigrationSubstateDetails	Dettagli dello stato secondario della migrazione corrente.
error	string	Messaggio di errore, se presente, per lo stato di migrazione.
state	MigrationState	Stato di migrazione.

MigrationSubstate

Enumerazione

Sottostato della migrazione.

Valore	Descrizione
PerformingPreRequisiteSteps
WaitingForLogicalReplicationSetupRequestOnSourceDB
WaitingForDBsToMigrateSpecification
WaitingForTargetDBOverwriteConfirmation
WaitingForDataMigrationScheduling
WaitingForDataMigrationWindow
MigratingData
WaitingForCutoverTrigger
CompletingMigration
Completed
CancelingRequestedDBMigrations
ValidationInProgress

MigrationSubstateDetails

Oggetto

Dettagli del sottostato di migrazione.

Nome	Tipo	Descrizione
currentSubState	MigrationSubstate	Sottostato della migrazione.
dbDetails	<string,  DatabaseMigrationState>
validationDetails	ValidationDetails	Dettagli per la convalida per la migrazione.

OverwriteDatabasesOnTargetServer

Enumerazione

Indica se i database nel server di destinazione possono essere sovrascritti quando sono già presenti. Se impostato su 'False', quando il flusso di lavoro di migrazione rileva che il database esiste già sul server di destinazione, attenderà una conferma.

Valore	Descrizione
True
False

ServerSku

Oggetto

Calcola le informazioni di un server.

Nome	Tipo	Descrizione
name	string	Livello di calcolo e dimensioni del server di database. Questo oggetto è vuoto per un server singolo di Database di Azure per PostgreSQL.
tier	SkuTier	Livello di calcolo assegnato a un server.

SkuTier

Enumerazione

Livello di calcolo assegnato a un server.

Valore	Descrizione
Burstable
GeneralPurpose
MemoryOptimized

SourceType

Enumerazione

Tipo di server di origine usato per la migrazione: 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 o Supabase_PostgreSQL

Valore	Descrizione
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

Enumerazione

Modalità SSL utilizzata da una migrazione. La modalità SSL predefinita per 'PostgreSQLSingleServer' è 'VerifyFull'. La modalità SSL predefinita per altri tipi di origine è "Preferisci".

Valore	Descrizione
Prefer
Require
VerifyCA
VerifyFull

StartDataMigration

Enumerazione

Indica se la migrazione dei dati deve essere avviata immediatamente.

Valore	Descrizione
True
False

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

TriggerCutover

Enumerazione

Indica se il cutover deve essere attivato per l'intera migrazione.

Valore	Descrizione
True
False

ValidationDetails

Oggetto

Dettagli per la convalida per la migrazione.

Nome	Tipo	Descrizione
dbLevelValidationDetails	DbLevelValidationStatus[]	Dettagli delle convalide a livello di server.
serverLevelValidationDetails	ValidationSummaryItem[]	Dettagli delle convalide a livello di server.
status	ValidationState	Stato di convalida per la migrazione.
validationEndTimeInUtc	string (date-time)	Ora di fine (UTC) per la convalida.
validationStartTimeInUtc	string (date-time)	Ora di inizio (UTC) per la convalida.

ValidationMessage

Oggetto

Oggetto messaggio di convalida.

Nome	Tipo	Descrizione
message	string	Stringa del messaggio di convalida.
state	ValidationState	Gravità del messaggio di convalida.

ValidationState

Enumerazione

Stato di convalida per la migrazione.

Valore	Descrizione
Failed
Succeeded
Warning

ValidationSummaryItem

Oggetto

Oggetto di riepilogo della convalida.

Nome	Tipo	Descrizione
messages	ValidationMessage[]	Messaggi di convalida.
state	ValidationState	Stato di convalida per la migrazione.
type	string	Tipo di convalida.