Migrations - Update

Usługa:

PostgreSQL

Wersja interfejsu API:

2025-08-01

Aktualizuje istniejącą migrację. Treść żądania może zawierać jeden do wielu właściwości modyfikowalnych znajdujących się w definicji migracji. Niektóre aktualizacje właściwości inicjują przejścia stanu migracji.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
migrationName	path	True	string pattern: ^[a-z][a-z0-9]*$	Nazwa migracji.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
serverName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*	Nazwa serwera.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
properties.cancel	Cancel	Wskazuje, czy anulowanie musi zostać wyzwolone dla całej migracji.
properties.dbsToCancelMigrationOn	string[]	Jeśli chcesz wyzwolić anulowanie dla określonych baz danych, ustaw wartość "triggerCutover" na "True" i nazwy określonych baz danych w tej tablicy.
properties.dbsToMigrate	string[]	Nazwy baz danych do migracji.
properties.dbsToTriggerCutoverOn	string[]	Jeśli chcesz wyzwolić środowisko jednorazowe dla określonych baz danych, ustaw wartość "triggerCutover" na wartość "True" i nazwy określonych baz danych w tej tablicy.
properties.migrateRoles	MigrateRolesAndPermissions	Wskazuje, czy należy przeprowadzić migrację ról i uprawnień.
properties.migrationMode	MigrationMode	Tryb używany do przeprowadzenia migracji: Online lub Offline.
properties.migrationWindowStartTimeInUtc	string (date-time)	Godzina rozpoczęcia (UTC) okna migracji.
properties.overwriteDbsInTarget	OverwriteDatabasesOnTargetServer	Wskazuje, czy bazy danych na serwerze docelowym mogą zostać zastąpione, jeśli są już obecne. W przypadku ustawienia wartości "Fałsz", gdy przepływ pracy migracji wykryje, że baza danych już istnieje na serwerze docelowym, będzie czekać na potwierdzenie.
properties.secretParameters	MigrationSecretParametersForPatch	Parametry wpisu tajnego migracji.
properties.setupLogicalReplicationOnSourceDbIfNeeded	LogicalReplicationOnSourceServer	Wskazuje, czy w razie potrzeby należy skonfigurować replikację logiczną na serwerze źródłowym.
properties.sourceDbServerFullyQualifiedDomainName	string	W pełni kwalifikowana nazwa domeny (FQDN) lub adres IP serwera źródłowego. Ta właściwość jest opcjonalna. Po podaniu usługa migracji zawsze będzie używać go do nawiązywania połączenia z serwerem źródłowym.
properties.sourceDbServerResourceId	string	Identyfikator zasobu źródłowego serwera bazy danych, gdy wartość "sourceType" to "PostgreSQLSingleServer". W przypadku innych typów źródeł należy ustawić wartość ipaddress:port@username lub hostname:port@username.
properties.startDataMigration	StartDataMigration	Wskazuje, czy migracja danych musi rozpocząć się od razu.
properties.targetDbServerFullyQualifiedDomainName	string	W pełni kwalifikowana nazwa domeny (FQDN) lub adres IP serwera docelowego. Ta właściwość jest opcjonalna. Po podaniu usługa migracji zawsze będzie używać go do nawiązywania połączenia z serwerem docelowym.
properties.triggerCutover	TriggerCutover	Wskazuje, czy należy wyzwolić jednorazowe przejście dla całej migracji.
tags	object	Metadane specyficzne dla aplikacji w postaci par klucz-wartość.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Migration	Operacja Azure zakończyła się pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Update an existing migration.

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
AdminCredentials	Poświadczenia administratorów dla serwerów źródłowych i docelowych.
AdminCredentialsForPatch	Poświadczenia administratorów dla serwerów źródłowych i docelowych.
Cancel	Wskazuje, czy anulowanie musi zostać wyzwolone dla całej migracji.
createdByType	Typ tożsamości, która utworzyła zasób.
DatabaseMigrationState	Stan migracji bazy danych.
DbLevelValidationStatus	Podsumowanie stanu walidacji bazy danych.
DbServerMetadata	Metadane serwera bazy danych.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
LogicalReplicationOnSourceServer	Wskazuje, czy w razie potrzeby należy skonfigurować replikację logiczną na serwerze źródłowym.
MigrateRolesAndPermissions	Wskazuje, czy należy przeprowadzić migrację ról i uprawnień.
Migration	Właściwości migracji.
MigrationDatabaseState	Stan migracji bazy danych.
MigrationMode	Tryb używany do przeprowadzenia migracji.
MigrationOption	Obsługiwana opcja migracji.
MigrationResourceForPatch	Migration.
MigrationSecretParameters	Parametry wpisu tajnego migracji.
MigrationSecretParametersForPatch	Parametry wpisu tajnego migracji.
MigrationState	Stan migracji.
MigrationStatus	Stan migracji.
MigrationSubstate	Podstan migracji.
MigrationSubstateDetails	Szczegółowe informacje o podstanie migracji.
OverwriteDatabasesOnTargetServer	Wskazuje, czy bazy danych na serwerze docelowym mogą zostać zastąpione, jeśli są już obecne.
ServerSku	Informacje o obliczeniach serwera.
SkuTier	Warstwa zasobów obliczeniowych przypisana do serwera.
SourceType	Typ serwera źródłowego użyty do migracji.
SslMode	Tryb SSL używany przez migrację. Domyślny tryb SSL dla "PostgreSQLSingleServer" to "VerifyFull". Domyślny tryb SSL dla innych typów źródeł to "Preferowany".
StartDataMigration	Wskazuje, czy migracja danych musi rozpocząć się od razu.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
TriggerCutover	Wskazuje, czy należy wyzwolić jednorazowe przejście dla całej migracji.
ValidationDetails	Szczegółowe informacje dotyczące walidacji migracji.
ValidationMessage	Obiekt komunikatu walidacji.
ValidationState	Stan walidacji dla migracji.
ValidationSummaryItem	Obiekt podsumowania walidacji.

