| Anchor | ||||
|---|---|---|---|---|
|
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 | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/topology/integrations/scminstance |
...
Each function returns a JSON test instance object. The test SCM instance Object is an object that has these attributes,
| Attributes | Type | Description |
|---|---|---|
| id | Long | This is an id of the SCM Instance. |
| code | String | This is a code of the SCM instance. |
| name | String | This is the unique name of the SCM instance. |
| type | String | This is the SCM type of the SCM instance. |
| isActive | Boolean | This is a Boolean that tracks whether or not the SCM instance is active. |
| description | String | This is the description of the SCM instance. |
| properties | List<PropertyValuePojo> | This is a list of the Properties associated with the SCM instance. |
Currently there are 8 different source control management types that are supported in Flex Deploy.
ClearCaseUCM
| Property Name | Type | Required | Description |
|---|---|---|---|
| ClearCaseUCM URL | String | Yes | URL of the ClearCase Server. |
| ClearCaseUCM User | String | Yes | ClearCase User to connect with. |
| ClearCaseUCM Password | String | Yes | ClearCase Password for connecting user. |
CVS
| Property Name | Type | Required | Description |
|---|---|---|---|
| CVS URL | String | Yes | URL to the CVS repository. |
| CVS User | String | Yes | CVS repository user. |
| CVS Password | String | Yes | CVS repository password. |
File System
| Property Name | Type | Required | Description |
|---|---|---|---|
| File Repository Root | String | Yes | Location on the FlexDeploy server of the repository. |
Git
| Property Name | Type | Required | Description |
|---|---|---|---|
| Git URL | String | Yes | URL to the Git repository. |
| Git User | String | Yes/No | Git repository user. |
| Git Password | String | Yes/no | Git repository password. |
| Git Timeout | Integer | No | Timeout for Git command execution. |
Perforce
| Property Name | Type | Required | Description |
|---|---|---|---|
| Perforce Host | String | Yes | Host of the Perforce repository. |
| Perforce Port | String | Yes | Port of the Perforce repository. |
| Perforce User | String | Yes | Perforce User to connect with. |
| Perforce User Password | String | Yes | Perforce Password associated with Perforce User. |
| Perforce SSL Connection | Boolean | Yes | Should ssl be used connecting to the server. |
PVCS
| Property Name | Type | Required | Description |
|---|---|---|---|
| PVCS Project Database | String | Yes | Project Database Name. |
| PVCS User | String | Yes | PVCS user to access ProjectDatabases. |
| PVCS Password | String | Yes | PVCS password to access ProjectDatabases |
Subversion
| Property Name | Type | Required | Description |
|---|---|---|---|
| Subversion URL | String | Yes | URL to the Subversion repository. |
| Subversion User | String | Yes | Subversion repository user. |
| Subversion Password | String | Yes | Subversion repository password. |
| Subversion Authentication Methods | String | No | One or more subversion authentication methods. For example, Basic, Digest, Negotiate, NTLM. |
TFVC
| Property Name | Type | Required | Description |
|---|---|---|---|
| TFVC URL | String | Yes | URL to the TFVC repository. |
| TFVC User | String | Yes | TFVC repository user. |
| TFVC Password | 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 | ||
|---|---|---|
| ||
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:To search by code only:http://host:port/flexdeploy/rest/topology/integrations/scminstance?code={code} To search by name only:http://host:port/flexdeploy/rest/topology/integrations/scminstance?name={name} To search by type and name:http://host:port/flexdeploy/rest/topology/scminstance?type={type}&name={name} |
| 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 | No | URL(query) | This is a URL query parameter for the name which is used to query the SCM instances with. |
| code | No | URL(query) | This is a URL query parameter for the code which is used to query the SCM instances with. |
| type | No | URL(query | This is a URL query parameter for the type which is used to query the SCM instances with. |
Response Codes
HTTP Code | Description |
|---|---|
| 200 | SCM Instances were found and returned |
| 400 | Bad request |
| 401 | Unauthorized |
| 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
...
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 | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/topology/integrations/scminstance/{Id} |
...