Projects - Create Or Update

Service:: Data Migration

Version d'API:: 2022-03-30-preview

Créer ou mettre à jour un projet
La ressource de projet est une ressource imbriquée représentant un projet de migration stocké. La méthode PUT crée un projet ou met à jour un projet existant.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
groupName	path	True	string	Nom du groupe de ressources
projectName	path	True	string	Nom du projet
serviceName	path	True	string	Nom du service
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
api-version	query	True	string	Version de l’API

Corps de la demande

Nom	Obligatoire	Type	Description
properties.sourcePlatform	True	ProjectSourcePlatform	Plateforme source pour le projet
properties.targetPlatform	True	ProjectTargetPlatform	Plateforme cible pour le projet
etag		string	Valeur de balise d’entité forte HTTP. Cette opération est ignorée si elle est envoyée.
location		string
properties.azureAuthenticationInfo		AzureActiveDirectoryApp	Champ qui définit les informations d’application Azure Active Directory utilisées pour se connecter à la ressource Azure cible
properties.databasesInfo		DatabaseInfo[]	Liste de DatabaseInfo
properties.sourceConnectionInfo		ConnectionInfo: SqlConnectionInfo MySqlConnectionInfo OracleConnectionInfo PostgreSqlConnectionInfo MiSqlConnectionInfo	Informations relatives à la connexion à la source
properties.targetConnectionInfo		ConnectionInfo: SqlConnectionInfo MySqlConnectionInfo OracleConnectionInfo PostgreSqlConnectionInfo MiSqlConnectionInfo	Informations pour la connexion à la cible
tags		object

Réponses

Nom	Type	Description
200 OK	Project	Projet mis à jour
201 Created	Project	Projet créé
Other Status Codes	ApiError	Erreur

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Projects_CreateOrUpdate

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
}

Code d’état:: 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"
}

Définitions

Nom	Description
ApiError	Informations sur l’erreur.
AuthenticationType	Énumération des types d’authentification possibles lors de la connexion
AzureActiveDirectoryApp	Azure Active Directory Application
createdByType
DatabaseInfo	Détails de la base de données du projet
MiSqlConnectionInfo	Propriétés requises pour créer une connexion à Azure SQL Database Managed Instance
MySqlConnectionInfo	Informations relatives à la connexion au serveur MySQL
ODataError	Informations d’erreur au format OData.
OracleConnectionInfo	Informations pour la connexion au serveur Oracle
PostgreSqlConnectionInfo	Informations relatives à la connexion au serveur PostgreSQL
Project	Ressource de projet
ProjectProvisioningState	État d’approvisionnement du projet
ProjectSourcePlatform	Plateforme source du projet
ProjectTargetPlatform	Plateforme cible du projet
SqlConnectionInfo	Informations relatives à la connexion au serveur de base de données SQL
SqlSourcePlatform	Type de plateforme serveur pour la connexion
SystemData

ApiError

Object

Informations sur l’erreur.

Nom	Type	Description
error	ODataError	Informations d’erreur au format OData
systemData	SystemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

AuthenticationType

Énumération

Énumération des types d’authentification possibles lors de la connexion

Valeur	Description
None
WindowsAuthentication
SqlAuthentication
ActiveDirectoryIntegrated
ActiveDirectoryPassword

AzureActiveDirectoryApp

Object

Azure Active Directory Application

Nom	Type	Description
appKey	string	Clé utilisée pour s’authentifier auprès de l’application Azure Active Directory
applicationId	string	ID d’application de l’application Azure Active Directory
ignoreAzurePermissions	boolean	Ignorer la vérification des autorisations Azure sur l’application AAD
tenantId	string	ID de locataire du client

createdByType

Énumération

Valeur	Description
User
Application
ManagedIdentity
Key

DatabaseInfo

Object

Détails de la base de données du projet

Nom	Type	Description
sourceDatabaseName	string	Nom de la base de données

MiSqlConnectionInfo

Object

Propriétés requises pour créer une connexion à Azure SQL Database Managed Instance

Nom	Type	Description
managedInstanceResourceId	string	ID de ressource pour Azure SQL Database Managed Instance
password	string	Informations d’identification du mot de passe.
type	string: MiSqlConnectionInfo	Type d’informations de connexion
userName	string	Nom d’utilisateur

MySqlConnectionInfo

Object

Informations relatives à la connexion au serveur MySQL

Nom	Type	Valeur par défaut	Description
additionalSettings	string		Paramètres de connexion supplémentaires
authentication	AuthenticationType		Type d’authentification à utiliser pour la connexion
dataSource	string		Source de données
encryptConnection	boolean	True	Indique s’il faut chiffrer la connexion
password	string		Informations d’identification du mot de passe.
port	integer		Port pour le serveur
serverName	string		Nom du serveur
type	string: MySqlConnectionInfo		Type d’informations de connexion
userName	string		Nom d’utilisateur

ODataError

Object

Informations d’erreur au format OData.

Nom	Type	Description
code	string	Description lisible par l’ordinateur de l’erreur, telle que « InvalidRequest » ou « InternalServerError ».
details	ODataError[]	Erreurs internes qui ont provoqué cette erreur
message	string	Description lisible par l’homme de l’erreur