AdminCredentials

Objekt

Poświadczenia administratorów dla serwerów źródłowych i docelowych.

Nazwa	Typ	Opis
sourceServerPassword	string (password)	Hasło dla użytkownika serwera źródłowego.
targetServerPassword	string (password)	Hasło dla użytkownika serwera docelowego.

AdminCredentialsForPatch

Objekt

Poświadczenia administratorów dla serwerów źródłowych i docelowych.

Nazwa	Typ	Opis
sourceServerPassword	string (password)	Hasło dla użytkownika serwera źródłowego.
targetServerPassword	string (password)	Hasło dla użytkownika serwera docelowego.

Cancel

Wyliczenie

Wskazuje, czy anulowanie musi zostać wyzwolone dla całej migracji.

Wartość	Opis
True	Opcja Anuluj musi zostać wyzwolona dla całej migracji.
False	Opcja Anuluj nie może zostać wyzwolona dla całej migracji.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

DatabaseMigrationState

Objekt

Stan migracji bazy danych.

Nazwa	Typ	Opis
appliedChanges	integer (int32)	Licznik zastosowanych zmian Change Data Capture.
cdcDeleteCounter	integer (int32)	Zmień licznik usuwania przechwytywania danych.
cdcInsertCounter	integer (int32)	Zmień licznik wstawiania przechwytywania danych.
cdcUpdateCounter	integer (int32)	Zmień licznik aktualizacji przechwytywania danych.
databaseName	string	Nazwa bazy danych.
endedOn	string (date-time)	Godzina zakończenia stanu migracji.
fullLoadCompletedTables	integer (int32)	Liczba tabel załadowanych podczas migracji bazy danych.
fullLoadErroredTables	integer (int32)	Liczba tabel, w których wystąpiły błędy podczas migracji bazy danych.
fullLoadLoadingTables	integer (int32)	Liczba tabel wczytywanych podczas migracji bazy danych.
fullLoadQueuedTables	integer (int32)	Liczba tabel oczekujących w kolejce do migracji bazy danych.
incomingChanges	integer (int32)	Licznik zmian przychodzących Change Data Capture.
latency	integer (int32)	Opóźnienie w ciągu kilku sekund między źródłem a celem w fazie online.
message	string	Komunikat o błędzie (jeśli istnieje) dla stanu migracji.
migrationOperation	string	Operacja migracji bazy danych.
migrationState	MigrationDatabaseState	Stan migracji bazy danych.
startedOn	string (date-time)	Godzina rozpoczęcia stanu migracji.

