Cloud OS Config API

OS management tools that can be used for patch management, patch compliance, and configuration management on VM instances.

Service: osconfig.googleapis.com

We recommend that you call this service using Google-provided client libraries. If your application needs to call this service using your own libraries, you should use the following information when making the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service may have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://osconfig.googleapis.com

REST Resource: v1beta.projects.guestPolicies

Methods
create POST /v1beta/{parent=projects/*}/guestPolicies
Create an OS Config guest policy.
delete DELETE /v1beta/{name=projects/*/guestPolicies/*}
Delete an OS Config guest policy.
get GET /v1beta/{name=projects/*/guestPolicies/*}
Get an OS Config guest policy.
list GET /v1beta/{parent=projects/*}/guestPolicies
Get a page of OS Config guest policies.
patch PATCH /v1beta/{guestPolicy.name=projects/*/guestPolicies/*}
Update an OS Config guest policy.

REST Resource: v1beta.projects.patchDeployments

Methods
create POST /v1beta/{parent=projects/*}/patchDeployments
Create an OS Config patch deployment.
delete DELETE /v1beta/{name=projects/*/patchDeployments/*}
Delete an OS Config patch deployment.
get GET /v1beta/{name=projects/*/patchDeployments/*}
Get an OS Config patch deployment.
list GET /v1beta/{parent=projects/*}/patchDeployments
Get a page of OS Config patch deployments.

REST Resource: v1beta.projects.patchJobs

Methods
cancel POST /v1beta/{name=projects/*/patchJobs/*}:cancel
Cancel a patch job.
execute POST /v1beta/{parent=projects/*}/patchJobs:execute
Patch VM instances by creating and running a patch job.
get GET /v1beta/{name=projects/*/patchJobs/*}
Get the patch job.
list GET /v1beta/{parent=projects/*}/patchJobs
Get a list of patch jobs.

REST Resource: v1beta.projects.patchJobs.instanceDetails

Methods
list GET /v1beta/{parent=projects/*/patchJobs/*}/instanceDetails
Get a list of instance details for a given patch job.

REST Resource: v1beta.projects.zones.instances

Methods
lookupEffectiveGuestPolicy POST /v1beta/{instance=projects/*/zones/*/instances/*}:lookupEffectiveGuestPolicy
Lookup the effective guest policy that applies to a VM instance.

Service: osconfig.googleapis.com

We recommend that you call this service using Google-provided client libraries. If your application needs to call this service using your own libraries, you should use the following information when making the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service may have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://osconfig.googleapis.com

REST Resource: v1.projects.patchDeployments

Methods
create POST /v1/{parent=projects/*}/patchDeployments
Create an OS Config patch deployment.
delete DELETE /v1/{name=projects/*/patchDeployments/*}
Delete an OS Config patch deployment.
get GET /v1/{name=projects/*/patchDeployments/*}
Get an OS Config patch deployment.
list GET /v1/{parent=projects/*}/patchDeployments
Get a page of OS Config patch deployments.

REST Resource: v1.projects.patchJobs

Methods
cancel POST /v1/{name=projects/*/patchJobs/*}:cancel
Cancel a patch job.
execute POST /v1/{parent=projects/*}/patchJobs:execute
Patch VM instances by creating and running a patch job.
get GET /v1/{name=projects/*/patchJobs/*}
Get the patch job.
list GET /v1/{parent=projects/*}/patchJobs
Get a list of patch jobs.

REST Resource: v1.projects.patchJobs.instanceDetails

Methods
list GET /v1/{parent=projects/*/patchJobs/*}/instanceDetails
Get a list of instance details for a given patch job.