AnchorTopTop

SCM Instances can be accessed and modified through this API using four services: GET, POST, PUT, and PATCH. These four services allow for the retrieval, creation, complete update, and partial update of SCM Instances.

Info

title	Base URL for SCM Instance REST API

http://host:port/flexdeploy/rest/topology/integrations/scminstance

Table of Contents

maxLevel	1

Each function returns a JSON test instance object. The test SCM instance Object is an object that has these attributes,

...

Currently there are 8 different source control management types that are supported in Flex Deploy.

ClearCaseUCM

...

CVS

...

File System

...

Git

...

Perforce

...

PVCS

...

Subversion

...

TFVC

...

Back to Top

GET

There are two implementations of GET. One will find a SCM instance with the given Id and return the JSON representation of the SCM instance. The other will find a list of SCM instances matching the parameters supplied to it.

GET (Using Id)

This GET service will find a SCM instance with the given Id and return the JSON representation of the object.

Info

title	API URL

http://host:port/flexdeploy/rest/topology/integrations/scminstance/{Id}

Parameters

...

Parameter

...

Required

...

Type

...

Description

...

Id

...

Response Codes

...

HTTP Code

...

Description

...

Example

If we had a SCM instance in our database with an Id of 11101 and had the following attributes

Code Block

theme	Eclipse
title	SCM Instance - 11101

{
   "name": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url"
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user"
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password"
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": "10000"
      }
   ],
   "type": "GIT",
   "description": "description",
   "code": "CODE1",
   "isActive": true
}

When we run a GET request at the following URL

http://host:port/flexdeploy/rest/topology/integrations/scminstance/11101

The GET request would return the following JSON SCM instance object

Code Block

theme	Eclipse
title	SCM Instance GET Return JSON

{
   "name": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url"
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user"
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password"
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": "10000"
      }
   ],
   "type": "GIT",
   "description": "description",
   "code": "CODE1",
   "isActive": true
}

Back to Top

GET (Using Query Parameters)

This GET service will find a SCM instance by querying based on a name, code, and/or type of the SCM and return the JSON representations of the objects. If no query parameters are given this request will return the entire list of SCM instances.

Info

title	API URLs

http://host:port/flexdeploy/rest/topology/integrations/scminstance?

Append the following character sequences to the above URL to specify Query parameters.

Use '&' between successive query parameters:

name={name}

code={code}

Examples:

Tip
The query parameters are not case sensitive. Searching by name=NAME is the same as searching by name=name.

Parameters

...

Parameter

...

Required

...

Type

...

Description

...

name

...

Response Codes

...

HTTP Code

...

Description

...

Example

...

SCM Instances can be accessed and modified through this API using four services: GET, POST, PUT, and PATCH. These four services allow for the retrieval, creation, complete update, and partial update of SCM Instances.

Include Page

	REST V1 Authentication
	REST V1 Authentication

Table of Contents

maxLevel	2

Currently there are 8 different source control management types that are supported in Flex Deploy. The scmType value is shown after the name of each.

CVS (CVS)

Property Display Name	Property Key Name	Data Type	Required	Description
CVS URL	`FDCVS_URL`	String	Yes	URL to the CVS repository.
CVS User	`FDCVS_PASSWORD`	String	Yes	CVS repository user.
CVS Password	`FDCVS_USER`	String	Yes	CVS repository password.

File System (FILE)

Property Name	Property Key Name	Data Type	Required	Description
File Repository Root	`FDFILE_REPO_ROOT_FOLDER`	String	Yes	Location on the FlexDeploy server of the repository.

Git (GIT)

Property Display Name	Property Key Name	Data Type	Required	Description
Git URL	FDGIT_URL	String	Yes	URL to the Git repository.
Git User	FDGIT_USER	String	Yes/No	Git repository user.
Git Password	FDGIT_PASSWORD	String	Yes/no	Git repository password.
Git Timeout	FDGIT_TIMEOUT	Integer	No	Timeout for Git command execution.

Perforce (PERF)

Property Display Name	Property Key Name	Data Type	Required	Description
Perforce Host	`FDPERF_HOST`	String	Yes	Host of the Perforce repository.
Perforce Port	`FDPERF_PORT`	String	Yes	Port of the Perforce repository.
Perforce User	`FDPERF_USER`	String	Yes	Perforce User to connect with.
Perforce User Password	`FDPERF_PASSWORD`	String	Yes	Perforce Password associated with Perforce User.
Perforce SSL Connection	`FDPERF_IS_SSL`	Boolean	Yes	Should ssl be used connecting to the server.