DbLevelValidationStatus

Objekt

Podsumowanie stanu walidacji bazy danych.

Nazwa	Typ	Opis
databaseName	string	Nazwa bazy danych.
endedOn	string (date-time)	Czas zakończenia walidacji na poziomie bazy danych.
startedOn	string (date-time)	Czas rozpoczęcia walidacji na poziomie bazy danych.
summary	ValidationSummaryItem[]	Podsumowanie walidacji na poziomie bazy danych.

DbServerMetadata

Objekt

Metadane serwera bazy danych.

Nazwa	Typ	Opis
location	string	Lokalizacja serwera bazy danych.
sku	ServerSku	Warstwa obliczeniowa i rozmiar serwera bazy danych. Ten obiekt jest pusty dla pojedynczego serwera Azure Database for PostgreSQL.
storageMb	integer (int32)	Rozmiar magazynu (w MB) dla serwera bazy danych.
version	string	Główna wersja silnika bazy danych PostgreSQL.

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

LogicalReplicationOnSourceServer

Wyliczenie

Wskazuje, czy w razie potrzeby należy skonfigurować replikację logiczną na serwerze źródłowym.

Wartość	Opis
True	Replikacja logiczna zostanie skonfigurowana na serwerze źródłowym.
False	Replikacja logiczna nie zostanie skonfigurowana na serwerze źródłowym.

MigrateRolesAndPermissions

Wyliczenie

Wskazuje, czy należy przeprowadzić migrację ról i uprawnień.

Wartość	Opis
True	Role i uprawnienia zostaną przeniesione.
False	Role i uprawnienia nie zostaną przeniesione.

Migration

Objekt

