Post

• Catalog Sources

Creates a new catalog source or updates an existing catalog source based on the request body and imports catalog items from it.

Request

URI

POST

https://{api_host}/catalog/api/admin/sources

COPY

Query Parameters

boolean

validationOnly

Optional

If true, the source will not be created. It returns the number of items belonging to the source. The request will still return an error code if the source is invalid.

---

Request Body

CatalogSource of type(s) application/json

Required

Show optional properties

{
    "config": {},
    "id": "string",
    "name": "string",
    "typeId": "string"
}

{
    "config": {},
    "createdAt": "string",
    "createdBy": "string",
    "creator": {
        "email": "string",
        "firstname": "string",
        "id": "string",
        "lastname": "string",
        "type": "string"
    },
    "description": "string",
    "global": false,
    "iconId": "string",
    "id": "string",
    "itemsFound": 0,
    "itemsImported": 0,
    "lastImportCompletedAt": "string",
    "lastImportErrors": [
        "string"
    ],
    "lastImportStartedAt": "string",
    "lastUpdatedAt": "string",
    "lastUpdatedBy": "string",
    "lastUpdater": {
        "email": "string",
        "firstname": "string",
        "id": "string",
        "lastname": "string",
        "type": "string"
    },
    "name": "string",
    "originOrgId": "string",
    "projectId": "string",
    "typeId": "string"
}

object

config

Required

config

string As date-time As date-time

createdAt

Optional

Creation time

string

createdBy

Optional

Created By

object

creator

Optional

Expanded policy last updater details

string

description

Optional

Constraints: maxLength: 2000

Catalog Source description

boolean

global

Optional

Global flag indicating that all the items can be requested across all projects.

string As uuid As uuid

iconId

Optional

Default Icon Id

string As uuid As uuid

id

Required

Catalog Source id

integer As int32 As int32

itemsFound

Optional

Number of items found

integer As int32 As int32

itemsImported

Optional

Number of items imported.

string As date-time As date-time

lastImportCompletedAt

Optional

Last import completion time

array of string

lastImportErrors

Optional

Last import error(s)

string As date-time As date-time

lastImportStartedAt

Optional

Last import start time

string As date-time As date-time

lastUpdatedAt

Optional

Update time

string

lastUpdatedBy

Optional

Updated By

object

lastUpdater

Optional

Expanded policy last updater details

string

name

Required

Constraints: maxLength: 1024

Catalog Source name

string

originOrgId

Optional

Org id where the source content originates from

string

projectId

Optional

Project id where the source content originates from

string

typeId

Required

Type of source, e.g. blueprint, CFT... etc

Authentication

This operation uses the following authentication methods.

bearerAuth

Responses

200

Hide Details

Validation is ok

Returns CatalogSource of type(s) application/json

"CatalogSource Object"

object

config

Required

config

string As date-time As date-time

createdAt

Optional

Creation time

string

createdBy

Optional

Created By

object

creator

Optional

Expanded policy last updater details

string

description

Optional

Constraints: maxLength: 2000

Catalog Source description

boolean

global

Optional

Global flag indicating that all the items can be requested across all projects.

string As uuid As uuid

iconId

Optional

Default Icon Id

string As uuid As uuid

id

Required

Catalog Source id

integer As int32 As int32

itemsFound

Optional

Number of items found

integer As int32 As int32

itemsImported

Optional

Number of items imported.

string As date-time As date-time

lastImportCompletedAt

Optional

Last import completion time

array of string

lastImportErrors

Optional

Last import error(s)

string As date-time As date-time

lastImportStartedAt

Optional

Last import start time

string As date-time As date-time

lastUpdatedAt

Optional

Update time

string

lastUpdatedBy

Optional

Updated By

object

lastUpdater

Optional

Expanded policy last updater details

string

name

Required

Constraints: maxLength: 1024

Catalog Source name

string

originOrgId

Optional

Org id where the source content originates from

string

projectId

Optional

Project id where the source content originates from

string

typeId

Required

Type of source, e.g. blueprint, CFT... etc

201

Hide Details

Created

Returns CatalogSource of type(s) application/json

"CatalogSource Object"

object

config

Required

config

string As date-time As date-time

createdAt

Optional

Creation time

string

createdBy

Optional

Created By

object

creator

Optional

Expanded policy last updater details

string

description

Optional

Constraints: maxLength: 2000

Catalog Source description

boolean

global

Optional

Global flag indicating that all the items can be requested across all projects.

string As uuid As uuid

iconId

Optional

Default Icon Id

string As uuid As uuid

id

Required

Catalog Source id

integer As int32 As int32

itemsFound

Optional

Number of items found

integer As int32 As int32

itemsImported

Optional

Number of items imported.

string As date-time As date-time

lastImportCompletedAt

Optional

Last import completion time

array of string

lastImportErrors

Optional

Last import error(s)

string As date-time As date-time

lastImportStartedAt

Optional

Last import start time

string As date-time As date-time

lastUpdatedAt

Optional

Update time

string

lastUpdatedBy

Optional

Updated By

object

lastUpdater

Optional

Expanded policy last updater details

string

name

Required

Constraints: maxLength: 1024

Catalog Source name

string

originOrgId

Optional

Org id where the source content originates from

string

projectId

Optional

Project id where the source content originates from

string

typeId

Required

Type of source, e.g. blueprint, CFT... etc

400

Hide Details

Bad Request

Returns CatalogSource of type(s) application/json

"CatalogSource Object"

object

config

Required

config

string As date-time As date-time

createdAt

Optional

Creation time

