Google Cloud OsConfig V1 Client - Class OSPolicyAssignment (1.2.2)

Reference documentation and code samples for the Google Cloud OsConfig V1 Client class OSPolicyAssignment.

OS policy assignment is an API resource that is used to apply a set of OS policies to a dynamically targeted group of Compute Engine VM instances.

An OS policy is used to define the desired state configuration for a Compute Engine VM instance through a set of configuration resources that provide capabilities such as installing or removing software packages, or executing a script. For more information, see OS policy and OS policy assignment.

Generated from protobuf message google.cloud.osconfig.v1.OSPolicyAssignment

Namespace

Google \ Cloud \ OsConfig \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ name`	`string` Resource name. Format: `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id}` This field is ignored when you create an OS policy assignment.
`↳ description`	`string` OS policy assignment description. Length of the description is limited to 1024 characters.
`↳ os_policies`	`array<Google\Cloud\OsConfig\V1\OSPolicy>` Required. List of OS policies to be applied to the VMs.
`↳ instance_filter`	`Google\Cloud\OsConfig\V1\OSPolicyAssignment\InstanceFilter` Required. Filter to select VMs.
`↳ rollout`	`Google\Cloud\OsConfig\V1\OSPolicyAssignment\Rollout` Required. Rollout to deploy the OS policy assignment. A rollout is triggered in the following situations: 1) OSPolicyAssignment is created. 2) OSPolicyAssignment is updated and the update contains changes to one of the following fields: - instance_filter - os_policies 3) OSPolicyAssignment is deleted.
`↳ revision_id`	`string` Output only. The assignment revision ID A new revision is committed whenever a rollout is triggered for a OS policy assignment
`↳ revision_create_time`	`Google\Protobuf\Timestamp` Output only. The timestamp that the revision was created.
`↳ etag`	`string` The etag for this OS policy assignment. If this is provided on update, it must match the server's etag.
`↳ rollout_state`	`int` Output only. OS policy assignment rollout state
`↳ baseline`	`bool` Output only. Indicates that this revision has been successfully rolled out in this zone and new VMs will be assigned OS policies from this revision. For a given OS policy assignment, there is only one revision with a value of `true` for this field.
`↳ deleted`	`bool` Output only. Indicates that this revision deletes the OS policy assignment.
`↳ reconciling`	`bool` Output only. Indicates that reconciliation is in progress for the revision. This value is `true` when the `rollout_state` is one of: * IN_PROGRESS * CANCELLING
`↳ uid`	`string` Output only. Server generated unique id for the OS policy assignment resource.

getName

Resource name.

Format: projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id} This field is ignored when you create an OS policy assignment.

Returns
Type	Description
`string`

setName

Resource name.

Format: projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id} This field is ignored when you create an OS policy assignment.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getDescription

OS policy assignment description.

Length of the description is limited to 1024 characters.

Returns
Type	Description
`string`

setDescription

OS policy assignment description.

Length of the description is limited to 1024 characters.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getOsPolicies

Required. List of OS policies to be applied to the VMs.

Returns
Type	Description
`Google\Protobuf\Internal\RepeatedField`

setOsPolicies

Required. List of OS policies to be applied to the VMs.

Parameter
Name	Description
`var`	`array<Google\Cloud\OsConfig\V1\OSPolicy>`

Returns
Type	Description
`$this`

getInstanceFilter

Required. Filter to select VMs.

Returns
Type	Description
`Google\Cloud\OsConfig\V1\OSPolicyAssignment\InstanceFilter\|null`

hasInstanceFilter

clearInstanceFilter

setInstanceFilter

Required. Filter to select VMs.

Parameter
Name	Description
`var`	`Google\Cloud\OsConfig\V1\OSPolicyAssignment\InstanceFilter`

Returns
Type	Description
`$this`

getRollout

Required. Rollout to deploy the OS policy assignment.

A rollout is triggered in the following situations: 1) OSPolicyAssignment is created. 2) OSPolicyAssignment is updated and the update contains changes to one of the following fields:

instance_filter
os_policies 3) OSPolicyAssignment is deleted.

Returns
Type	Description
`Google\Cloud\OsConfig\V1\OSPolicyAssignment\Rollout\|null`

hasRollout

clearRollout

setRollout

Required. Rollout to deploy the OS policy assignment.

A rollout is triggered in the following situations: 1) OSPolicyAssignment is created. 2) OSPolicyAssignment is updated and the update contains changes to one of the following fields:

instance_filter
os_policies 3) OSPolicyAssignment is deleted.

Parameter
Name	Description
`var`	`Google\Cloud\OsConfig\V1\OSPolicyAssignment\Rollout`

Returns
Type	Description
`$this`

getRevisionId

Output only. The assignment revision ID A new revision is committed whenever a rollout is triggered for a OS policy assignment

Returns
Type	Description
`string`

setRevisionId

Output only. The assignment revision ID A new revision is committed whenever a rollout is triggered for a OS policy assignment

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getRevisionCreateTime

Output only. The timestamp that the revision was created.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasRevisionCreateTime

clearRevisionCreateTime

setRevisionCreateTime

Output only. The timestamp that the revision was created.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getEtag

The etag for this OS policy assignment.

If this is provided on update, it must match the server's etag.

Returns
Type	Description
`string`

setEtag

The etag for this OS policy assignment.

If this is provided on update, it must match the server's etag.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getRolloutState

Output only. OS policy assignment rollout state

Returns
Type	Description
`int`

setRolloutState

Output only. OS policy assignment rollout state

Parameter
Name	Description
`var`	`int`

Returns
Type	Description
`$this`

getBaseline

Output only. Indicates that this revision has been successfully rolled out in this zone and new VMs will be assigned OS policies from this revision.

For a given OS policy assignment, there is only one revision with a value of true for this field.

Returns
Type	Description
`bool`

setBaseline

Output only. Indicates that this revision has been successfully rolled out in this zone and new VMs will be assigned OS policies from this revision.

For a given OS policy assignment, there is only one revision with a value of true for this field.

Parameter
Name	Description
`var`	`bool`

Returns
Type	Description
`$this`

getDeleted

Output only. Indicates that this revision deletes the OS policy assignment.

Returns
Type	Description
`bool`

setDeleted

Output only. Indicates that this revision deletes the OS policy assignment.

Parameter
Name	Description
`var`	`bool`

Returns
Type	Description
`$this`

getReconciling

Output only. Indicates that reconciliation is in progress for the revision.

This value is true when the rollout_state is one of:

IN_PROGRESS
CANCELLING

Returns
Type	Description
`bool`

setReconciling

Output only. Indicates that reconciliation is in progress for the revision.

This value is true when the rollout_state is one of:

IN_PROGRESS
CANCELLING

Parameter
Name	Description
`var`	`bool`

Returns
Type	Description
`$this`

getUid

Output only. Server generated unique id for the OS policy assignment resource.

Returns
Type	Description
`string`

setUid

Output only. Server generated unique id for the OS policy assignment resource.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`