Get Deployments 1

Get Deployments 1

Returns a paginated list of deployments.

Request
URI
GET
https://{api_host}/deployment/api/deployments
COPY
Query Parameters
integer
page
Optional
Constraints: minimum: 0 default: 0

Zero-based page index (0..N)

integer
size
Optional
Constraints: minimum: 1 default: 20

The size of the page to be returned

string of array
sort
Optional
Constraints: default: createdAt,DESC

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

string of array
ids
Optional

A comma-separated list. Only deployments with these IDs will be included in the results.

string
search
Optional

Given string should either be part of a searchable field in a deployment or one of deployment's resources.

string
name
Optional

Results must have exactly this name.

string of array
status
Optional

A comma-separated list. Results must be associated with one of these statuses.

string of array
projects
Optional

A comma-separated list. Results must be associated with one of these project IDs.

string of array
resourceTypes
Optional

A comma-separated list. Results must be associated with one of these resourceType Names.

string of array
cloudAccounts
Optional

A comma-separated list. Results must be associated with one of these cloud accounts.

string of array
cloudTypes
Optional

A comma-separated list. Results must be associated with one of these endpoint Types

string of array
requestedBy
Optional

A comma-separated list. Results must be associated with one of these requesters

string of array
ownedBy
Optional

A comma-separated list. Results must be associated with one of these owners

string of array
tags
Optional

A comma-separated list. Results must be associated with one of these tags

string
createdAt
Optional

Comma-separated start and end dates where start date or end date is optional (e.g. [2020-12-01T08:00:00.000Z,2020-12-11T23:59:00.000Z], [2020-11-03T08:00:00.000Z,], [,2020-11-08T08:00:00.000Z])

string
expiresAt
Optional

Comma-separated start and end dates where start date or end date is optional (e.g. [2020-12-01T08:00:00.000Z,2020-12-11T23:59:00.000Z], [2020-11-03T08:00:00.000Z,], [,2020-11-08T08:00:00.000Z])

string
lastUpdatedAt
Optional

Comma-separated start and end dates where start date or end date is optional (e.g. [2020-12-01T08:00:00.000Z,2020-12-11T23:59:00.000Z], [2020-11-03T08:00:00.000Z,], [,2020-11-08T08:00:00.000Z])

boolean
expandResources
Optional Deprecated

The 'resources' field of each resulting deployment will be retrieved.

boolean
expandLastRequest
Optional Deprecated

Expands deployment last request.

boolean
expandProject
Optional Deprecated

The 'project' field of each resulting deployment will be retrieved.

string of array
expand
Optional

The expanded details of the requested comma separated objects. 'resources' option returns resources with all properties. Ex. blueprint, project

string of array
lastRequestStatus
Optional

A comma-separated list of last request statuses. Allowed values are: ABORTED, APPROVAL_PENDING, APPROVAL_REJECTED, FAILED, INPROGRESS, PENDING and SUCCESSFUL. Results must be associated with one of these last request statuses.

boolean
deleted
Optional

Retrieves only soft-deleted deployments that have not yet been completely deleted.

integer
$top
Optional

Number of records you want

$top example
1
integer
$skip
Optional

Number of records you want to skip

$skip example
1
string
$orderby
Optional