PVCS (PVCS)

Property Display Name	Property Key Name	Data Type	Required	Description
PVCS Project Database	`FDPVCS_PROJECT_DATABASE`	String	Yes	Project Database Name.
PVCS User	`FDPVCS_USER`	String	Yes	PVCS user to access ProjectDatabases.
PVCS Password	`FDPVCS_PASSWORD`	String	Yes	PVCS password to access ProjectDatabases

Subversion (SVN)

Property Display Name	Property Key Name	Data Type	Required	Description
Subversion URL	`FDSVN_URL`	String	Yes	URL to the Subversion repository.
Subversion User	`FDSVN_USER`	String	Yes	Subversion repository user.
Subversion Password	`FDSVN_PASSWORD`	String	Yes	Subversion repository password.
Subversion Authentication Methods	`FDSVN_AUTH_METHODS`	String	No	One or more subversion authentication methods. For example, Basic, Digest, Negotiate, NTLM.

TFVC (TFVC)

Property Display Name	Property Key Name	Data Type	Required	Description
TFVC URL	`FDTFVC_URL`	String	Yes	URL to the TFVC repository.
TFVC User	`FDTFVC_USER`	String	Yes	TFVC repository user.
TFVC Password	`FDTFVC_USER`	String	Yes	TFVC repository password.

GET

There are two implementations of GET. One will find a SCM instance with the given Id and return the JSON representation of the SCM instance. The other will find a list of SCM instances matching the parameters supplied to it.

GET (Using Id)

This GET service will find a SCM instance with the given Id and return the JSON representation of the object.

Info

title	API URL

http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance/{Id}

Request

Parameter	Required	Type	Description
Id	Yes	URL	This is a URL parameter for the Id which is used to find and return a SCM instance with.

Include Page

	REST V1 SCM Instance Response
	REST V1 SCM Instance Response

Response Codes

HTTP Code	Description
200	SCM instance was found and returned
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
404	SCM instance not found
500	Unexpected internal server error

Example

If we had a SCM instance in our database with an Id of 11101 and had the following attributes

Code Block

theme	Eclipse
title	SCM Instance - 11101

{
   "instanceId": 11101,
   "nameinstanceName": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password",
		 "credentialId": 46259
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": 10000,
		 "10000credentialId": null
      }
   ],
   "typescmType": "GIT",
   "description": "description",
   "codeinstanceCode": "CODE1",
   "isActive": true
}

When we run a GET request at the following URL: http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance?code=code1&name=ScmName1/11101

The GET request would return the following JSON SCM instance object

Code Block

theme	Eclipse
title	SCM Instance GET Return JSON

{
   "nameinstanceId": 11101,
   "instanceName": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password*****",
		 "credentialId": 46259
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": 10000,
		 "10000credentialId": null
      }
   ],
   "typescmType": "GIT",
   "description": "description",
   "codeinstanceCode": "CODE1",
   "isActive": true
}

Back to Top

...

GET (Using Query Parameters)

This

...

GET service will

...

find a

...

SCM instance

...

by querying based on a name, code, and/or type of the SCM and return the JSON representations of the objects. If no query parameters are given this request will return the entire list of SCM instances.

Info

title	API URLs

http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance

Code Block

theme	Eclipse
title	Sample POST JSON Request

{
   "name": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url"
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user"
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password"
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": "10000"
      }
   ],
   "type": "GIT",
   "description": "description",
   "code": "CODE1",
   "isActive": true
}

Parameters

...

Parameters

...

Required

...

Type

...

Description

...

Response Codes

...

HTTP Code

...

Description

...

?

Append the following character sequences to the above URL to specify Query parameters.

Use '&' between successive query parameters:

instanceName={name}

instanceCode={code}

scmType={type}

isActive={boolean}

Examples:

To search by code only:

http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance?instanceCode={code}

To search by IsActive only:

http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance?isActive={boolean}

To search by name only:

http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance?instanceName={name}

To search by type and name:

http://host:port/flexdeploy/rest/v1/topology/scminstance?scmType={type}&instanceName={name}

