Project API GET By Id

This GET service will find a Project by Id and return a JSON representation of it.

API URLs

http://host:port/flexdeploy/rest/v1/project/{id}

Request

Parameter	Required	Type	Description
id	Yes	URL	This is a URL path parameter for the id which is used to find a project.

Response

Attribute	Type	Description
projectId	Long	Id of the project.
projectName	String	Unique name of the project.
applicationId	String	Id of the application the project is in.
projectPath	String	Fully qualified project path.
isActive	Boolean	Boolean that tracks whether or not the project is active. Null input defaults to true.
description	String	Description of the project.
partialDeployment	Boolean	Whether the project allows partial deployments. Null input defaults to false.
priority	Integer	Deploy priority of the project.
webhooksEnabled	Boolean	Whether or not webhooks are enabled.
projectType	ProjectTypeEnum	Type of project. Possible values are GENERAL, EBS, PARTIAL_FILE, PARTIAL_JDBC, OracleForms, ORACLE_DB, ORACLE_BI, ORACLE_APEX, MFT, SALESFORCE, UTILITY, MDS, or GENERIC.
scmType	SCMTypeEnum	This specifies the source control management system used by this project. Must be a valid source control management system. Possible values are SVN, GIT, CVS, TFVC, PERF, PVCS, FILE, or NONE.
priorityScope	String	This specifies the priority scope of the current project. Either Global, Folder, or Application.
buildInfo	ProjectBuildInfo	Build info for the project. See more info about the ProjectBuildInfo object below.
deployInfo	ProjectDeployInfo	Deploy info for the project. See more info about the ProjectDeployInfo object below.
utilityExecutionInfo	UtilityProjectExecutionInfo	Execution info for a utility project. See more info about the UtilityProjectExecutionInfo object below.
streams	List<Long>	List of ids which identify the project streams associated with this project.
mainStreamName	String	Name of the main stream for the project.
scmConfiguration	ProjectSCMPojo	SCM configuration for the project. See more info about the ProjectSCMPojo object below.
containerConfiguration	ContainerConfiguration	Container configuration for the project. See more info about the ContainerConfiguration type below.

ProjectBuildInfo

Attribute	Type	Description
buildWorkflowId	Long	Id of the build workflow used by this project.
buildInstanceId	Long	Id of the instance where this project is built.

ProjectDeployInfo

Attribute	Type	Description
deployWorkflowId	Long	Id of the deployment workflow used by this project.
deployInstanceIds	List<Long>	Id of each of the instances where the project can be deployed.

UtilityProjectExecutionInfo

Attribute	Type	Description
utilityWorkflowId	Long	Id of the utility workflow used by this project.
utilityInstanceIds	List<Long>	Id of each of the utility instance where this project can be run.

ProjectSCMPojo

Attribute	Type	Description
sources	List<ProjectSCMConfig>	List of SCM configuration sources. See more info about the ProjectSCMConfig object below.

ProjectSCMConfig

Attribute	Type	Description
instanceId	Long	SCM instance id for this source.
configValues	List<ProjectSCMConfigValue>	Configuration values for each SCM source. See more info about the ProjectSCMConfigValue object below.
sourceNumber	Integer	Number for the source. Source numbers start at 1 and increment for each source after that.

ProjectSCMConfigValue

Attribute	Type	Description
configName	String	Name of the configuration attribute.
configValue	String	Value of the configuration attribute.

ContainerConfiguration

Attribute	Type	Description
dockerFile	String	Name of the dockerfile
dockerStreams	List<DockerStream>	Information about the docker streams. See more info about the DockerStream type below.
kubernetesConfiguration	KubernetesConfiguration	Configuration for Kubernetes. See more info about the KubernetesConfiguration type below.

DockerStream

Attribute	Type	Description
streamId	Long	Id of the stream.
streamName	String	Name of the stream.
imageName	String	Name of the image.
isImageBuild	Boolean	If the image will build.
isImagePush	Boolean	If the image will push. Null if isImageBuild is false.

KubernetesConfiguration

Attribute	Type	Description
deploymentName	String	Name of the deployment.
manifestsToDeploy	List<String>	Manifests to deploy.
blueGreenManifests	List<String>	Blue green manifests.
canaryManifests	List<String>	Canary manifests.
abmanifests	List<String>	AB manifests.
helmConfiguration	HelmConfiguration	The helm configuration. See more info about the HelmConfiguration type below.

HelmConfiguration

Attribute	Type	Description
chart	String	Name of the chart.
releaseName	String	Name of the release.
parametersMap	List<ParameterMap>	All of the parameter mappings. See more info about the ParmaterMap type below.

ParameterMap

Attribute	Type	Description
key	String	Key for the parameter map.
value	String	Value for the parameter map.

Response Codes

HTTP Code	Description
200	Projects were found and returned
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
500	Unexpected internal server error

Example

If we had a Project in our database with the id 10002, when we run a GET request at the following URL:

http://host:port/flexdeploy/rest/v1/project/10002

The GET request would return the following JSON project object:

Project - "Project1"

{
    "priority": 1,
    "projectName": "XXHR",
    "projectId": 10002,
    "description": "EBS Customizations",
    "applicationId": 10011,
    "projectPath": "FlexDeploy/EBSCustomizations/HR/XXHR",
    "priorityScope": "Application",
    "partialDeployment": true,
    "isActive": true,
    "scmType": "GIT",
    "scmConfiguration": {
        "sources": [
            {
                "instanceId": 15551,
                "configValues": [
                    {
                        "configName": "BranchScript",
                        "configValue": "StreamName"
                    },
                    {
                        "configName": "TagScript",
                        "configValue": "ProjectVersion"
                    },
                    {
                        "configName": "SparseCheckoutFoldersScript",
                        "configValue": "\"EBSCustomizations/XXHR\""
                    },
                    {
                        "configName": "CheckoutFolderScript",
                        "configValue": "ProjectName"
                    }
                ],
                "sourceNumber": 1
            }
        ]
    },
    "streams": [
        10802,
        10803,
        10804,
        10805
    ],
    "mainStreamName": "master",
    "deployInfo": {
        "workflowId": 15529,
        "instanceIds": [
            11153,
            11168,
            11183,
            11198,
            11213,
            11228,
            11243
        ]
    },
    "buildInfo": {
        "workflowId": 10869,
        "instanceId": 11153
    },
    "utilityExecutionInfo": null,
    "projectType": "EBS",
	"webhooksEnabled": false,
	"containerConfiguration": {
        "dockerfile": "docker file name"
		"dockerStreams": [
            {
                "isImageBuild": true,
                "isImagePush": false,
                "streamName": "master",
                "streamId": 12345,
                "imageName": "image name"
            }
        ],
        "kubernetesConfiguration": {
            "manifestsToDeploy": [
                "deploymanifest1"
            ],
            "blueGreenManifests": [
                "bluegreenmanifest1",
                "bluegreenmanifest2"
            ],
            "canaryManifests": [
                "canarymanifest1"
            ],
            "abmanifests": [
                "abmanifest1",
                "abmanifest2",
                "abmanifest3"
            ],
            "helmConfiguration": {
                "parametersMap": [
                    {
                        "key": "key1",
                        "valueScript": "value1"
                    },
                    {
                        "key": "key2",
                        "valueScript": "value2"
                    }
                ],
                "releaseName": "release name",
                "chart": "chart name"
            },
            "deploymentName": "deployment name"
        }
	}
}