diff --git a/discovery/osconfig-v1.json b/discovery/osconfig-v1.json index 4127b24d71f..68bd3570445 100644 --- a/discovery/osconfig-v1.json +++ b/discovery/osconfig-v1.json @@ -11,10 +11,10 @@ "basePath": "", "baseUrl": "https://osconfig.googleapis.com/", "batchPath": "batch", - "canonicalName": "Systems Management", + "canonicalName": "OS Config", "description": "OS management tools that can be used for patch management, patch compliance, and configuration management on VM instances.", "discoveryVersion": "v1", - "documentationLink": "https://cloud.google.com/", + "documentationLink": "https://cloud.google.com/compute/docs/manage-os", "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -406,7 +406,7 @@ } } }, - "revision": "20200807", + "revision": "20200930", "rootUrl": "https://osconfig.googleapis.com/", "schemas": { "AptSettings": { @@ -456,67 +456,6 @@ "properties": {}, "type": "object" }, - "ExecResource": { - "description": "A resource that contains custom validation and enforcement steps.", - "id": "ExecResource", - "properties": { - "enforce": { - "$ref": "ExecResourceExec", - "description": "What to run to bring this resource into the desired state. Optional if policy is in validate only mode." - }, - "validate": { - "$ref": "ExecResourceExec", - "description": "What to run to validate this resource is in the desired state. A successful exit code indicates resource is in the desired state." - } - }, - "type": "object" - }, - "ExecResourceExec": { - "description": "A file or script to execute.", - "id": "ExecResourceExec", - "properties": { - "allowedSuccessCodes": { - "description": "Exit codes that indicate success.", - "items": { - "format": "int32", - "type": "integer" - }, - "type": "array" - }, - "args": { - "description": "Arguments to use.", - "items": { - "type": "string" - }, - "type": "array" - }, - "file": { - "$ref": "File", - "description": "A remote or local file." - }, - "interpreter": { - "description": "The script interpreter to use.", - "enum": [ - "INTERPRETER_UNSPECIFIED", - "NONE", - "SHELL", - "POWERSHELL" - ], - "enumDescriptions": [ - "Defaults to NONE.", - "If no interpreter is specified the source will be executed directly, which will likely only succeed for executables and scripts with shebang lines. [Wikipedia shebang](https://en.wikipedia.org/wiki/Shebang_(Unix)).", - "Indicates that the script will be run with /bin/sh on Linux and cmd.exe on windows.", - "Indicates that the script will be run with powershell." - ], - "type": "string" - }, - "script": { - "description": "An inline script.", - "type": "string" - } - }, - "type": "object" - }, "ExecStep": { "description": "A step that runs an executable for a PatchJob.", "id": "ExecStep", @@ -605,148 +544,6 @@ }, "type": "object" }, - "ExtractArchiveResource": { - "description": "A resource that extracts an archive", - "id": "ExtractArchiveResource", - "properties": { - "creates": { - "description": "Local file path that signals this resource is in the desired state. The absence of this file will indicate whether the archive needs to be extracted.", - "type": "string" - }, - "destination": { - "description": "Directory to extract archive to.", - "type": "string" - }, - "overwrite": { - "description": "Whether to overwrite existing files during extraction. If this is set to true, any existing files in the destination location will be overwritten by the extraction.", - "type": "boolean" - }, - "source": { - "$ref": "File", - "description": "The source archive to extract." - }, - "type": { - "description": "The type of the archive to extract.", - "enum": [ - "ARCHIVE_TYPE_UNSPECIFIED", - "TAR", - "TAR_GZIP", - "TAR_BZIP", - "TAR_LZMA", - "TAR_XZ", - "ZIP" - ], - "enumDescriptions": [ - "Unspecified is invalid.", - "Indicates that the archive is a tar archive with no encryption.", - "Indicates that the archive is a tar archive with gzip encryption.", - "Indicates that the archive is a tar archive with bzip encryption.", - "Indicates that the archive is a tar archive with lzma encryption.", - "Indicates that the archive is a tar archive with xz encryption.", - "Indicates that the archive is a zip archive." - ], - "type": "string" - } - }, - "type": "object" - }, - "File": { - "description": "A remote or local file.", - "id": "File", - "properties": { - "allowInsecure": { - "description": "Defaults to false. When false, files will be subject to validations based on the file type: Remote: A checksum must be specified. GCS: An object generation number must be specified.", - "type": "boolean" - }, - "gcs": { - "$ref": "FileGcs", - "description": "A GCS object." - }, - "localPath": { - "description": "A local path to use.", - "type": "string" - }, - "remote": { - "$ref": "FileRemote", - "description": "A generic remote file." - } - }, - "type": "object" - }, - "FileGcs": { - "description": "Specifies a file available as a GCS Object.", - "id": "FileGcs", - "properties": { - "bucket": { - "description": "Bucket of the GCS object.", - "type": "string" - }, - "generation": { - "description": "Generation number of the GCS object.", - "format": "int64", - "type": "string" - }, - "object": { - "description": "Name of the GCS object.", - "type": "string" - } - }, - "type": "object" - }, - "FileRemote": { - "description": "Specifies a file available via some URI.", - "id": "FileRemote", - "properties": { - "sha256Checksum": { - "description": "SHA256 checksum of the remote file.", - "type": "string" - }, - "uri": { - "description": "URI from which to fetch the object. It should contain both the protocol and path following the format {protocol}://{location}.", - "type": "string" - } - }, - "type": "object" - }, - "FileResource": { - "description": "A resource that manages the state of a file.", - "id": "FileResource", - "properties": { - "content": { - "description": "A a file with this content.", - "type": "string" - }, - "file": { - "$ref": "File", - "description": "A remote or local source." - }, - "path": { - "description": "The absolute path of the file.", - "type": "string" - }, - "permissions": { - "description": "Consists of three octal digits which represent, in order, the permissions of the owner, group, and other users for the file (similarly to the numeric mode used in the linux chmod utility). Each digit represents a three bit number with the 4 bit corresponding to the read permissions, the 2 bit corresponds to the write bit, and the one bit corresponds to the execute permission. Default behavior is 755. Below are some examples of permissions and their associated values: read, write, and execute: 7 read and execute: 5 read and write: 6 read only: 4", - "type": "string" - }, - "state": { - "description": "Desired state of the file.", - "enum": [ - "DESIRED_STATE_UNSPECIFIED", - "PRESENT", - "ABSENT", - "CONTENTS_MATCH" - ], - "enumDescriptions": [ - "Unspecified is invalid.", - "Ensure file at path is present.", - "Ensure file at path is absent.", - "Ensure the contents of the file at path matches. If the file does not exist it will be created." - ], - "type": "string" - } - }, - "type": "object" - }, "FixedOrPercent": { "description": "Message encapsulating a value that can be either absolute (\"fixed\") or relative (\"percent\") to a value.", "id": "FixedOrPercent", @@ -872,155 +669,6 @@ }, "type": "object" }, - "PackageResource": { - "description": "A resource that manages a system package.", - "id": "PackageResource", - "properties": { - "apt": { - "$ref": "PackageResourceAPT", - "description": "A package managed by Apt." - }, - "deb": { - "$ref": "PackageResourceDeb", - "description": "A deb package file." - }, - "desiredState": { - "description": "The desired_state the agent should maintain for this package. The default is to ensure the package is installed.", - "enum": [ - "DESIRED_STATE_UNSPECIFIED", - "INSTALLED", - "REMOVED" - ], - "enumDescriptions": [ - "Unspecified is invalid.", - "Ensure that the package is installed.", - "The agent will ensure that the package is not installed and uninstall it if detected." - ], - "type": "string" - }, - "googet": { - "$ref": "PackageResourceGooGet", - "description": "A package managed by GooGet." - }, - "msi": { - "$ref": "PackageResourceMSI", - "description": "An MSI package." - }, - "rpm": { - "$ref": "PackageResourceRPM", - "description": "An rpm package file." - }, - "yum": { - "$ref": "PackageResourceYUM", - "description": "A package managed by YUM." - }, - "zypper": { - "$ref": "PackageResourceZypper", - "description": "A package managed by Zypper." - } - }, - "type": "object" - }, - "PackageResourceAPT": { - "description": "A package managed by APT. install: `apt-get update && apt-get -y install [name]` remove: `apt-get -y remove [name]`", - "id": "PackageResourceAPT", - "properties": { - "name": { - "description": "Package name.", - "type": "string" - } - }, - "type": "object" - }, - "PackageResourceDeb": { - "description": "A deb package file. dpkg packages only support INSTALLED state.", - "id": "PackageResourceDeb", - "properties": { - "pullDeps": { - "description": "Whether dependencies should also be installed. install when false: `dpkg -i package` install when true: `apt-get update && apt-get -y install package.deb`", - "type": "boolean" - }, - "source": { - "$ref": "File", - "description": "A deb package." - } - }, - "type": "object" - }, - "PackageResourceGooGet": { - "description": "A package managed by GooGet. install: `googet -noconfirm install package` remove: `googet -noconfirm remove package`", - "id": "PackageResourceGooGet", - "properties": { - "name": { - "description": "Package name.", - "type": "string" - } - }, - "type": "object" - }, - "PackageResourceMSI": { - "description": "An MSI package. MSI packages only support INSTALLED state. Install msiexec /i /qn /norestart", - "id": "PackageResourceMSI", - "properties": { - "allowedSuccessCodes": { - "description": "Return codes that indicate that the software installed or updated successfully. Behaviour defaults to [0]", - "items": { - "format": "int32", - "type": "integer" - }, - "type": "array" - }, - "flags": { - "description": "Flags to use during package install. Appended to the defalts of \"/i /qn /norestart\"", - "items": { - "type": "string" - }, - "type": "array" - }, - "source": { - "$ref": "File", - "description": "The MSI package." - } - }, - "type": "object" - }, - "PackageResourceRPM": { - "description": "An RPM package file. RPM packages only support INSTALLED state.", - "id": "PackageResourceRPM", - "properties": { - "pullDeps": { - "description": "Whether dependencies should also be installed. install when false: `rpm --upgrade --replacepkgs package.rpm` install when true: `yum -y install package.rpm` or `zypper -y install package.rpm`", - "type": "boolean" - }, - "source": { - "$ref": "File", - "description": "An rpm package." - } - }, - "type": "object" - }, - "PackageResourceYUM": { - "description": "A package managed by YUM. install: `yum -y install package` remove: `yum -y remove package`", - "id": "PackageResourceYUM", - "properties": { - "name": { - "description": "Package name.", - "type": "string" - } - }, - "type": "object" - }, - "PackageResourceZypper": { - "description": "A package managed by Zypper. install: `zypper -y install package` remove: `zypper -y rm package`", - "id": "PackageResourceZypper", - "properties": { - "name": { - "description": "Package name.", - "type": "string" - } - }, - "type": "object" - }, "PatchConfig": { "description": "Patch configuration specifications. Contains details on how to apply the patch(es) to a VM instance.", "id": "PatchConfig", @@ -1505,142 +1153,6 @@ }, "type": "object" }, - "RepositoryResource": { - "description": "A resource that manages a package repository.", - "id": "RepositoryResource", - "properties": { - "apt": { - "$ref": "RepositoryResourceAptRepository", - "description": "An Apt Repository." - }, - "goo": { - "$ref": "RepositoryResourceGooRepository", - "description": "A Goo Repository." - }, - "yum": { - "$ref": "RepositoryResourceYumRepository", - "description": "A Yum Repository." - }, - "zypper": { - "$ref": "RepositoryResourceZypperRepository", - "description": "A Zypper Repository." - } - }, - "type": "object" - }, - "RepositoryResourceAptRepository": { - "description": "Represents a single apt package repository. These will be added to a repo file that will be managed at /etc/apt/sources.list.d/google_osconfig.list.", - "id": "RepositoryResourceAptRepository", - "properties": { - "archiveType": { - "description": "Type of archive files in this repository. The default behavior is DEB.", - "enum": [ - "ARCHIVE_TYPE_UNSPECIFIED", - "DEB", - "DEB_SRC" - ], - "enumDescriptions": [ - "Unspecified is invalid.", - "Deb indicates that the archive contains binary files.", - "Deb-src indicates that the archive contains source files." - ], - "type": "string" - }, - "components": { - "description": "List of components for this repository. Must contain at least one item.", - "items": { - "type": "string" - }, - "type": "array" - }, - "distribution": { - "description": "Distribution of this repository.", - "type": "string" - }, - "gpgKey": { - "description": "URI of the key file for this repository. The agent will maintain a keyring at /etc/apt/trusted.gpg.d/osconfig_agent_managed.gpg.", - "type": "string" - }, - "uri": { - "description": "URI for this repository.", - "type": "string" - } - }, - "type": "object" - }, - "RepositoryResourceGooRepository": { - "description": "Represents a Goo package repository. These will be added to a repo file that will be managed at C:/ProgramData/GooGet/repos/google_osconfig.repo.", - "id": "RepositoryResourceGooRepository", - "properties": { - "name": { - "description": "The name of the repository.", - "type": "string" - }, - "url": { - "description": "The url of the repository.", - "type": "string" - } - }, - "type": "object" - }, - "RepositoryResourceYumRepository": { - "description": "Represents a single yum package repository. These will be added to a repo file that will be managed at /etc/yum.repos.d/google_osconfig.repo.", - "id": "RepositoryResourceYumRepository", - "properties": { - "baseUrl": { - "description": "The location of the repository directory.", - "type": "string" - }, - "displayName": { - "description": "The display name of the repository.", - "type": "string" - }, - "gpgKeys": { - "description": "URIs of GPG keys.", - "items": { - "type": "string" - }, - "type": "array" - }, - "id": { - "description": "A one word, unique name for this repository. This will be the `repo id` in the yum config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for resource conflicts.", - "type": "string" - } - }, - "type": "object" - }, - "RepositoryResourceZypperRepository": { - "description": "Represents a single zypper package repository. These will be added to a repo file that will be managed at /etc/zypp/repos.d/google_osconfig.repo.", - "id": "RepositoryResourceZypperRepository", - "properties": { - "baseUrl": { - "description": "The location of the repository directory.", - "type": "string" - }, - "displayName": { - "description": "The display name of the repository.", - "type": "string" - }, - "gpgKeys": { - "description": "URIs of GPG keys.", - "items": { - "type": "string" - }, - "type": "array" - }, - "id": { - "description": "A one word, unique name for this repository. This will be the `repo id` in the zypper config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for GuestPolicy conflicts.", - "type": "string" - } - }, - "type": "object" - }, - "ServiceResource": { - "description": "A resource that manages a system service.", - "id": "ServiceResource", - "properties": {}, - "type": "object" - }, "TimeOfDay": { "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "id": "TimeOfDay", @@ -1756,18 +1268,6 @@ "properties": { "classifications": { "description": "Only apply updates of these windows update classifications. If empty, all updates are applied.", - "enumDescriptions": [ - "Invalid. If classifications are included, they must be specified.", - "\"A widely released fix for a specific problem that addresses a critical, non-security-related bug.\" [1]", - "\"A widely released fix for a product-specific, security-related vulnerability. Security vulnerabilities are rated by their severity. The severity rating is indicated in the Microsoft security bulletin as critical, important, moderate, or low.\" [1]", - "\"A widely released and frequent software update that contains additions to a product's definition database. Definition databases are often used to detect objects that have specific attributes, such as malicious code, phishing websites, or junk mail.\" [1]", - "\"Software that controls the input and output of a device.\" [1]", - "\"New product functionality that is first distributed outside the context of a product release and that is typically included in the next full product release.\" [1]", - "\"A tested, cumulative set of all hotfixes, security updates, critical updates, and updates. Additionally, service packs may contain additional fixes for problems that are found internally since the release of the product. Service packs my also contain a limited number of customer-requested design changes or features.\" [1]", - "\"A utility or feature that helps complete a task or set of tasks.\" [1]", - "\"A tested, cumulative set of hotfixes, security updates, critical updates, and updates that are packaged together for easy deployment. A rollup generally targets a specific area, such as security, or a component of a product, such as Internet Information Services (IIS).\" [1]", - "\"A widely released fix for a specific problem. An update addresses a noncritical, non-security-related bug.\" [1]" - ], "items": { "enum": [ "CLASSIFICATION_UNSPECIFIED", @@ -1888,7 +1388,7 @@ } }, "servicePath": "", - "title": "Cloud OS Config API", + "title": "OS Config API", "version": "v1", "version_module": true } \ No newline at end of file diff --git a/discovery/osconfig-v1beta.json b/discovery/osconfig-v1beta.json index 42044a591d2..8ac6addd012 100644 --- a/discovery/osconfig-v1beta.json +++ b/discovery/osconfig-v1beta.json @@ -11,10 +11,10 @@ "basePath": "", "baseUrl": "https://osconfig.googleapis.com/", "batchPath": "batch", - "canonicalName": "Systems Management", + "canonicalName": "OS Config", "description": "OS management tools that can be used for patch management, patch compliance, and configuration management on VM instances.", "discoveryVersion": "v1", - "documentationLink": "https://cloud.google.com/", + "documentationLink": "https://cloud.google.com/compute/docs/manage-os", "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -599,7 +599,7 @@ } } }, - "revision": "20200807", + "revision": "20200930", "rootUrl": "https://osconfig.googleapis.com/", "schemas": { "AptRepository": { @@ -837,67 +837,6 @@ "properties": {}, "type": "object" }, - "ExecResource": { - "description": "A resource that contains custom validation and enforcement steps.", - "id": "ExecResource", - "properties": { - "enforce": { - "$ref": "ExecResourceExec", - "description": "What to run to bring this resource into the desired state. Optional if policy is in validate only mode." - }, - "validate": { - "$ref": "ExecResourceExec", - "description": "What to run to validate this resource is in the desired state. A successful exit code indicates resource is in the desired state." - } - }, - "type": "object" - }, - "ExecResourceExec": { - "description": "A file or script to execute.", - "id": "ExecResourceExec", - "properties": { - "allowedSuccessCodes": { - "description": "Exit codes that indicate success.", - "items": { - "format": "int32", - "type": "integer" - }, - "type": "array" - }, - "args": { - "description": "Arguments to use.", - "items": { - "type": "string" - }, - "type": "array" - }, - "file": { - "$ref": "File", - "description": "A remote or local file." - }, - "interpreter": { - "description": "The script interpreter to use.", - "enum": [ - "INTERPRETER_UNSPECIFIED", - "NONE", - "SHELL", - "POWERSHELL" - ], - "enumDescriptions": [ - "Defaults to NONE.", - "If no interpreter is specified the source will be executed directly, which will likely only succeed for executables and scripts with shebang lines. [Wikipedia shebang](https://en.wikipedia.org/wiki/Shebang_(Unix)).", - "Indicates that the script will be run with /bin/sh on Linux and cmd.exe on windows.", - "Indicates that the script will be run with powershell." - ], - "type": "string" - }, - "script": { - "description": "An inline script.", - "type": "string" - } - }, - "type": "object" - }, "ExecStep": { "description": "A step that runs an executable for a PatchJob.", "id": "ExecStep", @@ -986,148 +925,6 @@ }, "type": "object" }, - "ExtractArchiveResource": { - "description": "A resource that extracts an archive", - "id": "ExtractArchiveResource", - "properties": { - "creates": { - "description": "Local file path that signals this resource is in the desired state. The absence of this file will indicate whether the archive needs to be extracted.", - "type": "string" - }, - "destination": { - "description": "Directory to extract archive to.", - "type": "string" - }, - "overwrite": { - "description": "Whether to overwrite existing files during extraction. If this is set to true, any existing files in the destination location will be overwritten by the extraction.", - "type": "boolean" - }, - "source": { - "$ref": "File", - "description": "The source archive to extract." - }, - "type": { - "description": "The type of the archive to extract.", - "enum": [ - "ARCHIVE_TYPE_UNSPECIFIED", - "TAR", - "TAR_GZIP", - "TAR_BZIP", - "TAR_LZMA", - "TAR_XZ", - "ZIP" - ], - "enumDescriptions": [ - "Unspecified is invalid.", - "Indicates that the archive is a tar archive with no encryption.", - "Indicates that the archive is a tar archive with gzip encryption.", - "Indicates that the archive is a tar archive with bzip encryption.", - "Indicates that the archive is a tar archive with lzma encryption.", - "Indicates that the archive is a tar archive with xz encryption.", - "Indicates that the archive is a zip archive." - ], - "type": "string" - } - }, - "type": "object" - }, - "File": { - "description": "A remote or local file.", - "id": "File", - "properties": { - "allowInsecure": { - "description": "Defaults to false. When false, files will be subject to validations based on the file type: Remote: A checksum must be specified. GCS: An object generation number must be specified.", - "type": "boolean" - }, - "gcs": { - "$ref": "FileGcs", - "description": "A GCS object." - }, - "localPath": { - "description": "A local path to use.", - "type": "string" - }, - "remote": { - "$ref": "FileRemote", - "description": "A generic remote file." - } - }, - "type": "object" - }, - "FileGcs": { - "description": "Specifies a file available as a GCS Object.", - "id": "FileGcs", - "properties": { - "bucket": { - "description": "Bucket of the GCS object.", - "type": "string" - }, - "generation": { - "description": "Generation number of the GCS object.", - "format": "int64", - "type": "string" - }, - "object": { - "description": "Name of the GCS object.", - "type": "string" - } - }, - "type": "object" - }, - "FileRemote": { - "description": "Specifies a file available via some URI.", - "id": "FileRemote", - "properties": { - "sha256Checksum": { - "description": "SHA256 checksum of the remote file.", - "type": "string" - }, - "uri": { - "description": "URI from which to fetch the object. It should contain both the protocol and path following the format {protocol}://{location}.", - "type": "string" - } - }, - "type": "object" - }, - "FileResource": { - "description": "A resource that manages the state of a file.", - "id": "FileResource", - "properties": { - "content": { - "description": "A a file with this content.", - "type": "string" - }, - "file": { - "$ref": "File", - "description": "A remote or local source." - }, - "path": { - "description": "The absolute path of the file.", - "type": "string" - }, - "permissions": { - "description": "Consists of three octal digits which represent, in order, the permissions of the owner, group, and other users for the file (similarly to the numeric mode used in the linux chmod utility). Each digit represents a three bit number with the 4 bit corresponding to the read permissions, the 2 bit corresponds to the write bit, and the one bit corresponds to the execute permission. Default behavior is 755. Below are some examples of permissions and their associated values: read, write, and execute: 7 read and execute: 5 read and write: 6 read only: 4", - "type": "string" - }, - "state": { - "description": "Desired state of the file.", - "enum": [ - "DESIRED_STATE_UNSPECIFIED", - "PRESENT", - "ABSENT", - "CONTENTS_MATCH" - ], - "enumDescriptions": [ - "Unspecified is invalid.", - "Ensure file at path is present.", - "Ensure file at path is absent.", - "Ensure the contents of the file at path matches. If the file does not exist it will be created." - ], - "type": "string" - } - }, - "type": "object" - }, "FixedOrPercent": { "description": "Message encapsulating a value that can be either absolute (\"fixed\") or relative (\"percent\") to a value.", "id": "FixedOrPercent", @@ -1431,155 +1228,6 @@ }, "type": "object" }, - "PackageResource": { - "description": "A resource that manages a system package.", - "id": "PackageResource", - "properties": { - "apt": { - "$ref": "PackageResourceAPT", - "description": "A package managed by Apt." - }, - "deb": { - "$ref": "PackageResourceDeb", - "description": "A deb package file." - }, - "desiredState": { - "description": "The desired_state the agent should maintain for this package. The default is to ensure the package is installed.", - "enum": [ - "DESIRED_STATE_UNSPECIFIED", - "INSTALLED", - "REMOVED" - ], - "enumDescriptions": [ - "Unspecified is invalid.", - "Ensure that the package is installed.", - "The agent will ensure that the package is not installed and uninstall it if detected." - ], - "type": "string" - }, - "googet": { - "$ref": "PackageResourceGooGet", - "description": "A package managed by GooGet." - }, - "msi": { - "$ref": "PackageResourceMSI", - "description": "An MSI package." - }, - "rpm": { - "$ref": "PackageResourceRPM", - "description": "An rpm package file." - }, - "yum": { - "$ref": "PackageResourceYUM", - "description": "A package managed by YUM." - }, - "zypper": { - "$ref": "PackageResourceZypper", - "description": "A package managed by Zypper." - } - }, - "type": "object" - }, - "PackageResourceAPT": { - "description": "A package managed by APT. install: `apt-get update && apt-get -y install [name]` remove: `apt-get -y remove [name]`", - "id": "PackageResourceAPT", - "properties": { - "name": { - "description": "Package name.", - "type": "string" - } - }, - "type": "object" - }, - "PackageResourceDeb": { - "description": "A deb package file. dpkg packages only support INSTALLED state.", - "id": "PackageResourceDeb", - "properties": { - "pullDeps": { - "description": "Whether dependencies should also be installed. install when false: `dpkg -i package` install when true: `apt-get update && apt-get -y install package.deb`", - "type": "boolean" - }, - "source": { - "$ref": "File", - "description": "A deb package." - } - }, - "type": "object" - }, - "PackageResourceGooGet": { - "description": "A package managed by GooGet. install: `googet -noconfirm install package` remove: `googet -noconfirm remove package`", - "id": "PackageResourceGooGet", - "properties": { - "name": { - "description": "Package name.", - "type": "string" - } - }, - "type": "object" - }, - "PackageResourceMSI": { - "description": "An MSI package. MSI packages only support INSTALLED state. Install msiexec /i /qn /norestart", - "id": "PackageResourceMSI", - "properties": { - "allowedSuccessCodes": { - "description": "Return codes that indicate that the software installed or updated successfully. Behaviour defaults to [0]", - "items": { - "format": "int32", - "type": "integer" - }, - "type": "array" - }, - "flags": { - "description": "Flags to use during package install. Appended to the defalts of \"/i /qn /norestart\"", - "items": { - "type": "string" - }, - "type": "array" - }, - "source": { - "$ref": "File", - "description": "The MSI package." - } - }, - "type": "object" - }, - "PackageResourceRPM": { - "description": "An RPM package file. RPM packages only support INSTALLED state.", - "id": "PackageResourceRPM", - "properties": { - "pullDeps": { - "description": "Whether dependencies should also be installed. install when false: `rpm --upgrade --replacepkgs package.rpm` install when true: `yum -y install package.rpm` or `zypper -y install package.rpm`", - "type": "boolean" - }, - "source": { - "$ref": "File", - "description": "An rpm package." - } - }, - "type": "object" - }, - "PackageResourceYUM": { - "description": "A package managed by YUM. install: `yum -y install package` remove: `yum -y remove package`", - "id": "PackageResourceYUM", - "properties": { - "name": { - "description": "Package name.", - "type": "string" - } - }, - "type": "object" - }, - "PackageResourceZypper": { - "description": "A package managed by Zypper. install: `zypper -y install package` remove: `zypper -y rm package`", - "id": "PackageResourceZypper", - "properties": { - "name": { - "description": "Package name.", - "type": "string" - } - }, - "type": "object" - }, "PatchConfig": { "description": "Patch configuration specifications. Contains details on how to apply the patch(es) to a VM instance.", "id": "PatchConfig", @@ -2064,142 +1712,6 @@ }, "type": "object" }, - "RepositoryResource": { - "description": "A resource that manages a package repository.", - "id": "RepositoryResource", - "properties": { - "apt": { - "$ref": "RepositoryResourceAptRepository", - "description": "An Apt Repository." - }, - "goo": { - "$ref": "RepositoryResourceGooRepository", - "description": "A Goo Repository." - }, - "yum": { - "$ref": "RepositoryResourceYumRepository", - "description": "A Yum Repository." - }, - "zypper": { - "$ref": "RepositoryResourceZypperRepository", - "description": "A Zypper Repository." - } - }, - "type": "object" - }, - "RepositoryResourceAptRepository": { - "description": "Represents a single apt package repository. These will be added to a repo file that will be managed at /etc/apt/sources.list.d/google_osconfig.list.", - "id": "RepositoryResourceAptRepository", - "properties": { - "archiveType": { - "description": "Type of archive files in this repository. The default behavior is DEB.", - "enum": [ - "ARCHIVE_TYPE_UNSPECIFIED", - "DEB", - "DEB_SRC" - ], - "enumDescriptions": [ - "Unspecified is invalid.", - "Deb indicates that the archive contains binary files.", - "Deb-src indicates that the archive contains source files." - ], - "type": "string" - }, - "components": { - "description": "List of components for this repository. Must contain at least one item.", - "items": { - "type": "string" - }, - "type": "array" - }, - "distribution": { - "description": "Distribution of this repository.", - "type": "string" - }, - "gpgKey": { - "description": "URI of the key file for this repository. The agent will maintain a keyring at /etc/apt/trusted.gpg.d/osconfig_agent_managed.gpg.", - "type": "string" - }, - "uri": { - "description": "URI for this repository.", - "type": "string" - } - }, - "type": "object" - }, - "RepositoryResourceGooRepository": { - "description": "Represents a Goo package repository. These will be added to a repo file that will be managed at C:/ProgramData/GooGet/repos/google_osconfig.repo.", - "id": "RepositoryResourceGooRepository", - "properties": { - "name": { - "description": "The name of the repository.", - "type": "string" - }, - "url": { - "description": "The url of the repository.", - "type": "string" - } - }, - "type": "object" - }, - "RepositoryResourceYumRepository": { - "description": "Represents a single yum package repository. These will be added to a repo file that will be managed at /etc/yum.repos.d/google_osconfig.repo.", - "id": "RepositoryResourceYumRepository", - "properties": { - "baseUrl": { - "description": "The location of the repository directory.", - "type": "string" - }, - "displayName": { - "description": "The display name of the repository.", - "type": "string" - }, - "gpgKeys": { - "description": "URIs of GPG keys.", - "items": { - "type": "string" - }, - "type": "array" - }, - "id": { - "description": "A one word, unique name for this repository. This will be the `repo id` in the yum config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for resource conflicts.", - "type": "string" - } - }, - "type": "object" - }, - "RepositoryResourceZypperRepository": { - "description": "Represents a single zypper package repository. These will be added to a repo file that will be managed at /etc/zypp/repos.d/google_osconfig.repo.", - "id": "RepositoryResourceZypperRepository", - "properties": { - "baseUrl": { - "description": "The location of the repository directory.", - "type": "string" - }, - "displayName": { - "description": "The display name of the repository.", - "type": "string" - }, - "gpgKeys": { - "description": "URIs of GPG keys.", - "items": { - "type": "string" - }, - "type": "array" - }, - "id": { - "description": "A one word, unique name for this repository. This will be the `repo id` in the zypper config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for GuestPolicy conflicts.", - "type": "string" - } - }, - "type": "object" - }, - "ServiceResource": { - "description": "A resource that manages a system service.", - "id": "ServiceResource", - "properties": {}, - "type": "object" - }, "SoftwareRecipe": { "description": "A software recipe is a set of instructions for installing and configuring a piece of software. It consists of a set of artifacts that are downloaded, and a set of steps that install, configure, and/or update the software. Recipes support installing and updating software from artifacts in the following formats: Zip archive, Tar archive, Windows MSI, Debian package, and RPM package. Additionally, recipes support executing a script (either defined in a file or directly in this api) in bash, sh, cmd, and powershell. Updating a software recipe If a recipe is assigned to an instance and there is a recipe with the same name but a lower version already installed and the assigned state of the recipe is `UPDATED`, then the recipe is updated to the new version. Script Working Directories Each script or execution step is run in its own temporary directory which is deleted after completing the step.", "id": "SoftwareRecipe", @@ -2631,18 +2143,6 @@ "properties": { "classifications": { "description": "Only apply updates of these windows update classifications. If empty, all updates are applied.", - "enumDescriptions": [ - "Invalid. If classifications are included, they must be specified.", - "\"A widely released fix for a specific problem that addresses a critical, non-security-related bug.\" [1]", - "\"A widely released fix for a product-specific, security-related vulnerability. Security vulnerabilities are rated by their severity. The severity rating is indicated in the Microsoft security bulletin as critical, important, moderate, or low.\" [1]", - "\"A widely released and frequent software update that contains additions to a product's definition database. Definition databases are often used to detect objects that have specific attributes, such as malicious code, phishing websites, or junk mail.\" [1]", - "\"Software that controls the input and output of a device.\" [1]", - "\"New product functionality that is first distributed outside the context of a product release and that is typically included in the next full product release.\" [1]", - "\"A tested, cumulative set of all hotfixes, security updates, critical updates, and updates. Additionally, service packs may contain additional fixes for problems that are found internally since the release of the product. Service packs my also contain a limited number of customer-requested design changes or features.\" [1]", - "\"A utility or feature that helps complete a task or set of tasks.\" [1]", - "\"A tested, cumulative set of hotfixes, security updates, critical updates, and updates that are packaged together for easy deployment. A rollup generally targets a specific area, such as security, or a component of a product, such as Internet Information Services (IIS).\" [1]", - "\"A widely released fix for a specific problem. An update addresses a noncritical, non-security-related bug.\" [1]" - ], "items": { "enum": [ "CLASSIFICATION_UNSPECIFIED", @@ -2815,7 +2315,7 @@ } }, "servicePath": "", - "title": "Cloud OS Config API", + "title": "OS Config API", "version": "v1beta", "version_module": true } \ No newline at end of file diff --git a/src/apis/osconfig/v1.ts b/src/apis/osconfig/v1.ts index 91d6dc71f7f..e0ebe924dbe 100644 --- a/src/apis/osconfig/v1.ts +++ b/src/apis/osconfig/v1.ts @@ -99,7 +99,7 @@ export namespace osconfig_v1 { } /** - * Cloud OS Config API + * OS Config API * * OS management tools that can be used for patch management, patch compliance, and configuration management on VM instances. * @@ -152,44 +152,6 @@ export namespace osconfig_v1 { * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`. */ export interface Schema$Empty {} - /** - * A resource that contains custom validation and enforcement steps. - */ - export interface Schema$ExecResource { - /** - * What to run to bring this resource into the desired state. Optional if policy is in validate only mode. - */ - enforce?: Schema$ExecResourceExec; - /** - * What to run to validate this resource is in the desired state. A successful exit code indicates resource is in the desired state. - */ - validate?: Schema$ExecResourceExec; - } - /** - * A file or script to execute. - */ - export interface Schema$ExecResourceExec { - /** - * Exit codes that indicate success. - */ - allowedSuccessCodes?: number[] | null; - /** - * Arguments to use. - */ - args?: string[] | null; - /** - * A remote or local file. - */ - file?: Schema$File; - /** - * The script interpreter to use. - */ - interpreter?: string | null; - /** - * An inline script. - */ - script?: string | null; - } /** * A step that runs an executable for a PatchJob. */ @@ -257,107 +219,6 @@ export namespace osconfig_v1 { */ rollout?: Schema$PatchRollout; } - /** - * A resource that extracts an archive - */ - export interface Schema$ExtractArchiveResource { - /** - * Local file path that signals this resource is in the desired state. The absence of this file will indicate whether the archive needs to be extracted. - */ - creates?: string | null; - /** - * Directory to extract archive to. - */ - destination?: string | null; - /** - * Whether to overwrite existing files during extraction. If this is set to true, any existing files in the destination location will be overwritten by the extraction. - */ - overwrite?: boolean | null; - /** - * The source archive to extract. - */ - source?: Schema$File; - /** - * The type of the archive to extract. - */ - type?: string | null; - } - /** - * A remote or local file. - */ - export interface Schema$File { - /** - * Defaults to false. When false, files will be subject to validations based on the file type: Remote: A checksum must be specified. GCS: An object generation number must be specified. - */ - allowInsecure?: boolean | null; - /** - * A GCS object. - */ - gcs?: Schema$FileGcs; - /** - * A local path to use. - */ - localPath?: string | null; - /** - * A generic remote file. - */ - remote?: Schema$FileRemote; - } - /** - * Specifies a file available as a GCS Object. - */ - export interface Schema$FileGcs { - /** - * Bucket of the GCS object. - */ - bucket?: string | null; - /** - * Generation number of the GCS object. - */ - generation?: string | null; - /** - * Name of the GCS object. - */ - object?: string | null; - } - /** - * Specifies a file available via some URI. - */ - export interface Schema$FileRemote { - /** - * SHA256 checksum of the remote file. - */ - sha256Checksum?: string | null; - /** - * URI from which to fetch the object. It should contain both the protocol and path following the format {protocol}://{location}. - */ - uri?: string | null; - } - /** - * A resource that manages the state of a file. - */ - export interface Schema$FileResource { - /** - * A a file with this content. - */ - content?: string | null; - /** - * A remote or local source. - */ - file?: Schema$File; - /** - * The absolute path of the file. - */ - path?: string | null; - /** - * Consists of three octal digits which represent, in order, the permissions of the owner, group, and other users for the file (similarly to the numeric mode used in the linux chmod utility). Each digit represents a three bit number with the 4 bit corresponding to the read permissions, the 2 bit corresponds to the write bit, and the one bit corresponds to the execute permission. Default behavior is 755. Below are some examples of permissions and their associated values: read, write, and execute: 7 read and execute: 5 read and write: 6 read only: 4 - */ - permissions?: string | null; - /** - * Desired state of the file. - */ - state?: string | null; - } /** * Message encapsulating a value that can be either absolute ("fixed") or relative ("percent") to a value. */ @@ -453,122 +314,6 @@ export namespace osconfig_v1 { */ executeTime?: string | null; } - /** - * A resource that manages a system package. - */ - export interface Schema$PackageResource { - /** - * A package managed by Apt. - */ - apt?: Schema$PackageResourceAPT; - /** - * A deb package file. - */ - deb?: Schema$PackageResourceDeb; - /** - * The desired_state the agent should maintain for this package. The default is to ensure the package is installed. - */ - desiredState?: string | null; - /** - * A package managed by GooGet. - */ - googet?: Schema$PackageResourceGooGet; - /** - * An MSI package. - */ - msi?: Schema$PackageResourceMSI; - /** - * An rpm package file. - */ - rpm?: Schema$PackageResourceRPM; - /** - * A package managed by YUM. - */ - yum?: Schema$PackageResourceYUM; - /** - * A package managed by Zypper. - */ - zypper?: Schema$PackageResourceZypper; - } - /** - * A package managed by APT. install: `apt-get update && apt-get -y install [name]` remove: `apt-get -y remove [name]` - */ - export interface Schema$PackageResourceAPT { - /** - * Package name. - */ - name?: string | null; - } - /** - * A deb package file. dpkg packages only support INSTALLED state. - */ - export interface Schema$PackageResourceDeb { - /** - * Whether dependencies should also be installed. install when false: `dpkg -i package` install when true: `apt-get update && apt-get -y install package.deb` - */ - pullDeps?: boolean | null; - /** - * A deb package. - */ - source?: Schema$File; - } - /** - * A package managed by GooGet. install: `googet -noconfirm install package` remove: `googet -noconfirm remove package` - */ - export interface Schema$PackageResourceGooGet { - /** - * Package name. - */ - name?: string | null; - } - /** - * An MSI package. MSI packages only support INSTALLED state. Install msiexec /i /qn /norestart - */ - export interface Schema$PackageResourceMSI { - /** - * Return codes that indicate that the software installed or updated successfully. Behaviour defaults to [0] - */ - allowedSuccessCodes?: number[] | null; - /** - * Flags to use during package install. Appended to the defalts of "/i /qn /norestart" - */ - flags?: string[] | null; - /** - * The MSI package. - */ - source?: Schema$File; - } - /** - * An RPM package file. RPM packages only support INSTALLED state. - */ - export interface Schema$PackageResourceRPM { - /** - * Whether dependencies should also be installed. install when false: `rpm --upgrade --replacepkgs package.rpm` install when true: `yum -y install package.rpm` or `zypper -y install package.rpm` - */ - pullDeps?: boolean | null; - /** - * An rpm package. - */ - source?: Schema$File; - } - /** - * A package managed by YUM. install: `yum -y install package` remove: `yum -y remove package` - */ - export interface Schema$PackageResourceYUM { - /** - * Package name. - */ - name?: string | null; - } - /** - * A package managed by Zypper. install: `zypper -y install package` remove: `zypper -y rm package` - */ - export interface Schema$PackageResourceZypper { - /** - * Package name. - */ - name?: string | null; - } /** * Patch configuration specifications. Contains details on how to apply the patch(es) to a VM instance. */ @@ -898,111 +643,6 @@ export namespace osconfig_v1 { */ weekly?: Schema$WeeklySchedule; } - /** - * A resource that manages a package repository. - */ - export interface Schema$RepositoryResource { - /** - * An Apt Repository. - */ - apt?: Schema$RepositoryResourceAptRepository; - /** - * A Goo Repository. - */ - goo?: Schema$RepositoryResourceGooRepository; - /** - * A Yum Repository. - */ - yum?: Schema$RepositoryResourceYumRepository; - /** - * A Zypper Repository. - */ - zypper?: Schema$RepositoryResourceZypperRepository; - } - /** - * Represents a single apt package repository. These will be added to a repo file that will be managed at /etc/apt/sources.list.d/google_osconfig.list. - */ - export interface Schema$RepositoryResourceAptRepository { - /** - * Type of archive files in this repository. The default behavior is DEB. - */ - archiveType?: string | null; - /** - * List of components for this repository. Must contain at least one item. - */ - components?: string[] | null; - /** - * Distribution of this repository. - */ - distribution?: string | null; - /** - * URI of the key file for this repository. The agent will maintain a keyring at /etc/apt/trusted.gpg.d/osconfig_agent_managed.gpg. - */ - gpgKey?: string | null; - /** - * URI for this repository. - */ - uri?: string | null; - } - /** - * Represents a Goo package repository. These will be added to a repo file that will be managed at C:/ProgramData/GooGet/repos/google_osconfig.repo. - */ - export interface Schema$RepositoryResourceGooRepository { - /** - * The name of the repository. - */ - name?: string | null; - /** - * The url of the repository. - */ - url?: string | null; - } - /** - * Represents a single yum package repository. These will be added to a repo file that will be managed at /etc/yum.repos.d/google_osconfig.repo. - */ - export interface Schema$RepositoryResourceYumRepository { - /** - * The location of the repository directory. - */ - baseUrl?: string | null; - /** - * The display name of the repository. - */ - displayName?: string | null; - /** - * URIs of GPG keys. - */ - gpgKeys?: string[] | null; - /** - * A one word, unique name for this repository. This will be the `repo id` in the yum config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for resource conflicts. - */ - id?: string | null; - } - /** - * Represents a single zypper package repository. These will be added to a repo file that will be managed at /etc/zypp/repos.d/google_osconfig.repo. - */ - export interface Schema$RepositoryResourceZypperRepository { - /** - * The location of the repository directory. - */ - baseUrl?: string | null; - /** - * The display name of the repository. - */ - displayName?: string | null; - /** - * URIs of GPG keys. - */ - gpgKeys?: string[] | null; - /** - * A one word, unique name for this repository. This will be the `repo id` in the zypper config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for GuestPolicy conflicts. - */ - id?: string | null; - } - /** - * A resource that manages a system service. - */ - export interface Schema$ServiceResource {} /** * Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. */ diff --git a/src/apis/osconfig/v1beta.ts b/src/apis/osconfig/v1beta.ts index 62521eed52c..569238f2af0 100644 --- a/src/apis/osconfig/v1beta.ts +++ b/src/apis/osconfig/v1beta.ts @@ -99,7 +99,7 @@ export namespace osconfig_v1beta { } /** - * Cloud OS Config API + * OS Config API * * OS management tools that can be used for patch management, patch compliance, and configuration management on VM instances. * @@ -284,44 +284,6 @@ export namespace osconfig_v1beta { * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`. */ export interface Schema$Empty {} - /** - * A resource that contains custom validation and enforcement steps. - */ - export interface Schema$ExecResource { - /** - * What to run to bring this resource into the desired state. Optional if policy is in validate only mode. - */ - enforce?: Schema$ExecResourceExec; - /** - * What to run to validate this resource is in the desired state. A successful exit code indicates resource is in the desired state. - */ - validate?: Schema$ExecResourceExec; - } - /** - * A file or script to execute. - */ - export interface Schema$ExecResourceExec { - /** - * Exit codes that indicate success. - */ - allowedSuccessCodes?: number[] | null; - /** - * Arguments to use. - */ - args?: string[] | null; - /** - * A remote or local file. - */ - file?: Schema$File; - /** - * The script interpreter to use. - */ - interpreter?: string | null; - /** - * An inline script. - */ - script?: string | null; - } /** * A step that runs an executable for a PatchJob. */ @@ -389,107 +351,6 @@ export namespace osconfig_v1beta { */ rollout?: Schema$PatchRollout; } - /** - * A resource that extracts an archive - */ - export interface Schema$ExtractArchiveResource { - /** - * Local file path that signals this resource is in the desired state. The absence of this file will indicate whether the archive needs to be extracted. - */ - creates?: string | null; - /** - * Directory to extract archive to. - */ - destination?: string | null; - /** - * Whether to overwrite existing files during extraction. If this is set to true, any existing files in the destination location will be overwritten by the extraction. - */ - overwrite?: boolean | null; - /** - * The source archive to extract. - */ - source?: Schema$File; - /** - * The type of the archive to extract. - */ - type?: string | null; - } - /** - * A remote or local file. - */ - export interface Schema$File { - /** - * Defaults to false. When false, files will be subject to validations based on the file type: Remote: A checksum must be specified. GCS: An object generation number must be specified. - */ - allowInsecure?: boolean | null; - /** - * A GCS object. - */ - gcs?: Schema$FileGcs; - /** - * A local path to use. - */ - localPath?: string | null; - /** - * A generic remote file. - */ - remote?: Schema$FileRemote; - } - /** - * Specifies a file available as a GCS Object. - */ - export interface Schema$FileGcs { - /** - * Bucket of the GCS object. - */ - bucket?: string | null; - /** - * Generation number of the GCS object. - */ - generation?: string | null; - /** - * Name of the GCS object. - */ - object?: string | null; - } - /** - * Specifies a file available via some URI. - */ - export interface Schema$FileRemote { - /** - * SHA256 checksum of the remote file. - */ - sha256Checksum?: string | null; - /** - * URI from which to fetch the object. It should contain both the protocol and path following the format {protocol}://{location}. - */ - uri?: string | null; - } - /** - * A resource that manages the state of a file. - */ - export interface Schema$FileResource { - /** - * A a file with this content. - */ - content?: string | null; - /** - * A remote or local source. - */ - file?: Schema$File; - /** - * The absolute path of the file. - */ - path?: string | null; - /** - * Consists of three octal digits which represent, in order, the permissions of the owner, group, and other users for the file (similarly to the numeric mode used in the linux chmod utility). Each digit represents a three bit number with the 4 bit corresponding to the read permissions, the 2 bit corresponds to the write bit, and the one bit corresponds to the execute permission. Default behavior is 755. Below are some examples of permissions and their associated values: read, write, and execute: 7 read and execute: 5 read and write: 6 read only: 4 - */ - permissions?: string | null; - /** - * Desired state of the file. - */ - state?: string | null; - } /** * Message encapsulating a value that can be either absolute ("fixed") or relative ("percent") to a value. */ @@ -707,122 +568,6 @@ export namespace osconfig_v1beta { */ zypper?: Schema$ZypperRepository; } - /** - * A resource that manages a system package. - */ - export interface Schema$PackageResource { - /** - * A package managed by Apt. - */ - apt?: Schema$PackageResourceAPT; - /** - * A deb package file. - */ - deb?: Schema$PackageResourceDeb; - /** - * The desired_state the agent should maintain for this package. The default is to ensure the package is installed. - */ - desiredState?: string | null; - /** - * A package managed by GooGet. - */ - googet?: Schema$PackageResourceGooGet; - /** - * An MSI package. - */ - msi?: Schema$PackageResourceMSI; - /** - * An rpm package file. - */ - rpm?: Schema$PackageResourceRPM; - /** - * A package managed by YUM. - */ - yum?: Schema$PackageResourceYUM; - /** - * A package managed by Zypper. - */ - zypper?: Schema$PackageResourceZypper; - } - /** - * A package managed by APT. install: `apt-get update && apt-get -y install [name]` remove: `apt-get -y remove [name]` - */ - export interface Schema$PackageResourceAPT { - /** - * Package name. - */ - name?: string | null; - } - /** - * A deb package file. dpkg packages only support INSTALLED state. - */ - export interface Schema$PackageResourceDeb { - /** - * Whether dependencies should also be installed. install when false: `dpkg -i package` install when true: `apt-get update && apt-get -y install package.deb` - */ - pullDeps?: boolean | null; - /** - * A deb package. - */ - source?: Schema$File; - } - /** - * A package managed by GooGet. install: `googet -noconfirm install package` remove: `googet -noconfirm remove package` - */ - export interface Schema$PackageResourceGooGet { - /** - * Package name. - */ - name?: string | null; - } - /** - * An MSI package. MSI packages only support INSTALLED state. Install msiexec /i /qn /norestart - */ - export interface Schema$PackageResourceMSI { - /** - * Return codes that indicate that the software installed or updated successfully. Behaviour defaults to [0] - */ - allowedSuccessCodes?: number[] | null; - /** - * Flags to use during package install. Appended to the defalts of "/i /qn /norestart" - */ - flags?: string[] | null; - /** - * The MSI package. - */ - source?: Schema$File; - } - /** - * An RPM package file. RPM packages only support INSTALLED state. - */ - export interface Schema$PackageResourceRPM { - /** - * Whether dependencies should also be installed. install when false: `rpm --upgrade --replacepkgs package.rpm` install when true: `yum -y install package.rpm` or `zypper -y install package.rpm` - */ - pullDeps?: boolean | null; - /** - * An rpm package. - */ - source?: Schema$File; - } - /** - * A package managed by YUM. install: `yum -y install package` remove: `yum -y remove package` - */ - export interface Schema$PackageResourceYUM { - /** - * Package name. - */ - name?: string | null; - } - /** - * A package managed by Zypper. install: `zypper -y install package` remove: `zypper -y rm package` - */ - export interface Schema$PackageResourceZypper { - /** - * Package name. - */ - name?: string | null; - } /** * Patch configuration specifications. Contains details on how to apply the patch(es) to a VM instance. */ @@ -1152,111 +897,6 @@ export namespace osconfig_v1beta { */ weekly?: Schema$WeeklySchedule; } - /** - * A resource that manages a package repository. - */ - export interface Schema$RepositoryResource { - /** - * An Apt Repository. - */ - apt?: Schema$RepositoryResourceAptRepository; - /** - * A Goo Repository. - */ - goo?: Schema$RepositoryResourceGooRepository; - /** - * A Yum Repository. - */ - yum?: Schema$RepositoryResourceYumRepository; - /** - * A Zypper Repository. - */ - zypper?: Schema$RepositoryResourceZypperRepository; - } - /** - * Represents a single apt package repository. These will be added to a repo file that will be managed at /etc/apt/sources.list.d/google_osconfig.list. - */ - export interface Schema$RepositoryResourceAptRepository { - /** - * Type of archive files in this repository. The default behavior is DEB. - */ - archiveType?: string | null; - /** - * List of components for this repository. Must contain at least one item. - */ - components?: string[] | null; - /** - * Distribution of this repository. - */ - distribution?: string | null; - /** - * URI of the key file for this repository. The agent will maintain a keyring at /etc/apt/trusted.gpg.d/osconfig_agent_managed.gpg. - */ - gpgKey?: string | null; - /** - * URI for this repository. - */ - uri?: string | null; - } - /** - * Represents a Goo package repository. These will be added to a repo file that will be managed at C:/ProgramData/GooGet/repos/google_osconfig.repo. - */ - export interface Schema$RepositoryResourceGooRepository { - /** - * The name of the repository. - */ - name?: string | null; - /** - * The url of the repository. - */ - url?: string | null; - } - /** - * Represents a single yum package repository. These will be added to a repo file that will be managed at /etc/yum.repos.d/google_osconfig.repo. - */ - export interface Schema$RepositoryResourceYumRepository { - /** - * The location of the repository directory. - */ - baseUrl?: string | null; - /** - * The display name of the repository. - */ - displayName?: string | null; - /** - * URIs of GPG keys. - */ - gpgKeys?: string[] | null; - /** - * A one word, unique name for this repository. This will be the `repo id` in the yum config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for resource conflicts. - */ - id?: string | null; - } - /** - * Represents a single zypper package repository. These will be added to a repo file that will be managed at /etc/zypp/repos.d/google_osconfig.repo. - */ - export interface Schema$RepositoryResourceZypperRepository { - /** - * The location of the repository directory. - */ - baseUrl?: string | null; - /** - * The display name of the repository. - */ - displayName?: string | null; - /** - * URIs of GPG keys. - */ - gpgKeys?: string[] | null; - /** - * A one word, unique name for this repository. This will be the `repo id` in the zypper config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for GuestPolicy conflicts. - */ - id?: string | null; - } - /** - * A resource that manages a system service. - */ - export interface Schema$ServiceResource {} /** * A software recipe is a set of instructions for installing and configuring a piece of software. It consists of a set of artifacts that are downloaded, and a set of steps that install, configure, and/or update the software. Recipes support installing and updating software from artifacts in the following formats: Zip archive, Tar archive, Windows MSI, Debian package, and RPM package. Additionally, recipes support executing a script (either defined in a file or directly in this api) in bash, sh, cmd, and powershell. Updating a software recipe If a recipe is assigned to an instance and there is a recipe with the same name but a lower version already installed and the assigned state of the recipe is `UPDATED`, then the recipe is updated to the new version. Script Working Directories Each script or execution step is run in its own temporary directory which is deleted after completing the step. */