Recommender V1 Client - Class Operation (1.7.8)

Version 1.7.8

• 2.0.2 (latest)
• 2.0.1
• 1.11.5
• 1.10.0
• 1.9.1
• 1.8.2
• 1.7.8

Reference documentation and code samples for the Recommender V1 Client class Operation.

Contains an operation for a resource loosely based on the JSON-PATCH format with support for:

• Custom filters for describing partial array patch.

• Extended path values for describing nested arrays.

• Custom fields for describing the resource for which the operation is being described.
• Allows extension to custom operations not natively supported by RFC6902. See https://tools.ietf.org/html/rfc6902 for details on the original RFC.

Generated from protobuf message google.cloud.recommender.v1.Operation

Methods

__construct

Constructor.

Parameters
Name	Description
data	array Optional. Data for populating the Message object.
↳ action	string Type of this operation. Contains one of 'add', 'remove', 'replace', 'move', 'copy', 'test' and custom operations. This field is case-insensitive and always populated.
↳ resource_type	string Type of GCP resource being modified/tested. This field is always populated. Example: cloudresourcemanager.googleapis.com/Project, compute.googleapis.com/Instance
↳ resource	string Contains the fully qualified resource name. This field is always populated. ex: //cloudresourcemanager.googleapis.com/projects/foo.
↳ path	string Path to the target field being operated on. If the operation is at the resource level, then path should be "/". This field is always populated.
↳ source_resource	string Can be set with action 'copy' to copy resource configuration across different resources of the same type. Example: A resource clone can be done via action = 'copy', path = "/", from = "/", source_resource = and resource_name =
↳ source_path	string Can be set with action 'copy' or 'move' to indicate the source field within resource or source_resource, ignored if provided for other operation types.
↳ value	Google\Protobuf\Value Value for the path field. Will be set for actions:'add'/'replace'. Maybe set for action: 'test'. Either this or value_matcher will be set for 'test' operation. An exact match must be performed.
↳ value_matcher	Google\Cloud\Recommender\V1\ValueMatcher Can be set for action 'test' for advanced matching for the value of 'path' field. Either this or value will be set for 'test' operation.
↳ path_filters	array|Google\Protobuf\Internal\MapField Set of filters to apply if path refers to array elements or nested array elements in order to narrow down to a single unique element that is being tested/modified. This is intended to be an exact match per filter. To perform advanced matching, use path_value_matchers. * Example: { "/versions/*/name" : "it-123" "/versions/*/targetSize/percent": 20 } * Example: { "/bindings/*/role": "roles/owner" "/bindings/*/condition" : null } * Example: { "/bindings/*/role": "roles/owner" "/bindings/*/members/*" : ["[e-mail]", "[e-mail]"] } When both path_filters and path_value_matchers are set, an implicit AND must be performed.
↳ path_value_matchers	array|Google\Protobuf\Internal\MapField Similar to path_filters, this contains set of filters to apply if path field refers to array elements. This is meant to support value matching beyond exact match. To perform exact match, use path_filters. When both path_filters and path_value_matchers are set, an implicit AND must be performed.

getAction

Type of this operation. Contains one of 'add', 'remove', 'replace', 'move', 'copy', 'test' and custom operations. This field is case-insensitive and always populated.

Returns
Type	Description
string

setAction

Type of this operation. Contains one of 'add', 'remove', 'replace', 'move', 'copy', 'test' and custom operations. This field is case-insensitive and always populated.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getResourceType

Type of GCP resource being modified/tested. This field is always populated.

Example: cloudresourcemanager.googleapis.com/Project, compute.googleapis.com/Instance

Returns
Type	Description
string

setResourceType

Type of GCP resource being modified/tested. This field is always populated.

Example: cloudresourcemanager.googleapis.com/Project, compute.googleapis.com/Instance

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getResource

Contains the fully qualified resource name. This field is always populated.

ex: //cloudresourcemanager.googleapis.com/projects/foo.

Returns
Type	Description
string

setResource

Contains the fully qualified resource name. This field is always populated.

ex: //cloudresourcemanager.googleapis.com/projects/foo.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getPath

