google.cloud.securitycenter.v1.GroupAssetsRequest */ class GroupAssetsRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the parent to group the assets by. Its format is * "organizations/[organization_id]", "folders/[folder_id]", or * "projects/[project_id]". * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ private $parent = ''; /** * Expression that defines the filter to apply across assets. * The expression is a list of zero or more restrictions combined via logical * operators `AND` and `OR`. * Parentheses are supported, and `OR` has higher precedence than `AND`. * Restrictions have the form ` ` and may have a `-` * character in front of them to indicate negation. The fields map to those * defined in the Asset resource. Examples include: * * name * * security_center_properties.resource_name * * resource_properties.a_property * * security_marks.marks.marka * The supported operators are: * * `=` for all value types. * * `>`, `<`, `>=`, `<=` for integer values. * * `:`, meaning substring matching, for strings. * The supported value types are: * * string literals in quotes. * * integer literals without quotes. * * boolean literals `true` and `false` without quotes. * The following field and operator combinations are supported: * * name: `=` * * update_time: `=`, `>`, `<`, `>=`, `<=` * Usage: This should be milliseconds since epoch or an RFC3339 string. * Examples: * `update_time = "2019-06-10T16:07:18-07:00"` * `update_time = 1560208038000` * * create_time: `=`, `>`, `<`, `>=`, `<=` * Usage: This should be milliseconds since epoch or an RFC3339 string. * Examples: * `create_time = "2019-06-10T16:07:18-07:00"` * `create_time = 1560208038000` * * iam_policy.policy_blob: `=`, `:` * * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=` * * security_marks.marks: `=`, `:` * * security_center_properties.resource_name: `=`, `:` * * security_center_properties.resource_display_name: `=`, `:` * * security_center_properties.resource_type: `=`, `:` * * security_center_properties.resource_parent: `=`, `:` * * security_center_properties.resource_parent_display_name: `=`, `:` * * security_center_properties.resource_project: `=`, `:` * * security_center_properties.resource_project_display_name: `=`, `:` * * security_center_properties.resource_owners: `=`, `:` * For example, `resource_properties.size = 100` is a valid filter string. * Use a partial match on the empty string to filter based on a property * existing: `resource_properties.my_property : ""` * Use a negated partial match on the empty string to filter based on a * property not existing: `-resource_properties.my_property : ""` * * Generated from protobuf field string filter = 2; */ private $filter = ''; /** * Required. Expression that defines what assets fields to use for grouping. * The string value should follow SQL syntax: comma separated list of fields. * For example: * "security_center_properties.resource_project,security_center_properties.project". * The following fields are supported when compare_duration is not set: * * security_center_properties.resource_project * * security_center_properties.resource_project_display_name * * security_center_properties.resource_type * * security_center_properties.resource_parent * * security_center_properties.resource_parent_display_name * The following fields are supported when compare_duration is set: * * security_center_properties.resource_type * * security_center_properties.resource_project_display_name * * security_center_properties.resource_parent_display_name * * Generated from protobuf field string group_by = 3 [(.google.api.field_behavior) = REQUIRED]; */ private $group_by = ''; /** * When compare_duration is set, the GroupResult's "state_change" property is * updated to indicate whether the asset was added, removed, or remained * present during the compare_duration period of time that precedes the * read_time. This is the time between (read_time - compare_duration) and * read_time. * The state change value is derived based on the presence of the asset at the * two points in time. Intermediate state changes between the two times don't * affect the result. For example, the results aren't affected if the asset is * removed and re-created again. * Possible "state_change" values when compare_duration is specified: * * "ADDED": indicates that the asset was not present at the start of * compare_duration, but present at reference_time. * * "REMOVED": indicates that the asset was present at the start of * compare_duration, but not present at reference_time. * * "ACTIVE": indicates that the asset was present at both the * start and the end of the time period defined by * compare_duration and reference_time. * If compare_duration is not specified, then the only possible state_change * is "UNUSED", which will be the state_change set for all assets present at * read_time. * If this field is set then `state_change` must be a specified field in * `group_by`. * * Generated from protobuf field .google.protobuf.Duration compare_duration = 4; */ private $compare_duration = null; /** * Time used as a reference point when filtering assets. The filter is limited * to assets existing at the supplied time and their values are those at that * specific time. Absence of this field will default to the API's version of * NOW. * * Generated from protobuf field .google.protobuf.Timestamp read_time = 5; */ private $read_time = null; /** * The value returned by the last `GroupAssetsResponse`; indicates * that this is a continuation of a prior `GroupAssets` call, and that the * system should return the next page of data. * * Generated from protobuf field string page_token = 7; */ private $page_token = ''; /** * The maximum number of results to return in a single response. Default is * 10, minimum is 1, maximum is 1000. * * Generated from protobuf field int32 page_size = 8; */ private $page_size = 0; /** * Constructor. * * @param array $data { * Optional. Data for populating the Message object. * * @type string $parent * Required. The name of the parent to group the assets by. Its format is * "organizations/[organization_id]", "folders/[folder_id]", or * "projects/[project_id]". * @type string $filter * Expression that defines the filter to apply across assets. * The expression is a list of zero or more restrictions combined via logical * operators `AND` and `OR`. * Parentheses are supported, and `OR` has higher precedence than `AND`. * Restrictions have the form ` ` and may have a `-` * character in front of them to indicate negation. The fields map to those * defined in the Asset resource. Examples include: * * name * * security_center_properties.resource_name * * resource_properties.a_property * * security_marks.marks.marka * The supported operators are: * * `=` for all value types. * * `>`, `<`, `>=`, `<=` for integer values. * * `:`, meaning substring matching, for strings. * The supported value types are: * * string literals in quotes. * * integer literals without quotes. * * boolean literals `true` and `false` without quotes. * The following field and operator combinations are supported: * * name: `=` * * update_time: `=`, `>`, `<`, `>=`, `<=` * Usage: This should be milliseconds since epoch or an RFC3339 string. * Examples: * `update_time = "2019-06-10T16:07:18-07:00"` * `update_time = 1560208038000` * * create_time: `=`, `>`, `<`, `>=`, `<=` * Usage: This should be milliseconds since epoch or an RFC3339 string. * Examples: * `create_time = "2019-06-10T16:07:18-07:00"` * `create_time = 1560208038000` * * iam_policy.policy_blob: `=`, `:` * * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=` * * security_marks.marks: `=`, `:` * * security_center_properties.resource_name: `=`, `:` * * security_center_properties.resource_display_name: `=`, `:` * * security_center_properties.resource_type: `=`, `:` * * security_center_properties.resource_parent: `=`, `:` * * security_center_properties.resource_parent_display_name: `=`, `:` * * security_center_properties.resource_project: `=`, `:` * * security_center_properties.resource_project_display_name: `=`, `:` * * security_center_properties.resource_owners: `=`, `:` * For example, `resource_properties.size = 100` is a valid filter string. * Use a partial match on the empty string to filter based on a property * existing: `resource_properties.my_property : ""` * Use a negated partial match on the empty string to filter based on a * property not existing: `-resource_properties.my_property : ""` * @type string $group_by * Required. Expression that defines what assets fields to use for grouping. * The string value should follow SQL syntax: comma separated list of fields. * For example: * "security_center_properties.resource_project,security_center_properties.project". * The following fields are supported when compare_duration is not set: * * security_center_properties.resource_project * * security_center_properties.resource_project_display_name * * security_center_properties.resource_type * * security_center_properties.resource_parent * * security_center_properties.resource_parent_display_name * The following fields are supported when compare_duration is set: * * security_center_properties.resource_type * * security_center_properties.resource_project_display_name * * security_center_properties.resource_parent_display_name * @type \Google\Protobuf\Duration $compare_duration * When compare_duration is set, the GroupResult's "state_change" property is * updated to indicate whether the asset was added, removed, or remained * present during the compare_duration period of time that precedes the * read_time. This is the time between (read_time - compare_duration) and * read_time. * The state change value is derived based on the presence of the asset at the * two points in time. Intermediate state changes between the two times don't * affect the result. For example, the results aren't affected if the asset is * removed and re-created again. * Possible "state_change" values when compare_duration is specified: * * "ADDED": indicates that the asset was not present at the start of * compare_duration, but present at reference_time. * * "REMOVED": indicates that the asset was present at the start of * compare_duration, but not present at reference_time. * * "ACTIVE": indicates that the asset was present at both the * start and the end of the time period defined by * compare_duration and reference_time. * If compare_duration is not specified, then the only possible state_change * is "UNUSED", which will be the state_change set for all assets present at * read_time. * If this field is set then `state_change` must be a specified field in * `group_by`. * @type \Google\Protobuf\Timestamp $read_time * Time used as a reference point when filtering assets. The filter is limited * to assets existing at the supplied time and their values are those at that * specific time. Absence of this field will default to the API's version of * NOW. * @type string $page_token * The value returned by the last `GroupAssetsResponse`; indicates * that this is a continuation of a prior `GroupAssets` call, and that the * system should return the next page of data. * @type int $page_size * The maximum number of results to return in a single response. Default is * 10, minimum is 1, maximum is 1000. * } */ public function __construct($data = NULL) { \GPBMetadata\Google\Cloud\Securitycenter\V1\SecuritycenterService::initOnce(); parent::__construct($data); } /** * Required. The name of the parent to group the assets by. Its format is * "organizations/[organization_id]", "folders/[folder_id]", or * "projects/[project_id]". * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string */ public function getParent() { return $this->parent; } /** * Required. The name of the parent to group the assets by. Its format is * "organizations/[organization_id]", "folders/[folder_id]", or * "projects/[project_id]". * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var * @return $this */ public function setParent($var) { GPBUtil::checkString($var, True); $this->parent = $var; return $this; } /** * Expression that defines the filter to apply across assets. * The expression is a list of zero or more restrictions combined via logical * operators `AND` and `OR`. * Parentheses are supported, and `OR` has higher precedence than `AND`. * Restrictions have the form ` ` and may have a `-` * character in front of them to indicate negation. The fields map to those * defined in the Asset resource. Examples include: * * name * * security_center_properties.resource_name * * resource_properties.a_property * * security_marks.marks.marka * The supported operators are: * * `=` for all value types. * * `>`, `<`, `>=`, `<=` for integer values. * * `:`, meaning substring matching, for strings. * The supported value types are: * * string literals in quotes. * * integer literals without quotes. * * boolean literals `true` and `false` without quotes. * The following field and operator combinations are supported: * * name: `=` * * update_time: `=`, `>`, `<`, `>=`, `<=` * Usage: This should be milliseconds since epoch or an RFC3339 string. * Examples: * `update_time = "2019-06-10T16:07:18-07:00"` * `update_time = 1560208038000` * * create_time: `=`, `>`, `<`, `>=`, `<=` * Usage: This should be milliseconds since epoch or an RFC3339 string. * Examples: * `create_time = "2019-06-10T16:07:18-07:00"` * `create_time = 1560208038000` * * iam_policy.policy_blob: `=`, `:` * * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=` * * security_marks.marks: `=`, `:` * * security_center_properties.resource_name: `=`, `:` * * security_center_properties.resource_display_name: `=`, `:` * * security_center_properties.resource_type: `=`, `:` * * security_center_properties.resource_parent: `=`, `:` * * security_center_properties.resource_parent_display_name: `=`, `:` * * security_center_properties.resource_project: `=`, `:` * * security_center_properties.resource_project_display_name: `=`, `:` * * security_center_properties.resource_owners: `=`, `:` * For example, `resource_properties.size = 100` is a valid filter string. * Use a partial match on the empty string to filter based on a property * existing: `resource_properties.my_property : ""` * Use a negated partial match on the empty string to filter based on a * property not existing: `-resource_properties.my_property : ""` * * Generated from protobuf field string filter = 2; * @return string */ public function getFilter() { return $this->filter; } /** * Expression that defines the filter to apply across assets. * The expression is a list of zero or more restrictions combined via logical * operators `AND` and `OR`. * Parentheses are supported, and `OR` has higher precedence than `AND`. * Restrictions have the form ` ` and may have a `-` * character in front of them to indicate negation. The fields map to those * defined in the Asset resource. Examples include: * * name * * security_center_properties.resource_name * * resource_properties.a_property * * security_marks.marks.marka * The supported operators are: * * `=` for all value types. * * `>`, `<`, `>=`, `<=` for integer values. * * `:`, meaning substring matching, for strings. * The supported value types are: * * string literals in quotes. * * integer literals without quotes. * * boolean literals `true` and `false` without quotes. * The following field and operator combinations are supported: * * name: `=` * * update_time: `=`, `>`, `<`, `>=`, `<=` * Usage: This should be milliseconds since epoch or an RFC3339 string. * Examples: * `update_time = "2019-06-10T16:07:18-07:00"` * `update_time = 1560208038000` * * create_time: `=`, `>`, `<`, `>=`, `<=` * Usage: This should be milliseconds since epoch or an RFC3339 string. * Examples: * `create_time = "2019-06-10T16:07:18-07:00"` * `create_time = 1560208038000` * * iam_policy.policy_blob: `=`, `:` * * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=` * * security_marks.marks: `=`, `:` * * security_center_properties.resource_name: `=`, `:` * * security_center_properties.resource_display_name: `=`, `:` * * security_center_properties.resource_type: `=`, `:` * * security_center_properties.resource_parent: `=`, `:` * * security_center_properties.resource_parent_display_name: `=`, `:` * * security_center_properties.resource_project: `=`, `:` * * security_center_properties.resource_project_display_name: `=`, `:` * * security_center_properties.resource_owners: `=`, `:` * For example, `resource_properties.size = 100` is a valid filter string. * Use a partial match on the empty string to filter based on a property * existing: `resource_properties.my_property : ""` * Use a negated partial match on the empty string to filter based on a * property not existing: `-resource_properties.my_property : ""` * * Generated from protobuf field string filter = 2; * @param string $var * @return $this */ public function setFilter($var) { GPBUtil::checkString($var, True); $this->filter = $var; return $this; } /** * Required. Expression that defines what assets fields to use for grouping. * The string value should follow SQL syntax: comma separated list of fields. * For example: * "security_center_properties.resource_project,security_center_properties.project". * The following fields are supported when compare_duration is not set: * * security_center_properties.resource_project * * security_center_properties.resource_project_display_name * * security_center_properties.resource_type * * security_center_properties.resource_parent * * security_center_properties.resource_parent_display_name * The following fields are supported when compare_duration is set: * * security_center_properties.resource_type * * security_center_properties.resource_project_display_name * * security_center_properties.resource_parent_display_name * * Generated from protobuf field string group_by = 3 [(.google.api.field_behavior) = REQUIRED]; * @return string */ public function getGroupBy() { return $this->group_by; } /** * Required. Expression that defines what assets fields to use for grouping. * The string value should follow SQL syntax: comma separated list of fields. * For example: * "security_center_properties.resource_project,security_center_properties.project". * The following fields are supported when compare_duration is not set: * * security_center_properties.resource_project * * security_center_properties.resource_project_display_name * * security_center_properties.resource_type * * security_center_properties.resource_parent * * security_center_properties.resource_parent_display_name * The following fields are supported when compare_duration is set: * * security_center_properties.resource_type * * security_center_properties.resource_project_display_name * * security_center_properties.resource_parent_display_name * * Generated from protobuf field string group_by = 3 [(.google.api.field_behavior) = REQUIRED]; * @param string $var * @return $this */ public function setGroupBy($var) { GPBUtil::checkString($var, True); $this->group_by = $var; return $this; } /** * When compare_duration is set, the GroupResult's "state_change" property is * updated to indicate whether the asset was added, removed, or remained * present during the compare_duration period of time that precedes the * read_time. This is the time between (read_time - compare_duration) and * read_time. * The state change value is derived based on the presence of the asset at the * two points in time. Intermediate state changes between the two times don't * affect the result. For example, the results aren't affected if the asset is * removed and re-created again. * Possible "state_change" values when compare_duration is specified: * * "ADDED": indicates that the asset was not present at the start of * compare_duration, but present at reference_time. * * "REMOVED": indicates that the asset was present at the start of * compare_duration, but not present at reference_time. * * "ACTIVE": indicates that the asset was present at both the * start and the end of the time period defined by * compare_duration and reference_time. * If compare_duration is not specified, then the only possible state_change * is "UNUSED", which will be the state_change set for all assets present at * read_time. * If this field is set then `state_change` must be a specified field in * `group_by`. * * Generated from protobuf field .google.protobuf.Duration compare_duration = 4; * @return \Google\Protobuf\Duration|null */ public function getCompareDuration() { return $this->compare_duration; } public function hasCompareDuration() { return isset($this->compare_duration); } public function clearCompareDuration() { unset($this->compare_duration); } /** * When compare_duration is set, the GroupResult's "state_change" property is * updated to indicate whether the asset was added, removed, or remained * present during the compare_duration period of time that precedes the * read_time. This is the time between (read_time - compare_duration) and * read_time. * The state change value is derived based on the presence of the asset at the * two points in time. Intermediate state changes between the two times don't * affect the result. For example, the results aren't affected if the asset is * removed and re-created again. * Possible "state_change" values when compare_duration is specified: * * "ADDED": indicates that the asset was not present at the start of * compare_duration, but present at reference_time. * * "REMOVED": indicates that the asset was present at the start of * compare_duration, but not present at reference_time. * * "ACTIVE": indicates that the asset was present at both the * start and the end of the time period defined by * compare_duration and reference_time. * If compare_duration is not specified, then the only possible state_change * is "UNUSED", which will be the state_change set for all assets present at * read_time. * If this field is set then `state_change` must be a specified field in * `group_by`. * * Generated from protobuf field .google.protobuf.Duration compare_duration = 4; * @param \Google\Protobuf\Duration $var * @return $this */ public function setCompareDuration($var) { GPBUtil::checkMessage($var, \Google\Protobuf\Duration::class); $this->compare_duration = $var; return $this; } /** * Time used as a reference point when filtering assets. The filter is limited * to assets existing at the supplied time and their values are those at that * specific time. Absence of this field will default to the API's version of * NOW. * * Generated from protobuf field .google.protobuf.Timestamp read_time = 5; * @return \Google\Protobuf\Timestamp|null */ public function getReadTime() { return $this->read_time; } public function hasReadTime() { return isset($this->read_time); } public function clearReadTime() { unset($this->read_time); } /** * Time used as a reference point when filtering assets. The filter is limited * to assets existing at the supplied time and their values are those at that * specific time. Absence of this field will default to the API's version of * NOW. * * Generated from protobuf field .google.protobuf.Timestamp read_time = 5; * @param \Google\Protobuf\Timestamp $var * @return $this */ public function setReadTime($var) { GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); $this->read_time = $var; return $this; } /** * The value returned by the last `GroupAssetsResponse`; indicates * that this is a continuation of a prior `GroupAssets` call, and that the * system should return the next page of data. * * Generated from protobuf field string page_token = 7; * @return string */ public function getPageToken() { return $this->page_token; } /** * The value returned by the last `GroupAssetsResponse`; indicates * that this is a continuation of a prior `GroupAssets` call, and that the * system should return the next page of data. * * Generated from protobuf field string page_token = 7; * @param string $var * @return $this */ public function setPageToken($var) { GPBUtil::checkString($var, True); $this->page_token = $var; return $this; } /** * The maximum number of results to return in a single response. Default is * 10, minimum is 1, maximum is 1000. * * Generated from protobuf field int32 page_size = 8; * @return int */ public function getPageSize() { return $this->page_size; } /** * The maximum number of results to return in a single response. Default is * 10, minimum is 1, maximum is 1000. * * Generated from protobuf field int32 page_size = 8; * @param int $var * @return $this */ public function setPageSize($var) { GPBUtil::checkInt32($var); $this->page_size = $var; return $this; } }