Właściwości migracji.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.cancel	Cancel	Wskazuje, czy anulowanie musi zostać wyzwolone dla całej migracji.
properties.currentStatus	MigrationStatus	Bieżący stan migracji.
properties.dbsToCancelMigrationOn	string[]	Jeśli chcesz wyzwolić anulowanie dla określonych baz danych, ustaw wartość "triggerCutover" na "True" i nazwy określonych baz danych w tej tablicy.
properties.dbsToMigrate	string[]	Nazwy baz danych do migracji.
properties.dbsToTriggerCutoverOn	string[]	Jeśli chcesz wyzwolić środowisko jednorazowe dla określonych baz danych, ustaw wartość "triggerCutover" na wartość "True" i nazwy określonych baz danych w tej tablicy.
properties.migrateRoles	MigrateRolesAndPermissions	Wskazuje, czy należy przeprowadzić migrację ról i uprawnień.
properties.migrationId	string	Identyfikator migracji.
properties.migrationInstanceResourceId	string (arm-id)	Identyfikator wystąpienia migracji prywatnego punktu końcowego.
properties.migrationMode	MigrationMode	Tryb używany do przeprowadzenia migracji: Online lub Offline.
properties.migrationOption	MigrationOption	Obsługiwana opcja migracji.
properties.migrationWindowEndTimeInUtc	string (date-time)	Czas zakończenia (UTC) okna migracji.
properties.migrationWindowStartTimeInUtc	string (date-time)	Godzina rozpoczęcia (UTC) okna migracji.
properties.overwriteDbsInTarget	OverwriteDatabasesOnTargetServer	Wskazuje, czy bazy danych na serwerze docelowym mogą zostać zastąpione, jeśli są już obecne. W przypadku ustawienia wartości "Fałsz", gdy przepływ pracy migracji wykryje, że baza danych już istnieje na serwerze docelowym, będzie czekać na potwierdzenie.
properties.secretParameters	MigrationSecretParameters	Parametry wpisu tajnego migracji.
properties.setupLogicalReplicationOnSourceDbIfNeeded	LogicalReplicationOnSourceServer	Wskazuje, czy w razie potrzeby należy skonfigurować replikację logiczną na serwerze źródłowym.
properties.sourceDbServerFullyQualifiedDomainName	string	W pełni kwalifikowana nazwa domeny (FQDN) lub adres IP serwera źródłowego. Ta właściwość jest opcjonalna. Po podaniu usługa migracji zawsze będzie używać go do nawiązywania połączenia z serwerem źródłowym.
properties.sourceDbServerMetadata	DbServerMetadata	Metadane źródłowego serwera bazy danych.
properties.sourceDbServerResourceId	string	Identyfikator zasobu źródłowego serwera bazy danych, gdy wartość "sourceType" to "PostgreSQLSingleServer". W przypadku innych typów źródeł należy ustawić wartość ipaddress:port@username lub hostname:port@username.
properties.sourceType	SourceType	Typ serwera źródłowego używany do migracji: 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 lub Supabase_PostgreSQL
properties.sslMode	SslMode	Tryb SSL używany przez migrację. Domyślny tryb SSL dla "PostgreSQLSingleServer" to "VerifyFull". Domyślny tryb SSL dla innych typów źródeł to "Preferowany".
properties.startDataMigration	StartDataMigration	Wskazuje, czy migracja danych musi rozpocząć się od razu.
properties.targetDbServerFullyQualifiedDomainName	string	W pełni kwalifikowana nazwa domeny (FQDN) lub adres IP serwera docelowego. Ta właściwość jest opcjonalna. Po podaniu usługa migracji zawsze będzie używać go do nawiązywania połączenia z serwerem docelowym.
properties.targetDbServerMetadata	DbServerMetadata	Metadane docelowego serwera bazy danych.
properties.targetDbServerResourceId	string	Identyfikator zasobu docelowego serwera bazy danych.
properties.triggerCutover	TriggerCutover	Wskazuje, czy należy wyzwolić jednorazowe przejście dla całej migracji.
systemData	systemData	Metadane Azure Resource Manager zawierające informacje createdBy i modifiedBy.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft. Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

MigrationDatabaseState

Wyliczenie

Stan migracji bazy danych.

Wartość	Opis
InProgress	Trwa migracja bazy danych.
WaitingForCutoverTrigger	Migracja oczekuje na wyzwalacz jednorazowy dla bazy danych.
Failed	Migracja bazy danych nie powiodła się.
Canceled	Migracja bazy danych została anulowana.
Succeeded	Migracja bazy danych zakończyła się pomyślnie.
Canceling	Migracja bazy danych jest anulowana.

MigrationMode

Wyliczenie

Tryb używany do przeprowadzenia migracji.

Wartość	Opis
Offline	Tryb migracji w trybie offline.
Online	Tryb migracji online.

MigrationOption

Wyliczenie

Obsługiwana opcja migracji.

Wartość	Opis
Validate	Zweryfikuj migrację bez jej wykonywania.
Migrate	Przeprowadź migrację.
ValidateAndMigrate	Sprawdź poprawność i przeprowadź migrację.

MigrationResourceForPatch

Objekt

Migration.