Tip
The query parameters are not case sensitive. Searching by instanceName=NAME is the same as searching by instanceName=name.

Request

Parameter	Required	Type	Description
instanceName	No	Query - String	This is a URL query parameter for the name which is used to query the SCM instances with. Contains ignore case search
instanceCode	No	Query - String	This is a URL query parameter for the code which is used to query the SCM instances with. Equals ignore case search
scmType	No	Query - String	This is a URL query parameter for the type which is used to query the SCM instances with. Equals ignore case search
isActive	No	Query - Boolean	Returns scm instances where isActive field matches parameter.

Include Page

	REST V1 SCM Instance Response
	REST V1 SCM Instance Response

Response Codes

HTTP Code	Description
200	Search successful and results returned
400	Bad request
401Unauthorized	Authentication failure
404	Instance not found
403	Authorization failure (no access to resource)
500	Unexpected internal server error

Example

If

the POST request receives the following JSON test instance object,

we had a SCM instance in our database with an Id of 11101 and had the following attributes

Code Block

theme	Eclipse
title	POST JSONSCM Instance - 11101

{
   "instanceId": 11101
   "nameinstanceName": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password",
		 "credentialId": 46259
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": 10000,
		 "10000credentialId": null
      }
   ],
   "typescmType": "GIT",
   "description": "description",
   "codeinstanceCode": "CODE1",
   "isActive": true
}

When we run a GET request at the following URL

http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance?code=code1&name=ScmName1

The GET request would return the following JSON SCM instance object will then be created as a new row in the database.

Code Block

theme	Eclipse
title	SCM Instance

Post

GET Return JSON

{
   "

name

instanceId": 11101
   "instanceName": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password",
		 "credentialId": 46259
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue":

"10000"

10000,
		 "credentialId": null
      }
   ],
   "

type

scmType": "GIT",
   "description": "description",
   "

code

instanceCode": "CODE1",
   "isActive": true
}

Back to Top

POST

PUT

This PUT POST service will update all attributes of create a new SCM instance with the same attributes as the given Id based on the attributes of a JSON object paramaters.

Info

title	API URL

http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance

...

Code Block

theme	Eclipse
title	Sample PUT JSON Request

{
   "name": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url"
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user"
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password"
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": "10000"
      }
   ],
   "type": "GIT",
   "description": "description",
   "code": "CODE1",
   "isActive": true
}

Parameters

...

Parameters

...

Required

...

Type

...

Description

...

Response Codes

...

HTTP Code

...

Description

...

Example

If we had a SCM instance in our database with an Id of 11101 and had the following attributes

Code Block

theme	Eclipse
title	SCM Instance PUT JSON

{ "name": "ScmName1", "properties": [ { "propertyName": "FDGIT_URL", "propertyValue": "url"

Parameters

Parameters	Required	Type	Description
Id	Yes	URL	This is a URL parameter for the Id which is used to find and return an SCM instance with.
description	No	String	This is the description that the SCM instance's description will be updated to.
isActive	Yes	Boolean	This is the isActive Boolean that the SCM instance's isActive Boolean will be updated to.
instanceCode	Yes	String	This is the code that the SCM instance's code will be updated to.
properties	Yes/No	List<PropertyValue>	This is the list of Properties that will be updated in the SCM instance. The JSON object must have all of the properties of the SCM instance's type. More info on the PropertyValue object is included below.
instanceName	Yes	String	This is the name that the SCM instance's name will be updated to.
scmType	Yes	String	This is the scm type of the SCM instance.

PropertyValue

Attributes	Type	Description
propertyName	String	This is the code of the property
propertyValue	String	This is the value of the property
credentialId	Long	Id of the credential associated with this property. Applicable only for encrypted properties.

Response Codes

HTTP Code	Description
201	Instance was created successfully
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
500	Unexpected internal server error

Example

If the POST request receives the following JSON test instance object,

Code Block

theme	Eclipse
title	POST JSON

{
   "instanceName": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password",
		 "credentialId": 46259
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": 10000,
		 "

...

credentialId": null
      }
   ],
   "

...

scmType": "GIT",

...

When we run a PUT request at the following URL

http://host:port/flexdeploy/rest/topology/integrations/scminstance/11101

...

"description": "description",
   "instanceCode": "CODE1",
   "isActive": true
}

The following SCM instance object will then be created as a new row in the database.

Code Block

theme	Eclipse
title	SCM Instance Post Return JSON

{
   "instanceId": 11101,
   "instanceName": "ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "url",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "password",
		 "credentialId": 46259
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": 10000,
		 "credentialId": null
      }
   ],
   "scmType": "GIT",
   "description": "description",
   "instanceCode": "CODE1",
   "isActive": true
}