Path to the target field being operated on. If the operation is at the resource level, then path should be "/". This field is always populated.

Returns
Type	Description
string

setPath

Path to the target field being operated on. If the operation is at the resource level, then path should be "/". This field is always populated.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getSourceResource

Can be set with action 'copy' to copy resource configuration across different resources of the same type. Example: A resource clone can be done via action = 'copy', path = "/", from = "/", source_resource = and resource_name =

This field is empty for all other values of action.

Returns
Type	Description
string

setSourceResource

Can be set with action 'copy' to copy resource configuration across different resources of the same type. Example: A resource clone can be done via action = 'copy', path = "/", from = "/", source_resource = and resource_name =

This field is empty for all other values of action.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getSourcePath

Can be set with action 'copy' or 'move' to indicate the source field within resource or source_resource, ignored if provided for other operation types.

Returns
Type	Description
string

setSourcePath

Can be set with action 'copy' or 'move' to indicate the source field within resource or source_resource, ignored if provided for other operation types.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getValue

Value for the path field. Will be set for actions:'add'/'replace'.

Maybe set for action: 'test'. Either this or value_matcher will be set for 'test' operation. An exact match must be performed.

Returns
Type	Description
Google\Protobuf\Value|null

hasValue

setValue

Value for the path field. Will be set for actions:'add'/'replace'.

Maybe set for action: 'test'. Either this or value_matcher will be set for 'test' operation. An exact match must be performed.

Parameter
Name	Description
var	Google\Protobuf\Value

Returns
Type	Description
$this

getValueMatcher

Can be set for action 'test' for advanced matching for the value of 'path' field. Either this or value will be set for 'test' operation.

Returns
Type	Description
Google\Cloud\Recommender\V1\ValueMatcher|null

hasValueMatcher

setValueMatcher

Can be set for action 'test' for advanced matching for the value of 'path' field. Either this or value will be set for 'test' operation.

Parameter
Name	Description
var	Google\Cloud\Recommender\V1\ValueMatcher

Returns
Type	Description
$this

getPathFilters

Set of filters to apply if path refers to array elements or nested array elements in order to narrow down to a single unique element that is being tested/modified.

This is intended to be an exact match per filter. To perform advanced matching, use path_value_matchers.

• Example: php { "/versions/*/name" : "it-123" "/versions/*/targetSize/percent": 20 }
• Example: { "/bindings/*/role": "roles/owner" "/bindings/*/condition" : null }
• Example: { "/bindings/*/role": "roles/owner" "/bindings/*/members/*" : ["[e-mail]", "[e-mail]"] } When both path_filters and path_value_matchers are set, an implicit AND must be performed.

Returns
Type	Description
Google\Protobuf\Internal\MapField

setPathFilters

Set of filters to apply if path refers to array elements or nested array elements in order to narrow down to a single unique element that is being tested/modified.

This is intended to be an exact match per filter. To perform advanced matching, use path_value_matchers.

• Example: php { "/versions/*/name" : "it-123" "/versions/*/targetSize/percent": 20 }
• Example: { "/bindings/*/role": "roles/owner" "/bindings/*/condition" : null }
• Example: { "/bindings/*/role": "roles/owner" "/bindings/*/members/*" : ["[e-mail]", "[e-mail]"] } When both path_filters and path_value_matchers are set, an implicit AND must be performed.

Parameter
Name	Description
var	array|Google\Protobuf\Internal\MapField

Returns
Type	Description
$this

getPathValueMatchers

Similar to path_filters, this contains set of filters to apply if path field refers to array elements. This is meant to support value matching beyond exact match. To perform exact match, use path_filters.

When both path_filters and path_value_matchers are set, an implicit AND must be performed.

Returns
Type	Description
Google\Protobuf\Internal\MapField

setPathValueMatchers

Similar to path_filters, this contains set of filters to apply if path field refers to array elements. This is meant to support value matching beyond exact match. To perform exact match, use path_filters.

When both path_filters and path_value_matchers are set, an implicit AND must be performed.

Parameter
Name	Description
var	array|Google\Protobuf\Internal\MapField

Returns
Type	Description
$this

getPathValue

Returns
Type	Description
string