Projects - Create Or Update

Služba:: Data Migration

Verze rozhraní API:: 2022-03-30-preview

Vytvoření nebo aktualizace projektu
Zdroj projektu je vnořený zdroj představující uložený projekt migrace. Metoda PUT vytvoří nový projekt nebo aktualizuje existující projekt.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.DataMigration/services/{serviceName}/projects/{projectName}?api-version=2022-03-30-preview

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
groupName	path	True	string	Název skupiny prostředků
projectName	path	True	string	Název projektu
serviceName	path	True	string	Název služby
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API

Text požadavku

Name	Vyžadováno	Typ	Description
properties.sourcePlatform	True	ProjectSourcePlatform	Zdrojová platforma pro projekt
properties.targetPlatform	True	ProjectTargetPlatform	Cílová platforma pro projekt
etag		string	Hodnota značky silné entity HTTP Pokud se odešle, bude se tato možnost ignorovat.
location		string
properties.azureAuthenticationInfo		AzureActiveDirectoryApp	Pole definující informace o aplikaci Azure Active Directory, které slouží k připojení k cílovému prostředku Azure
properties.databasesInfo		DatabaseInfo[]	Seznam informací o databázi
properties.sourceConnectionInfo		ConnectionInfo: SqlConnectionInfo MySqlConnectionInfo OracleConnectionInfo PostgreSqlConnectionInfo MiSqlConnectionInfo	Informace o připojení ke zdroji
properties.targetConnectionInfo		ConnectionInfo: SqlConnectionInfo MySqlConnectionInfo OracleConnectionInfo PostgreSqlConnectionInfo MiSqlConnectionInfo	Informace o připojení k cíli
tags		object

Odpovědi

Name	Typ	Description
200 OK	Project	Projekt byl aktualizován.
201 Created	Project	Projekt byl vytvořen.
Other Status Codes	ApiError	Chyba

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Projects_CreateOrUpdate

Ukázkový požadavek

HTTP

PUT https://management.azure.com/subscriptions/fc04246f-04c5-437e-ac5e-206a19e7193f/resourceGroups/DmsSdkRg/providers/Microsoft.DataMigration/services/DmsSdkService/projects/DmsSdkProject?api-version=2022-03-30-preview