PUT

This PUT service will update all attributes of a SCM instance with the given Id based on the attributes of a JSON object paramaters.

Info

title	API URL

http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance/{Id}

Request

Parameters	Required	Type	Description
Id	Yes	URL	This is a URL parameter for the Id which is used to find and return an SCM instance with.
description	No	String	This is the description that the SCM instance's description will be updated to.
isActive	Yes	Boolean	This is the isActive Boolean that the SCM instance's isActive Boolean will be updated to.
instanceCode	Yes	String	This is the code that the SCM instance's code will be updated to.
properties	Yes/No	List<PropertyValue>	This is the list of Properties that will be updated in the SCM instance. The JSON object must have all of the properties of the SCM instance's type. More info on the PropertyValue object is included below.
instanceName	Yes	String	This is the name that the SCM instance's name will be updated to.
scmType	Yes	String	This is the SCM type of the SCM instance.

PropertyValue

Attributes	Type	Description
propertyName	String	This is the code of the property
propertyValue	String	This is the value of the property
credentialId	Long	Id of the credential associated with this property. Applicable only for encrypted properties.

Include Page

	REST V1 SCM Instance Response
	REST V1 SCM Instance Response

Response Codes

HTTP Code	Description
200	SCM Instance was found and updated
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
404	SCM Instance not found
500	Unexpected internal server error

Example

If we had a SCM instance in our database with an Id of 11101 and had the following attributes

Code Block

theme	Eclipse
title	SCM Instance PUT Receive JSON

{
   "nameinstanceName": "ScmName2ScmName1",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "urlPUT""url",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "user",
		 "userPUTcredentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "passwordPUT"
password",
		 "credentialId": 46259
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": 10000,
		 "10001credentialId": null
      }
   ],
   "typescmType": "GIT",
   "description": "descriptionPUTdescription",
   "codeinstanceCode": "CODE2CODE1",
   "isActive": true
}

The When we run a PUT request would then update the SCM instance with Id 11101 and return the following JSON SCM instance objectat the following URL: http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance/11101

And the PUT request recieves the following JSON SCM instace object,

Code Block

theme	Eclipse
title	SCM Instance PUT Return Receive JSON

{
   "nameinstanceId": 11101,
   "instanceName": "ScmName2",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "urlPUT",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "userPUT",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "passwordPUT",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": "10001"
10001,
		 "credentialId": null
      }
   ],
   "typescmType": "GIT",
   "description": "descriptionPUT",
   "codeinstanceCode": "CODE2",
   "isActive": true
}

Back to Top

PATCH

This PATCH service will update an existing SCM instance with the information passed through a JSON object. If an attribute of the JSON is null it will not be updated in the SCM instance.

...

title	API URL

...

The PUT request would then update the SCM instance with Id 11101 and return the following JSON SCM instance object

Code Block

title
theme	Eclipse

...

SCM Instance PUT Return JSON

...

{
   "instanceId": 11101,
   "

...

instanceName": "

...

ScmName2",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "

...

urlPUT",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue":

...

"userPUT",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue":

...

 "*****",
		 "credentialId": 46259
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": 10001,
		 "

...

credentialId": null
      }
   ],
   "

...

scmType": "GIT",
   "description": "

...

descriptionPUT",
   "

...

instanceCode": "

...

CODE2",

...

 "isActive": true
}

PATCH

This PATCH service will update an existing SCM instance with the information passed through a JSON object. If an attribute of the JSON is null it will not be updated in the SCM instance.

Info

title	API URL

http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance/{Id}

Request

Parameters	Required	Type	Description
Id	Yes	URL	This is a URL parameter for the Id which is used to find and return an SCM instance with.
description	No	String	This is the description that the SCM instance's description will be updated to.
isActive	No	Boolean	This is the isActive Boolean that the SCM instance's isActive Boolean will be updated to.
instanceCode	No	String	This is the code that the SCM instance's code will be updated to.
properties	No	List<PropertyValue>	This is the list of Properties that will be updated in the SCM instance. Property values provided in input are updated, other values will be unchanged. More info on the PropertyValue object is included below.
instanceName	No	String	This is the

