[ aws . ssm ]

get-default-patch-baseline

Description

Retrieves the default patch baseline. Amazon Web Services Systems Manager supports creating multiple default patch baselines. For example, you can create a default patch baseline for each operating system.

If you don’t specify an operating system value, the default patch baseline for Windows is returned.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  get-default-patch-baseline
[--operating-system <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--operating-system (string)

Returns the default patch baseline for the specified operating system.

Possible values:

  • WINDOWS

  • AMAZON_LINUX

  • AMAZON_LINUX_2

  • UBUNTU

  • REDHAT_ENTERPRISE_LINUX

  • SUSE

  • CENTOS

  • ORACLE_LINUX

  • DEBIAN

  • MACOS

  • RASPBIAN

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Examples

Example 1: To display the default Windows patch baseline

The following get-default-patch-baseline example retrieves details for the default patch baseline for Windows Server.

aws ssm get-default-patch-baseline

Output:

{
  "BaselineId": "pb-0713accee01612345",
  "OperatingSystem": "WINDOWS"
}

Example 2: To display the default patch baseline for Amazon Linux

The following get-default-patch-baseline example retrieves details for the default patch baseline for Amazon Linux.

aws ssm get-default-patch-baseline \
    --operating-system AMAZON_LINUX

Output:

{
    "BaselineId": "pb-047c6eb9c8fc12345",
    "OperatingSystem": "AMAZON_LINUX"
}

For more information, see About Predefined and Custom Patch Baselines <https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-patch-baselines.html>__ and Set an Existing Patch Baseline as the Default in the AWS Systems Manager User Guide.

Output

BaselineId -> (string)

The ID of the default patch baseline.

OperatingSystem -> (string)

The operating system for the returned patch baseline.