{
  "location": "southcentralus",
  "properties": {
    "sourcePlatform": "SQL",
    "targetPlatform": "SQLDB"
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "properties": {
    "sourcePlatform": "SQL",
    "targetPlatform": "SQLDB",
    "creationTime": "2017-11-03T02:14:54.2458282-07:00",
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/fc04246f-04c5-437e-ac5e-206a19e7193f/resourceGroups/DmsSdkRg/providers/Microsoft.DataMigration/services/DmsSdkService/projects/DmsSdkProject",
  "location": "southcentralus",
  "name": "DmsSdkProject",
  "type": "Microsoft.DataMigration/services/projects"
}

Stavový kód:: 201

{
  "properties": {
    "sourcePlatform": "SQL",
    "targetPlatform": "SQLDB",
    "creationTime": "2017-11-03T02:14:54.2458282-07:00",
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/fc04246f-04c5-437e-ac5e-206a19e7193f/resourceGroups/DmsSdkRg/providers/Microsoft.DataMigration/services/DmsSdkService/projects/DmsSdkProject",
  "location": "southcentralus",
  "name": "DmsSdkProject",
  "type": "Microsoft.DataMigration/services/projects"
}

Definice

Name	Description
ApiError	Informace o chybě
AuthenticationType	Výčet možných typů ověřování při připojování
AzureActiveDirectoryApp	Aplikace Azure Active Directory
createdByType
DatabaseInfo	Podrobnosti databáze projektu
MiSqlConnectionInfo	Vlastnosti potřebné k vytvoření připojení ke spravované instanci Azure SQL Database
MySqlConnectionInfo	Informace o připojení k serveru MySQL
ODataError	Informace o chybě ve formátu OData
OracleConnectionInfo	Informace o připojení k serveru Oracle
PostgreSqlConnectionInfo	Informace o připojení k serveru PostgreSQL
Project	Zdroj projektu
ProjectProvisioningState	Stav zřizování projektu
ProjectSourcePlatform	Zdrojová platforma projektu
ProjectTargetPlatform	Cílová platforma projektu
SqlConnectionInfo	Informace o připojení k databázovému serveru SQL
SqlSourcePlatform	Typ platformy serveru pro připojení
SystemData

ApiError

Objekt

Informace o chybě

Name	Typ	Description
error	ODataError	Informace o chybě ve formátu OData
systemData	SystemData	Metadata týkající se vytvoření a poslední změny prostředku.

AuthenticationType

Výčet

Výčet možných typů ověřování při připojování

Hodnota	Description
None
WindowsAuthentication
SqlAuthentication
ActiveDirectoryIntegrated
ActiveDirectoryPassword

AzureActiveDirectoryApp

Objekt

Aplikace Azure Active Directory

Name	Typ	Description
appKey	string	Klíč použitý k ověření v aplikaci Azure Active Directory
applicationId	string	ID aplikace Azure Active Directory
ignoreAzurePermissions	boolean	Ignorování kontroly oprávnění Azure v aplikaci AAD
tenantId	string	ID tenanta zákazníka

createdByType

Výčet

Hodnota	Description
User
Application
ManagedIdentity
Key

DatabaseInfo

Objekt

Podrobnosti databáze projektu

Name	Typ	Description
sourceDatabaseName	string	Název databáze

MiSqlConnectionInfo

Objekt

Vlastnosti potřebné k vytvoření připojení ke spravované instanci Azure SQL Database

Name	Typ	Description
managedInstanceResourceId	string	ID prostředku pro spravovanou instanci Azure SQL Database
password	string	Přihlašovací údaje hesla.
type	string: MiSqlConnectionInfo	Typ informací o připojení
userName	string	Jméno uživatele

MySqlConnectionInfo

Objekt

Informace o připojení k serveru MySQL

Name	Typ	Default value	Description
additionalSettings	string		Další nastavení připojení
authentication	AuthenticationType		Typ ověřování, který se má použít pro připojení
dataSource	string		Zdroj dat
encryptConnection	boolean	True	Zda se má připojení šifrovat
password	string		Přihlašovací údaje hesla.
port	integer		Port pro server
serverName	string		Název serveru
type	string: MySqlConnectionInfo		Typ informací o připojení
userName	string		Jméno uživatele

ODataError

Objekt

Informace o chybě ve formátu OData

Name	Typ	Description
code	string	Strojově čitelný popis chyby, například InvalidRequest nebo InternalServerError
details	ODataError[]	Vnitřní chyby, které způsobily tuto chybu
message	string	Popis chyby čitelný člověkem

OracleConnectionInfo

Objekt

Informace o připojení k serveru Oracle

Name	Typ	Description
authentication	AuthenticationType	Typ ověřování, který se má použít pro připojení
dataSource	string	Připojovací řetězec EZConnect nebo TNSName
password	string	Přihlašovací údaje hesla.
port	integer	port pro server
serverName	string	název serveru
serverVersion	string	verze serveru
type	string: OracleConnectionInfo	Typ informací o připojení
userName	string	Jméno uživatele

PostgreSqlConnectionInfo

Objekt

Informace o připojení k serveru PostgreSQL

Name	Typ	Default value	Description
additionalSettings	string		Další nastavení připojení
authentication	AuthenticationType		Typ ověřování, který se má použít pro připojení
dataSource	string		Zdroj dat
databaseName	string		Název databáze
encryptConnection	boolean	True	Zda se má připojení šifrovat
password	string		Přihlašovací údaje hesla.
port	integer		Port pro server
serverBrandVersion	string		Verze značky serveru
serverName	string		Název serveru
serverVersion	string		verze serveru
trustServerCertificate	boolean	False	Zda se má certifikát serveru důvěřovat
type	string: PostgreSqlConnectionInfo		Typ informací o připojení
userName	string		Jméno uživatele

Project

Objekt

Zdroj projektu

Name	Typ	Description
etag	string	Hodnota značky silné entity HTTP Pokud se odešle, bude se tato možnost ignorovat.
id	string
location	string
name	string
properties.azureAuthenticationInfo	AzureActiveDirectoryApp	Pole definující informace o aplikaci Azure Active Directory, které slouží k připojení k cílovému prostředku Azure
properties.creationTime	string (date-time)	Datum a čas UTC při vytvoření projektu
properties.databasesInfo	DatabaseInfo[]	Seznam informací o databázi
properties.provisioningState	ProjectProvisioningState	Stav zřizování projektu
properties.sourceConnectionInfo	ConnectionInfo: MiSqlConnectionInfo MySqlConnectionInfo OracleConnectionInfo PostgreSqlConnectionInfo SqlConnectionInfo	Informace o připojení ke zdroji
properties.sourcePlatform	ProjectSourcePlatform	Zdrojová platforma pro projekt
properties.targetConnectionInfo	ConnectionInfo: MiSqlConnectionInfo MySqlConnectionInfo OracleConnectionInfo PostgreSqlConnectionInfo SqlConnectionInfo	Informace o připojení k cíli
properties.targetPlatform	ProjectTargetPlatform	Cílová platforma pro projekt
systemData	SystemData	Metadata týkající se vytvoření a poslední změny prostředku.
tags	object
type	string

ProjectProvisioningState

Výčet

Stav zřizování projektu

Hodnota	Description
Deleting
Succeeded

ProjectSourcePlatform

Výčet

Zdrojová platforma projektu

Hodnota	Description
SQL
MySQL
PostgreSql
MongoDb
Unknown

ProjectTargetPlatform

Výčet

Cílová platforma projektu

Hodnota	Description
SQLDB
SQLMI
AzureDbForMySql
AzureDbForPostgreSql
MongoDb
Unknown

SqlConnectionInfo

Objekt

Informace o připojení k databázovému serveru SQL

Name	Typ	Default value	Description
additionalSettings	string		Další nastavení připojení
authentication	AuthenticationType		Typ ověřování, který se má použít pro připojení
dataSource	string		Zdroj dat ve formátu Protocol:MachineName\SQLServerInstanceName,PortNumber
encryptConnection	boolean	True	Zda se má připojení šifrovat
password	string		Přihlašovací údaje hesla.
platform	SqlSourcePlatform		Typ platformy serveru pro připojení
port	integer		Port pro server
resourceId	string		Představuje ID prostředku HTTP reprezentovaného poskytovatelem prostředků Azure.
serverBrandVersion	string		Verze značky serveru
serverName	string		název serveru
serverVersion	string		verze serveru
trustServerCertificate	boolean	False	Zda se má certifikát serveru důvěřovat
type	string: SqlConnectionInfo		Typ informací o připojení
userName	string		Jméno uživatele

SqlSourcePlatform

Výčet

Typ platformy serveru pro připojení

Hodnota	Description
SqlOnPrem

SystemData

Objekt

Name	Typ	Description
createdAt	string (date-time)
createdBy	string
createdByType	createdByType
lastModifiedAt	string (date-time)
lastModifiedBy	string
lastModifiedByType	createdByType

Sdílet prostřednictvím

Projects - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Projects_CreateOrUpdate

Ukázkový požadavek

Ukázková odpověď

Definice

ApiError

AuthenticationType

AzureActiveDirectoryApp

createdByType

DatabaseInfo

MiSqlConnectionInfo

MySqlConnectionInfo

ODataError

OracleConnectionInfo

PostgreSqlConnectionInfo

Project

ProjectProvisioningState

ProjectSourcePlatform

ProjectTargetPlatform

SqlConnectionInfo

SqlSourcePlatform

SystemData