code

name that the SCM instance's

code

name will be updated to.

properties

scmType

No

Yes

List<PropertyValuePojo>

String

This is the

list of Properties that will be updated in

SCM type of the SCM instance.

The JSON object must have all of the properties of the SCM instance's type. nameNo

PropertyValue

Attributes	Type	Description
propertyName	String	This is the code of the property
propertyValue	String	This is

the name that the SCM instance's name will be updated to.

the value of the property
credentialId	Long	Id of the credential associated with this property. Applicable only for encrypted properties.

Include Page

	REST V1 SCM Instance Response
	REST V1 SCM Instance Response

Response Codes

HTTP Code	Description
200	SCM Instance was found and patched
400	Bad request
401Unauthorized	Authentication failure
403	Authorization failure (no access to resource)
404	SCM Instance not found
500	Unexpected internal server error

Example

If we had an test instance in our database with an Id of 11101 and had the following attributes

Code Block

theme	Eclipse
title	SCM Instance PATCH JSON

{
   "nameinstanceId": 11101,
   "instanceName": "ScmName2",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "urlPUT",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "userPUT",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "passwordPUT",
		 "credentialId": 46259
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": 10001,
		 "10001credentialId": null
      }
   ],
   "typescmType": "GIT",
   "description": "descriptionPUT",
   "codeinstanceCode": "CODE2",
   "isActive": true
}

When we run a PATCH request at the following URL: http://host:port/flexdeploy/rest/v1/topology/integrations/scminstance/11101

And the PATCH request receives the following JSON SCM instance object,

Code Block

theme	Eclipse
title	SCM Instance Patch Receive JSON

{
   "nameinstanceName": null,
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "urlPatch"
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "",
		 "passwordPatchcredentialId": 15825
      },
   ],
   "typescmType": "GIT",
   "description": null,
   "codeinstanceCode": "CODE3",
   "isActive": true
}

The PATCH request would then update the SCM instance with Id 11101 and return the the following JSON SCM instance object

Code Block

theme	Eclipse
title	SCM Instance PATCH Return JSON

{
   "nameinstanceId": 11101,
   "instanceName": "ScmName2",
   "properties":    [
            {
         "propertyName": "FDGIT_URL",
         "propertyValue": "urlPatch",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_USER",
         "propertyValue": "userPUT",
		 "credentialId": null
      },
            {
         "propertyName": "FDGIT_PASSWORD",
         "propertyValue": "passwordPatch*****",
		 "credentialId": 15825
      },
            {
         "propertyName": "FDGIT_TIMEOUT",
         "propertyValue": "10001",
		 "credentialId": null
      }
   ],
   "typescmType": "GIT",
   "description": "descriptionPUT",
   "codeinstanceCode": "CODE3",
   "isActive": true
}

Back to Top

Version	Old Version 6	New Version Current
Changes made by	Chandresh Patel	Jay-Ar Brouillard
Saved on	Jul 03, 2018	May 04, 2020

Page Comparison

Versions Compared

Key

ClearCaseUCM

CVS

File System

Git

Perforce

PVCS

Subversion

TFVC

GET

GET (Using Id)

Parameters

Response Codes

Example

GET (Using Query Parameters)

Append the following character sequences to the above URL to specify Query parameters.

Use '&' between successive query parameters:

Examples:

To search by code only:

To search by name only:

To search by type and name:

Parameters

Response Codes

Example

CVS (CVS)

File System (FILE)

Git (GIT)

Perforce (PERF)

PVCS (PVCS)

Subversion (SVN)

TFVC (TFVC)

GET

GET (Using Id)

Request

Response Codes

Example

GET (Using Query Parameters)

Parameters

Response Codes

Append the following character sequences to the above URL to specify Query parameters.

Use '&' between successive query parameters:

Examples:

To search by code only:

To search by IsActive only:

To search by name only:

To search by type and name:

Request

Response Codes

Example

POST

PUT

Parameters

Response Codes

Example

Parameters

Response Codes

Example

PUT

Request

Response Codes

Example

PATCH

PATCH

Request

Response Codes

Example