OracleConnectionInfo

Object

Informations pour la connexion au serveur Oracle

Nom	Type	Description
authentication	AuthenticationType	Type d’authentification à utiliser pour la connexion
dataSource	string	Chaîne de connexion EZConnect ou TNSName.
password	string	Informations d’identification du mot de passe.
port	integer	port pour le serveur
serverName	string	nom du serveur
serverVersion	string	version du serveur
type	string: OracleConnectionInfo	Type d’informations de connexion
userName	string	Nom d’utilisateur

PostgreSqlConnectionInfo

Object

Informations relatives à la connexion au serveur PostgreSQL

Nom	Type	Valeur par défaut	Description
additionalSettings	string		Paramètres de connexion supplémentaires
authentication	AuthenticationType		Type d’authentification à utiliser pour la connexion
dataSource	string		Source de données
databaseName	string		Nom de la base de données
encryptConnection	boolean	True	Indique s’il faut chiffrer la connexion
password	string		Informations d’identification du mot de passe.
port	integer		Port pour le serveur
serverBrandVersion	string		version de la marque de serveur
serverName	string		Nom du serveur
serverVersion	string		version du serveur
trustServerCertificate	boolean	False	Indique s’il faut approuver le certificat de serveur
type	string: PostgreSqlConnectionInfo		Type d’informations de connexion
userName	string		Nom d’utilisateur

Project

Object

Ressource de projet

Nom	Type	Description
etag	string	Valeur de balise d’entité forte HTTP. Cette opération est ignorée si elle est envoyée.
id	string
location	string
name	string
properties.azureAuthenticationInfo	AzureActiveDirectoryApp	Champ qui définit les informations d’application Azure Active Directory utilisées pour se connecter à la ressource Azure cible
properties.creationTime	string (date-time)	Date et heure UTC de création du projet
properties.databasesInfo	DatabaseInfo[]	Liste de DatabaseInfo
properties.provisioningState	ProjectProvisioningState	État d’approvisionnement du projet
properties.sourceConnectionInfo	ConnectionInfo: MiSqlConnectionInfo MySqlConnectionInfo OracleConnectionInfo PostgreSqlConnectionInfo SqlConnectionInfo	Informations relatives à la connexion à la source
properties.sourcePlatform	ProjectSourcePlatform	Plateforme source pour le projet
properties.targetConnectionInfo	ConnectionInfo: MiSqlConnectionInfo MySqlConnectionInfo OracleConnectionInfo PostgreSqlConnectionInfo SqlConnectionInfo	Informations pour la connexion à la cible
properties.targetPlatform	ProjectTargetPlatform	Plateforme cible pour le projet
systemData	SystemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
tags	object
type	string

ProjectProvisioningState

Énumération

État d’approvisionnement du projet

Valeur	Description
Deleting
Succeeded

ProjectSourcePlatform

Énumération

Plateforme source du projet

Valeur	Description
SQL
MySQL
PostgreSql
MongoDb
Unknown

ProjectTargetPlatform

Énumération

Plateforme cible du projet

Valeur	Description
SQLDB
SQLMI
AzureDbForMySql
AzureDbForPostgreSql
MongoDb
Unknown

SqlConnectionInfo

Object

Informations relatives à la connexion au serveur de base de données SQL

Nom	Type	Valeur par défaut	Description
additionalSettings	string		Paramètres de connexion supplémentaires
authentication	AuthenticationType		Type d’authentification à utiliser pour la connexion
dataSource	string		Source de données au format Protocol :MachineName\SQLServerInstanceName,PortNumber
encryptConnection	boolean	True	Indique s’il faut chiffrer la connexion
password	string		Informations d’identification du mot de passe.
platform	SqlSourcePlatform		Type de plateforme serveur pour la connexion
port	integer		Port pour le serveur
resourceId	string		Représente l’ID d’une ressource HTTP représentée par un fournisseur de ressources Azure.
serverBrandVersion	string		version de la marque de serveur
serverName	string		nom du serveur
serverVersion	string		version du serveur
trustServerCertificate	boolean	False	Indique s’il faut approuver le certificat de serveur
type	string: SqlConnectionInfo		Type d’informations de connexion
userName	string		Nom d’utilisateur

SqlSourcePlatform

Énumération

Type de plateforme serveur pour la connexion

Valeur	Description
SqlOnPrem

SystemData

Object

Nom	Type	Description
createdAt	string (date-time)
createdBy	string
createdByType	createdByType
lastModifiedAt	string (date-time)
lastModifiedBy	string
lastModifiedByType	createdByType

Partager via

Projects - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Projects_CreateOrUpdate

Exemple de requête

Exemple de réponse

Définitions

ApiError

AuthenticationType

AzureActiveDirectoryApp

createdByType

DatabaseInfo

MiSqlConnectionInfo

MySqlConnectionInfo

ODataError

OracleConnectionInfo

PostgreSqlConnectionInfo

Project

ProjectProvisioningState

ProjectSourcePlatform

ProjectTargetPlatform

SqlConnectionInfo

SqlSourcePlatform

SystemData