Jump to

• Request
• Response
• Examples

Retrieve Deployments in a Project

get

/ic/api/integration/v1/projects/{projectId}/deployments

Retrieves information about all the deployments in a project.

Request

Path Parameters

• projectId(required): string
  Project identifier

Query Parameters

• integrationInstance(required): string
  This is the name of the service instance. You can get this value from the About page where it is specified in the Service instance field.
• limit: integer(int32)
  Use with the offset parameter for paginating through the returned results. The limit is the maximum number of items to return at one time. For example, offset=3&limit=16 indicates to list deployments starting at the 4th item, and the list will contain 16 items.
• offset: integer(int32)
  Use with the limit parameter for paginating through the returned results. The offset is the starting point from which to return records. For example, offset=3&limit=16 indicates to list deployments starting at the 4th item, and the list will contain 16 items.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json;charset=utf-8, application/vnd.oracle.model+json;type=collection

200 Response

Successful operation

Body ()

Root Schema : LabelsRs

Type: object

Show Source

• items: array items
  List of Deployments

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "description":"List of Deployments",
            "items":{
                "$ref":"#/components/schemas/LabelRs"
            }
        }
    }
}

Nested Schema : items

Type: array

List of Deployments

Show Source

• Array of: object LabelRs

{
    "type":"array",
    "description":"List of Deployments",
    "items":{
        "$ref":"#/components/schemas/LabelRs"
    }
}

Nested Schema : LabelRs

Type: object

Show Source

• code(required): string
  Deployment Identifier
• description: string
  Deployment Description
• lastUpdated: string (date-time)
  Last Updated Date
• name(required): string
  Deployment Name
• rows: array rows
  Integration List

{
    "required":[
        "name",
        "code"
    ],
    "type":"object",
    "properties":{
        "name":{
            "required":[
                "true"
            ],
            "type":"string",
            "description":"Deployment Name"
        },
        "code":{
            "required":[
                "true"
            ],
            "type":"string",
            "description":"Deployment Identifier"
        },
        "description":{
            "type":"string",
            "description":"Deployment Description"
        },
        "lastUpdated":{
            "type":"string",
            "description":"Last Updated Date",
            "format":"date-time"
        },
        "rows":{
            "type":"array",
            "description":"Integration List",
            "items":{
                "$ref":"#/components/schemas/Integration"
            }
        }
    }
}

Nested Schema : rows

Type: array

Integration List

Show Source

• Array of: object Integration

{
    "type":"array",
    "description":"Integration List",
    "items":{
        "$ref":"#/components/schemas/Integration"
    }
}

Nested Schema : Integration

Type: object

Show Source

• code: string
• name: string
• status: string
• version: string

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string"
        },
        "version":{
            "type":"string"
        },
        "name":{
            "type":"string"
        },
        "status":{
            "type":"string"
        }
    }
}

400 Response

Malformed parameters

500 Response

Server error

Back to Top

Examples

The following example shows how to retrieve details about deployments in a project by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL. For more information about endpoint URL structure, see Send Requests.

Example: Paginate through returned deployments in the project TEST_PROJECT

Pagination is done with limit and offset. In this example, we list deployments starting at the fourth item. The list contains 16 items.

curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" -d "offset=3&limit=16" https://design.integration.region.ocp.oraclecloud.com/ic/api/integration/v1/projects/TEST_PROJECT/deployments?integrationInstance=service-instance

Example: Get all deployments in the project TEST_PROJECT

curl -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" https://design.integration.region.ocp.oraclecloud.com/ic/api/integration/v1/projects/TEST_PROJECT/deployments?integrationInstance=service-instance

Back to Top