diff --git a/SecurityCenter/metadata/V1/Finding.php b/SecurityCenter/metadata/V1/Finding.php index bbf540666a16..b28c1d7e81c9 100644 Binary files a/SecurityCenter/metadata/V1/Finding.php and b/SecurityCenter/metadata/V1/Finding.php differ diff --git a/SecurityCenter/metadata/V1/MitreAttack.php b/SecurityCenter/metadata/V1/MitreAttack.php index d2d5247864af..3b8049028c0d 100644 Binary files a/SecurityCenter/metadata/V1/MitreAttack.php and b/SecurityCenter/metadata/V1/MitreAttack.php differ diff --git a/SecurityCenter/metadata/V1/MuteConfig.php b/SecurityCenter/metadata/V1/MuteConfig.php index c98c2628fcd8..fc135298b1cf 100644 Binary files a/SecurityCenter/metadata/V1/MuteConfig.php and b/SecurityCenter/metadata/V1/MuteConfig.php differ diff --git a/SecurityCenter/metadata/V1/SecuritycenterService.php b/SecurityCenter/metadata/V1/SecuritycenterService.php index 641895541fc2..95cbc377ad45 100644 Binary files a/SecurityCenter/metadata/V1/SecuritycenterService.php and b/SecurityCenter/metadata/V1/SecuritycenterService.php differ diff --git a/SecurityCenter/metadata/V1/Vulnerability.php b/SecurityCenter/metadata/V1/Vulnerability.php index 96d54a80edd1..c1a7a0d3806e 100644 Binary files a/SecurityCenter/metadata/V1/Vulnerability.php and b/SecurityCenter/metadata/V1/Vulnerability.php differ diff --git a/SecurityCenter/metadata/V2/BigqueryExport.php b/SecurityCenter/metadata/V2/BigqueryExport.php index b3bd3445ab67..7cb61bdba227 100644 --- a/SecurityCenter/metadata/V2/BigqueryExport.php +++ b/SecurityCenter/metadata/V2/BigqueryExport.php @@ -19,10 +19,10 @@ public static function initOnce() { \GPBMetadata\Google\Protobuf\Timestamp::initOnce(); $pool->internalAddGeneratedFile( ' -� -4google/cloud/securitycenter/v2/bigquery_export.protogoogle.cloud.securitycenter.v2google/api/resource.protogoogle/protobuf/timestamp.proto"� -BigQueryExport -name (  +� +4google/cloud/securitycenter/v2/bigquery_export.protogoogle.cloud.securitycenter.v2google/api/resource.protogoogle/protobuf/timestamp.proto"� +BigQueryExport +name ( B�A description (  filter (  dataset ( 4 diff --git a/SecurityCenter/metadata/V2/Finding.php b/SecurityCenter/metadata/V2/Finding.php index ce87104095b8..db08fd18a472 100644 Binary files a/SecurityCenter/metadata/V2/Finding.php and b/SecurityCenter/metadata/V2/Finding.php differ diff --git a/SecurityCenter/metadata/V2/MitreAttack.php b/SecurityCenter/metadata/V2/MitreAttack.php index 61d429ac69c1..cbf3c915fd90 100644 Binary files a/SecurityCenter/metadata/V2/MitreAttack.php and b/SecurityCenter/metadata/V2/MitreAttack.php differ diff --git a/SecurityCenter/metadata/V2/MuteConfig.php b/SecurityCenter/metadata/V2/MuteConfig.php index 6b092319f8dd..cfac4e23b502 100644 Binary files a/SecurityCenter/metadata/V2/MuteConfig.php and b/SecurityCenter/metadata/V2/MuteConfig.php differ diff --git a/SecurityCenter/metadata/V2/NotificationConfig.php b/SecurityCenter/metadata/V2/NotificationConfig.php index 8493156c21bb..e54e75bba0c1 100644 Binary files a/SecurityCenter/metadata/V2/NotificationConfig.php and b/SecurityCenter/metadata/V2/NotificationConfig.php differ diff --git a/SecurityCenter/metadata/V2/ResourceValueConfig.php b/SecurityCenter/metadata/V2/ResourceValueConfig.php index 8b11b3f6e653..47c26bef68ad 100644 Binary files a/SecurityCenter/metadata/V2/ResourceValueConfig.php and b/SecurityCenter/metadata/V2/ResourceValueConfig.php differ diff --git a/SecurityCenter/metadata/V2/SecuritycenterService.php b/SecurityCenter/metadata/V2/SecuritycenterService.php index b0afb9ba07b8..2dcdcefa8de6 100644 Binary files a/SecurityCenter/metadata/V2/SecuritycenterService.php and b/SecurityCenter/metadata/V2/SecuritycenterService.php differ diff --git a/SecurityCenter/metadata/V2/Vulnerability.php b/SecurityCenter/metadata/V2/Vulnerability.php index 91fca7d9ea31..1bc7524830e1 100644 Binary files a/SecurityCenter/metadata/V2/Vulnerability.php and b/SecurityCenter/metadata/V2/Vulnerability.php differ diff --git a/SecurityCenter/src/V1/BulkMuteFindingsRequest.php b/SecurityCenter/src/V1/BulkMuteFindingsRequest.php index 2a2d45ad5e40..33fc7d01ef55 100644 --- a/SecurityCenter/src/V1/BulkMuteFindingsRequest.php +++ b/SecurityCenter/src/V1/BulkMuteFindingsRequest.php @@ -55,6 +55,14 @@ class BulkMuteFindingsRequest extends \Google\Protobuf\Internal\Message * @deprecated */ protected $mute_annotation = ''; + /** + * Optional. All findings matching the given filter will have their mute state + * set to this value. The default value is `MUTED`. Setting this to + * `UNDEFINED` will clear the mute state on all matching findings. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.BulkMuteFindingsRequest.MuteState mute_state = 4 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $mute_state = 0; /** * @param string $parent Required. The parent, at which bulk action needs to be applied. Its format @@ -100,6 +108,10 @@ public static function build(string $parent): self * @type string $mute_annotation * This can be a mute configuration name or any identifier for mute/unmute * of findings based on the filter. + * @type int $mute_state + * Optional. All findings matching the given filter will have their mute state + * set to this value. The default value is `MUTED`. Setting this to + * `UNDEFINED` will clear the mute state on all matching findings. * } */ public function __construct($data = NULL) { @@ -223,5 +235,35 @@ public function setMuteAnnotation($var) return $this; } + /** + * Optional. All findings matching the given filter will have their mute state + * set to this value. The default value is `MUTED`. Setting this to + * `UNDEFINED` will clear the mute state on all matching findings. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.BulkMuteFindingsRequest.MuteState mute_state = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @return int + */ + public function getMuteState() + { + return $this->mute_state; + } + + /** + * Optional. All findings matching the given filter will have their mute state + * set to this value. The default value is `MUTED`. Setting this to + * `UNDEFINED` will clear the mute state on all matching findings. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.BulkMuteFindingsRequest.MuteState mute_state = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var + * @return $this + */ + public function setMuteState($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\SecurityCenter\V1\BulkMuteFindingsRequest\MuteState::class); + $this->mute_state = $var; + + return $this; + } + } diff --git a/SecurityCenter/src/V1/BulkMuteFindingsRequest/MuteState.php b/SecurityCenter/src/V1/BulkMuteFindingsRequest/MuteState.php new file mode 100644 index 000000000000..1487890efd6c --- /dev/null +++ b/SecurityCenter/src/V1/BulkMuteFindingsRequest/MuteState.php @@ -0,0 +1,62 @@ +google.cloud.securitycenter.v1.BulkMuteFindingsRequest.MuteState + */ +class MuteState +{ + /** + * Unused. + * + * Generated from protobuf enum MUTE_STATE_UNSPECIFIED = 0; + */ + const MUTE_STATE_UNSPECIFIED = 0; + /** + * Matching findings will be muted (default). + * + * Generated from protobuf enum MUTED = 1; + */ + const MUTED = 1; + /** + * Matching findings will have their mute state cleared. + * + * Generated from protobuf enum UNDEFINED = 2; + */ + const UNDEFINED = 2; + + private static $valueToName = [ + self::MUTE_STATE_UNSPECIFIED => 'MUTE_STATE_UNSPECIFIED', + self::MUTED => 'MUTED', + self::UNDEFINED => 'UNDEFINED', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/SecurityCenter/src/V1/Cve.php b/SecurityCenter/src/V1/Cve.php index fe9664a68a58..b2672b3b5d08 100644 --- a/SecurityCenter/src/V1/Cve.php +++ b/SecurityCenter/src/V1/Cve.php @@ -69,6 +69,12 @@ class Cve extends \Google\Protobuf\Internal\Message * Generated from protobuf field bool zero_day = 8; */ protected $zero_day = false; + /** + * Date the first publicly available exploit or PoC was released. + * + * Generated from protobuf field .google.protobuf.Timestamp exploit_release_date = 9; + */ + protected $exploit_release_date = null; /** * Constructor. @@ -95,6 +101,8 @@ class Cve extends \Google\Protobuf\Internal\Message * @type bool $zero_day * Whether or not the vulnerability was zero day when the finding was * published. + * @type \Google\Protobuf\Timestamp $exploit_release_date + * Date the first publicly available exploit or PoC was released. * } */ public function __construct($data = NULL) { @@ -326,5 +334,41 @@ public function setZeroDay($var) return $this; } + /** + * Date the first publicly available exploit or PoC was released. + * + * Generated from protobuf field .google.protobuf.Timestamp exploit_release_date = 9; + * @return \Google\Protobuf\Timestamp|null + */ + public function getExploitReleaseDate() + { + return $this->exploit_release_date; + } + + public function hasExploitReleaseDate() + { + return isset($this->exploit_release_date); + } + + public function clearExploitReleaseDate() + { + unset($this->exploit_release_date); + } + + /** + * Date the first publicly available exploit or PoC was released. + * + * Generated from protobuf field .google.protobuf.Timestamp exploit_release_date = 9; + * @param \Google\Protobuf\Timestamp $var + * @return $this + */ + public function setExploitReleaseDate($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); + $this->exploit_release_date = $var; + + return $this; + } + } diff --git a/SecurityCenter/src/V1/DeleteEventThreatDetectionCustomModuleRequest.php b/SecurityCenter/src/V1/DeleteEventThreatDetectionCustomModuleRequest.php index 93cb461d988d..867973683a11 100644 --- a/SecurityCenter/src/V1/DeleteEventThreatDetectionCustomModuleRequest.php +++ b/SecurityCenter/src/V1/DeleteEventThreatDetectionCustomModuleRequest.php @@ -18,9 +18,9 @@ class DeleteEventThreatDetectionCustomModuleRequest extends \Google\Protobuf\Int /** * Required. Name of the custom module to delete. * Its format is: - * * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". - * * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". - * * "projects/{project}/eventThreatDetectionSettings/customModules/{module}". + * * `organizations/{organization}/eventThreatDetectionSettings/customModules/{module}`. + * * `folders/{folder}/eventThreatDetectionSettings/customModules/{module}`. + * * `projects/{project}/eventThreatDetectionSettings/customModules/{module}`. * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,9 +31,9 @@ class DeleteEventThreatDetectionCustomModuleRequest extends \Google\Protobuf\Int * * Its format is: * - * * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". - * * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". - * * "projects/{project}/eventThreatDetectionSettings/customModules/{module}". Please see + * * `organizations/{organization}/eventThreatDetectionSettings/customModules/{module}`. + * * `folders/{folder}/eventThreatDetectionSettings/customModules/{module}`. + * * `projects/{project}/eventThreatDetectionSettings/customModules/{module}`. Please see * {@see SecurityCenterClient::eventThreatDetectionCustomModuleName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V1\DeleteEventThreatDetectionCustomModuleRequest @@ -55,9 +55,9 @@ public static function build(string $name): self * @type string $name * Required. Name of the custom module to delete. * Its format is: - * * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". - * * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". - * * "projects/{project}/eventThreatDetectionSettings/customModules/{module}". + * * `organizations/{organization}/eventThreatDetectionSettings/customModules/{module}`. + * * `folders/{folder}/eventThreatDetectionSettings/customModules/{module}`. + * * `projects/{project}/eventThreatDetectionSettings/customModules/{module}`. * } */ public function __construct($data = NULL) { @@ -68,9 +68,9 @@ public function __construct($data = NULL) { /** * Required. Name of the custom module to delete. * Its format is: - * * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". - * * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". - * * "projects/{project}/eventThreatDetectionSettings/customModules/{module}". + * * `organizations/{organization}/eventThreatDetectionSettings/customModules/{module}`. + * * `folders/{folder}/eventThreatDetectionSettings/customModules/{module}`. + * * `projects/{project}/eventThreatDetectionSettings/customModules/{module}`. * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -83,9 +83,9 @@ public function getName() /** * Required. Name of the custom module to delete. * Its format is: - * * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". - * * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". - * * "projects/{project}/eventThreatDetectionSettings/customModules/{module}". + * * `organizations/{organization}/eventThreatDetectionSettings/customModules/{module}`. + * * `folders/{folder}/eventThreatDetectionSettings/customModules/{module}`. + * * `projects/{project}/eventThreatDetectionSettings/customModules/{module}`. * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V1/Finding.php b/SecurityCenter/src/V1/Finding.php index 85951aedbfca..49c0aca2c856 100644 --- a/SecurityCenter/src/V1/Finding.php +++ b/SecurityCenter/src/V1/Finding.php @@ -200,6 +200,12 @@ class Finding extends \Google\Protobuf\Internal\Message * Generated from protobuf field string mute_initiator = 28; */ protected $mute_initiator = ''; + /** + * Output only. The mute information regarding this finding. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.Finding.MuteInfo mute_info = 61 [(.google.api.field_behavior) = OUTPUT_ONLY]; + */ + protected $mute_info = null; /** * Represents operating system processes associated with the Finding. * @@ -488,6 +494,8 @@ class Finding extends \Google\Protobuf\Internal\Message * Records additional information about the mute operation, for example, the * [mute configuration](/security-command-center/docs/how-to-mute-findings) * that muted the finding and the user who muted the finding. + * @type \Google\Cloud\SecurityCenter\V1\Finding\MuteInfo $mute_info + * Output only. The mute information regarding this finding. * @type array<\Google\Cloud\SecurityCenter\V1\Process>|\Google\Protobuf\Internal\RepeatedField $processes * Represents operating system processes associated with the Finding. * @type array|\Google\Protobuf\Internal\MapField $contacts @@ -1324,6 +1332,42 @@ public function setMuteInitiator($var) return $this; } + /** + * Output only. The mute information regarding this finding. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.Finding.MuteInfo mute_info = 61 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @return \Google\Cloud\SecurityCenter\V1\Finding\MuteInfo|null + */ + public function getMuteInfo() + { + return $this->mute_info; + } + + public function hasMuteInfo() + { + return isset($this->mute_info); + } + + public function clearMuteInfo() + { + unset($this->mute_info); + } + + /** + * Output only. The mute information regarding this finding. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.Finding.MuteInfo mute_info = 61 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @param \Google\Cloud\SecurityCenter\V1\Finding\MuteInfo $var + * @return $this + */ + public function setMuteInfo($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\SecurityCenter\V1\Finding\MuteInfo::class); + $this->mute_info = $var; + + return $this; + } + /** * Represents operating system processes associated with the Finding. * diff --git a/SecurityCenter/src/V1/Finding/MuteInfo.php b/SecurityCenter/src/V1/Finding/MuteInfo.php new file mode 100644 index 000000000000..b152e54714ff --- /dev/null +++ b/SecurityCenter/src/V1/Finding/MuteInfo.php @@ -0,0 +1,117 @@ +google.cloud.securitycenter.v1.Finding.MuteInfo + */ +class MuteInfo extends \Google\Protobuf\Internal\Message +{ + /** + * If set, the static mute applied to this finding. Static mutes override + * dynamic mutes. If unset, there is no static mute. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.Finding.MuteInfo.StaticMute static_mute = 1; + */ + protected $static_mute = null; + /** + * The list of dynamic mute rules that currently match the finding. + * + * Generated from protobuf field repeated .google.cloud.securitycenter.v1.Finding.MuteInfo.DynamicMuteRecord dynamic_mute_records = 2; + */ + private $dynamic_mute_records; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type \Google\Cloud\SecurityCenter\V1\Finding\MuteInfo\StaticMute $static_mute + * If set, the static mute applied to this finding. Static mutes override + * dynamic mutes. If unset, there is no static mute. + * @type array<\Google\Cloud\SecurityCenter\V1\Finding\MuteInfo\DynamicMuteRecord>|\Google\Protobuf\Internal\RepeatedField $dynamic_mute_records + * The list of dynamic mute rules that currently match the finding. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Securitycenter\V1\Finding::initOnce(); + parent::__construct($data); + } + + /** + * If set, the static mute applied to this finding. Static mutes override + * dynamic mutes. If unset, there is no static mute. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.Finding.MuteInfo.StaticMute static_mute = 1; + * @return \Google\Cloud\SecurityCenter\V1\Finding\MuteInfo\StaticMute|null + */ + public function getStaticMute() + { + return $this->static_mute; + } + + public function hasStaticMute() + { + return isset($this->static_mute); + } + + public function clearStaticMute() + { + unset($this->static_mute); + } + + /** + * If set, the static mute applied to this finding. Static mutes override + * dynamic mutes. If unset, there is no static mute. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.Finding.MuteInfo.StaticMute static_mute = 1; + * @param \Google\Cloud\SecurityCenter\V1\Finding\MuteInfo\StaticMute $var + * @return $this + */ + public function setStaticMute($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\SecurityCenter\V1\Finding\MuteInfo\StaticMute::class); + $this->static_mute = $var; + + return $this; + } + + /** + * The list of dynamic mute rules that currently match the finding. + * + * Generated from protobuf field repeated .google.cloud.securitycenter.v1.Finding.MuteInfo.DynamicMuteRecord dynamic_mute_records = 2; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getDynamicMuteRecords() + { + return $this->dynamic_mute_records; + } + + /** + * The list of dynamic mute rules that currently match the finding. + * + * Generated from protobuf field repeated .google.cloud.securitycenter.v1.Finding.MuteInfo.DynamicMuteRecord dynamic_mute_records = 2; + * @param array<\Google\Cloud\SecurityCenter\V1\Finding\MuteInfo\DynamicMuteRecord>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setDynamicMuteRecords($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\SecurityCenter\V1\Finding\MuteInfo\DynamicMuteRecord::class); + $this->dynamic_mute_records = $arr; + + return $this; + } + +} + + diff --git a/SecurityCenter/src/V1/Finding/MuteInfo/DynamicMuteRecord.php b/SecurityCenter/src/V1/Finding/MuteInfo/DynamicMuteRecord.php new file mode 100644 index 000000000000..2955ddd53e43 --- /dev/null +++ b/SecurityCenter/src/V1/Finding/MuteInfo/DynamicMuteRecord.php @@ -0,0 +1,124 @@ +google.cloud.securitycenter.v1.Finding.MuteInfo.DynamicMuteRecord + */ +class DynamicMuteRecord extends \Google\Protobuf\Internal\Message +{ + /** + * The relative resource name of the mute rule, represented by a mute + * config, that created this record, for example + * `organizations/123/muteConfigs/mymuteconfig` or + * `organizations/123/locations/global/muteConfigs/mymuteconfig`. + * + * Generated from protobuf field string mute_config = 1; + */ + protected $mute_config = ''; + /** + * When the dynamic mute rule first matched the finding. + * + * Generated from protobuf field .google.protobuf.Timestamp match_time = 2; + */ + protected $match_time = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $mute_config + * The relative resource name of the mute rule, represented by a mute + * config, that created this record, for example + * `organizations/123/muteConfigs/mymuteconfig` or + * `organizations/123/locations/global/muteConfigs/mymuteconfig`. + * @type \Google\Protobuf\Timestamp $match_time + * When the dynamic mute rule first matched the finding. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Securitycenter\V1\Finding::initOnce(); + parent::__construct($data); + } + + /** + * The relative resource name of the mute rule, represented by a mute + * config, that created this record, for example + * `organizations/123/muteConfigs/mymuteconfig` or + * `organizations/123/locations/global/muteConfigs/mymuteconfig`. + * + * Generated from protobuf field string mute_config = 1; + * @return string + */ + public function getMuteConfig() + { + return $this->mute_config; + } + + /** + * The relative resource name of the mute rule, represented by a mute + * config, that created this record, for example + * `organizations/123/muteConfigs/mymuteconfig` or + * `organizations/123/locations/global/muteConfigs/mymuteconfig`. + * + * Generated from protobuf field string mute_config = 1; + * @param string $var + * @return $this + */ + public function setMuteConfig($var) + { + GPBUtil::checkString($var, True); + $this->mute_config = $var; + + return $this; + } + + /** + * When the dynamic mute rule first matched the finding. + * + * Generated from protobuf field .google.protobuf.Timestamp match_time = 2; + * @return \Google\Protobuf\Timestamp|null + */ + public function getMatchTime() + { + return $this->match_time; + } + + public function hasMatchTime() + { + return isset($this->match_time); + } + + public function clearMatchTime() + { + unset($this->match_time); + } + + /** + * When the dynamic mute rule first matched the finding. + * + * Generated from protobuf field .google.protobuf.Timestamp match_time = 2; + * @param \Google\Protobuf\Timestamp $var + * @return $this + */ + public function setMatchTime($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); + $this->match_time = $var; + + return $this; + } + +} + + diff --git a/SecurityCenter/src/V1/Finding/MuteInfo/StaticMute.php b/SecurityCenter/src/V1/Finding/MuteInfo/StaticMute.php new file mode 100644 index 000000000000..b9f93e28e5bb --- /dev/null +++ b/SecurityCenter/src/V1/Finding/MuteInfo/StaticMute.php @@ -0,0 +1,118 @@ +google.cloud.securitycenter.v1.Finding.MuteInfo.StaticMute + */ +class StaticMute extends \Google\Protobuf\Internal\Message +{ + /** + * The static mute state. If the value is `MUTED` or `UNMUTED`, then the + * finding's overall mute state will have the same value. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.Finding.Mute state = 1; + */ + protected $state = 0; + /** + * When the static mute was applied. + * + * Generated from protobuf field .google.protobuf.Timestamp apply_time = 2; + */ + protected $apply_time = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $state + * The static mute state. If the value is `MUTED` or `UNMUTED`, then the + * finding's overall mute state will have the same value. + * @type \Google\Protobuf\Timestamp $apply_time + * When the static mute was applied. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Securitycenter\V1\Finding::initOnce(); + parent::__construct($data); + } + + /** + * The static mute state. If the value is `MUTED` or `UNMUTED`, then the + * finding's overall mute state will have the same value. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.Finding.Mute state = 1; + * @return int + */ + public function getState() + { + return $this->state; + } + + /** + * The static mute state. If the value is `MUTED` or `UNMUTED`, then the + * finding's overall mute state will have the same value. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.Finding.Mute state = 1; + * @param int $var + * @return $this + */ + public function setState($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\SecurityCenter\V1\Finding\Mute::class); + $this->state = $var; + + return $this; + } + + /** + * When the static mute was applied. + * + * Generated from protobuf field .google.protobuf.Timestamp apply_time = 2; + * @return \Google\Protobuf\Timestamp|null + */ + public function getApplyTime() + { + return $this->apply_time; + } + + public function hasApplyTime() + { + return isset($this->apply_time); + } + + public function clearApplyTime() + { + unset($this->apply_time); + } + + /** + * When the static mute was applied. + * + * Generated from protobuf field .google.protobuf.Timestamp apply_time = 2; + * @param \Google\Protobuf\Timestamp $var + * @return $this + */ + public function setApplyTime($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); + $this->apply_time = $var; + + return $this; + } + +} + + diff --git a/SecurityCenter/src/V1/MitreAttack/Technique.php b/SecurityCenter/src/V1/MitreAttack/Technique.php index 935cafc02e76..0d3d225c0f06 100644 --- a/SecurityCenter/src/V1/MitreAttack/Technique.php +++ b/SecurityCenter/src/V1/MitreAttack/Technique.php @@ -9,7 +9,7 @@ /** * MITRE ATT&CK techniques that can be referenced by SCC findings. * See: https://attack.mitre.org/techniques/enterprise/ - * Next ID: 63 + * Next ID: 65 * * Protobuf type google.cloud.securitycenter.v1.MitreAttack.Technique */ @@ -75,6 +75,12 @@ class Technique * Generated from protobuf enum PYTHON = 59; */ const PYTHON = 59; + /** + * T1068 + * + * Generated from protobuf enum EXPLOITATION_FOR_PRIVILEGE_ESCALATION = 63; + */ + const EXPLOITATION_FOR_PRIVILEGE_ESCALATION = 63; /** * T1069 * @@ -87,6 +93,12 @@ class Technique * Generated from protobuf enum CLOUD_GROUPS = 19; */ const CLOUD_GROUPS = 19; + /** + * T1070.004 + * + * Generated from protobuf enum INDICATOR_REMOVAL_FILE_DELETION = 64; + */ + const INDICATOR_REMOVAL_FILE_DELETION = 64; /** * T1071 * @@ -405,8 +417,10 @@ class Technique self::COMMAND_AND_SCRIPTING_INTERPRETER => 'COMMAND_AND_SCRIPTING_INTERPRETER', self::UNIX_SHELL => 'UNIX_SHELL', self::PYTHON => 'PYTHON', + self::EXPLOITATION_FOR_PRIVILEGE_ESCALATION => 'EXPLOITATION_FOR_PRIVILEGE_ESCALATION', self::PERMISSION_GROUPS_DISCOVERY => 'PERMISSION_GROUPS_DISCOVERY', self::CLOUD_GROUPS => 'CLOUD_GROUPS', + self::INDICATOR_REMOVAL_FILE_DELETION => 'INDICATOR_REMOVAL_FILE_DELETION', self::APPLICATION_LAYER_PROTOCOL => 'APPLICATION_LAYER_PROTOCOL', self::DNS => 'DNS', self::SOFTWARE_DEPLOYMENT_TOOLS => 'SOFTWARE_DEPLOYMENT_TOOLS', diff --git a/SecurityCenter/src/V1/MuteConfig.php b/SecurityCenter/src/V1/MuteConfig.php index 51c7773423f4..fbe9c5bfa23e 100644 --- a/SecurityCenter/src/V1/MuteConfig.php +++ b/SecurityCenter/src/V1/MuteConfig.php @@ -88,6 +88,23 @@ class MuteConfig extends \Google\Protobuf\Internal\Message * Generated from protobuf field string most_recent_editor = 7 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ protected $most_recent_editor = ''; + /** + * Optional. The type of the mute config, which determines what type of mute + * state the config affects. The static mute state takes precedence over the + * dynamic mute state. Immutable after creation. STATIC by default if not set + * during creation. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.MuteConfig.MuteConfigType type = 8 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $type = 0; + /** + * Optional. The expiry of the mute config. Only applicable for dynamic + * configs. If the expiry is set, when the config expires, it is removed from + * all findings. + * + * Generated from protobuf field .google.protobuf.Timestamp expiry_time = 9 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $expiry_time = null; /** * Constructor. @@ -138,6 +155,15 @@ class MuteConfig extends \Google\Protobuf\Internal\Message * Output only. Email address of the user who last edited the mute config. * This field is set by the server and will be ignored if provided on config * creation or update. + * @type int $type + * Optional. The type of the mute config, which determines what type of mute + * state the config affects. The static mute state takes precedence over the + * dynamic mute state. Immutable after creation. STATIC by default if not set + * during creation. + * @type \Google\Protobuf\Timestamp $expiry_time + * Optional. The expiry of the mute config. Only applicable for dynamic + * configs. If the expiry is set, when the config expires, it is removed from + * all findings. * } */ public function __construct($data = NULL) { @@ -409,5 +435,77 @@ public function setMostRecentEditor($var) return $this; } + /** + * Optional. The type of the mute config, which determines what type of mute + * state the config affects. The static mute state takes precedence over the + * dynamic mute state. Immutable after creation. STATIC by default if not set + * during creation. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.MuteConfig.MuteConfigType type = 8 [(.google.api.field_behavior) = OPTIONAL]; + * @return int + */ + public function getType() + { + return $this->type; + } + + /** + * Optional. The type of the mute config, which determines what type of mute + * state the config affects. The static mute state takes precedence over the + * dynamic mute state. Immutable after creation. STATIC by default if not set + * during creation. + * + * Generated from protobuf field .google.cloud.securitycenter.v1.MuteConfig.MuteConfigType type = 8 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var + * @return $this + */ + public function setType($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\SecurityCenter\V1\MuteConfig\MuteConfigType::class); + $this->type = $var; + + return $this; + } + + /** + * Optional. The expiry of the mute config. Only applicable for dynamic + * configs. If the expiry is set, when the config expires, it is removed from + * all findings. + * + * Generated from protobuf field .google.protobuf.Timestamp expiry_time = 9 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Protobuf\Timestamp|null + */ + public function getExpiryTime() + { + return $this->expiry_time; + } + + public function hasExpiryTime() + { + return isset($this->expiry_time); + } + + public function clearExpiryTime() + { + unset($this->expiry_time); + } + + /** + * Optional. The expiry of the mute config. Only applicable for dynamic + * configs. If the expiry is set, when the config expires, it is removed from + * all findings. + * + * Generated from protobuf field .google.protobuf.Timestamp expiry_time = 9 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Protobuf\Timestamp $var + * @return $this + */ + public function setExpiryTime($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); + $this->expiry_time = $var; + + return $this; + } + } diff --git a/SecurityCenter/src/V1/MuteConfig/MuteConfigType.php b/SecurityCenter/src/V1/MuteConfig/MuteConfigType.php new file mode 100644 index 000000000000..4dc3a704dd94 --- /dev/null +++ b/SecurityCenter/src/V1/MuteConfig/MuteConfigType.php @@ -0,0 +1,73 @@ +google.cloud.securitycenter.v1.MuteConfig.MuteConfigType + */ +class MuteConfigType +{ + /** + * Unused. + * + * Generated from protobuf enum MUTE_CONFIG_TYPE_UNSPECIFIED = 0; + */ + const MUTE_CONFIG_TYPE_UNSPECIFIED = 0; + /** + * A static mute config, which sets the static mute state of future matching + * findings to muted. Once the static mute state has been set, finding or + * config modifications will not affect the state. + * + * Generated from protobuf enum STATIC = 1; + */ + const PBSTATIC = 1; + /** + * A dynamic mute config, which is applied to existing and future matching + * findings, setting their dynamic mute state to "muted". If the config is + * updated or deleted, or a matching finding is updated, such that the + * finding doesn't match the config, the config will be removed from the + * finding, and the finding's dynamic mute state may become "unmuted" + * (unless other configs still match). + * + * Generated from protobuf enum DYNAMIC = 2; + */ + const DYNAMIC = 2; + + private static $valueToName = [ + self::MUTE_CONFIG_TYPE_UNSPECIFIED => 'MUTE_CONFIG_TYPE_UNSPECIFIED', + self::PBSTATIC => 'STATIC', + self::DYNAMIC => 'DYNAMIC', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + $pbconst = __CLASS__. '::PB' . strtoupper($name); + if (!defined($pbconst)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($pbconst); + } + return constant($const); + } +} + + diff --git a/SecurityCenter/src/V2/AttackExposure.php b/SecurityCenter/src/V2/AttackExposure.php index 1c7ab996ecca..b0106206d916 100644 --- a/SecurityCenter/src/V2/AttackExposure.php +++ b/SecurityCenter/src/V2/AttackExposure.php @@ -32,7 +32,7 @@ class AttackExposure extends \Google\Protobuf\Internal\Message /** * The resource name of the attack path simulation result that contains the * details regarding this attack exposure score. - * Example: organizations/123/simulations/456/attackExposureResults/789 + * Example: `organizations/123/simulations/456/attackExposureResults/789` * * Generated from protobuf field string attack_exposure_result = 3; */ @@ -81,7 +81,7 @@ class AttackExposure extends \Google\Protobuf\Internal\Message * @type string $attack_exposure_result * The resource name of the attack path simulation result that contains the * details regarding this attack exposure score. - * Example: organizations/123/simulations/456/attackExposureResults/789 + * Example: `organizations/123/simulations/456/attackExposureResults/789` * @type int $state * Output only. What state this AttackExposure is in. This captures whether or * not an attack exposure has been calculated or not. @@ -170,7 +170,7 @@ public function setLatestCalculationTime($var) /** * The resource name of the attack path simulation result that contains the * details regarding this attack exposure score. - * Example: organizations/123/simulations/456/attackExposureResults/789 + * Example: `organizations/123/simulations/456/attackExposureResults/789` * * Generated from protobuf field string attack_exposure_result = 3; * @return string @@ -183,7 +183,7 @@ public function getAttackExposureResult() /** * The resource name of the attack path simulation result that contains the * details regarding this attack exposure score. - * Example: organizations/123/simulations/456/attackExposureResults/789 + * Example: `organizations/123/simulations/456/attackExposureResults/789` * * Generated from protobuf field string attack_exposure_result = 3; * @param string $var diff --git a/SecurityCenter/src/V2/AttackPath/AttackPathNode.php b/SecurityCenter/src/V2/AttackPath/AttackPathNode.php index 5a8c0a094fca..d6a67eaad8f1 100644 --- a/SecurityCenter/src/V2/AttackPath/AttackPathNode.php +++ b/SecurityCenter/src/V2/AttackPath/AttackPathNode.php @@ -19,14 +19,14 @@ class AttackPathNode extends \Google\Protobuf\Internal\Message * The name of the resource at this point in the attack path. * The format of the name follows the Cloud Asset Inventory [resource * name - * format]("https://cloud.google.com/asset-inventory/docs/resource-name-format") + * format](https://cloud.google.com/asset-inventory/docs/resource-name-format) * * Generated from protobuf field string resource = 1; */ protected $resource = ''; /** * The [supported resource - * type](https://cloud.google.com/asset-inventory/docs/supported-asset-types") + * type](https://cloud.google.com/asset-inventory/docs/supported-asset-types) * * Generated from protobuf field string resource_type = 2; */ @@ -66,10 +66,10 @@ class AttackPathNode extends \Google\Protobuf\Internal\Message * The name of the resource at this point in the attack path. * The format of the name follows the Cloud Asset Inventory [resource * name - * format]("https://cloud.google.com/asset-inventory/docs/resource-name-format") + * format](https://cloud.google.com/asset-inventory/docs/resource-name-format) * @type string $resource_type * The [supported resource - * type](https://cloud.google.com/asset-inventory/docs/supported-asset-types") + * type](https://cloud.google.com/asset-inventory/docs/supported-asset-types) * @type string $display_name * Human-readable name of this resource. * @type array<\Google\Cloud\SecurityCenter\V2\AttackPath\AttackPathNode\PathNodeAssociatedFinding>|\Google\Protobuf\Internal\RepeatedField $associated_findings @@ -89,7 +89,7 @@ public function __construct($data = NULL) { * The name of the resource at this point in the attack path. * The format of the name follows the Cloud Asset Inventory [resource * name - * format]("https://cloud.google.com/asset-inventory/docs/resource-name-format") + * format](https://cloud.google.com/asset-inventory/docs/resource-name-format) * * Generated from protobuf field string resource = 1; * @return string @@ -103,7 +103,7 @@ public function getResource() * The name of the resource at this point in the attack path. * The format of the name follows the Cloud Asset Inventory [resource * name - * format]("https://cloud.google.com/asset-inventory/docs/resource-name-format") + * format](https://cloud.google.com/asset-inventory/docs/resource-name-format) * * Generated from protobuf field string resource = 1; * @param string $var @@ -119,7 +119,7 @@ public function setResource($var) /** * The [supported resource - * type](https://cloud.google.com/asset-inventory/docs/supported-asset-types") + * type](https://cloud.google.com/asset-inventory/docs/supported-asset-types) * * Generated from protobuf field string resource_type = 2; * @return string @@ -131,7 +131,7 @@ public function getResourceType() /** * The [supported resource - * type](https://cloud.google.com/asset-inventory/docs/supported-asset-types") + * type](https://cloud.google.com/asset-inventory/docs/supported-asset-types) * * Generated from protobuf field string resource_type = 2; * @param string $var diff --git a/SecurityCenter/src/V2/AttackPath/AttackPathNode/PathNodeAssociatedFinding.php b/SecurityCenter/src/V2/AttackPath/AttackPathNode/PathNodeAssociatedFinding.php index a728f43a027e..8c24970743c8 100644 --- a/SecurityCenter/src/V2/AttackPath/AttackPathNode/PathNodeAssociatedFinding.php +++ b/SecurityCenter/src/V2/AttackPath/AttackPathNode/PathNodeAssociatedFinding.php @@ -17,7 +17,7 @@ class PathNodeAssociatedFinding extends \Google\Protobuf\Internal\Message { /** * Canonical name of the associated findings. Example: - * organizations/123/sources/456/findings/789 + * `organizations/123/sources/456/findings/789` * * Generated from protobuf field string canonical_finding = 1; */ @@ -43,7 +43,7 @@ class PathNodeAssociatedFinding extends \Google\Protobuf\Internal\Message * * @type string $canonical_finding * Canonical name of the associated findings. Example: - * organizations/123/sources/456/findings/789 + * `organizations/123/sources/456/findings/789` * @type string $finding_category * The additional taxonomy group within findings from a given source. * @type string $name @@ -57,7 +57,7 @@ public function __construct($data = NULL) { /** * Canonical name of the associated findings. Example: - * organizations/123/sources/456/findings/789 + * `organizations/123/sources/456/findings/789` * * Generated from protobuf field string canonical_finding = 1; * @return string @@ -69,7 +69,7 @@ public function getCanonicalFinding() /** * Canonical name of the associated findings. Example: - * organizations/123/sources/456/findings/789 + * `organizations/123/sources/456/findings/789` * * Generated from protobuf field string canonical_finding = 1; * @param string $var diff --git a/SecurityCenter/src/V2/AzureMetadata/AzureManagementGroup.php b/SecurityCenter/src/V2/AzureMetadata/AzureManagementGroup.php index 47ea0ecd8c5d..b5fbf29e015d 100644 --- a/SecurityCenter/src/V2/AzureMetadata/AzureManagementGroup.php +++ b/SecurityCenter/src/V2/AzureMetadata/AzureManagementGroup.php @@ -17,7 +17,7 @@ class AzureManagementGroup extends \Google\Protobuf\Internal\Message { /** * The UUID of the Azure management group, for example, - * "20000000-0001-0000-0000-000000000000". + * `20000000-0001-0000-0000-000000000000`. * * Generated from protobuf field string id = 1; */ @@ -37,7 +37,7 @@ class AzureManagementGroup extends \Google\Protobuf\Internal\Message * * @type string $id * The UUID of the Azure management group, for example, - * "20000000-0001-0000-0000-000000000000". + * `20000000-0001-0000-0000-000000000000`. * @type string $display_name * The display name of the Azure management group. * } @@ -49,7 +49,7 @@ public function __construct($data = NULL) { /** * The UUID of the Azure management group, for example, - * "20000000-0001-0000-0000-000000000000". + * `20000000-0001-0000-0000-000000000000`. * * Generated from protobuf field string id = 1; * @return string @@ -61,7 +61,7 @@ public function getId() /** * The UUID of the Azure management group, for example, - * "20000000-0001-0000-0000-000000000000". + * `20000000-0001-0000-0000-000000000000`. * * Generated from protobuf field string id = 1; * @param string $var diff --git a/SecurityCenter/src/V2/AzureMetadata/AzureSubscription.php b/SecurityCenter/src/V2/AzureMetadata/AzureSubscription.php index 8555af1e4d2f..65c3cf967fa7 100644 --- a/SecurityCenter/src/V2/AzureMetadata/AzureSubscription.php +++ b/SecurityCenter/src/V2/AzureMetadata/AzureSubscription.php @@ -17,7 +17,7 @@ class AzureSubscription extends \Google\Protobuf\Internal\Message { /** * The UUID of the Azure subscription, for example, - * "291bba3f-e0a5-47bc-a099-3bdcb2a50a05". + * `291bba3f-e0a5-47bc-a099-3bdcb2a50a05`. * * Generated from protobuf field string id = 1; */ @@ -37,7 +37,7 @@ class AzureSubscription extends \Google\Protobuf\Internal\Message * * @type string $id * The UUID of the Azure subscription, for example, - * "291bba3f-e0a5-47bc-a099-3bdcb2a50a05". + * `291bba3f-e0a5-47bc-a099-3bdcb2a50a05`. * @type string $display_name * The display name of the Azure subscription. * } @@ -49,7 +49,7 @@ public function __construct($data = NULL) { /** * The UUID of the Azure subscription, for example, - * "291bba3f-e0a5-47bc-a099-3bdcb2a50a05". + * `291bba3f-e0a5-47bc-a099-3bdcb2a50a05`. * * Generated from protobuf field string id = 1; * @return string @@ -61,7 +61,7 @@ public function getId() /** * The UUID of the Azure subscription, for example, - * "291bba3f-e0a5-47bc-a099-3bdcb2a50a05". + * `291bba3f-e0a5-47bc-a099-3bdcb2a50a05`. * * Generated from protobuf field string id = 1; * @param string $var diff --git a/SecurityCenter/src/V2/BigQueryExport.php b/SecurityCenter/src/V2/BigQueryExport.php index 4f52487609e8..b39d9a70343a 100644 --- a/SecurityCenter/src/V2/BigQueryExport.php +++ b/SecurityCenter/src/V2/BigQueryExport.php @@ -16,7 +16,7 @@ class BigQueryExport extends \Google\Protobuf\Internal\Message { /** - * The relative resource name of this export. See: + * Identifier. The relative resource name of this export. See: * https://cloud.google.com/apis/design/resource_names#relative_resource_name. * The following list shows some examples: * + @@ -27,7 +27,7 @@ class BigQueryExport extends \Google\Protobuf\Internal\Message * This field is provided in responses, and is ignored when provided in create * requests. * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; */ protected $name = ''; /** @@ -59,7 +59,7 @@ class BigQueryExport extends \Google\Protobuf\Internal\Message /** * The dataset to write findings' updates to. Its format is * "projects/[project_id]/datasets/[bigquery_dataset_id]". - * BigQuery Dataset unique ID must contain only letters (a-z, A-Z), numbers + * BigQuery dataset unique ID must contain only letters (a-z, A-Z), numbers * (0-9), or underscores (_). * * Generated from protobuf field string dataset = 4; @@ -104,7 +104,7 @@ class BigQueryExport extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $name - * The relative resource name of this export. See: + * Identifier. The relative resource name of this export. See: * https://cloud.google.com/apis/design/resource_names#relative_resource_name. * The following list shows some examples: * + @@ -135,7 +135,7 @@ class BigQueryExport extends \Google\Protobuf\Internal\Message * @type string $dataset * The dataset to write findings' updates to. Its format is * "projects/[project_id]/datasets/[bigquery_dataset_id]". - * BigQuery Dataset unique ID must contain only letters (a-z, A-Z), numbers + * BigQuery dataset unique ID must contain only letters (a-z, A-Z), numbers * (0-9), or underscores (_). * @type \Google\Protobuf\Timestamp $create_time * Output only. The time at which the BigQuery export was created. @@ -160,7 +160,7 @@ public function __construct($data = NULL) { } /** - * The relative resource name of this export. See: + * Identifier. The relative resource name of this export. See: * https://cloud.google.com/apis/design/resource_names#relative_resource_name. * The following list shows some examples: * + @@ -171,7 +171,7 @@ public function __construct($data = NULL) { * This field is provided in responses, and is ignored when provided in create * requests. * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @return string */ public function getName() @@ -180,7 +180,7 @@ public function getName() } /** - * The relative resource name of this export. See: + * Identifier. The relative resource name of this export. See: * https://cloud.google.com/apis/design/resource_names#relative_resource_name. * The following list shows some examples: * + @@ -191,7 +191,7 @@ public function getName() * This field is provided in responses, and is ignored when provided in create * requests. * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @param string $var * @return $this */ @@ -286,7 +286,7 @@ public function setFilter($var) /** * The dataset to write findings' updates to. Its format is * "projects/[project_id]/datasets/[bigquery_dataset_id]". - * BigQuery Dataset unique ID must contain only letters (a-z, A-Z), numbers + * BigQuery dataset unique ID must contain only letters (a-z, A-Z), numbers * (0-9), or underscores (_). * * Generated from protobuf field string dataset = 4; @@ -300,7 +300,7 @@ public function getDataset() /** * The dataset to write findings' updates to. Its format is * "projects/[project_id]/datasets/[bigquery_dataset_id]". - * BigQuery Dataset unique ID must contain only letters (a-z, A-Z), numbers + * BigQuery dataset unique ID must contain only letters (a-z, A-Z), numbers * (0-9), or underscores (_). * * Generated from protobuf field string dataset = 4; diff --git a/SecurityCenter/src/V2/BulkMuteFindingsRequest.php b/SecurityCenter/src/V2/BulkMuteFindingsRequest.php index 8a1d92e384e0..d47d6fb489ef 100644 --- a/SecurityCenter/src/V2/BulkMuteFindingsRequest.php +++ b/SecurityCenter/src/V2/BulkMuteFindingsRequest.php @@ -53,6 +53,14 @@ class BulkMuteFindingsRequest extends \Google\Protobuf\Internal\Message * Generated from protobuf field string filter = 2; */ protected $filter = ''; + /** + * Optional. All findings matching the given filter will have their mute state + * set to this value. The default value is `MUTED`. Setting this to + * `UNDEFINED` will clear the mute state on all matching findings. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.BulkMuteFindingsRequest.MuteState mute_state = 3 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $mute_state = 0; /** * @param string $parent Required. The parent, at which bulk action needs to be applied. If no @@ -108,6 +116,10 @@ public static function build(string $parent): self * * string literals in quotes. * * integer literals without quotes. * * boolean literals `true` and `false` without quotes. + * @type int $mute_state + * Optional. All findings matching the given filter will have their mute state + * set to this value. The default value is `MUTED`. Setting this to + * `UNDEFINED` will clear the mute state on all matching findings. * } */ public function __construct($data = NULL) { @@ -211,5 +223,35 @@ public function setFilter($var) return $this; } + /** + * Optional. All findings matching the given filter will have their mute state + * set to this value. The default value is `MUTED`. Setting this to + * `UNDEFINED` will clear the mute state on all matching findings. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.BulkMuteFindingsRequest.MuteState mute_state = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @return int + */ + public function getMuteState() + { + return $this->mute_state; + } + + /** + * Optional. All findings matching the given filter will have their mute state + * set to this value. The default value is `MUTED`. Setting this to + * `UNDEFINED` will clear the mute state on all matching findings. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.BulkMuteFindingsRequest.MuteState mute_state = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var + * @return $this + */ + public function setMuteState($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\SecurityCenter\V2\BulkMuteFindingsRequest\MuteState::class); + $this->mute_state = $var; + + return $this; + } + } diff --git a/SecurityCenter/src/V2/BulkMuteFindingsRequest/MuteState.php b/SecurityCenter/src/V2/BulkMuteFindingsRequest/MuteState.php new file mode 100644 index 000000000000..479efe01cb92 --- /dev/null +++ b/SecurityCenter/src/V2/BulkMuteFindingsRequest/MuteState.php @@ -0,0 +1,62 @@ +google.cloud.securitycenter.v2.BulkMuteFindingsRequest.MuteState + */ +class MuteState +{ + /** + * Unused. + * + * Generated from protobuf enum MUTE_STATE_UNSPECIFIED = 0; + */ + const MUTE_STATE_UNSPECIFIED = 0; + /** + * Matching findings will be muted (default). + * + * Generated from protobuf enum MUTED = 1; + */ + const MUTED = 1; + /** + * Matching findings will have their mute state cleared. + * + * Generated from protobuf enum UNDEFINED = 2; + */ + const UNDEFINED = 2; + + private static $valueToName = [ + self::MUTE_STATE_UNSPECIFIED => 'MUTE_STATE_UNSPECIFIED', + self::MUTED => 'MUTED', + self::UNDEFINED => 'UNDEFINED', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/SecurityCenter/src/V2/CreateBigQueryExportRequest.php b/SecurityCenter/src/V2/CreateBigQueryExportRequest.php index 67573501164e..f3d80c48836a 100644 --- a/SecurityCenter/src/V2/CreateBigQueryExportRequest.php +++ b/SecurityCenter/src/V2/CreateBigQueryExportRequest.php @@ -17,9 +17,9 @@ class CreateBigQueryExportRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the parent resource of the new BigQuery export. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -42,9 +42,9 @@ class CreateBigQueryExportRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. The name of the parent resource of the new BigQuery export. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". Please see + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. Please see * {@see SecurityCenterClient::organizationLocationName()} for help formatting this field. * @param \Google\Cloud\SecurityCenter\V2\BigQueryExport $bigQueryExport Required. The BigQuery export being created. * @param string $bigQueryExportId Required. Unique identifier provided by the client within the parent scope. @@ -72,9 +72,9 @@ public static function build(string $parent, \Google\Cloud\SecurityCenter\V2\Big * * @type string $parent * Required. The name of the parent resource of the new BigQuery export. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * @type \Google\Cloud\SecurityCenter\V2\BigQueryExport $big_query_export * Required. The BigQuery export being created. * @type string $big_query_export_id @@ -91,9 +91,9 @@ public function __construct($data = NULL) { /** * Required. The name of the parent resource of the new BigQuery export. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -105,9 +105,9 @@ public function getParent() /** * Required. The name of the parent resource of the new BigQuery export. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/CreateMuteConfigRequest.php b/SecurityCenter/src/V2/CreateMuteConfigRequest.php index 137dd1b119c6..54454d9d0a6d 100644 --- a/SecurityCenter/src/V2/CreateMuteConfigRequest.php +++ b/SecurityCenter/src/V2/CreateMuteConfigRequest.php @@ -17,9 +17,9 @@ class CreateMuteConfigRequest extends \Google\Protobuf\Internal\Message { /** * Required. Resource name of the new mute configs's parent. Its format is - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -42,9 +42,9 @@ class CreateMuteConfigRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. Resource name of the new mute configs's parent. Its format is - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". Please see + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. Please see * {@see SecurityCenterClient::organizationLocationName()} for help formatting this field. * @param \Google\Cloud\SecurityCenter\V2\MuteConfig $muteConfig Required. The mute config being created. * @param string $muteConfigId Required. Unique identifier provided by the client within the parent scope. @@ -72,9 +72,9 @@ public static function build(string $parent, \Google\Cloud\SecurityCenter\V2\Mut * * @type string $parent * Required. Resource name of the new mute configs's parent. Its format is - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * @type \Google\Cloud\SecurityCenter\V2\MuteConfig $mute_config * Required. The mute config being created. * @type string $mute_config_id @@ -91,9 +91,9 @@ public function __construct($data = NULL) { /** * Required. Resource name of the new mute configs's parent. Its format is - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -105,9 +105,9 @@ public function getParent() /** * Required. Resource name of the new mute configs's parent. Its format is - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/CreateNotificationConfigRequest.php b/SecurityCenter/src/V2/CreateNotificationConfigRequest.php index aade0d29f8d1..3d8a30d97582 100644 --- a/SecurityCenter/src/V2/CreateNotificationConfigRequest.php +++ b/SecurityCenter/src/V2/CreateNotificationConfigRequest.php @@ -17,9 +17,9 @@ class CreateNotificationConfigRequest extends \Google\Protobuf\Internal\Message { /** * Required. Resource name of the new notification config's parent. Its format - * is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -44,9 +44,9 @@ class CreateNotificationConfigRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. Resource name of the new notification config's parent. Its format - * is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". Please see + * is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. Please see * {@see SecurityCenterClient::organizationLocationName()} for help formatting this field. * @param \Google\Cloud\SecurityCenter\V2\NotificationConfig $notificationConfig Required. The notification config being created. The name and the service * account will be ignored as they are both output only fields on this @@ -76,9 +76,9 @@ public static function build(string $parent, \Google\Cloud\SecurityCenter\V2\Not * * @type string $parent * Required. Resource name of the new notification config's parent. Its format - * is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * @type string $config_id * Required. * Unique identifier provided by the client within the parent scope. @@ -97,9 +97,9 @@ public function __construct($data = NULL) { /** * Required. Resource name of the new notification config's parent. Its format - * is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -111,9 +111,9 @@ public function getParent() /** * Required. Resource name of the new notification config's parent. Its format - * is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/CreateSourceRequest.php b/SecurityCenter/src/V2/CreateSourceRequest.php index b6617f605ad1..3ffa0b5dfdf1 100644 --- a/SecurityCenter/src/V2/CreateSourceRequest.php +++ b/SecurityCenter/src/V2/CreateSourceRequest.php @@ -17,7 +17,7 @@ class CreateSourceRequest extends \Google\Protobuf\Internal\Message { /** * Required. Resource name of the new source's parent. Its format should be - * "organizations/[organization_id]". + * `organizations/[organization_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -32,7 +32,7 @@ class CreateSourceRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. Resource name of the new source's parent. Its format should be - * "organizations/[organization_id]". Please see + * `organizations/[organization_id]`. Please see * {@see SecurityCenterClient::organizationName()} for help formatting this field. * @param \Google\Cloud\SecurityCenter\V2\Source $source Required. The Source being created, only the display_name and description * will be used. All other fields will be ignored. @@ -56,7 +56,7 @@ public static function build(string $parent, \Google\Cloud\SecurityCenter\V2\Sou * * @type string $parent * Required. Resource name of the new source's parent. Its format should be - * "organizations/[organization_id]". + * `organizations/[organization_id]`. * @type \Google\Cloud\SecurityCenter\V2\Source $source * Required. The Source being created, only the display_name and description * will be used. All other fields will be ignored. @@ -69,7 +69,7 @@ public function __construct($data = NULL) { /** * Required. Resource name of the new source's parent. Its format should be - * "organizations/[organization_id]". + * `organizations/[organization_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -81,7 +81,7 @@ public function getParent() /** * Required. Resource name of the new source's parent. Its format should be - * "organizations/[organization_id]". + * `organizations/[organization_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/Cve.php b/SecurityCenter/src/V2/Cve.php index 97f7f34d10df..7b8c725d2753 100644 --- a/SecurityCenter/src/V2/Cve.php +++ b/SecurityCenter/src/V2/Cve.php @@ -69,6 +69,12 @@ class Cve extends \Google\Protobuf\Internal\Message * Generated from protobuf field bool zero_day = 8; */ protected $zero_day = false; + /** + * Date the first publicly available exploit or PoC was released. + * + * Generated from protobuf field .google.protobuf.Timestamp exploit_release_date = 9; + */ + protected $exploit_release_date = null; /** * Constructor. @@ -95,6 +101,8 @@ class Cve extends \Google\Protobuf\Internal\Message * @type bool $zero_day * Whether or not the vulnerability was zero day when the finding was * published. + * @type \Google\Protobuf\Timestamp $exploit_release_date + * Date the first publicly available exploit or PoC was released. * } */ public function __construct($data = NULL) { @@ -326,5 +334,41 @@ public function setZeroDay($var) return $this; } + /** + * Date the first publicly available exploit or PoC was released. + * + * Generated from protobuf field .google.protobuf.Timestamp exploit_release_date = 9; + * @return \Google\Protobuf\Timestamp|null + */ + public function getExploitReleaseDate() + { + return $this->exploit_release_date; + } + + public function hasExploitReleaseDate() + { + return isset($this->exploit_release_date); + } + + public function clearExploitReleaseDate() + { + unset($this->exploit_release_date); + } + + /** + * Date the first publicly available exploit or PoC was released. + * + * Generated from protobuf field .google.protobuf.Timestamp exploit_release_date = 9; + * @param \Google\Protobuf\Timestamp $var + * @return $this + */ + public function setExploitReleaseDate($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); + $this->exploit_release_date = $var; + + return $this; + } + } diff --git a/SecurityCenter/src/V2/Finding.php b/SecurityCenter/src/V2/Finding.php index a7ea154b1943..17a6a7e6e63b 100644 --- a/SecurityCenter/src/V2/Finding.php +++ b/SecurityCenter/src/V2/Finding.php @@ -156,6 +156,12 @@ class Finding extends \Google\Protobuf\Internal\Message * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.Mute mute = 15; */ protected $mute = 0; + /** + * Output only. The mute information regarding this finding. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.MuteInfo mute_info = 53 [(.google.api.field_behavior) = OUTPUT_ONLY]; + */ + protected $mute_info = null; /** * The class of the finding. * @@ -502,6 +508,8 @@ class Finding extends \Google\Protobuf\Internal\Message * Indicates the mute state of a finding (either muted, unmuted * or undefined). Unlike other attributes of a finding, a finding provider * shouldn't set the value of mute. + * @type \Google\Cloud\SecurityCenter\V2\Finding\MuteInfo $mute_info + * Output only. The mute information regarding this finding. * @type int $finding_class * The class of the finding. * @type \Google\Cloud\SecurityCenter\V2\Indicator $indicator @@ -1104,6 +1112,42 @@ public function setMute($var) return $this; } + /** + * Output only. The mute information regarding this finding. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.MuteInfo mute_info = 53 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @return \Google\Cloud\SecurityCenter\V2\Finding\MuteInfo|null + */ + public function getMuteInfo() + { + return $this->mute_info; + } + + public function hasMuteInfo() + { + return isset($this->mute_info); + } + + public function clearMuteInfo() + { + unset($this->mute_info); + } + + /** + * Output only. The mute information regarding this finding. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.MuteInfo mute_info = 53 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @param \Google\Cloud\SecurityCenter\V2\Finding\MuteInfo $var + * @return $this + */ + public function setMuteInfo($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\SecurityCenter\V2\Finding\MuteInfo::class); + $this->mute_info = $var; + + return $this; + } + /** * The class of the finding. * diff --git a/SecurityCenter/src/V2/Finding/MuteInfo.php b/SecurityCenter/src/V2/Finding/MuteInfo.php new file mode 100644 index 000000000000..8c45a1bd4952 --- /dev/null +++ b/SecurityCenter/src/V2/Finding/MuteInfo.php @@ -0,0 +1,117 @@ +google.cloud.securitycenter.v2.Finding.MuteInfo + */ +class MuteInfo extends \Google\Protobuf\Internal\Message +{ + /** + * If set, the static mute applied to this finding. Static mutes override + * dynamic mutes. If unset, there is no static mute. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.MuteInfo.StaticMute static_mute = 1; + */ + protected $static_mute = null; + /** + * The list of dynamic mute rules that currently match the finding. + * + * Generated from protobuf field repeated .google.cloud.securitycenter.v2.Finding.MuteInfo.DynamicMuteRecord dynamic_mute_records = 2; + */ + private $dynamic_mute_records; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type \Google\Cloud\SecurityCenter\V2\Finding\MuteInfo\StaticMute $static_mute + * If set, the static mute applied to this finding. Static mutes override + * dynamic mutes. If unset, there is no static mute. + * @type array<\Google\Cloud\SecurityCenter\V2\Finding\MuteInfo\DynamicMuteRecord>|\Google\Protobuf\Internal\RepeatedField $dynamic_mute_records + * The list of dynamic mute rules that currently match the finding. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Securitycenter\V2\Finding::initOnce(); + parent::__construct($data); + } + + /** + * If set, the static mute applied to this finding. Static mutes override + * dynamic mutes. If unset, there is no static mute. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.MuteInfo.StaticMute static_mute = 1; + * @return \Google\Cloud\SecurityCenter\V2\Finding\MuteInfo\StaticMute|null + */ + public function getStaticMute() + { + return $this->static_mute; + } + + public function hasStaticMute() + { + return isset($this->static_mute); + } + + public function clearStaticMute() + { + unset($this->static_mute); + } + + /** + * If set, the static mute applied to this finding. Static mutes override + * dynamic mutes. If unset, there is no static mute. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.MuteInfo.StaticMute static_mute = 1; + * @param \Google\Cloud\SecurityCenter\V2\Finding\MuteInfo\StaticMute $var + * @return $this + */ + public function setStaticMute($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\SecurityCenter\V2\Finding\MuteInfo\StaticMute::class); + $this->static_mute = $var; + + return $this; + } + + /** + * The list of dynamic mute rules that currently match the finding. + * + * Generated from protobuf field repeated .google.cloud.securitycenter.v2.Finding.MuteInfo.DynamicMuteRecord dynamic_mute_records = 2; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getDynamicMuteRecords() + { + return $this->dynamic_mute_records; + } + + /** + * The list of dynamic mute rules that currently match the finding. + * + * Generated from protobuf field repeated .google.cloud.securitycenter.v2.Finding.MuteInfo.DynamicMuteRecord dynamic_mute_records = 2; + * @param array<\Google\Cloud\SecurityCenter\V2\Finding\MuteInfo\DynamicMuteRecord>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setDynamicMuteRecords($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\SecurityCenter\V2\Finding\MuteInfo\DynamicMuteRecord::class); + $this->dynamic_mute_records = $arr; + + return $this; + } + +} + + diff --git a/SecurityCenter/src/V2/Finding/MuteInfo/DynamicMuteRecord.php b/SecurityCenter/src/V2/Finding/MuteInfo/DynamicMuteRecord.php new file mode 100644 index 000000000000..aa03a7d5ef7a --- /dev/null +++ b/SecurityCenter/src/V2/Finding/MuteInfo/DynamicMuteRecord.php @@ -0,0 +1,124 @@ +google.cloud.securitycenter.v2.Finding.MuteInfo.DynamicMuteRecord + */ +class DynamicMuteRecord extends \Google\Protobuf\Internal\Message +{ + /** + * The relative resource name of the mute rule, represented by a mute + * config, that created this record, for example + * `organizations/123/muteConfigs/mymuteconfig` or + * `organizations/123/locations/global/muteConfigs/mymuteconfig`. + * + * Generated from protobuf field string mute_config = 1; + */ + protected $mute_config = ''; + /** + * When the dynamic mute rule first matched the finding. + * + * Generated from protobuf field .google.protobuf.Timestamp match_time = 2; + */ + protected $match_time = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $mute_config + * The relative resource name of the mute rule, represented by a mute + * config, that created this record, for example + * `organizations/123/muteConfigs/mymuteconfig` or + * `organizations/123/locations/global/muteConfigs/mymuteconfig`. + * @type \Google\Protobuf\Timestamp $match_time + * When the dynamic mute rule first matched the finding. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Securitycenter\V2\Finding::initOnce(); + parent::__construct($data); + } + + /** + * The relative resource name of the mute rule, represented by a mute + * config, that created this record, for example + * `organizations/123/muteConfigs/mymuteconfig` or + * `organizations/123/locations/global/muteConfigs/mymuteconfig`. + * + * Generated from protobuf field string mute_config = 1; + * @return string + */ + public function getMuteConfig() + { + return $this->mute_config; + } + + /** + * The relative resource name of the mute rule, represented by a mute + * config, that created this record, for example + * `organizations/123/muteConfigs/mymuteconfig` or + * `organizations/123/locations/global/muteConfigs/mymuteconfig`. + * + * Generated from protobuf field string mute_config = 1; + * @param string $var + * @return $this + */ + public function setMuteConfig($var) + { + GPBUtil::checkString($var, True); + $this->mute_config = $var; + + return $this; + } + + /** + * When the dynamic mute rule first matched the finding. + * + * Generated from protobuf field .google.protobuf.Timestamp match_time = 2; + * @return \Google\Protobuf\Timestamp|null + */ + public function getMatchTime() + { + return $this->match_time; + } + + public function hasMatchTime() + { + return isset($this->match_time); + } + + public function clearMatchTime() + { + unset($this->match_time); + } + + /** + * When the dynamic mute rule first matched the finding. + * + * Generated from protobuf field .google.protobuf.Timestamp match_time = 2; + * @param \Google\Protobuf\Timestamp $var + * @return $this + */ + public function setMatchTime($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); + $this->match_time = $var; + + return $this; + } + +} + + diff --git a/SecurityCenter/src/V2/Finding/MuteInfo/StaticMute.php b/SecurityCenter/src/V2/Finding/MuteInfo/StaticMute.php new file mode 100644 index 000000000000..5dcb91b3239b --- /dev/null +++ b/SecurityCenter/src/V2/Finding/MuteInfo/StaticMute.php @@ -0,0 +1,118 @@ +google.cloud.securitycenter.v2.Finding.MuteInfo.StaticMute + */ +class StaticMute extends \Google\Protobuf\Internal\Message +{ + /** + * The static mute state. If the value is `MUTED` or `UNMUTED`, then the + * finding's overall mute state will have the same value. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.Mute state = 1; + */ + protected $state = 0; + /** + * When the static mute was applied. + * + * Generated from protobuf field .google.protobuf.Timestamp apply_time = 2; + */ + protected $apply_time = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $state + * The static mute state. If the value is `MUTED` or `UNMUTED`, then the + * finding's overall mute state will have the same value. + * @type \Google\Protobuf\Timestamp $apply_time + * When the static mute was applied. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Securitycenter\V2\Finding::initOnce(); + parent::__construct($data); + } + + /** + * The static mute state. If the value is `MUTED` or `UNMUTED`, then the + * finding's overall mute state will have the same value. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.Mute state = 1; + * @return int + */ + public function getState() + { + return $this->state; + } + + /** + * The static mute state. If the value is `MUTED` or `UNMUTED`, then the + * finding's overall mute state will have the same value. + * + * Generated from protobuf field .google.cloud.securitycenter.v2.Finding.Mute state = 1; + * @param int $var + * @return $this + */ + public function setState($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\SecurityCenter\V2\Finding\Mute::class); + $this->state = $var; + + return $this; + } + + /** + * When the static mute was applied. + * + * Generated from protobuf field .google.protobuf.Timestamp apply_time = 2; + * @return \Google\Protobuf\Timestamp|null + */ + public function getApplyTime() + { + return $this->apply_time; + } + + public function hasApplyTime() + { + return isset($this->apply_time); + } + + public function clearApplyTime() + { + unset($this->apply_time); + } + + /** + * When the static mute was applied. + * + * Generated from protobuf field .google.protobuf.Timestamp apply_time = 2; + * @param \Google\Protobuf\Timestamp $var + * @return $this + */ + public function setApplyTime($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); + $this->apply_time = $var; + + return $this; + } + +} + + diff --git a/SecurityCenter/src/V2/GetSimulationRequest.php b/SecurityCenter/src/V2/GetSimulationRequest.php index 48849de351ad..ccc4f8fe7076 100644 --- a/SecurityCenter/src/V2/GetSimulationRequest.php +++ b/SecurityCenter/src/V2/GetSimulationRequest.php @@ -20,8 +20,8 @@ class GetSimulationRequest extends \Google\Protobuf\Internal\Message /** * Required. The organization name or simulation name of this simulation * Valid format: - * "organizations/{organization}/simulations/latest" - * "organizations/{organization}/simulations/{simulation}" + * `organizations/{organization}/simulations/latest` + * `organizations/{organization}/simulations/{simulation}` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,8 +31,8 @@ class GetSimulationRequest extends \Google\Protobuf\Internal\Message * @param string $name Required. The organization name or simulation name of this simulation * * Valid format: - * "organizations/{organization}/simulations/latest" - * "organizations/{organization}/simulations/{simulation}" + * `organizations/{organization}/simulations/latest` + * `organizations/{organization}/simulations/{simulation}` * Please see {@see SecurityCenterClient::simulationName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V2\GetSimulationRequest @@ -54,8 +54,8 @@ public static function build(string $name): self * @type string $name * Required. The organization name or simulation name of this simulation * Valid format: - * "organizations/{organization}/simulations/latest" - * "organizations/{organization}/simulations/{simulation}" + * `organizations/{organization}/simulations/latest` + * `organizations/{organization}/simulations/{simulation}` * } */ public function __construct($data = NULL) { @@ -66,8 +66,8 @@ public function __construct($data = NULL) { /** * Required. The organization name or simulation name of this simulation * Valid format: - * "organizations/{organization}/simulations/latest" - * "organizations/{organization}/simulations/{simulation}" + * `organizations/{organization}/simulations/latest` + * `organizations/{organization}/simulations/{simulation}` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -80,8 +80,8 @@ public function getName() /** * Required. The organization name or simulation name of this simulation * Valid format: - * "organizations/{organization}/simulations/latest" - * "organizations/{organization}/simulations/{simulation}" + * `organizations/{organization}/simulations/latest` + * `organizations/{organization}/simulations/{simulation}` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/GetSourceRequest.php b/SecurityCenter/src/V2/GetSourceRequest.php index cd90dcc92cf9..df2b2682d295 100644 --- a/SecurityCenter/src/V2/GetSourceRequest.php +++ b/SecurityCenter/src/V2/GetSourceRequest.php @@ -17,7 +17,7 @@ class GetSourceRequest extends \Google\Protobuf\Internal\Message { /** * Required. Relative resource name of the source. Its format is - * "organizations/[organization_id]/source/[source_id]". + * `organizations/[organization_id]/source/[source_id]`. * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -25,7 +25,7 @@ class GetSourceRequest extends \Google\Protobuf\Internal\Message /** * @param string $name Required. Relative resource name of the source. Its format is - * "organizations/[organization_id]/source/[source_id]". Please see + * `organizations/[organization_id]/source/[source_id]`. Please see * {@see SecurityCenterClient::sourceName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V2\GetSourceRequest @@ -46,7 +46,7 @@ public static function build(string $name): self * * @type string $name * Required. Relative resource name of the source. Its format is - * "organizations/[organization_id]/source/[source_id]". + * `organizations/[organization_id]/source/[source_id]`. * } */ public function __construct($data = NULL) { @@ -56,7 +56,7 @@ public function __construct($data = NULL) { /** * Required. Relative resource name of the source. Its format is - * "organizations/[organization_id]/source/[source_id]". + * `organizations/[organization_id]/source/[source_id]`. * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -68,7 +68,7 @@ public function getName() /** * Required. Relative resource name of the source. Its format is - * "organizations/[organization_id]/source/[source_id]". + * `organizations/[organization_id]/source/[source_id]`. * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/GetValuedResourceRequest.php b/SecurityCenter/src/V2/GetValuedResourceRequest.php index fae32a7a0a52..a1576eb4b6c3 100644 --- a/SecurityCenter/src/V2/GetValuedResourceRequest.php +++ b/SecurityCenter/src/V2/GetValuedResourceRequest.php @@ -18,7 +18,7 @@ class GetValuedResourceRequest extends \Google\Protobuf\Internal\Message /** * Required. The name of this valued resource * Valid format: - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -28,7 +28,7 @@ class GetValuedResourceRequest extends \Google\Protobuf\Internal\Message * @param string $name Required. The name of this valued resource * * Valid format: - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * Please see {@see SecurityCenterClient::valuedResourceName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V2\GetValuedResourceRequest @@ -50,7 +50,7 @@ public static function build(string $name): self * @type string $name * Required. The name of this valued resource * Valid format: - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * } */ public function __construct($data = NULL) { @@ -61,7 +61,7 @@ public function __construct($data = NULL) { /** * Required. The name of this valued resource * Valid format: - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -74,7 +74,7 @@ public function getName() /** * Required. The name of this valued resource * Valid format: - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/ListAttackPathsRequest.php b/SecurityCenter/src/V2/ListAttackPathsRequest.php index ffa62ff39865..bf3a25f0b987 100644 --- a/SecurityCenter/src/V2/ListAttackPathsRequest.php +++ b/SecurityCenter/src/V2/ListAttackPathsRequest.php @@ -19,10 +19,10 @@ class ListAttackPathsRequest extends \Google\Protobuf\Internal\Message /** * Required. Name of parent to list attack paths. * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -55,10 +55,10 @@ class ListAttackPathsRequest extends \Google\Protobuf\Internal\Message * @param string $parent Required. Name of parent to list attack paths. * * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * Please see {@see SecurityCenterClient::organizationValuedResourceName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V2\ListAttackPathsRequest @@ -80,10 +80,10 @@ public static function build(string $parent): self * @type string $parent * Required. Name of parent to list attack paths. * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * @type string $filter * The filter expression that filters the attack path in the response. * Supported fields: @@ -105,10 +105,10 @@ public function __construct($data = NULL) { /** * Required. Name of parent to list attack paths. * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -121,10 +121,10 @@ public function getParent() /** * Required. Name of parent to list attack paths. * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" - * "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` + * `organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/ListBigQueryExportsRequest.php b/SecurityCenter/src/V2/ListBigQueryExportsRequest.php index d6e1e47072cf..fa6b8c07deef 100644 --- a/SecurityCenter/src/V2/ListBigQueryExportsRequest.php +++ b/SecurityCenter/src/V2/ListBigQueryExportsRequest.php @@ -18,9 +18,9 @@ class ListBigQueryExportsRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns the collection of BigQuery exports. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -46,9 +46,9 @@ class ListBigQueryExportsRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. The parent, which owns the collection of BigQuery exports. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". Please see + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. Please see * {@see SecurityCenterClient::organizationLocationName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V2\ListBigQueryExportsRequest @@ -69,9 +69,9 @@ public static function build(string $parent): self * * @type string $parent * Required. The parent, which owns the collection of BigQuery exports. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * @type int $page_size * The maximum number of configs to return. The service may return fewer than * this value. @@ -91,9 +91,9 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns the collection of BigQuery exports. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -105,9 +105,9 @@ public function getParent() /** * Required. The parent, which owns the collection of BigQuery exports. Its - * format is "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", or - * "projects/[project_id]/locations/[location_id]". + * format is `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, or + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/ListFindingsResponse/ListFindingsResult/Resource.php b/SecurityCenter/src/V2/ListFindingsResponse/ListFindingsResult/Resource.php index 3591f25f0ad0..77aa126fb14a 100644 --- a/SecurityCenter/src/V2/ListFindingsResponse/ListFindingsResult/Resource.php +++ b/SecurityCenter/src/V2/ListFindingsResponse/ListFindingsResult/Resource.php @@ -62,13 +62,13 @@ class Resource extends \Google\Protobuf\Internal\Message /** * A string representation of the resource path. * For Google Cloud, it has the format of - * organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id} + * `organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id}` * where there can be any number of folders. * For AWS, it has the format of - * org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id} + * `org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id}` * where there can be any number of organizational units. * For Azure, it has the format of - * mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name} + * `mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name}` * where there can be any number of management groups. * * Generated from protobuf field string resource_path_string = 11; @@ -106,13 +106,13 @@ class Resource extends \Google\Protobuf\Internal\Message * @type string $resource_path_string * A string representation of the resource path. * For Google Cloud, it has the format of - * organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id} + * `organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id}` * where there can be any number of folders. * For AWS, it has the format of - * org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id} + * `org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id}` * where there can be any number of organizational units. * For Azure, it has the format of - * mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name} + * `mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name}` * where there can be any number of management groups. * } */ @@ -411,13 +411,13 @@ public function setResourcePath($var) /** * A string representation of the resource path. * For Google Cloud, it has the format of - * organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id} + * `organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id}` * where there can be any number of folders. * For AWS, it has the format of - * org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id} + * `org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id}` * where there can be any number of organizational units. * For Azure, it has the format of - * mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name} + * `mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name}` * where there can be any number of management groups. * * Generated from protobuf field string resource_path_string = 11; @@ -431,13 +431,13 @@ public function getResourcePathString() /** * A string representation of the resource path. * For Google Cloud, it has the format of - * organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id} + * `organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id}` * where there can be any number of folders. * For AWS, it has the format of - * org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id} + * `org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id}` * where there can be any number of organizational units. * For Azure, it has the format of - * mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name} + * `mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name}` * where there can be any number of management groups. * * Generated from protobuf field string resource_path_string = 11; diff --git a/SecurityCenter/src/V2/ListMuteConfigsRequest.php b/SecurityCenter/src/V2/ListMuteConfigsRequest.php index 25486891126a..7562efaed0a1 100644 --- a/SecurityCenter/src/V2/ListMuteConfigsRequest.php +++ b/SecurityCenter/src/V2/ListMuteConfigsRequest.php @@ -19,11 +19,11 @@ class ListMuteConfigsRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns the collection of mute configs. Its format - * is "organizations/[organization_id]", "folders/[folder_id]", - * "projects/[project_id]", - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", - * "projects/[project_id]/locations/[location_id]". + * is `organizations/[organization_id]", "folders/[folder_id]`, + * `projects/[project_id]`, + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -49,11 +49,11 @@ class ListMuteConfigsRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. The parent, which owns the collection of mute configs. Its format - * is "organizations/[organization_id]", "folders/[folder_id]", - * "projects/[project_id]", - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", - * "projects/[project_id]/locations/[location_id]". Please see + * is `organizations/[organization_id]", "folders/[folder_id]`, + * `projects/[project_id]`, + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, + * `projects/[project_id]/locations/[location_id]`. Please see * {@see SecurityCenterClient::organizationLocationName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V2\ListMuteConfigsRequest @@ -74,11 +74,11 @@ public static function build(string $parent): self * * @type string $parent * Required. The parent, which owns the collection of mute configs. Its format - * is "organizations/[organization_id]", "folders/[folder_id]", - * "projects/[project_id]", - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", - * "projects/[project_id]/locations/[location_id]". + * is `organizations/[organization_id]", "folders/[folder_id]`, + * `projects/[project_id]`, + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, + * `projects/[project_id]/locations/[location_id]`. * @type int $page_size * The maximum number of configs to return. The service may return fewer than * this value. @@ -98,11 +98,11 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns the collection of mute configs. Its format - * is "organizations/[organization_id]", "folders/[folder_id]", - * "projects/[project_id]", - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", - * "projects/[project_id]/locations/[location_id]". + * is `organizations/[organization_id]", "folders/[folder_id]`, + * `projects/[project_id]`, + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -114,11 +114,11 @@ public function getParent() /** * Required. The parent, which owns the collection of mute configs. Its format - * is "organizations/[organization_id]", "folders/[folder_id]", - * "projects/[project_id]", - * "organizations/[organization_id]/locations/[location_id]", - * "folders/[folder_id]/locations/[location_id]", - * "projects/[project_id]/locations/[location_id]". + * is `organizations/[organization_id]", "folders/[folder_id]`, + * `projects/[project_id]`, + * `organizations/[organization_id]/locations/[location_id]`, + * `folders/[folder_id]/locations/[location_id]`, + * `projects/[project_id]/locations/[location_id]`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/ListResourceValueConfigsRequest.php b/SecurityCenter/src/V2/ListResourceValueConfigsRequest.php index 3083c60fd32e..74b3a368e485 100644 --- a/SecurityCenter/src/V2/ListResourceValueConfigsRequest.php +++ b/SecurityCenter/src/V2/ListResourceValueConfigsRequest.php @@ -18,7 +18,7 @@ class ListResourceValueConfigsRequest extends \Google\Protobuf\Internal\Message /** * Required. The parent, which owns the collection of resource value configs. * Its format is - * "organizations/[organization_id]" + * `organizations/[organization_id]` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -47,7 +47,7 @@ class ListResourceValueConfigsRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. The parent, which owns the collection of resource value configs. * Its format is - * "organizations/[organization_id]" + * `organizations/[organization_id]` * Please see {@see SecurityCenterClient::organizationLocationName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V2\ListResourceValueConfigsRequest @@ -69,7 +69,7 @@ public static function build(string $parent): self * @type string $parent * Required. The parent, which owns the collection of resource value configs. * Its format is - * "organizations/[organization_id]" + * `organizations/[organization_id]` * @type int $page_size * The maximum number of configs to return. The service may return fewer than * this value. @@ -92,7 +92,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns the collection of resource value configs. * Its format is - * "organizations/[organization_id]" + * `organizations/[organization_id]` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -105,7 +105,7 @@ public function getParent() /** * Required. The parent, which owns the collection of resource value configs. * Its format is - * "organizations/[organization_id]" + * `organizations/[organization_id]` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/ListSourcesRequest.php b/SecurityCenter/src/V2/ListSourcesRequest.php index 643ac6477dd6..e5df59138105 100644 --- a/SecurityCenter/src/V2/ListSourcesRequest.php +++ b/SecurityCenter/src/V2/ListSourcesRequest.php @@ -17,8 +17,8 @@ class ListSourcesRequest extends \Google\Protobuf\Internal\Message { /** * Required. Resource name of the parent of sources to list. Its format should - * be "organizations/[organization_id]", "folders/[folder_id]", or - * "projects/[project_id]". + * be `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) = { */ @@ -41,8 +41,8 @@ class ListSourcesRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. Resource name of the parent of sources to list. Its format should - * be "organizations/[organization_id]", "folders/[folder_id]", or - * "projects/[project_id]". Please see + * be `organizations/[organization_id]`, `folders/[folder_id]`, or + * `projects/[project_id]`. Please see * {@see SecurityCenterClient::projectName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V2\ListSourcesRequest @@ -63,8 +63,8 @@ public static function build(string $parent): self * * @type string $parent * Required. Resource name of the parent of sources to list. Its format should - * be "organizations/[organization_id]", "folders/[folder_id]", or - * "projects/[project_id]". + * be `organizations/[organization_id]`, `folders/[folder_id]`, or + * `projects/[project_id]`. * @type string $page_token * The value returned by the last `ListSourcesResponse`; indicates * that this is a continuation of a prior `ListSources` call, and @@ -81,8 +81,8 @@ public function __construct($data = NULL) { /** * Required. Resource name of the parent of sources to list. Its format should - * be "organizations/[organization_id]", "folders/[folder_id]", or - * "projects/[project_id]". + * be `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 @@ -94,8 +94,8 @@ public function getParent() /** * Required. Resource name of the parent of sources to list. Its format should - * be "organizations/[organization_id]", "folders/[folder_id]", or - * "projects/[project_id]". + * be `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 diff --git a/SecurityCenter/src/V2/ListValuedResourcesRequest.php b/SecurityCenter/src/V2/ListValuedResourcesRequest.php index 796336e2ecc8..690855b79af5 100644 --- a/SecurityCenter/src/V2/ListValuedResourcesRequest.php +++ b/SecurityCenter/src/V2/ListValuedResourcesRequest.php @@ -18,9 +18,9 @@ class ListValuedResourcesRequest extends \Google\Protobuf\Internal\Message /** * Required. Name of parent to list exposed resources. * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -69,9 +69,9 @@ class ListValuedResourcesRequest extends \Google\Protobuf\Internal\Message * @param string $parent Required. Name of parent to list exposed resources. * * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` * Please see {@see SecurityCenterClient::simulationName()} for help formatting this field. * * @return \Google\Cloud\SecurityCenter\V2\ListValuedResourcesRequest @@ -93,9 +93,9 @@ public static function build(string $parent): self * @type string $parent * Required. Name of parent to list exposed resources. * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` * @type string $filter * The filter expression that filters the valued resources in the response. * Supported fields: @@ -129,9 +129,9 @@ public function __construct($data = NULL) { /** * Required. Name of parent to list exposed resources. * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -144,9 +144,9 @@ public function getParent() /** * Required. Name of parent to list exposed resources. * Valid formats: - * "organizations/{organization}", - * "organizations/{organization}/simulations/{simulation}" - * "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" + * `organizations/{organization}`, + * `organizations/{organization}/simulations/{simulation}` + * `organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/SecurityCenter/src/V2/MitreAttack/Technique.php b/SecurityCenter/src/V2/MitreAttack/Technique.php index bef131a31d3a..a825b548452b 100644 --- a/SecurityCenter/src/V2/MitreAttack/Technique.php +++ b/SecurityCenter/src/V2/MitreAttack/Technique.php @@ -9,7 +9,7 @@ /** * MITRE ATT&CK techniques that can be referenced by SCC findings. * See: https://attack.mitre.org/techniques/enterprise/ - * Next ID: 63 + * Next ID: 65 * * Protobuf type google.cloud.securitycenter.v2.MitreAttack.Technique */ @@ -75,6 +75,12 @@ class Technique * Generated from protobuf enum PYTHON = 59; */ const PYTHON = 59; + /** + * T1068 + * + * Generated from protobuf enum EXPLOITATION_FOR_PRIVILEGE_ESCALATION = 63; + */ + const EXPLOITATION_FOR_PRIVILEGE_ESCALATION = 63; /** * T1069 * @@ -87,6 +93,12 @@ class Technique * Generated from protobuf enum CLOUD_GROUPS = 19; */ const CLOUD_GROUPS = 19; + /** + * T1070.004 + * + * Generated from protobuf enum INDICATOR_REMOVAL_FILE_DELETION = 64; + */ + const INDICATOR_REMOVAL_FILE_DELETION = 64; /** * T1071 * @@ -370,7 +382,7 @@ class Technique */ const SCANNING_IP_BLOCKS = 2; /** - * T1613 + * T1609 * * Generated from protobuf enum CONTAINER_ADMINISTRATION_COMMAND = 60; */ @@ -405,8 +417,10 @@ class Technique self::COMMAND_AND_SCRIPTING_INTERPRETER => 'COMMAND_AND_SCRIPTING_INTERPRETER', self::UNIX_SHELL => 'UNIX_SHELL', self::PYTHON => 'PYTHON', + self::EXPLOITATION_FOR_PRIVILEGE_ESCALATION => 'EXPLOITATION_FOR_PRIVILEGE_ESCALATION', self::PERMISSION_GROUPS_DISCOVERY => 'PERMISSION_GROUPS_DISCOVERY', self::CLOUD_GROUPS => 'CLOUD_GROUPS', + self::INDICATOR_REMOVAL_FILE_DELETION => 'INDICATOR_REMOVAL_FILE_DELETION', self::APPLICATION_LAYER_PROTOCOL => 'APPLICATION_LAYER_PROTOCOL', self::DNS => 'DNS', self::SOFTWARE_DEPLOYMENT_TOOLS => 'SOFTWARE_DEPLOYMENT_TOOLS', diff --git a/SecurityCenter/src/V2/MuteConfig.php b/SecurityCenter/src/V2/MuteConfig.php index 2d22fc8b58d6..d6609fbc1051 100644 --- a/SecurityCenter/src/V2/MuteConfig.php +++ b/SecurityCenter/src/V2/MuteConfig.php @@ -17,8 +17,8 @@ class MuteConfig extends \Google\Protobuf\Internal\Message { /** - * This field will be ignored if provided on config creation. The following - * list shows some examples of the format: + * Identifier. This field will be ignored if provided on config creation. The + * following list shows some examples of the format: * + `organizations/{organization}/muteConfigs/{mute_config}` * + * `organizations/{organization}locations/{location}//muteConfigs/{mute_config}` @@ -27,7 +27,7 @@ class MuteConfig extends \Google\Protobuf\Internal\Message * + `projects/{project}/muteConfigs/{mute_config}` * + `projects/{project}/locations/{location}/muteConfigs/{mute_config}` * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; */ protected $name = ''; /** @@ -90,6 +90,14 @@ class MuteConfig extends \Google\Protobuf\Internal\Message * Generated from protobuf field .google.cloud.securitycenter.v2.MuteConfig.MuteConfigType type = 8 [(.google.api.field_behavior) = REQUIRED]; */ protected $type = 0; + /** + * Optional. The expiry of the mute config. Only applicable for dynamic + * configs. If the expiry is set, when the config expires, it is removed from + * all findings. + * + * Generated from protobuf field .google.protobuf.Timestamp expiry_time = 9 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $expiry_time = null; /** * Constructor. @@ -98,8 +106,8 @@ class MuteConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $name - * This field will be ignored if provided on config creation. The following - * list shows some examples of the format: + * Identifier. This field will be ignored if provided on config creation. The + * following list shows some examples of the format: * + `organizations/{organization}/muteConfigs/{mute_config}` * + * `organizations/{organization}locations/{location}//muteConfigs/{mute_config}` @@ -143,6 +151,10 @@ class MuteConfig extends \Google\Protobuf\Internal\Message * @type int $type * Required. The type of the mute config, which determines what type of mute * state the config affects. Immutable after creation. + * @type \Google\Protobuf\Timestamp $expiry_time + * Optional. The expiry of the mute config. Only applicable for dynamic + * configs. If the expiry is set, when the config expires, it is removed from + * all findings. * } */ public function __construct($data = NULL) { @@ -151,8 +163,8 @@ public function __construct($data = NULL) { } /** - * This field will be ignored if provided on config creation. The following - * list shows some examples of the format: + * Identifier. This field will be ignored if provided on config creation. The + * following list shows some examples of the format: * + `organizations/{organization}/muteConfigs/{mute_config}` * + * `organizations/{organization}locations/{location}//muteConfigs/{mute_config}` @@ -161,7 +173,7 @@ public function __construct($data = NULL) { * + `projects/{project}/muteConfigs/{mute_config}` * + `projects/{project}/locations/{location}/muteConfigs/{mute_config}` * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @return string */ public function getName() @@ -170,8 +182,8 @@ public function getName() } /** - * This field will be ignored if provided on config creation. The following - * list shows some examples of the format: + * Identifier. This field will be ignored if provided on config creation. The + * following list shows some examples of the format: * + `organizations/{organization}/muteConfigs/{mute_config}` * + * `organizations/{organization}locations/{location}//muteConfigs/{mute_config}` @@ -180,7 +192,7 @@ public function getName() * + `projects/{project}/muteConfigs/{mute_config}` * + `projects/{project}/locations/{location}/muteConfigs/{mute_config}` * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @param string $var * @return $this */ @@ -416,5 +428,45 @@ public function setType($var) return $this; } + /** + * Optional. The expiry of the mute config. Only applicable for dynamic + * configs. If the expiry is set, when the config expires, it is removed from + * all findings. + * + * Generated from protobuf field .google.protobuf.Timestamp expiry_time = 9 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Protobuf\Timestamp|null + */ + public function getExpiryTime() + { + return $this->expiry_time; + } + + public function hasExpiryTime() + { + return isset($this->expiry_time); + } + + public function clearExpiryTime() + { + unset($this->expiry_time); + } + + /** + * Optional. The expiry of the mute config. Only applicable for dynamic + * configs. If the expiry is set, when the config expires, it is removed from + * all findings. + * + * Generated from protobuf field .google.protobuf.Timestamp expiry_time = 9 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Protobuf\Timestamp $var + * @return $this + */ + public function setExpiryTime($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); + $this->expiry_time = $var; + + return $this; + } + } diff --git a/SecurityCenter/src/V2/MuteConfig/MuteConfigType.php b/SecurityCenter/src/V2/MuteConfig/MuteConfigType.php index f20d9764a36f..2679d8f041e5 100644 --- a/SecurityCenter/src/V2/MuteConfig/MuteConfigType.php +++ b/SecurityCenter/src/V2/MuteConfig/MuteConfigType.php @@ -27,10 +27,22 @@ class MuteConfigType * Generated from protobuf enum STATIC = 1; */ const PBSTATIC = 1; + /** + * A dynamic mute config, which is applied to existing and future matching + * findings, setting their dynamic mute state to "muted". If the config is + * updated or deleted, or a matching finding is updated, such that the + * finding doesn't match the config, the config will be removed from the + * finding, and the finding's dynamic mute state may become "unmuted" + * (unless other configs still match). + * + * Generated from protobuf enum DYNAMIC = 2; + */ + const DYNAMIC = 2; private static $valueToName = [ self::MUTE_CONFIG_TYPE_UNSPECIFIED => 'MUTE_CONFIG_TYPE_UNSPECIFIED', self::PBSTATIC => 'STATIC', + self::DYNAMIC => 'DYNAMIC', ]; public static function name($value) diff --git a/SecurityCenter/src/V2/NotificationConfig.php b/SecurityCenter/src/V2/NotificationConfig.php index 762556b94f42..54feee3ac70b 100644 --- a/SecurityCenter/src/V2/NotificationConfig.php +++ b/SecurityCenter/src/V2/NotificationConfig.php @@ -18,7 +18,7 @@ class NotificationConfig extends \Google\Protobuf\Internal\Message { /** - * The relative resource name of this notification config. See: + * Identifier. The relative resource name of this notification config. See: * https://cloud.google.com/apis/design/resource_names#relative_resource_name * The following list shows some examples: * + @@ -28,7 +28,7 @@ class NotificationConfig extends \Google\Protobuf\Internal\Message * + * `projects/{project_id}/locations/{location_id}/notificationConfigs/notify_public_bucket` * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; */ protected $name = ''; /** @@ -60,7 +60,7 @@ class NotificationConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $name - * The relative resource name of this notification config. See: + * Identifier. The relative resource name of this notification config. See: * https://cloud.google.com/apis/design/resource_names#relative_resource_name * The following list shows some examples: * + @@ -87,7 +87,7 @@ public function __construct($data = NULL) { } /** - * The relative resource name of this notification config. See: + * Identifier. The relative resource name of this notification config. See: * https://cloud.google.com/apis/design/resource_names#relative_resource_name * The following list shows some examples: * + @@ -97,7 +97,7 @@ public function __construct($data = NULL) { * + * `projects/{project_id}/locations/{location_id}/notificationConfigs/notify_public_bucket` * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @return string */ public function getName() @@ -106,7 +106,7 @@ public function getName() } /** - * The relative resource name of this notification config. See: + * Identifier. The relative resource name of this notification config. See: * https://cloud.google.com/apis/design/resource_names#relative_resource_name * The following list shows some examples: * + @@ -116,7 +116,7 @@ public function getName() * + * `projects/{project_id}/locations/{location_id}/notificationConfigs/notify_public_bucket` * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @param string $var * @return $this */ diff --git a/SecurityCenter/src/V2/Resource.php b/SecurityCenter/src/V2/Resource.php index 644e65332382..5f52c7593822 100644 --- a/SecurityCenter/src/V2/Resource.php +++ b/SecurityCenter/src/V2/Resource.php @@ -61,13 +61,13 @@ class Resource extends \Google\Protobuf\Internal\Message /** * A string representation of the resource path. * For Google Cloud, it has the format of - * organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id} + * `organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id}` * where there can be any number of folders. * For AWS, it has the format of - * org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id} + * `org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id}` * where there can be any number of organizational units. * For Azure, it has the format of - * mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name} + * `mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name}` * where there can be any number of management groups. * * Generated from protobuf field string resource_path_string = 11; @@ -105,13 +105,13 @@ class Resource extends \Google\Protobuf\Internal\Message * @type string $resource_path_string * A string representation of the resource path. * For Google Cloud, it has the format of - * organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id} + * `organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id}` * where there can be any number of folders. * For AWS, it has the format of - * org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id} + * `org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id}` * where there can be any number of organizational units. * For Azure, it has the format of - * mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name} + * `mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name}` * where there can be any number of management groups. * } */ @@ -410,13 +410,13 @@ public function setResourcePath($var) /** * A string representation of the resource path. * For Google Cloud, it has the format of - * organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id} + * `organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id}` * where there can be any number of folders. * For AWS, it has the format of - * org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id} + * `org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id}` * where there can be any number of organizational units. * For Azure, it has the format of - * mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name} + * `mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name}` * where there can be any number of management groups. * * Generated from protobuf field string resource_path_string = 11; @@ -430,13 +430,13 @@ public function getResourcePathString() /** * A string representation of the resource path. * For Google Cloud, it has the format of - * organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id} + * `organizations/{organization_id}/folders/{folder_id}/folders/{folder_id}/projects/{project_id}` * where there can be any number of folders. * For AWS, it has the format of - * org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id} + * `org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{account_id}` * where there can be any number of organizational units. * For Azure, it has the format of - * mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name} + * `mg/{management_group_id}/mg/{management_group_id}/subscription/{subscription_id}/rg/{resource_group_name}` * where there can be any number of management groups. * * Generated from protobuf field string resource_path_string = 11; diff --git a/SecurityCenter/src/V2/ResourceValueConfig.php b/SecurityCenter/src/V2/ResourceValueConfig.php index 390eee2b4943..571a3a02c982 100644 --- a/SecurityCenter/src/V2/ResourceValueConfig.php +++ b/SecurityCenter/src/V2/ResourceValueConfig.php @@ -17,30 +17,31 @@ class ResourceValueConfig extends \Google\Protobuf\Internal\Message { /** - * Name for the resource value configuration + * Identifier. Name for the resource value configuration * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; */ protected $name = ''; /** * Resource value level this expression represents - * Only required when there is no SDP mapping in the request + * Only required when there is no Sensitive Data Protection mapping in the + * request * * Generated from protobuf field .google.cloud.securitycenter.v2.ResourceValue resource_value = 2; */ protected $resource_value = 0; /** - * Required. Tag values combined with AND to check against. + * Tag values combined with `AND` to check against. * Values in the form "tagValues/123" - * Example: [ "tagValues/123", "tagValues/456", "tagValues/789" ] + * Example: `[ "tagValues/123", "tagValues/456", "tagValues/789" ]` * https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing * - * Generated from protobuf field repeated string tag_values = 3 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field repeated string tag_values = 3; */ private $tag_values; /** * Apply resource_value only to resources that match resource_type. - * resource_type will be checked with AND of other resources. + * resource_type will be checked with `AND` of other resources. * For example, "storage.googleapis.com/Bucket" with resource_value "HIGH" * will apply "HIGH" value only to "storage.googleapis.com/Bucket" resources. * @@ -50,16 +51,15 @@ class ResourceValueConfig extends \Google\Protobuf\Internal\Message /** * Project or folder to scope this configuration to. * For example, "project/456" would apply this configuration only to resources - * in "project/456" scope will be checked with AND of other - * resources. + * in "project/456" scope and will be checked with `AND` of other resources. * * Generated from protobuf field string scope = 5; */ protected $scope = ''; /** - * List of resource labels to search for, evaluated with AND. + * List of resource labels to search for, evaluated with `AND`. * For example, "resource_labels_selector": {"key": "value", "env": "prod"} - * will match resources with labels "key": "value" AND "env": + * will match resources with labels "key": "value" `AND` "env": * "prod" * https://cloud.google.com/resource-manager/docs/creating-managing-labels * @@ -107,29 +107,29 @@ class ResourceValueConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $name - * Name for the resource value configuration + * Identifier. Name for the resource value configuration * @type int $resource_value * Resource value level this expression represents - * Only required when there is no SDP mapping in the request + * Only required when there is no Sensitive Data Protection mapping in the + * request * @type array|\Google\Protobuf\Internal\RepeatedField $tag_values - * Required. Tag values combined with AND to check against. + * Tag values combined with `AND` to check against. * Values in the form "tagValues/123" - * Example: [ "tagValues/123", "tagValues/456", "tagValues/789" ] + * Example: `[ "tagValues/123", "tagValues/456", "tagValues/789" ]` * https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing * @type string $resource_type * Apply resource_value only to resources that match resource_type. - * resource_type will be checked with AND of other resources. + * resource_type will be checked with `AND` of other resources. * For example, "storage.googleapis.com/Bucket" with resource_value "HIGH" * will apply "HIGH" value only to "storage.googleapis.com/Bucket" resources. * @type string $scope * Project or folder to scope this configuration to. * For example, "project/456" would apply this configuration only to resources - * in "project/456" scope will be checked with AND of other - * resources. + * in "project/456" scope and will be checked with `AND` of other resources. * @type array|\Google\Protobuf\Internal\MapField $resource_labels_selector - * List of resource labels to search for, evaluated with AND. + * List of resource labels to search for, evaluated with `AND`. * For example, "resource_labels_selector": {"key": "value", "env": "prod"} - * will match resources with labels "key": "value" AND "env": + * will match resources with labels "key": "value" `AND` "env": * "prod" * https://cloud.google.com/resource-manager/docs/creating-managing-labels * @type string $description @@ -153,9 +153,9 @@ public function __construct($data = NULL) { } /** - * Name for the resource value configuration + * Identifier. Name for the resource value configuration * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @return string */ public function getName() @@ -164,9 +164,9 @@ public function getName() } /** - * Name for the resource value configuration + * Identifier. Name for the resource value configuration * - * Generated from protobuf field string name = 1; + * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @param string $var * @return $this */ @@ -180,7 +180,8 @@ public function setName($var) /** * Resource value level this expression represents - * Only required when there is no SDP mapping in the request + * Only required when there is no Sensitive Data Protection mapping in the + * request * * Generated from protobuf field .google.cloud.securitycenter.v2.ResourceValue resource_value = 2; * @return int @@ -192,7 +193,8 @@ public function getResourceValue() /** * Resource value level this expression represents - * Only required when there is no SDP mapping in the request + * Only required when there is no Sensitive Data Protection mapping in the + * request * * Generated from protobuf field .google.cloud.securitycenter.v2.ResourceValue resource_value = 2; * @param int $var @@ -207,12 +209,12 @@ public function setResourceValue($var) } /** - * Required. Tag values combined with AND to check against. + * Tag values combined with `AND` to check against. * Values in the form "tagValues/123" - * Example: [ "tagValues/123", "tagValues/456", "tagValues/789" ] + * Example: `[ "tagValues/123", "tagValues/456", "tagValues/789" ]` * https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing * - * Generated from protobuf field repeated string tag_values = 3 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field repeated string tag_values = 3; * @return \Google\Protobuf\Internal\RepeatedField */ public function getTagValues() @@ -221,12 +223,12 @@ public function getTagValues() } /** - * Required. Tag values combined with AND to check against. + * Tag values combined with `AND` to check against. * Values in the form "tagValues/123" - * Example: [ "tagValues/123", "tagValues/456", "tagValues/789" ] + * Example: `[ "tagValues/123", "tagValues/456", "tagValues/789" ]` * https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing * - * Generated from protobuf field repeated string tag_values = 3 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field repeated string tag_values = 3; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ @@ -240,7 +242,7 @@ public function setTagValues($var) /** * Apply resource_value only to resources that match resource_type. - * resource_type will be checked with AND of other resources. + * resource_type will be checked with `AND` of other resources. * For example, "storage.googleapis.com/Bucket" with resource_value "HIGH" * will apply "HIGH" value only to "storage.googleapis.com/Bucket" resources. * @@ -254,7 +256,7 @@ public function getResourceType() /** * Apply resource_value only to resources that match resource_type. - * resource_type will be checked with AND of other resources. + * resource_type will be checked with `AND` of other resources. * For example, "storage.googleapis.com/Bucket" with resource_value "HIGH" * will apply "HIGH" value only to "storage.googleapis.com/Bucket" resources. * @@ -273,8 +275,7 @@ public function setResourceType($var) /** * Project or folder to scope this configuration to. * For example, "project/456" would apply this configuration only to resources - * in "project/456" scope will be checked with AND of other - * resources. + * in "project/456" scope and will be checked with `AND` of other resources. * * Generated from protobuf field string scope = 5; * @return string @@ -287,8 +288,7 @@ public function getScope() /** * Project or folder to scope this configuration to. * For example, "project/456" would apply this configuration only to resources - * in "project/456" scope will be checked with AND of other - * resources. + * in "project/456" scope and will be checked with `AND` of other resources. * * Generated from protobuf field string scope = 5; * @param string $var @@ -303,9 +303,9 @@ public function setScope($var) } /** - * List of resource labels to search for, evaluated with AND. + * List of resource labels to search for, evaluated with `AND`. * For example, "resource_labels_selector": {"key": "value", "env": "prod"} - * will match resources with labels "key": "value" AND "env": + * will match resources with labels "key": "value" `AND` "env": * "prod" * https://cloud.google.com/resource-manager/docs/creating-managing-labels * @@ -318,9 +318,9 @@ public function getResourceLabelsSelector() } /** - * List of resource labels to search for, evaluated with AND. + * List of resource labels to search for, evaluated with `AND`. * For example, "resource_labels_selector": {"key": "value", "env": "prod"} - * will match resources with labels "key": "value" AND "env": + * will match resources with labels "key": "value" `AND` "env": * "prod" * https://cloud.google.com/resource-manager/docs/creating-managing-labels * diff --git a/SecurityCenter/src/V2/Simulation.php b/SecurityCenter/src/V2/Simulation.php index f94b7f0cface..ada9b78786e6 100644 --- a/SecurityCenter/src/V2/Simulation.php +++ b/SecurityCenter/src/V2/Simulation.php @@ -17,7 +17,7 @@ class Simulation extends \Google\Protobuf\Internal\Message { /** * Full resource name of the Simulation: - * organizations/123/simulations/456 + * `organizations/123/simulations/456` * * Generated from protobuf field string name = 1; */ @@ -50,7 +50,7 @@ class Simulation extends \Google\Protobuf\Internal\Message * * @type string $name * Full resource name of the Simulation: - * organizations/123/simulations/456 + * `organizations/123/simulations/456` * @type \Google\Protobuf\Timestamp $create_time * Output only. Time simulation was created * @type array<\Google\Cloud\SecurityCenter\V2\ResourceValueConfigMetadata>|\Google\Protobuf\Internal\RepeatedField $resource_value_configs_metadata @@ -67,7 +67,7 @@ public function __construct($data = NULL) { /** * Full resource name of the Simulation: - * organizations/123/simulations/456 + * `organizations/123/simulations/456` * * Generated from protobuf field string name = 1; * @return string @@ -79,7 +79,7 @@ public function getName() /** * Full resource name of the Simulation: - * organizations/123/simulations/456 + * `organizations/123/simulations/456` * * Generated from protobuf field string name = 1; * @param string $var diff --git a/SecurityCenter/tests/Unit/V2/Client/SecurityCenterClientTest.php b/SecurityCenter/tests/Unit/V2/Client/SecurityCenterClientTest.php index a874d2e22e1d..6ada0f703d81 100644 --- a/SecurityCenter/tests/Unit/V2/Client/SecurityCenterClientTest.php +++ b/SecurityCenter/tests/Unit/V2/Client/SecurityCenterClientTest.php @@ -2958,8 +2958,6 @@ public function updateResourceValueConfigTest() $transport->addResponse($expectedResponse); // Mock request $resourceValueConfig = new ResourceValueConfig(); - $resourceValueConfigTagValues = []; - $resourceValueConfig->setTagValues($resourceValueConfigTagValues); $request = (new UpdateResourceValueConfigRequest())->setResourceValueConfig($resourceValueConfig); $response = $gapicClient->updateResourceValueConfig($request); $this->assertEquals($expectedResponse, $response); @@ -2996,8 +2994,6 @@ public function updateResourceValueConfigExceptionTest() $transport->addResponse(null, $status); // Mock request $resourceValueConfig = new ResourceValueConfig(); - $resourceValueConfigTagValues = []; - $resourceValueConfig->setTagValues($resourceValueConfigTagValues); $request = (new UpdateResourceValueConfigRequest())->setResourceValueConfig($resourceValueConfig); try { $gapicClient->updateResourceValueConfig($request); diff --git a/StorageTransfer/metadata/V1/TransferTypes.php b/StorageTransfer/metadata/V1/TransferTypes.php index 636e033a09bc..120c424a099b 100644 Binary files a/StorageTransfer/metadata/V1/TransferTypes.php and b/StorageTransfer/metadata/V1/TransferTypes.php differ diff --git a/StorageTransfer/src/V1/AgentPool.php b/StorageTransfer/src/V1/AgentPool.php index 78565b5a9d71..f7d504146c20 100644 --- a/StorageTransfer/src/V1/AgentPool.php +++ b/StorageTransfer/src/V1/AgentPool.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an On-Premises Agent pool. + * Represents an agent pool. * * Generated from protobuf message google.storagetransfer.v1.AgentPool */ diff --git a/StorageTransfer/src/V1/AgentPool/State.php b/StorageTransfer/src/V1/AgentPool/State.php index 877e31dcc6d7..cc126053b367 100644 --- a/StorageTransfer/src/V1/AgentPool/State.php +++ b/StorageTransfer/src/V1/AgentPool/State.php @@ -20,8 +20,8 @@ class State */ const STATE_UNSPECIFIED = 0; /** - * This is an initialization state. During this stage, the resources such as - * Pub/Sub topics are allocated for the AgentPool. + * This is an initialization state. During this stage, resources are + * allocated for the AgentPool. * * Generated from protobuf enum CREATING = 1; */ diff --git a/StorageTransfer/src/V1/AwsS3Data.php b/StorageTransfer/src/V1/AwsS3Data.php index 85290818c457..21d2a93d42e6 100644 --- a/StorageTransfer/src/V1/AwsS3Data.php +++ b/StorageTransfer/src/V1/AwsS3Data.php @@ -57,25 +57,40 @@ class AwsS3Data extends \Google\Protobuf\Internal\Message * Generated from protobuf field string role_arn = 4; */ protected $role_arn = ''; + /** + * Optional. The CloudFront distribution domain name pointing to this bucket, + * to use when fetching. + * See + * [Transfer from S3 via + * CloudFront](https://cloud.google.com/storage-transfer/docs/s3-cloudfront) + * for more information. + * Format: `https://{id}.cloudfront.net` or any valid custom domain. Must + * begin with `https://`. + * + * Generated from protobuf field string cloudfront_domain = 6 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $cloudfront_domain = ''; /** * Optional. The Resource name of a secret in Secret Manager. - * The Azure SAS token must be stored in Secret Manager in JSON format: - *
{
-     *  "sas_token" : "SAS_TOKEN"
-     * }
+ * AWS credentials must be stored in Secret Manager in JSON format: + * { + * "access_key_id": "ACCESS_KEY_ID", + * "secret_access_key": "SECRET_ACCESS_KEY" + * } * [GoogleServiceAccount][google.storagetransfer.v1.GoogleServiceAccount] must * be granted `roles/secretmanager.secretAccessor` for the resource. - * See [Configure access to a source: Microsoft Azure Blob Storage] - * (https://cloud.google.com/storage-transfer/docs/source-microsoft-azure#secret_manager) + * See [Configure access to a source: Amazon S3] + * (https://cloud.google.com/storage-transfer/docs/source-amazon-s3#secret_manager) * for more information. - * If `credentials_secret` is specified, do not specify [azure_credentials][]. - * This feature is in - * [preview](https://cloud.google.com/terms/service-terms#1). + * If `credentials_secret` is specified, do not specify + * [role_arn][google.storagetransfer.v1.AwsS3Data.role_arn] or + * [aws_access_key][google.storagetransfer.v1.AwsS3Data.aws_access_key]. * Format: `projects/{project_number}/secrets/{secret_name}` * * Generated from protobuf field string credentials_secret = 7 [(.google.api.field_behavior) = OPTIONAL]; */ protected $credentials_secret = ''; + protected $private_network; /** * Constructor. @@ -108,21 +123,34 @@ class AwsS3Data extends \Google\Protobuf\Internal\Message * the provided role using the * [GoogleServiceAccount][google.storagetransfer.v1.GoogleServiceAccount] for * this project. + * @type string $cloudfront_domain + * Optional. The CloudFront distribution domain name pointing to this bucket, + * to use when fetching. + * See + * [Transfer from S3 via + * CloudFront](https://cloud.google.com/storage-transfer/docs/s3-cloudfront) + * for more information. + * Format: `https://{id}.cloudfront.net` or any valid custom domain. Must + * begin with `https://`. * @type string $credentials_secret * Optional. The Resource name of a secret in Secret Manager. - * The Azure SAS token must be stored in Secret Manager in JSON format: - *
{
-     *            "sas_token" : "SAS_TOKEN"
-     *           }
+ * AWS credentials must be stored in Secret Manager in JSON format: + * { + * "access_key_id": "ACCESS_KEY_ID", + * "secret_access_key": "SECRET_ACCESS_KEY" + * } * [GoogleServiceAccount][google.storagetransfer.v1.GoogleServiceAccount] must * be granted `roles/secretmanager.secretAccessor` for the resource. - * See [Configure access to a source: Microsoft Azure Blob Storage] - * (https://cloud.google.com/storage-transfer/docs/source-microsoft-azure#secret_manager) + * See [Configure access to a source: Amazon S3] + * (https://cloud.google.com/storage-transfer/docs/source-amazon-s3#secret_manager) * for more information. - * If `credentials_secret` is specified, do not specify [azure_credentials][]. - * This feature is in - * [preview](https://cloud.google.com/terms/service-terms#1). + * If `credentials_secret` is specified, do not specify + * [role_arn][google.storagetransfer.v1.AwsS3Data.role_arn] or + * [aws_access_key][google.storagetransfer.v1.AwsS3Data.aws_access_key]. * Format: `projects/{project_number}/secrets/{secret_name}` + * @type bool $managed_private_network + * Egress bytes over a Google-managed private network. + * This network is shared between other users of Storage Transfer Service. * } */ public function __construct($data = NULL) { @@ -278,20 +306,61 @@ public function setRoleArn($var) return $this; } + /** + * Optional. The CloudFront distribution domain name pointing to this bucket, + * to use when fetching. + * See + * [Transfer from S3 via + * CloudFront](https://cloud.google.com/storage-transfer/docs/s3-cloudfront) + * for more information. + * Format: `https://{id}.cloudfront.net` or any valid custom domain. Must + * begin with `https://`. + * + * Generated from protobuf field string cloudfront_domain = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getCloudfrontDomain() + { + return $this->cloudfront_domain; + } + + /** + * Optional. The CloudFront distribution domain name pointing to this bucket, + * to use when fetching. + * See + * [Transfer from S3 via + * CloudFront](https://cloud.google.com/storage-transfer/docs/s3-cloudfront) + * for more information. + * Format: `https://{id}.cloudfront.net` or any valid custom domain. Must + * begin with `https://`. + * + * Generated from protobuf field string cloudfront_domain = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setCloudfrontDomain($var) + { + GPBUtil::checkString($var, True); + $this->cloudfront_domain = $var; + + return $this; + } + /** * Optional. The Resource name of a secret in Secret Manager. - * The Azure SAS token must be stored in Secret Manager in JSON format: - *
{
-     *  "sas_token" : "SAS_TOKEN"
-     * }
+ * AWS credentials must be stored in Secret Manager in JSON format: + * { + * "access_key_id": "ACCESS_KEY_ID", + * "secret_access_key": "SECRET_ACCESS_KEY" + * } * [GoogleServiceAccount][google.storagetransfer.v1.GoogleServiceAccount] must * be granted `roles/secretmanager.secretAccessor` for the resource. - * See [Configure access to a source: Microsoft Azure Blob Storage] - * (https://cloud.google.com/storage-transfer/docs/source-microsoft-azure#secret_manager) + * See [Configure access to a source: Amazon S3] + * (https://cloud.google.com/storage-transfer/docs/source-amazon-s3#secret_manager) * for more information. - * If `credentials_secret` is specified, do not specify [azure_credentials][]. - * This feature is in - * [preview](https://cloud.google.com/terms/service-terms#1). + * If `credentials_secret` is specified, do not specify + * [role_arn][google.storagetransfer.v1.AwsS3Data.role_arn] or + * [aws_access_key][google.storagetransfer.v1.AwsS3Data.aws_access_key]. * Format: `projects/{project_number}/secrets/{secret_name}` * * Generated from protobuf field string credentials_secret = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -304,18 +373,19 @@ public function getCredentialsSecret() /** * Optional. The Resource name of a secret in Secret Manager. - * The Azure SAS token must be stored in Secret Manager in JSON format: - *
{
-     *  "sas_token" : "SAS_TOKEN"
-     * }
+ * AWS credentials must be stored in Secret Manager in JSON format: + * { + * "access_key_id": "ACCESS_KEY_ID", + * "secret_access_key": "SECRET_ACCESS_KEY" + * } * [GoogleServiceAccount][google.storagetransfer.v1.GoogleServiceAccount] must * be granted `roles/secretmanager.secretAccessor` for the resource. - * See [Configure access to a source: Microsoft Azure Blob Storage] - * (https://cloud.google.com/storage-transfer/docs/source-microsoft-azure#secret_manager) + * See [Configure access to a source: Amazon S3] + * (https://cloud.google.com/storage-transfer/docs/source-amazon-s3#secret_manager) * for more information. - * If `credentials_secret` is specified, do not specify [azure_credentials][]. - * This feature is in - * [preview](https://cloud.google.com/terms/service-terms#1). + * If `credentials_secret` is specified, do not specify + * [role_arn][google.storagetransfer.v1.AwsS3Data.role_arn] or + * [aws_access_key][google.storagetransfer.v1.AwsS3Data.aws_access_key]. * Format: `projects/{project_number}/secrets/{secret_name}` * * Generated from protobuf field string credentials_secret = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -330,5 +400,46 @@ public function setCredentialsSecret($var) return $this; } + /** + * Egress bytes over a Google-managed private network. + * This network is shared between other users of Storage Transfer Service. + * + * Generated from protobuf field bool managed_private_network = 8; + * @return bool + */ + public function getManagedPrivateNetwork() + { + return $this->readOneof(8); + } + + public function hasManagedPrivateNetwork() + { + return $this->hasOneof(8); + } + + /** + * Egress bytes over a Google-managed private network. + * This network is shared between other users of Storage Transfer Service. + * + * Generated from protobuf field bool managed_private_network = 8; + * @param bool $var + * @return $this + */ + public function setManagedPrivateNetwork($var) + { + GPBUtil::checkBool($var); + $this->writeOneof(8, $var); + + return $this; + } + + /** + * @return string + */ + public function getPrivateNetwork() + { + return $this->whichOneof("private_network"); + } + } diff --git a/StorageTransfer/src/V1/AzureBlobStorageData.php b/StorageTransfer/src/V1/AzureBlobStorageData.php index 3094ad5dc2b8..24b3b9fab1b2 100644 --- a/StorageTransfer/src/V1/AzureBlobStorageData.php +++ b/StorageTransfer/src/V1/AzureBlobStorageData.php @@ -54,9 +54,9 @@ class AzureBlobStorageData extends \Google\Protobuf\Internal\Message /** * Optional. The Resource name of a secret in Secret Manager. * The Azure SAS token must be stored in Secret Manager in JSON format: - *
{
-     *  "sas_token" : "SAS_TOKEN"
-     * }
+ * { + * "sas_token" : "SAS_TOKEN" + * } * [GoogleServiceAccount][google.storagetransfer.v1.GoogleServiceAccount] must * be granted `roles/secretmanager.secretAccessor` for the resource. * See [Configure access to a source: Microsoft Azure Blob Storage] @@ -64,8 +64,6 @@ class AzureBlobStorageData extends \Google\Protobuf\Internal\Message * for more information. * If `credentials_secret` is specified, do not specify * [azure_credentials][google.storagetransfer.v1.AzureBlobStorageData.azure_credentials]. - * This feature is in - * [preview](https://cloud.google.com/terms/service-terms#1). * Format: `projects/{project_number}/secrets/{secret_name}` * * Generated from protobuf field string credentials_secret = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -95,9 +93,9 @@ class AzureBlobStorageData extends \Google\Protobuf\Internal\Message * @type string $credentials_secret * Optional. The Resource name of a secret in Secret Manager. * The Azure SAS token must be stored in Secret Manager in JSON format: - *
{
-     *            "sas_token" : "SAS_TOKEN"
-     *           }
+ * { + * "sas_token" : "SAS_TOKEN" + * } * [GoogleServiceAccount][google.storagetransfer.v1.GoogleServiceAccount] must * be granted `roles/secretmanager.secretAccessor` for the resource. * See [Configure access to a source: Microsoft Azure Blob Storage] @@ -105,8 +103,6 @@ class AzureBlobStorageData extends \Google\Protobuf\Internal\Message * for more information. * If `credentials_secret` is specified, do not specify * [azure_credentials][google.storagetransfer.v1.AzureBlobStorageData.azure_credentials]. - * This feature is in - * [preview](https://cloud.google.com/terms/service-terms#1). * Format: `projects/{project_number}/secrets/{secret_name}` * } */ @@ -244,9 +240,9 @@ public function setPath($var) /** * Optional. The Resource name of a secret in Secret Manager. * The Azure SAS token must be stored in Secret Manager in JSON format: - *
{
-     *  "sas_token" : "SAS_TOKEN"
-     * }
+ * { + * "sas_token" : "SAS_TOKEN" + * } * [GoogleServiceAccount][google.storagetransfer.v1.GoogleServiceAccount] must * be granted `roles/secretmanager.secretAccessor` for the resource. * See [Configure access to a source: Microsoft Azure Blob Storage] @@ -254,8 +250,6 @@ public function setPath($var) * for more information. * If `credentials_secret` is specified, do not specify * [azure_credentials][google.storagetransfer.v1.AzureBlobStorageData.azure_credentials]. - * This feature is in - * [preview](https://cloud.google.com/terms/service-terms#1). * Format: `projects/{project_number}/secrets/{secret_name}` * * Generated from protobuf field string credentials_secret = 7 [(.google.api.field_behavior) = OPTIONAL]; @@ -269,9 +263,9 @@ public function getCredentialsSecret() /** * Optional. The Resource name of a secret in Secret Manager. * The Azure SAS token must be stored in Secret Manager in JSON format: - *
{
-     *  "sas_token" : "SAS_TOKEN"
-     * }
+ * { + * "sas_token" : "SAS_TOKEN" + * } * [GoogleServiceAccount][google.storagetransfer.v1.GoogleServiceAccount] must * be granted `roles/secretmanager.secretAccessor` for the resource. * See [Configure access to a source: Microsoft Azure Blob Storage] @@ -279,8 +273,6 @@ public function getCredentialsSecret() * for more information. * If `credentials_secret` is specified, do not specify * [azure_credentials][google.storagetransfer.v1.AzureBlobStorageData.azure_credentials]. - * This feature is in - * [preview](https://cloud.google.com/terms/service-terms#1). * Format: `projects/{project_number}/secrets/{secret_name}` * * Generated from protobuf field string credentials_secret = 7 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/StorageTransfer/src/V1/GcsData.php b/StorageTransfer/src/V1/GcsData.php index 90d9dacbed53..ff79b3646040 100644 --- a/StorageTransfer/src/V1/GcsData.php +++ b/StorageTransfer/src/V1/GcsData.php @@ -36,6 +36,21 @@ class GcsData extends \Google\Protobuf\Internal\Message * Generated from protobuf field string path = 3; */ protected $path = ''; + /** + * Preview. Enables the transfer of managed folders between Cloud Storage + * buckets. Set this option on the gcs_data_source. + * If set to true: + * - Managed folders in the source bucket are transferred to the + * destination bucket. + * - Managed folders in the destination bucket are overwritten. Other + * OVERWRITE options are not supported. + * See + * [Transfer Cloud Storage managed + * folders](/storage-transfer/docs/managed-folders). + * + * Generated from protobuf field bool managed_folder_transfer_enabled = 4; + */ + protected $managed_folder_transfer_enabled = false; /** * Constructor. @@ -53,6 +68,17 @@ class GcsData extends \Google\Protobuf\Internal\Message * a '/'. * The root path value must meet * [Object Name Requirements](/storage/docs/naming#objectnames). + * @type bool $managed_folder_transfer_enabled + * Preview. Enables the transfer of managed folders between Cloud Storage + * buckets. Set this option on the gcs_data_source. + * If set to true: + * - Managed folders in the source bucket are transferred to the + * destination bucket. + * - Managed folders in the destination bucket are overwritten. Other + * OVERWRITE options are not supported. + * See + * [Transfer Cloud Storage managed + * folders](/storage-transfer/docs/managed-folders). * } */ public function __construct($data = NULL) { @@ -124,5 +150,49 @@ public function setPath($var) return $this; } + /** + * Preview. Enables the transfer of managed folders between Cloud Storage + * buckets. Set this option on the gcs_data_source. + * If set to true: + * - Managed folders in the source bucket are transferred to the + * destination bucket. + * - Managed folders in the destination bucket are overwritten. Other + * OVERWRITE options are not supported. + * See + * [Transfer Cloud Storage managed + * folders](/storage-transfer/docs/managed-folders). + * + * Generated from protobuf field bool managed_folder_transfer_enabled = 4; + * @return bool + */ + public function getManagedFolderTransferEnabled() + { + return $this->managed_folder_transfer_enabled; + } + + /** + * Preview. Enables the transfer of managed folders between Cloud Storage + * buckets. Set this option on the gcs_data_source. + * If set to true: + * - Managed folders in the source bucket are transferred to the + * destination bucket. + * - Managed folders in the destination bucket are overwritten. Other + * OVERWRITE options are not supported. + * See + * [Transfer Cloud Storage managed + * folders](/storage-transfer/docs/managed-folders). + * + * Generated from protobuf field bool managed_folder_transfer_enabled = 4; + * @param bool $var + * @return $this + */ + public function setManagedFolderTransferEnabled($var) + { + GPBUtil::checkBool($var); + $this->managed_folder_transfer_enabled = $var; + + return $this; + } + } diff --git a/StorageTransfer/src/V1/HdfsData.php b/StorageTransfer/src/V1/HdfsData.php new file mode 100644 index 000000000000..0f758e41c179 --- /dev/null +++ b/StorageTransfer/src/V1/HdfsData.php @@ -0,0 +1,70 @@ +google.storagetransfer.v1.HdfsData + */ +class HdfsData extends \Google\Protobuf\Internal\Message +{ + /** + * Root path to transfer files. + * + * Generated from protobuf field string path = 1; + */ + protected $path = ''; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $path + * Root path to transfer files. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Storagetransfer\V1\TransferTypes::initOnce(); + parent::__construct($data); + } + + /** + * Root path to transfer files. + * + * Generated from protobuf field string path = 1; + * @return string + */ + public function getPath() + { + return $this->path; + } + + /** + * Root path to transfer files. + * + * Generated from protobuf field string path = 1; + * @param string $var + * @return $this + */ + public function setPath($var) + { + GPBUtil::checkString($var, True); + $this->path = $var; + + return $this; + } + +} + diff --git a/StorageTransfer/src/V1/LoggingConfig.php b/StorageTransfer/src/V1/LoggingConfig.php index aa59c8604305..22f830828e9c 100644 --- a/StorageTransfer/src/V1/LoggingConfig.php +++ b/StorageTransfer/src/V1/LoggingConfig.php @@ -10,15 +10,10 @@ /** * Specifies the logging behavior for transfer operations. - * For cloud-to-cloud transfers, logs are sent to Cloud Logging. See + * Logs can be sent to Cloud Logging for all transfer types. See * [Read transfer * logs](https://cloud.google.com/storage-transfer/docs/read-transfer-logs) for * details. - * For transfers to or from a POSIX file system, logs are stored in the - * Cloud Storage bucket that is the source or sink of the transfer. - * See [Managing Transfer for on-premises jobs] - * (https://cloud.google.com/storage-transfer/docs/managing-on-prem-jobs#viewing-logs) - * for details. * * Generated from protobuf message google.storagetransfer.v1.LoggingConfig */ @@ -26,25 +21,23 @@ class LoggingConfig extends \Google\Protobuf\Internal\Message { /** * Specifies the actions to be logged. If empty, no logs are generated. - * Not supported for transfers with PosixFilesystem data sources; use - * [enable_onprem_gcs_transfer_logs][google.storagetransfer.v1.LoggingConfig.enable_onprem_gcs_transfer_logs] - * instead. * * Generated from protobuf field repeated .google.storagetransfer.v1.LoggingConfig.LoggableAction log_actions = 1; */ private $log_actions; /** * States in which `log_actions` are logged. If empty, no logs are generated. - * Not supported for transfers with PosixFilesystem data sources; use - * [enable_onprem_gcs_transfer_logs][google.storagetransfer.v1.LoggingConfig.enable_onprem_gcs_transfer_logs] - * instead. * * Generated from protobuf field repeated .google.storagetransfer.v1.LoggingConfig.LoggableActionState log_action_states = 2; */ private $log_action_states; /** - * For transfers with a PosixFilesystem source, this option enables the Cloud - * Storage transfer logs for this transfer. + * For PosixFilesystem transfers, enables + * [file system transfer + * logs](https://cloud.google.com/storage-transfer/docs/on-prem-transfer-log-format) + * instead of, or in addition to, Cloud Logging. + * This option ignores [LoggableAction] and [LoggableActionState]. If these + * are set, Cloud Logging will also be enabled for this transfer. * * Generated from protobuf field bool enable_onprem_gcs_transfer_logs = 3; */ @@ -58,17 +51,15 @@ class LoggingConfig extends \Google\Protobuf\Internal\Message * * @type array|\Google\Protobuf\Internal\RepeatedField $log_actions * Specifies the actions to be logged. If empty, no logs are generated. - * Not supported for transfers with PosixFilesystem data sources; use - * [enable_onprem_gcs_transfer_logs][google.storagetransfer.v1.LoggingConfig.enable_onprem_gcs_transfer_logs] - * instead. * @type array|\Google\Protobuf\Internal\RepeatedField $log_action_states * States in which `log_actions` are logged. If empty, no logs are generated. - * Not supported for transfers with PosixFilesystem data sources; use - * [enable_onprem_gcs_transfer_logs][google.storagetransfer.v1.LoggingConfig.enable_onprem_gcs_transfer_logs] - * instead. * @type bool $enable_onprem_gcs_transfer_logs - * For transfers with a PosixFilesystem source, this option enables the Cloud - * Storage transfer logs for this transfer. + * For PosixFilesystem transfers, enables + * [file system transfer + * logs](https://cloud.google.com/storage-transfer/docs/on-prem-transfer-log-format) + * instead of, or in addition to, Cloud Logging. + * This option ignores [LoggableAction] and [LoggableActionState]. If these + * are set, Cloud Logging will also be enabled for this transfer. * } */ public function __construct($data = NULL) { @@ -78,9 +69,6 @@ public function __construct($data = NULL) { /** * Specifies the actions to be logged. If empty, no logs are generated. - * Not supported for transfers with PosixFilesystem data sources; use - * [enable_onprem_gcs_transfer_logs][google.storagetransfer.v1.LoggingConfig.enable_onprem_gcs_transfer_logs] - * instead. * * Generated from protobuf field repeated .google.storagetransfer.v1.LoggingConfig.LoggableAction log_actions = 1; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,9 +80,6 @@ public function getLogActions() /** * Specifies the actions to be logged. If empty, no logs are generated. - * Not supported for transfers with PosixFilesystem data sources; use - * [enable_onprem_gcs_transfer_logs][google.storagetransfer.v1.LoggingConfig.enable_onprem_gcs_transfer_logs] - * instead. * * Generated from protobuf field repeated .google.storagetransfer.v1.LoggingConfig.LoggableAction log_actions = 1; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -110,9 +95,6 @@ public function setLogActions($var) /** * States in which `log_actions` are logged. If empty, no logs are generated. - * Not supported for transfers with PosixFilesystem data sources; use - * [enable_onprem_gcs_transfer_logs][google.storagetransfer.v1.LoggingConfig.enable_onprem_gcs_transfer_logs] - * instead. * * Generated from protobuf field repeated .google.storagetransfer.v1.LoggingConfig.LoggableActionState log_action_states = 2; * @return \Google\Protobuf\Internal\RepeatedField @@ -124,9 +106,6 @@ public function getLogActionStates() /** * States in which `log_actions` are logged. If empty, no logs are generated. - * Not supported for transfers with PosixFilesystem data sources; use - * [enable_onprem_gcs_transfer_logs][google.storagetransfer.v1.LoggingConfig.enable_onprem_gcs_transfer_logs] - * instead. * * Generated from protobuf field repeated .google.storagetransfer.v1.LoggingConfig.LoggableActionState log_action_states = 2; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -141,8 +120,12 @@ public function setLogActionStates($var) } /** - * For transfers with a PosixFilesystem source, this option enables the Cloud - * Storage transfer logs for this transfer. + * For PosixFilesystem transfers, enables + * [file system transfer + * logs](https://cloud.google.com/storage-transfer/docs/on-prem-transfer-log-format) + * instead of, or in addition to, Cloud Logging. + * This option ignores [LoggableAction] and [LoggableActionState]. If these + * are set, Cloud Logging will also be enabled for this transfer. * * Generated from protobuf field bool enable_onprem_gcs_transfer_logs = 3; * @return bool @@ -153,8 +136,12 @@ public function getEnableOnpremGcsTransferLogs() } /** - * For transfers with a PosixFilesystem source, this option enables the Cloud - * Storage transfer logs for this transfer. + * For PosixFilesystem transfers, enables + * [file system transfer + * logs](https://cloud.google.com/storage-transfer/docs/on-prem-transfer-log-format) + * instead of, or in addition to, Cloud Logging. + * This option ignores [LoggableAction] and [LoggableActionState]. If these + * are set, Cloud Logging will also be enabled for this transfer. * * Generated from protobuf field bool enable_onprem_gcs_transfer_logs = 3; * @param bool $var diff --git a/StorageTransfer/src/V1/MetadataOptions.php b/StorageTransfer/src/V1/MetadataOptions.php index 79898cf63c57..e1c793ca7909 100644 --- a/StorageTransfer/src/V1/MetadataOptions.php +++ b/StorageTransfer/src/V1/MetadataOptions.php @@ -83,9 +83,10 @@ class MetadataOptions extends \Google\Protobuf\Internal\Message protected $kms_key = 0; /** * Specifies how each object's `timeCreated` metadata is preserved for - * transfers between Google Cloud Storage buckets. If unspecified, the - * default behavior is the same as + * transfers. If unspecified, the default behavior is the same as * [TIME_CREATED_SKIP][google.storagetransfer.v1.MetadataOptions.TimeCreated.TIME_CREATED_SKIP]. + * This behavior is supported for transfers to Cloud Storage buckets from + * Cloud Storage, Amazon S3, S3-compatible storage, and Azure sources. * * Generated from protobuf field .google.storagetransfer.v1.MetadataOptions.TimeCreated time_created = 9; */ @@ -133,9 +134,10 @@ class MetadataOptions extends \Google\Protobuf\Internal\Message * [KMS_KEY_DESTINATION_BUCKET_DEFAULT][google.storagetransfer.v1.MetadataOptions.KmsKey.KMS_KEY_DESTINATION_BUCKET_DEFAULT]. * @type int $time_created * Specifies how each object's `timeCreated` metadata is preserved for - * transfers between Google Cloud Storage buckets. If unspecified, the - * default behavior is the same as + * transfers. If unspecified, the default behavior is the same as * [TIME_CREATED_SKIP][google.storagetransfer.v1.MetadataOptions.TimeCreated.TIME_CREATED_SKIP]. + * This behavior is supported for transfers to Cloud Storage buckets from + * Cloud Storage, Amazon S3, S3-compatible storage, and Azure sources. * } */ public function __construct($data = NULL) { @@ -389,9 +391,10 @@ public function setKmsKey($var) /** * Specifies how each object's `timeCreated` metadata is preserved for - * transfers between Google Cloud Storage buckets. If unspecified, the - * default behavior is the same as + * transfers. If unspecified, the default behavior is the same as * [TIME_CREATED_SKIP][google.storagetransfer.v1.MetadataOptions.TimeCreated.TIME_CREATED_SKIP]. + * This behavior is supported for transfers to Cloud Storage buckets from + * Cloud Storage, Amazon S3, S3-compatible storage, and Azure sources. * * Generated from protobuf field .google.storagetransfer.v1.MetadataOptions.TimeCreated time_created = 9; * @return int @@ -403,9 +406,10 @@ public function getTimeCreated() /** * Specifies how each object's `timeCreated` metadata is preserved for - * transfers between Google Cloud Storage buckets. If unspecified, the - * default behavior is the same as + * transfers. If unspecified, the default behavior is the same as * [TIME_CREATED_SKIP][google.storagetransfer.v1.MetadataOptions.TimeCreated.TIME_CREATED_SKIP]. + * This behavior is supported for transfers to Cloud Storage buckets from + * Cloud Storage, Amazon S3, S3-compatible storage, and Azure sources. * * Generated from protobuf field .google.storagetransfer.v1.MetadataOptions.TimeCreated time_created = 9; * @param int $var diff --git a/StorageTransfer/src/V1/MetadataOptions/TimeCreated.php b/StorageTransfer/src/V1/MetadataOptions/TimeCreated.php index 2c172f59f594..7a3b23cea78d 100644 --- a/StorageTransfer/src/V1/MetadataOptions/TimeCreated.php +++ b/StorageTransfer/src/V1/MetadataOptions/TimeCreated.php @@ -27,10 +27,10 @@ class TimeCreated */ const TIME_CREATED_SKIP = 1; /** - * Preserves the source object's `timeCreated` metadata in the `customTime` - * field in the destination object. Note that any value stored in the - * source object's `customTime` field will not be propagated to the - * destination object. + * Preserves the source object's `timeCreated` or `lastModified` metadata in + * the `customTime` field in the destination object. Note that any value + * stored in the source object's `customTime` field will not be propagated + * to the destination object. * * Generated from protobuf enum TIME_CREATED_PRESERVE_AS_CUSTOM_TIME = 2; */ diff --git a/StorageTransfer/src/V1/TransferJob.php b/StorageTransfer/src/V1/TransferJob.php index e44c5128169e..efc91b2f5ac8 100644 --- a/StorageTransfer/src/V1/TransferJob.php +++ b/StorageTransfer/src/V1/TransferJob.php @@ -60,8 +60,7 @@ class TransferJob extends \Google\Protobuf\Internal\Message */ protected $transfer_spec = null; /** - * Notification configuration. This is not supported for transfers involving - * PosixFilesystem. + * Notification configuration. * * Generated from protobuf field .google.storagetransfer.v1.NotificationConfig notification_config = 11; */ @@ -161,8 +160,7 @@ class TransferJob extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\StorageTransfer\V1\TransferSpec $transfer_spec * Transfer specification. * @type \Google\Cloud\StorageTransfer\V1\NotificationConfig $notification_config - * Notification configuration. This is not supported for transfers involving - * PosixFilesystem. + * Notification configuration. * @type \Google\Cloud\StorageTransfer\V1\LoggingConfig $logging_config * Logging configuration. * @type \Google\Cloud\StorageTransfer\V1\Schedule $schedule @@ -351,8 +349,7 @@ public function setTransferSpec($var) } /** - * Notification configuration. This is not supported for transfers involving - * PosixFilesystem. + * Notification configuration. * * Generated from protobuf field .google.storagetransfer.v1.NotificationConfig notification_config = 11; * @return \Google\Cloud\StorageTransfer\V1\NotificationConfig|null @@ -373,8 +370,7 @@ public function clearNotificationConfig() } /** - * Notification configuration. This is not supported for transfers involving - * PosixFilesystem. + * Notification configuration. * * Generated from protobuf field .google.storagetransfer.v1.NotificationConfig notification_config = 11; * @param \Google\Cloud\StorageTransfer\V1\NotificationConfig $var diff --git a/StorageTransfer/src/V1/TransferSpec.php b/StorageTransfer/src/V1/TransferSpec.php index 8ba191f5580e..28466a839393 100644 --- a/StorageTransfer/src/V1/TransferSpec.php +++ b/StorageTransfer/src/V1/TransferSpec.php @@ -81,6 +81,8 @@ class TransferSpec extends \Google\Protobuf\Internal\Message * An Azure Blob Storage data source. * @type \Google\Cloud\StorageTransfer\V1\AwsS3CompatibleData $aws_s3_compatible_data_source * An AWS S3 compatible data source. + * @type \Google\Cloud\StorageTransfer\V1\HdfsData $hdfs_data_source + * An HDFS cluster data source. * @type \Google\Cloud\StorageTransfer\V1\GcsData $gcs_intermediate_data_location * For transfers between file systems, specifies a Cloud Storage bucket * to be used as an intermediate location through which to transfer data. @@ -362,6 +364,37 @@ public function setAwsS3CompatibleDataSource($var) return $this; } + /** + * An HDFS cluster data source. + * + * Generated from protobuf field .google.storagetransfer.v1.HdfsData hdfs_data_source = 20; + * @return \Google\Cloud\StorageTransfer\V1\HdfsData|null + */ + public function getHdfsDataSource() + { + return $this->readOneof(20); + } + + public function hasHdfsDataSource() + { + return $this->hasOneof(20); + } + + /** + * An HDFS cluster data source. + * + * Generated from protobuf field .google.storagetransfer.v1.HdfsData hdfs_data_source = 20; + * @param \Google\Cloud\StorageTransfer\V1\HdfsData $var + * @return $this + */ + public function setHdfsDataSource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\StorageTransfer\V1\HdfsData::class); + $this->writeOneof(20, $var); + + return $this; + } + /** * For transfers between file systems, specifies a Cloud Storage bucket * to be used as an intermediate location through which to transfer data.