Contentless Linux Patch Groups

A contentless Linux patch group defines a set of patches that you want to scan for or deploy.

Base URL

        https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups

Supported Requests

Method URL Input Return

DELETE

https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups/{patchgroupId}

  Success Code

https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups/{patchgroupId}/patches/{patchId}

  Success Code

GET

https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups   LinuxPatchGroup
https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups/{patchgroupId}   LinuxPatchGroup
https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups/patches   LinuxPatchLinks
https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups/{patchgroupId}/usedby  

LinuxPatchGroupUsedby

POST

https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups

Request Body LinuxPatchGroup

https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups/{patchgroupId}/patches

Request Body Patches Success Code

PUT

https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups/{patchgroupId}

Request Body Success Code

Input Models

Name Type Description

createdByMe

Boolean

Returns only those items created by the user.

This parameter will be removed in a future release and should only be used in legacy requests.

name

String

Returns the items whose name matches the specified name.

path

String

Returns the items containing the path.
Name Required? Type Default Value Description

name

Yes

String

None

Contentless Linux patch group name.

path

No

String

None

The path to the group.
Name Required? Type Default Value Description

errorPolicy

No

Enum

Throw

Determines if the call will throw an error when encountering an invalid ID.

  • Throw: The entire request will be rejected.
  • Omit: The problem area will be omitted but the rest of the request will be completed.

advisories

Yes

advisory id

None

The advisories.

packages

Yes

Package id

None

The package IDs.

Example with Sample Response

Find all contentless Linux patch groups

GET Request

https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups

Sample Response

Copy 
{
    "count": 1,
    "value": [
        {
            "id": 1,
            "links": {
                "self": {
                "href": "https://device-name.example.com:3121/st/console/api/v1.0/linux/contentlesspatchgroups/1"
                },
                "patches": {
                "href": "https://device-name.example.com:3121/st/console/api/v1.0/linux/contentlesspatchgroups/1/patches"
                },
                "usedby": {
                "href": "https://device-name.example.com:3121/st/console/api/v1.0/linux/contentlesspatchgroups/1/usedby"
                }
            },
            "name": "Sample-contentless-Linux-Patch-Group"
        }
    ]
}

Other Request Examples

DELETE Request

https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups/1

DELETE Request

https://<consoleFQDN:port>/st/console/api/v1.0/linux/contentlesspatchgroups/1/patches/0002b0ed-0000-0000-0000-000000000000

GET Request

https://<consoleFQDN:port>/st/console/api/v1.0/contentlesspatchgroups/groups/1

GET Request

https://<consoleFQDN:port>/st/console/api/v1.0/contentlesspatchgroups/groups/1/patches

GET Request

https://<consoleFQDN:port>/st/console/api/v1.0/contentlesspatchgroups/groups/1/usedby

POST Request

Copy 
https://<consoleFQDN:port>/st/console/api/v1.0/contentlesspatchgroups/groups

{
    "name": "SampleGroup",
    "Description": "A sample group created via the REST API"
}

POST Request

Copy 
https://<consoleFQDN:port>/st/console/api/v1.0/contentlesspatchgroups/groups/1/patches

{
    "advisories":["ELBA-2022-10077","ELBA-2022-2334"],
    "packages":["adcli-0.9.2-1.el9.x86_64.rpm","bc-1.07.1-14.el9.x86_64.rpm"],

}

PUT Request

Copy 
https://<consoleFQDN:port>/st/console/api/v1.0/contentlesspatchgroups/groups/1

{
    "name": "New Name"
}

For a fuller understanding of how to create and use a contentless Linux patch group, see PowerShell Example: Create and Install an Agent.

Output Models

Name Type Description

id

String

Patch group ID.

links

Links

Links for the patch group.

name

String

Specifies the patch group name.

path

String

The path that describes the location of the group within the contentless Linux Patch Groups list in the navigation pane.
Name Type Description

links

Links

Links for the patch.

patchId

Guid

The unique ID for the patch.
Name Type Description

name

String

Specifies the name of the contentless Linux patch scan configuration.

usageType

Enum

The component type that use the contentless Linux patch group.