Class OsConfigZonalServiceClient (1.18.1)

Zonal OS Config API

The OS Config service is the server-side component that allows users to manage package installations and patch jobs for Compute Engine VM instances.

Return the API endpoint used by the client instance.

Returns the transport used by the client instance.

Return the universe domain used by the client instance.

Instantiates the os config zonal service client.

Releases underlying transport's resources.

Returns a fully-qualified billing_account string.

Returns a fully-qualified folder string.

Returns a fully-qualified location string.

Returns a fully-qualified organization string.

Returns a fully-qualified project string.

Create an OS policy assignment.

This method also creates the first revision of the OS policy assignment.

This method returns a long running operation (LRO) that contains the rollout details. The rollout can be cancelled by cancelling the LRO.

For more information, see Method: projects.locations.osPolicyAssignments.operations.cancel <https://cloud.google.com/compute/docs/osconfig/rest/v1/projects.locations.osPolicyAssignments.operations/cancel>__.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_create_os_policy_assignment():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    os_policy_assignment = osconfig_v1.OSPolicyAssignment()
    os_policy_assignment.os_policies.id = "id_value"
    os_policy_assignment.os_policies.mode = "ENFORCEMENT"
    os_policy_assignment.os_policies.resource_groups.resources.pkg.apt.name = "name_value"
    os_policy_assignment.os_policies.resource_groups.resources.pkg.desired_state = "REMOVED"
    os_policy_assignment.os_policies.resource_groups.resources.id = "id_value"
    os_policy_assignment.rollout.disruption_budget.fixed = 528

    request = osconfig_v1.CreateOSPolicyAssignmentRequest(
        parent="parent_value",
        os_policy_assignment=os_policy_assignment,
        os_policy_assignment_id="os_policy_assignment_id_value",
    )

    # Make the request
    operation = client.create_os_policy_assignment(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Delete the OS policy assignment.

This method creates a new revision of the OS policy assignment.

This method returns a long running operation (LRO) that contains the rollout details. The rollout can be cancelled by cancelling the LRO.

If the LRO completes and is not cancelled, all revisions associated with the OS policy assignment are deleted.

For more information, see Method: projects.locations.osPolicyAssignments.operations.cancel <https://cloud.google.com/compute/docs/osconfig/rest/v1/projects.locations.osPolicyAssignments.operations/cancel>__.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_delete_os_policy_assignment():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.DeleteOSPolicyAssignmentRequest(
        name="name_value",
    )

    # Make the request
    operation = client.delete_os_policy_assignment(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Creates an instance of this client using the provided credentials file.

Creates an instance of this client using the provided credentials info.

Creates an instance of this client using the provided credentials file.

Get inventory data for the specified VM instance. If the VM has no associated inventory, the message NOT_FOUND is returned.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_get_inventory():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.GetInventoryRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_inventory(request=request)

    # Handle the response
    print(response)

Deprecated. Return the API endpoint and client cert source for mutual TLS.

The client cert source is determined in the following order: (1) if GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is not "true", the client cert source is None. (2) if client_options.client_cert_source is provided, use the provided one; if the default client cert source exists, use the default one; otherwise the client cert source is None.

The API endpoint is determined in the following order: (1) if client_options.api_endpoint if provided, use the provided one. (2) if GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is "always", use the default mTLS endpoint; if the environment variable is "never", use the default API endpoint; otherwise if client cert source exists, use the default mTLS endpoint, otherwise use the default API endpoint.

More details can be found at https://google.aip.dev/auth/4114.

Retrieve an existing OS policy assignment.

This method always returns the latest revision. In order to retrieve a previous revision of the assignment, also provide the revision ID in the name parameter.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_get_os_policy_assignment():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.GetOSPolicyAssignmentRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_os_policy_assignment(request=request)

    # Handle the response
    print(response)

Get the OS policy asssignment report for the specified Compute Engine VM instance.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_get_os_policy_assignment_report():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.GetOSPolicyAssignmentReportRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_os_policy_assignment_report(request=request)

    # Handle the response
    print(response)

Gets the vulnerability report for the specified VM instance. Only VMs with inventory data have vulnerability reports associated with them.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_get_vulnerability_report():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.GetVulnerabilityReportRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_vulnerability_report(request=request)

    # Handle the response
    print(response)

Returns a fully-qualified instance_os_policy_assignment string.

Returns a fully-qualified instance string.

Returns a fully-qualified inventory string.

List inventory data for all VM instances in the specified zone.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_list_inventories():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.ListInventoriesRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_inventories(request=request)

    # Handle the response
    for response in page_result:
        print(response)

List OS policy asssignment reports for all Compute Engine VM instances in the specified zone.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_list_os_policy_assignment_reports():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.ListOSPolicyAssignmentReportsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_os_policy_assignment_reports(request=request)

    # Handle the response
    for response in page_result:
        print(response)

List the OS policy assignment revisions for a given OS policy assignment.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_list_os_policy_assignment_revisions():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.ListOSPolicyAssignmentRevisionsRequest(
        name="name_value",
    )

    # Make the request
    page_result = client.list_os_policy_assignment_revisions(request=request)

    # Handle the response
    for response in page_result:
        print(response)

List the OS policy assignments under the parent resource. For each OS policy assignment, the latest revision is returned.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_list_os_policy_assignments():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.ListOSPolicyAssignmentsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_os_policy_assignments(request=request)

    # Handle the response
    for response in page_result:
        print(response)

List vulnerability reports for all VM instances in the specified zone.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_list_vulnerability_reports():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    request = osconfig_v1.ListVulnerabilityReportsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_vulnerability_reports(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Returns a fully-qualified os_policy_assignment string.

Returns a fully-qualified os_policy_assignment_report string.

Parse a billing_account path into its component segments.

Parse a folder path into its component segments.

Parse a location path into its component segments.

Parse a organization path into its component segments.

Parse a project path into its component segments.

Parses a instance_os_policy_assignment path into its component segments.

Parses a instance path into its component segments.

Parses a inventory path into its component segments.

Parses a os_policy_assignment path into its component segments.

Parses a os_policy_assignment_report path into its component segments.

Parses a vulnerability_report path into its component segments.

Update an existing OS policy assignment.

This method creates a new revision of the OS policy assignment.

This method returns a long running operation (LRO) that contains the rollout details. The rollout can be cancelled by cancelling the LRO.

For more information, see Method: projects.locations.osPolicyAssignments.operations.cancel <https://cloud.google.com/compute/docs/osconfig/rest/v1/projects.locations.osPolicyAssignments.operations/cancel>__.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import osconfig_v1

def sample_update_os_policy_assignment():
    # Create a client
    client = osconfig_v1.OsConfigZonalServiceClient()

    # Initialize request argument(s)
    os_policy_assignment = osconfig_v1.OSPolicyAssignment()
    os_policy_assignment.os_policies.id = "id_value"
    os_policy_assignment.os_policies.mode = "ENFORCEMENT"
    os_policy_assignment.os_policies.resource_groups.resources.pkg.apt.name = "name_value"
    os_policy_assignment.os_policies.resource_groups.resources.pkg.desired_state = "REMOVED"
    os_policy_assignment.os_policies.resource_groups.resources.id = "id_value"
    os_policy_assignment.rollout.disruption_budget.fixed = 528

    request = osconfig_v1.UpdateOSPolicyAssignmentRequest(
        os_policy_assignment=os_policy_assignment,
    )

    # Make the request
    operation = client.update_os_policy_assignment(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Returns a fully-qualified vulnerability_report string.