Nazwa	Typ	Opis
properties.cancel	Cancel	Wskazuje, czy anulowanie musi zostać wyzwolone dla całej migracji.
properties.dbsToCancelMigrationOn	string[]	Jeśli chcesz wyzwolić anulowanie dla określonych baz danych, ustaw wartość "triggerCutover" na "True" i nazwy określonych baz danych w tej tablicy.
properties.dbsToMigrate	string[]	Nazwy baz danych do migracji.
properties.dbsToTriggerCutoverOn	string[]	Jeśli chcesz wyzwolić środowisko jednorazowe dla określonych baz danych, ustaw wartość "triggerCutover" na wartość "True" i nazwy określonych baz danych w tej tablicy.
properties.migrateRoles	MigrateRolesAndPermissions	Wskazuje, czy należy przeprowadzić migrację ról i uprawnień.
properties.migrationMode	MigrationMode	Tryb używany do przeprowadzenia migracji: Online lub Offline.
properties.migrationWindowStartTimeInUtc	string (date-time)	Godzina rozpoczęcia (UTC) okna migracji.
properties.overwriteDbsInTarget	OverwriteDatabasesOnTargetServer	Wskazuje, czy bazy danych na serwerze docelowym mogą zostać zastąpione, jeśli są już obecne. W przypadku ustawienia wartości "Fałsz", gdy przepływ pracy migracji wykryje, że baza danych już istnieje na serwerze docelowym, będzie czekać na potwierdzenie.
properties.secretParameters	MigrationSecretParametersForPatch	Parametry wpisu tajnego migracji.
properties.setupLogicalReplicationOnSourceDbIfNeeded	LogicalReplicationOnSourceServer	Wskazuje, czy w razie potrzeby należy skonfigurować replikację logiczną na serwerze źródłowym.
properties.sourceDbServerFullyQualifiedDomainName	string	W pełni kwalifikowana nazwa domeny (FQDN) lub adres IP serwera źródłowego. Ta właściwość jest opcjonalna. Po podaniu usługa migracji zawsze będzie używać go do nawiązywania połączenia z serwerem źródłowym.
properties.sourceDbServerResourceId	string	Identyfikator zasobu źródłowego serwera bazy danych, gdy wartość "sourceType" to "PostgreSQLSingleServer". W przypadku innych typów źródeł należy ustawić wartość ipaddress:port@username lub hostname:port@username.
properties.startDataMigration	StartDataMigration	Wskazuje, czy migracja danych musi rozpocząć się od razu.
properties.targetDbServerFullyQualifiedDomainName	string	W pełni kwalifikowana nazwa domeny (FQDN) lub adres IP serwera docelowego. Ta właściwość jest opcjonalna. Po podaniu usługa migracji zawsze będzie używać go do nawiązywania połączenia z serwerem docelowym.
properties.triggerCutover	TriggerCutover	Wskazuje, czy należy wyzwolić jednorazowe przejście dla całej migracji.
tags	object	Metadane specyficzne dla aplikacji w postaci par klucz-wartość.

MigrationSecretParameters

Objekt

Parametry wpisu tajnego migracji.

Nazwa	Typ	Opis
adminCredentials	AdminCredentials (password)	Poświadczenia administratorów dla serwerów źródłowych i docelowych.
sourceServerUsername	string	Pobiera lub ustawia nazwę użytkownika dla serwera źródłowego. Ten użytkownik nie musi być administratorem.
targetServerUsername	string	Pobiera lub ustawia nazwę użytkownika dla serwera docelowego. Ten użytkownik nie musi być administratorem.

MigrationSecretParametersForPatch

Objekt

Parametry wpisu tajnego migracji.

Nazwa	Typ	Opis
adminCredentials	AdminCredentialsForPatch (password)	Poświadczenia administratorów dla serwerów źródłowych i docelowych.
sourceServerUsername	string	Pobiera lub ustawia nazwę użytkownika dla serwera źródłowego. Ten użytkownik nie musi być administratorem.
targetServerUsername	string	Pobiera lub ustawia nazwę użytkownika dla serwera docelowego. Ten użytkownik nie musi być administratorem.

MigrationState

Wyliczenie

Stan migracji.

Wartość	Opis
InProgress	Migracja jest w toku.
WaitingForUserAction	Migracja oczekuje na akcję użytkownika.
Canceled	Migracja została anulowana.
Failed	Migracja nie powiodła się.
Succeeded	Migracja się powiodła.
ValidationFailed	Walidacja migracji nie powiodła się.
CleaningUp	Migracja to czyszczenie zasobów.

MigrationStatus

Objekt

Stan migracji.