string

createdBy

Optional

Created By

object

creator

Optional

Expanded policy last updater details

string

description

Optional

Constraints: maxLength: 2000

Catalog Source description

boolean

global

Optional

Global flag indicating that all the items can be requested across all projects.

string As uuid As uuid

iconId

Optional

Default Icon Id

string As uuid As uuid

id

Required

Catalog Source id

integer As int32 As int32

itemsFound

Optional

Number of items found

integer As int32 As int32

itemsImported

Optional

Number of items imported.

string As date-time As date-time

lastImportCompletedAt

Optional

Last import completion time

array of string

lastImportErrors

Optional

Last import error(s)

string As date-time As date-time

lastImportStartedAt

Optional

Last import start time

string As date-time As date-time

lastUpdatedAt

Optional

Update time

string

lastUpdatedBy

Optional

Updated By

object

lastUpdater

Optional

Expanded policy last updater details

string

name

Required

Constraints: maxLength: 1024

Catalog Source name

string

originOrgId

Optional

Org id where the source content originates from

string

projectId

Optional

Project id where the source content originates from

string

typeId

Required

Type of source, e.g. blueprint, CFT... etc

401

Hide Details

Unauthorized

Returns CatalogSource of type(s) application/json

"CatalogSource Object"

object

config

Required

config

string As date-time As date-time

createdAt

Optional

Creation time

string

createdBy

Optional

Created By

object

creator

Optional

Expanded policy last updater details

string

description

Optional

Constraints: maxLength: 2000

Catalog Source description

boolean

global

Optional

Global flag indicating that all the items can be requested across all projects.

string As uuid As uuid

iconId

Optional

Default Icon Id

string As uuid As uuid

id

Required

Catalog Source id

integer As int32 As int32

itemsFound

Optional

Number of items found

integer As int32 As int32

itemsImported

Optional

Number of items imported.

string As date-time As date-time

lastImportCompletedAt

Optional

Last import completion time

array of string

lastImportErrors

Optional

Last import error(s)

string As date-time As date-time

lastImportStartedAt

Optional

Last import start time

string As date-time As date-time

lastUpdatedAt

Optional

Update time

string

lastUpdatedBy

Optional

Updated By

object

lastUpdater

Optional

Expanded policy last updater details

string

name

Required

Constraints: maxLength: 1024

Catalog Source name

string

originOrgId

Optional

Org id where the source content originates from

string

projectId

Optional

Project id where the source content originates from

string

typeId

Required

Type of source, e.g. blueprint, CFT... etc

403

Hide Details

Forbidden

Returns CatalogSource of type(s) application/json

"CatalogSource Object"

object

config

Required

config

string As date-time As date-time

createdAt

Optional

Creation time

string

createdBy

Optional

Created By

object

creator

Optional

Expanded policy last updater details

string

description

Optional

Constraints: maxLength: 2000

Catalog Source description

boolean

global

Optional

Global flag indicating that all the items can be requested across all projects.

string As uuid As uuid

iconId

Optional

Default Icon Id

string As uuid As uuid

id

Required

Catalog Source id

integer As int32 As int32

itemsFound

Optional

Number of items found

integer As int32 As int32

itemsImported

Optional

Number of items imported.

string As date-time As date-time

lastImportCompletedAt

Optional

Last import completion time

array of string

lastImportErrors

Optional

Last import error(s)

string As date-time As date-time

lastImportStartedAt

Optional

Last import start time

string As date-time As date-time

lastUpdatedAt

Optional

Update time

string

lastUpdatedBy

Optional

Updated By

object

lastUpdater

Optional

Expanded policy last updater details

string

name

Required

Constraints: maxLength: 1024

Catalog Source name

string

originOrgId

Optional

Org id where the source content originates from

string

projectId

Optional

Project id where the source content originates from

string

typeId

Required

Type of source, e.g. blueprint, CFT... etc

404

Hide Details

Not Found

Returns CatalogSource of type(s) application/json

"CatalogSource Object"

object

config

Required

config

string As date-time As date-time

createdAt

Optional

Creation time

string

createdBy

Optional

Created By

object

creator

Optional

Expanded policy last updater details

string

description

Optional

Constraints: maxLength: 2000

Catalog Source description

boolean

global

Optional

Global flag indicating that all the items can be requested across all projects.

string As uuid As uuid

iconId

Optional

Default Icon Id

string As uuid As uuid

id

Required

Catalog Source id

integer As int32 As int32

itemsFound

Optional

Number of items found

integer As int32 As int32

itemsImported

Optional

Number of items imported.

string As date-time As date-time

lastImportCompletedAt

Optional

Last import completion time

array of string

lastImportErrors

Optional

Last import error(s)

string As date-time As date-time

lastImportStartedAt

Optional

Last import start time

string As date-time As date-time

lastUpdatedAt

Optional

Update time

string

lastUpdatedBy

Optional

Updated By

object

lastUpdater

Optional

Expanded policy last updater details

string

name

Required

Constraints: maxLength: 1024

Catalog Source name

string

originOrgId

Optional

Org id where the source content originates from

string

projectId

Optional

Project id where the source content originates from

string

typeId

Required

Type of source, e.g. blueprint, CFT... etc

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"config:"object","id:"string","name:"string","typeId:"string"}' https://{api_host}/catalog/api/admin/sources
                

On This Page

Description

Request

Query Parameters

Request Body

Authentication

Response

200 Response Body

201 Response Body

Errors

Catalog Sources Operations

GET

Get Page

POST

Post

DELETE

Delete 2

GET

Get