Lists the properties of available patches organized by product, product family, classification, severity, and other properties of available patches. You can use the reported properties in the filters you specify in requests for operations such as CreatePatchBaseline, UpdatePatchBaseline, DescribeAvailablePatches, and DescribePatchBaselines.
The following section lists the properties that can be used in filters for each major operating system type:
- AMAZON_LINUX
-
Valid properties: PRODUCT | CLASSIFICATION | SEVERITY
- AMAZON_LINUX_2
-
Valid properties: PRODUCT | CLASSIFICATION | SEVERITY
- AMAZON_LINUX_2023
-
Valid properties: PRODUCT | CLASSIFICATION | SEVERITY
- CENTOS
-
Valid properties: PRODUCT | CLASSIFICATION | SEVERITY
- DEBIAN
-
Valid properties: PRODUCT | PRIORITY
- MACOS
-
Valid properties: PRODUCT | CLASSIFICATION
- ORACLE_LINUX
-
Valid properties: PRODUCT | CLASSIFICATION | SEVERITY
- REDHAT_ENTERPRISE_LINUX
-
Valid properties: PRODUCT | CLASSIFICATION | SEVERITY
- SUSE
-
Valid properties: PRODUCT | CLASSIFICATION | SEVERITY
- UBUNTU
-
Valid properties: PRODUCT | PRIORITY
- WINDOWS
-
Valid properties: PRODUCT | PRODUCT_FAMILY | CLASSIFICATION | MSRC_SEVERITY
Parameters:
-
operating_system
(OperatingSystem)
–
The operating system type for which to list patches.
-
property
(PatchProperty)
–
The patch property for which you want to view patch details.
-
patch_set
(Optional[PatchSet], default:
None
)
–
Indicates whether to list patches for the Windows operating system or for applications released by Microsoft. Not applicable for the Linux or macOS operating systems.
-
max_results
(Optional[MaxResults], default:
None
)
–
The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.
-
next_token
(Optional[NextToken], default:
None
)
–
The token for the next set of items to return. (You received this token from a previous call.)
Raises:
Source code in docs_src/capo_ssm/_services/async_ssm.py
| async def describe_patch_properties(
self,
operating_system: "capo_ssm.types.operating_system.OperatingSystem",
property: "capo_ssm.types.patch_property.PatchProperty",
*,
config_overrides: Optional[AsyncSSMClientConfig] = None,
patch_set: Optional["capo_ssm.types.patch_set.PatchSet"] = None,
max_results: Optional["capo_ssm.types.max_results.MaxResults"] = None,
next_token: Optional["capo_ssm.types.next_token.NextToken"] = None,
) -> (
"capo_ssm.types.describe_patch_properties_result.DescribePatchPropertiesResult"
):
"""<p>Lists the properties of available patches organized by product, product family, classification, severity, and other properties of available patches. You can use the reported properties in the filters you specify in requests for operations such as <a>CreatePatchBaseline</a>, <a>UpdatePatchBaseline</a>, <a>DescribeAvailablePatches</a>, and <a>DescribePatchBaselines</a>.</p> <p>The following section lists the properties that can be used in filters for each major operating system type:</p> <dl> <dt>AMAZON_LINUX</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> | <code>SEVERITY</code> </p> </dd> <dt>AMAZON_LINUX_2</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> | <code>SEVERITY</code> </p> </dd> <dt>AMAZON_LINUX_2023</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> | <code>SEVERITY</code> </p> </dd> <dt>CENTOS</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> | <code>SEVERITY</code> </p> </dd> <dt>DEBIAN</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>PRIORITY</code> </p> </dd> <dt>MACOS</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> </p> </dd> <dt>ORACLE_LINUX</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> | <code>SEVERITY</code> </p> </dd> <dt>REDHAT_ENTERPRISE_LINUX</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> | <code>SEVERITY</code> </p> </dd> <dt>SUSE</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>CLASSIFICATION</code> | <code>SEVERITY</code> </p> </dd> <dt>UBUNTU</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>PRIORITY</code> </p> </dd> <dt>WINDOWS</dt> <dd> <p>Valid properties: <code>PRODUCT</code> | <code>PRODUCT_FAMILY</code> | <code>CLASSIFICATION</code> | <code>MSRC_SEVERITY</code> </p> </dd> </dl>
Args:
operating_system: <p>The operating system type for which to list patches.</p>
property: <p>The patch property for which you want to view patch details. </p>
patch_set: <p>Indicates whether to list patches for the Windows operating system or for applications released by Microsoft. Not applicable for the Linux or macOS operating systems.</p>
max_results: <p>The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.</p>
next_token: <p>The token for the next set of items to return. (You received this token from a previous call.)</p>
Raises:
capo_ssm.errors.internal_server_error.InternalServerError: <p>An error occurred on the server side.</p>
capo_ssm.errors.UnknownServiceError: The service returned an error code this client does not model.
"""
async def _handler(
req: "AsyncOperationRequest[capo_ssm.types.describe_patch_properties_request.DescribePatchPropertiesRequest]",
) -> AsyncOperationResponse[
"capo_ssm.types.describe_patch_properties_result.DescribePatchPropertiesResult"
]:
import capo_ssm._operations.amazon_ssm.describe_patch_properties
(
output,
http_response,
) = await capo_ssm._operations.amazon_ssm.describe_patch_properties.async_describe_patch_properties(
req.options, req.input
)
return AsyncOperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("DescribePatchProperties")
)
input_: capo_ssm.types.describe_patch_properties_request.DescribePatchPropertiesRequest = {
"operating_system": operating_system,
"property": property,
}
if patch_set is not None:
input_["patch_set"] = patch_set
if max_results is not None:
input_["max_results"] = max_results
if next_token is not None:
input_["next_token"] = next_token
response = await aexecute_pipeline(
AsyncOperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
await response.response.aclose()
return response.output
|