As of January 1, 2020 this library no longer supports Python 2 on the latest released version.
Library versions released prior to that date will continue to be available. For more information please
visit Python 2 support on Google Cloud.
Source code for grafeas.grafeas_v1.types.upgrade
# -*- coding: utf-8 -*-
# Copyright 2024 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
from __future__ import annotations
from typing import MutableMapping, MutableSequence
from google.protobuf import timestamp_pb2 # type: ignore
import proto # type: ignore
from grafeas.grafeas_v1.types import package as g_package
__protobuf__ = proto.module(
package="grafeas.v1",
manifest={
"UpgradeNote",
"UpgradeDistribution",
"WindowsUpdate",
"UpgradeOccurrence",
},
)
[docs]class UpgradeNote(proto.Message):
r"""An Upgrade Note represents a potential upgrade of a package to a
given version. For each package version combination (i.e. bash 4.0,
bash 4.1, bash 4.1.2), there will be an Upgrade Note. For Windows,
windows_update field represents the information related to the
update.
Attributes:
package (str):
Required for non-Windows OS. The package this
Upgrade is for.
version (grafeas.grafeas_v1.types.Version):
Required for non-Windows OS. The version of
the package in machine + human readable form.
distributions (MutableSequence[grafeas.grafeas_v1.types.UpgradeDistribution]):
Metadata about the upgrade for each specific
operating system.
windows_update (grafeas.grafeas_v1.types.WindowsUpdate):
Required for Windows OS. Represents the
metadata about the Windows update.
"""
package: str = proto.Field(
proto.STRING,
number=1,
)
version: g_package.Version = proto.Field(
proto.MESSAGE,
number=2,
message=g_package.Version,
)
distributions: MutableSequence["UpgradeDistribution"] = proto.RepeatedField(
proto.MESSAGE,
number=3,
message="UpgradeDistribution",
)
windows_update: "WindowsUpdate" = proto.Field(
proto.MESSAGE,
number=4,
message="WindowsUpdate",
)
[docs]class UpgradeDistribution(proto.Message):
r"""The Upgrade Distribution represents metadata about the
Upgrade for each operating system (CPE). Some distributions have
additional metadata around updates, classifying them into
various categories and severities.
Attributes:
cpe_uri (str):
Required - The specific operating system this
metadata applies to. See
https://cpe.mitre.org/specification/.
classification (str):
The operating system classification of this Upgrade, as
specified by the upstream operating system upgrade feed. For
Windows the classification is one of the category_ids listed
at
https://docs.microsoft.com/en-us/previous-versions/windows/desktop/ff357803(v=vs.85)
severity (str):
The severity as specified by the upstream
operating system.
cve (MutableSequence[str]):
The cve tied to this Upgrade.
"""
cpe_uri: str = proto.Field(
proto.STRING,
number=1,
)
classification: str = proto.Field(
proto.STRING,
number=2,
)
severity: str = proto.Field(
proto.STRING,
number=3,
)
cve: MutableSequence[str] = proto.RepeatedField(
proto.STRING,
number=4,
)
[docs]class WindowsUpdate(proto.Message):
r"""Windows Update represents the metadata about the update for
the Windows operating system. The fields in this message come
from the Windows Update API documented at
https://docs.microsoft.com/en-us/windows/win32/api/wuapi/nn-wuapi-iupdate.
Attributes:
identity (grafeas.grafeas_v1.types.WindowsUpdate.Identity):
Required - The unique identifier for the
update.
title (str):
The localized title of the update.
description (str):
The localized description of the update.
categories (MutableSequence[grafeas.grafeas_v1.types.WindowsUpdate.Category]):
The list of categories to which the update
belongs.
kb_article_ids (MutableSequence[str]):
The Microsoft Knowledge Base article IDs that
are associated with the update.
support_url (str):
The hyperlink to the support information for
the update.
last_published_timestamp (google.protobuf.timestamp_pb2.Timestamp):
The last published timestamp of the update.
"""
[docs] class Identity(proto.Message):
r"""The unique identifier of the update.
Attributes:
update_id (str):
The revision independent identifier of the
update.
revision (int):
The revision number of the update.
"""
update_id: str = proto.Field(
proto.STRING,
number=1,
)
revision: int = proto.Field(
proto.INT32,
number=2,
)
[docs] class Category(proto.Message):
r"""The category to which the update belongs.
Attributes:
category_id (str):
The identifier of the category.
name (str):
The localized name of the category.
"""
category_id: str = proto.Field(
proto.STRING,
number=1,
)
name: str = proto.Field(
proto.STRING,
number=2,
)
identity: Identity = proto.Field(
proto.MESSAGE,
number=1,
message=Identity,
)
title: str = proto.Field(
proto.STRING,
number=2,
)
description: str = proto.Field(
proto.STRING,
number=3,
)
categories: MutableSequence[Category] = proto.RepeatedField(
proto.MESSAGE,
number=4,
message=Category,
)
kb_article_ids: MutableSequence[str] = proto.RepeatedField(
proto.STRING,
number=5,
)
support_url: str = proto.Field(
proto.STRING,
number=6,
)
last_published_timestamp: timestamp_pb2.Timestamp = proto.Field(
proto.MESSAGE,
number=7,
message=timestamp_pb2.Timestamp,
)
[docs]class UpgradeOccurrence(proto.Message):
r"""An Upgrade Occurrence represents that a specific resource_url could
install a specific upgrade. This presence is supplied via local
sources (i.e. it is present in the mirror and the running system has
noticed its availability). For Windows, both distribution and
windows_update contain information for the Windows update.
Attributes:
package (str):
Required for non-Windows OS. The package this
Upgrade is for.
parsed_version (grafeas.grafeas_v1.types.Version):
Required for non-Windows OS. The version of
the package in a machine + human readable form.
distribution (grafeas.grafeas_v1.types.UpgradeDistribution):
Metadata about the upgrade for available for the specific
operating system for the resource_url. This allows efficient
filtering, as well as making it easier to use the
occurrence.
windows_update (grafeas.grafeas_v1.types.WindowsUpdate):
Required for Windows OS. Represents the
metadata about the Windows update.
"""
package: str = proto.Field(
proto.STRING,
number=1,
)
parsed_version: g_package.Version = proto.Field(
proto.MESSAGE,
number=3,
message=g_package.Version,
)
distribution: "UpgradeDistribution" = proto.Field(
proto.MESSAGE,
number=4,
message="UpgradeDistribution",
)
windows_update: "WindowsUpdate" = proto.Field(
proto.MESSAGE,
number=5,
message="WindowsUpdate",
)
__all__ = tuple(sorted(__protobuf__.manifest))