Nazwa	Typ	Opis
currentSubStateDetails	MigrationSubstateDetails	Szczegóły bieżącego stanu podrzędnego migracji.
error	string	Komunikat o błędzie (jeśli istnieje) dla stanu migracji.
state	MigrationState	Stan migracji.

MigrationSubstate

Wyliczenie

Podstan migracji.

Wartość	Opis
PerformingPreRequisiteSteps	Wykonywanie kroków wstępnych wymaganych do migracji.
WaitingForLogicalReplicationSetupRequestOnSourceDB	Oczekiwanie na żądanie konfiguracji replikacji logicznej w źródłowej bazie danych.
WaitingForDBsToMigrateSpecification	Oczekiwanie na migrację specyfikacji baz danych.
WaitingForTargetDBOverwriteConfirmation	Oczekiwanie na potwierdzenie zastąpienia docelowej bazy danych.
WaitingForDataMigrationScheduling	Oczekiwanie na zaplanowanie migracji danych.
WaitingForDataMigrationWindow	Oczekiwanie na okno migracji danych.
MigratingData	Migracja danych.
WaitingForCutoverTrigger	Oczekiwanie na wyzwalacz jednorazowy.
CompletingMigration	Kończenie migracji.
Completed	Migracja zakończona.
CancelingRequestedDBMigrations	Anulowanie żądanych migracji baz danych.
ValidationInProgress	Walidacja w toku.

MigrationSubstateDetails

Objekt

Szczegółowe informacje o podstanie migracji.

Nazwa	Typ	Opis
currentSubState	MigrationSubstate	Podstan migracji.
dbDetails	<string,  DatabaseMigrationState>
validationDetails	ValidationDetails	Szczegółowe informacje dotyczące walidacji migracji.

OverwriteDatabasesOnTargetServer

Wyliczenie

Wskazuje, czy bazy danych na serwerze docelowym mogą zostać zastąpione, jeśli są już obecne.

Wartość	Opis
True	Bazy danych na serwerze docelowym mogą zostać nadpisane, jeśli są już obecne.
False	Nie można zastąpić baz danych na serwerze docelowym, jeśli są już obecne. Gdy workflow migracji wykryje, że baza danych już istnieje na docelowym serwerze, czeka na potwierdzenie.

ServerSku

Objekt

Informacje o obliczeniach serwera.

Nazwa	Typ	Opis
name	string	Warstwa obliczeniowa i rozmiar serwera bazy danych. Ten obiekt jest pusty dla pojedynczego serwera Azure Database for PostgreSQL.
tier	SkuTier	Warstwa zasobów obliczeniowych przypisana do serwera.

SkuTier

Wyliczenie

Warstwa zasobów obliczeniowych przypisana do serwera.

Wartość	Opis
Burstable	Ekonomiczna warstwa do rzadkiego użycia procesora CPU, idealna do tworzenia i testowania obciążeń o niskich wymaganiach dotyczących wydajności.
GeneralPurpose	Zrównoważone zasoby obliczeniowe i pamięć dla większości obciążeń, oferujące skalowalną wydajność i przepustowość we/wy.
MemoryOptimized	Wysoki stosunek pamięci do rdzenia dla wymagających obciążeń wymagających szybkiego przetwarzania w pamięci i wysokiej współbieżności.

SourceType

Wyliczenie

Typ serwera źródłowego użyty do migracji.