Sorting criteria in the format: property (asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

string
$filter
Optional

A subset of records that satisfy the given predicate expression

$filter example
startswith(name, 'Act'), toupper(name) eq 'ACTIVATE', substringof('renameVM', name), name eq 'ABCD'

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns PageDeployment of type(s) application/json
{
    "content": [
        {
            "blueprint": {
                "description": "string",
                "id": "string",
                "name": "string",
                "version": "string"
            },
            "blueprintId": "string",
            "blueprintVersion": "string",
            "catalog": {
                "description": "string",
                "id": "string",
                "name": "string",
                "version": "string"
            },
            "catalogItemId": "string",
            "catalogItemVersion": "string",
            "createdAt": "string",
            "createdBy": "string",
            "creator": {
                "email": "string",
                "firstname": "string",
                "id": "string",
                "lastname": "string",
                "type": "string"
            },
            "deleted": false,
            "description": "string",
            "expense": {
                "additionalExpense": "number",
                "code": "string",
                "computeExpense": "number",
                "lastUpdatedTime": "string",
                "message": "string",
                "networkExpense": "number",
                "storageExpense": "number",
                "totalExpense": "number",
                "unit": "string"
            },
            "iconId": "string",
            "id": "string",
            "inprogressRequests": {},
            "inputs": {},
            "lastRequest": {
                "actionId": "string",
                "approvedAt": "string",
                "blueprintId": "string",
                "cancelable": false,
                "catalogItemId": "string",
                "completedAt": "string",
                "completedTasks": 0,
                "createdAt": "string",
                "deploymentId": "string",
                "details": "string",
                "dismissed": false,
                "estimatedCompletionTime": "string",
                "id": "string",
                "initializedAt": "string",
                "inputs": {
                    "inputs": {}
                },
                "name": "string",
                "outputs": {
                    "outputs": {}
                },
                "requestedBy": "string",
                "resourceIds": [
                    "string"
                ],
                "resources": [
                    {
                        "description": "string",
                        "id": "string",
                        "name": "string",
                        "version": "string"
                    }
                ],
                "status": "string",
                "totalTasks": 0,
                "updatedAt": "string"
            },
            "lastUpdatedAt": "string",
            "lastUpdatedBy": "string",
            "lastUpdater": {
                "email": "string",
                "firstname": "string",
                "id": "string",
                "lastname": "string",
                "type": "string"
            },
            "leaseExpireAt": "string",
            "leaseGracePeriodDays": 0,
            "name": "string",
            "orgId": "string",
            "outputs": {},
            "ownedBy": "string",
            "owner": {
                "email": "string",
                "firstname": "string",
                "id": "string",
                "lastname": "string",
                "type": "string"
            },
            "ownerType": "string",
            "project": {
                "description": "string",
                "id": "string",
                "name": "string",
                "version": "string"
            },
            "projectId": "string",
            "resources": [
                {
                    "createdAt": "string",
                    "currentRequest": {
                        "actionId": "string",
                        "approvedAt": "string",
                        "blueprintId": "string",
                        "cancelable": false,
                        "catalogItemId": "string",
                        "completedAt": "string",
                        "completedTasks": 0,
                        "createdAt": "string",
                        "deploymentId": "string",
                        "details": "string",
                        "dismissed": false,
                        "estimatedCompletionTime": "string",
                        "id": "string",
                        "initializedAt": "string",
                        "inputs": {
                            "inputs": {}
                        },
                        "name": "string",
                        "outputs": {
                            "outputs": {}
                        },
                        "requestedBy": "string",
                        "resourceIds": [
                            "string"
                        ],
                        "resources": [
                            {
                                "description": "string",
                                "id": "string",
                                "name": "string",
                                "version": "string"
                            }
                        ],
                        "status": "string",
                        "totalTasks": 0,
                        "updatedAt": "string"
                    },
                    "dependsOn": [
                        "string"
                    ],
                    "description": "string",
                    "expense": {
                        "additionalExpense": "number",
                        "code": "string",
                        "computeExpense": "number",
                        "lastUpdatedTime": "string",
                        "message": "string",
                        "networkExpense": "number",
                        "storageExpense": "number",
                        "totalExpense": "number",
                        "unit": "string"
                    },
                    "id": "string",
                    "inprogressRequests": {},
                    "name": "string",
                    "origin": "string",
                    "properties": {
                        "properties": {}
                    },
                    "state": "string",
                    "syncStatus": "string",
                    "type": "string"
                }
            ],
            "status": "string"
        }
    ],
    "empty": false,
    "first": false,
    "last": false,
    "number": 0,
    "numberOfElements": 0,
    "pageable": {
        "offset": 0,
        "pageNumber": 0,
        "pageSize": 0,
        "paged": false,
        "sort": [
            {
                "ascending": false,
                "direction": "string",
                "ignoreCase": false,
                "nullHandling": "string",
                "property": "string"
            }
        ],
        "unpaged": false
    },
    "size": 0,
    "sort": [
        {
            "ascending": false,
            "direction": "string",
            "ignoreCase": false,
            "nullHandling": "string",
            "property": "string"
        }
    ],
    "totalElements": 0,
    "totalPages": 0
}
array of object
content
Optional

A group of resources such as machines, network, software, etc... typically provisioned together to deliver a complete/workable application.

boolean
empty
Optional

empty

boolean
first
Optional

first

boolean
last
Optional

last

integer As int32 As int32
number
Optional

number

integer As int32 As int32
numberOfElements
Optional

numberOfElements

object
pageable
Optional

pageable

integer As int32 As int32
size
Optional

size

array of object
sort
Optional

sort

integer As int64 As int64
totalElements
Optional

totalElements

integer As int32 As int32
totalPages
Optional

totalPages


401

Unauthorized

Returns PageDeployment of type(s) application/json
"PageDeployment Object"
array of object
content
Optional

A group of resources such as machines, network, software, etc... typically provisioned together to deliver a complete/workable application.

boolean
empty
Optional

empty

boolean
first
Optional

first

boolean
last
Optional

last

integer As int32 As int32
number
Optional

number

integer As int32 As int32
numberOfElements
Optional

numberOfElements

object
pageable
Optional

pageable

integer As int32 As int32
size
Optional

size

array of object
sort
Optional

sort

integer As int64 As int64
totalElements
Optional

totalElements

integer As int32 As int32
totalPages
Optional

totalPages


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/deployment/api/deployments