Wartość	Opis
OnPremises	Lokalny serwer PostgreSQL.
AWS	Serwer Amazon Web Services PostgreSQL.
GCP	Serwer PostgreSQL Google Cloud Platform.
AzureVM	Azure Virtual Machine PostgreSQL server.
PostgreSQLSingleServer	Azure Database for PostgreSQL single server.
AWS_RDS	Amazon RDS dla PostgreSQL.
AWS_AURORA	Amazon Aurora dla PostgreSQL.
AWS_EC2	Amazon EC2 dla PostgreSQL.
GCP_CloudSQL	Google Cloud SQL dla bazy danych PostgreSQL.
GCP_AlloyDB	Google Cloud AlloyDB dla PostgreSQL.
GCP_Compute	Google Compute Engine dla PostgreSQL.
EDB	Serwer EnterpriseDB PostgreSQL.
EDB_Oracle_Server	Serwer Oracle DB Enterprise.
EDB_PostgreSQL	Serwer EnterpriseDB PostgreSQL.
PostgreSQLFlexibleServer	Azure Database for PostgreSQL flexible server.
PostgreSQLCosmosDB	.NET Cosmos DB for PostgreSQL
Huawei_RDS	Huawei RDS dla PostgreSQL
Huawei_Compute	Huawei Compute dla PostgreSQL
Heroku_PostgreSQL	Heroku PostgreSQL
Crunchy_PostgreSQL	Chrupiący PostgreSQL
ApsaraDB_RDS	ApsaraDB RDS dla PostgreSQL
Digital_Ocean_Droplets	Cyfrowe kropelki oceaniczne dla PostgreSQL
Digital_Ocean_PostgreSQL	Cyfrowy ocean PostgreSQL
Supabase_PostgreSQL	Supabase PostgreSQL

SslMode

Wyliczenie

Tryb SSL używany przez migrację. Domyślny tryb SSL dla "PostgreSQLSingleServer" to "VerifyFull". Domyślny tryb SSL dla innych typów źródeł to "Preferowany".

Wartość	Opis
Prefer	Preferuj połączenie SSL. Jeśli serwer nie obsługuje protokołu SSL, połączenie zostanie nawiązane bez protokołu SSL.
Require	Wymagaj połączenia SSL. Jeśli serwer nie obsługuje protokołu SSL, połączenie zakończy się niepowodzeniem.
VerifyCA	Wymagaj połączenia SSL i zweryfikuj certyfikat serwera z certyfikatem CA.
VerifyFull	Wymagaj połączenia SSL, sprawdź certyfikat serwera względem certyfikatu CA i sprawdź, czy nazwa hosta serwera jest zgodna z certyfikatem.

StartDataMigration

Wyliczenie

Wskazuje, czy migracja danych musi rozpocząć się od razu.

Wartość	Opis
True	Migracja danych musi rozpocząć się od razu.
False	Migracja danych nie może rozpocząć się od razu.

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

TriggerCutover

Wyliczenie

Wskazuje, czy należy wyzwolić jednorazowe przejście dla całej migracji.

Wartość	Opis
True	Jednorazowe przejście musi zostać wyzwolone dla całej migracji.
False	Jednorazowe przejście nie może być wyzwalane dla całej migracji.

ValidationDetails

Objekt

Szczegółowe informacje dotyczące walidacji migracji.

Nazwa	Typ	Opis
dbLevelValidationDetails	DbLevelValidationStatus[]	Szczegółowe informacje na temat walidacji na poziomie serwera.
serverLevelValidationDetails	ValidationSummaryItem[]	Szczegółowe informacje na temat walidacji na poziomie serwera.
status	ValidationState	Stan weryfikacji migracji.
validationEndTimeInUtc	string (date-time)	Czas zakończenia (UTC) walidacji.
validationStartTimeInUtc	string (date-time)	Czas rozpoczęcia (UTC) walidacji.

ValidationMessage

Objekt

Obiekt komunikatu walidacji.

Nazwa	Typ	Opis
message	string	Ciąg komunikatu sprawdzania poprawności.
state	ValidationState	Ważność komunikatu sprawdzania poprawności.

ValidationState

Wyliczenie

Stan walidacji dla migracji.

Wartość	Opis
Failed	Walidacja nie powiodła się.
Succeeded	Walidacja zakończyła się pomyślnie.
Warning	Walidacja zakończyła się pomyślnie z ostrzeżeniami.

ValidationSummaryItem

Objekt

Obiekt podsumowania walidacji.

Nazwa	Typ	Opis
messages	ValidationMessage[]	Komunikaty weryfikacyjne.
state	ValidationState	Stan weryfikacji migracji.
type	string	Typ walidacji.