Regenerate orgpolicy client (#8254)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-php-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

src/OrgPolicyAPI/GoogleCloudOrgpolicyV2Constraint.php

@@ -56,8 +56,11 @@ class GoogleCloudOrgpolicyV2Constraint extends \Google\Model
    */
   public $displayName;
   /**
-   * Managed constraint and canned constraint sometimes can have equivalents.
-   * This field is used to store the equivalent constraint name.
+   * Defines the equivalent constraint name, if it exists. Managed constraints
+   * can have an equivalent legacy managed constraint, and legacy managed
+   * constraints can have an equivalent managed constraint. For example,
+   * "constraints/iam.disableServiceAccountKeyUpload" is equivalent to
+   * "constraints/iam.managed.disableServiceAccountKeyUpload".
    *
    * @var string
    */
@@ -156,8 +159,11 @@ public function getDisplayName()
     return $this->displayName;
   }
   /**
-   * Managed constraint and canned constraint sometimes can have equivalents.
-   * This field is used to store the equivalent constraint name.
+   * Defines the equivalent constraint name, if it exists. Managed constraints
+   * can have an equivalent legacy managed constraint, and legacy managed
+   * constraints can have an equivalent managed constraint. For example,
+   * "constraints/iam.disableServiceAccountKeyUpload" is equivalent to
+   * "constraints/iam.managed.disableServiceAccountKeyUpload".
    *
    * @param string $equivalentConstraint
    */

src/OrgPolicyAPI/GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition.php

@@ -57,8 +57,8 @@ class GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition extends \Google
   protected $parametersType = GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter::class;
   protected $parametersDataType = 'map';
   /**
-   * The resource instance type on which this policy applies. Format will be of
-   * the form : `/` Example: * `compute.googleapis.com/Instance`.
+   * The resource instance type that this policy applies to, in the format `/`.
+   * Example: * `compute.googleapis.com/Instance`.
    *
    * @var string[]
    */
@@ -135,8 +135,8 @@ public function getParameters()
     return $this->parameters;
   }
   /**
-   * The resource instance type on which this policy applies. Format will be of
-   * the form : `/` Example: * `compute.googleapis.com/Instance`.
+   * The resource instance type that this policy applies to, in the format `/`.
+   * Example: * `compute.googleapis.com/Instance`.
    *
    * @param string[] $resourceTypes
    */

src/OrgPolicyAPI/GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter.php

@@ -77,7 +77,7 @@ class GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter extend
   /**
    * Provides a CEL expression to specify the acceptable parameter values during
    * assignment. For example, parameterName in ("parameterValue1",
-   * "parameterValue2")
+   * "parameterValue2").
    *
    * @var string
    */
@@ -156,7 +156,7 @@ public function getType()
   /**
    * Provides a CEL expression to specify the acceptable parameter values during
    * assignment. For example, parameterName in ("parameterValue1",
-   * "parameterValue2")
+   * "parameterValue2").
    *
    * @param string $validValuesExpr
    */

src/OrgPolicyAPI/GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata.php

@@ -20,14 +20,14 @@
 class GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata extends \Google\Model
 {
   /**
-   * Detailed description of what this `parameter` is and use of it. Mutable.
+   * Detailed description of what this `parameter` is and its use. Mutable.
    *
    * @var string
    */
   public $description;
 
   /**
-   * Detailed description of what this `parameter` is and use of it. Mutable.
+   * Detailed description of what this `parameter` is and its use. Mutable.
    *
    * @param string $description
    */

src/OrgPolicyAPI/GoogleCloudOrgpolicyV2Policy.php

@@ -25,16 +25,16 @@ class GoogleCloudOrgpolicyV2Policy extends \Google\Model
   protected $dryRunSpecDataType = '';
   /**
    * Optional. An opaque tag indicating the current state of the policy, used
-   * for concurrency control. This 'etag' is computed by the server based on the
-   * value of other fields, and may be sent on update and delete requests to
-   * ensure the client has an up-to-date value before proceeding.
+   * for concurrency control. This entity tag (ETag) is computed by the server
+   * based on the value of other fields, and may be sent on update and delete
+   * requests to ensure the client has an up-to-date value before proceeding.
    *
    * @var string
    */
   public $etag;
   /**
    * Immutable. The resource name of the policy. Must be one of the following
-   * forms, where `constraint_name` is the name of the constraint which this
+   * forms, where `constraint_name` is the name of the constraint that this
    * policy configures: * `projects/{project_number}/policies/{constraint_name}`
    * * `folders/{folder_id}/policies/{constraint_name}` *
    * `organizations/{organization_id}/policies/{constraint_name}` For example,
@@ -86,9 +86,9 @@ public function getDryRunSpec()
   }
   /**
    * Optional. An opaque tag indicating the current state of the policy, used
-   * for concurrency control. This 'etag' is computed by the server based on the
-   * value of other fields, and may be sent on update and delete requests to
-   * ensure the client has an up-to-date value before proceeding.
+   * for concurrency control. This entity tag (ETag) is computed by the server
+   * based on the value of other fields, and may be sent on update and delete
+   * requests to ensure the client has an up-to-date value before proceeding.
    *
    * @param string $etag
    */
@@ -105,7 +105,7 @@ public function getEtag()
   }
   /**
    * Immutable. The resource name of the policy. Must be one of the following
-   * forms, where `constraint_name` is the name of the constraint which this
+   * forms, where `constraint_name` is the name of the constraint that this
    * policy configures: * `projects/{project_number}/policies/{constraint_name}`
    * * `folders/{folder_id}/policies/{constraint_name}` *
    * `organizations/{organization_id}/policies/{constraint_name}` For example,

src/OrgPolicyAPI/GoogleCloudOrgpolicyV2PolicySpec.php

@@ -24,9 +24,10 @@ class GoogleCloudOrgpolicyV2PolicySpec extends \Google\Collection
    * An opaque tag indicating the current version of the policySpec, used for
    * concurrency control. This field is ignored if used in a `CreatePolicy`
    * request. When the policy is returned from either a `GetPolicy` or a
-   * `ListPolicies` request, this `etag` indicates the version of the current
-   * policySpec to use when executing a read-modify-write loop. When the policy
-   * is returned from a `GetEffectivePolicy` request, the `etag` will be unset.
+   * `ListPolicies` request, this entity tag (ETag) indicates the version of the
+   * current policySpec to use when executing a read-modify-write loop. When the
+   * policy is returned from a `GetEffectivePolicy` request, the ETag will be
+   * unset.
    *
    * @var string
    */
@@ -36,7 +37,7 @@ class GoogleCloudOrgpolicyV2PolicySpec extends \Google\Collection
    * `inherit_from_parent` is true, policy rules set higher up in the hierarchy
    * (up to the closest root) are inherited and present in the effective policy.
    * If it is false, then no rules are inherited, and this policy becomes the
-   * new root for evaluation. This field can be set only for policies which
+   * new root for evaluation. This field can be set only for policies that
    * configure list constraints.
    *
    * @var bool
@@ -67,9 +68,10 @@ class GoogleCloudOrgpolicyV2PolicySpec extends \Google\Collection
    * An opaque tag indicating the current version of the policySpec, used for
    * concurrency control. This field is ignored if used in a `CreatePolicy`
    * request. When the policy is returned from either a `GetPolicy` or a
-   * `ListPolicies` request, this `etag` indicates the version of the current
-   * policySpec to use when executing a read-modify-write loop. When the policy
-   * is returned from a `GetEffectivePolicy` request, the `etag` will be unset.
+   * `ListPolicies` request, this entity tag (ETag) indicates the version of the
+   * current policySpec to use when executing a read-modify-write loop. When the
+   * policy is returned from a `GetEffectivePolicy` request, the ETag will be
+   * unset.
    *
    * @param string $etag
    */
@@ -89,7 +91,7 @@ public function getEtag()
    * `inherit_from_parent` is true, policy rules set higher up in the hierarchy
    * (up to the closest root) are inherited and present in the effective policy.
    * If it is false, then no rules are inherited, and this policy becomes the
-   * new root for evaluation. This field can be set only for policies which
+   * new root for evaluation. This field can be set only for policies that
    * configure list constraints.
    *
    * @param bool $inheritFromParent
@@ -127,10 +129,10 @@ public function getReset()
   }
   /**
    * In policies for boolean constraints, the following requirements apply: -
-   * There must be one and only one policy rule where condition is unset. -
-   * Boolean policy rules with conditions must set `enforced` to the opposite of
-   * the policy rule without a condition. - During policy evaluation, policy
-   * rules with conditions that are true for a target resource take precedence.
+   * There must be exactly one policy rule where a condition is unset. - Boolean
+   * policy rules with conditions must set `enforced` to the opposite of the
+   * policy rule without a condition. - During policy evaluation, policy rules
+   * with conditions that are true for a target resource take precedence.
    *
    * @param GoogleCloudOrgpolicyV2PolicySpecPolicyRule[] $rules
    */

src/OrgPolicyAPI/Resource/FoldersPolicies.php

@@ -61,9 +61,10 @@ public function create($parent, GoogleCloudOrgpolicyV2Policy $postBody, $optPara
    * entry for naming rules.
    * @param array $optParams Optional parameters.
    *
-   * @opt_param string etag Optional. The current etag of policy. If an etag is
-   * provided and does not match the current etag of the policy, deletion will be
-   * blocked and an ABORTED error will be returned.
+   * @opt_param string etag Optional. The current entity tag (ETag) of the
+   * organization policy. If an ETag is provided and doesn't match the current
+   * ETag of the policy, deletion of the policy will be blocked and an `ABORTED`
+   * error will be returned.
    * @return GoogleProtobufEmpty
    * @throws \Google\Service\Exception
    */
@@ -75,8 +76,8 @@ public function delete($name, $optParams = [])
   }
   /**
    * Gets a policy on a resource. If no policy is set on the resource, `NOT_FOUND`
-   * is returned. The `etag` value can be used with `UpdatePolicy()` to update a
-   * policy during read-modify-write. (policies.get)
+   * is returned. The entity tag (ETag) can be used with `UpdatePolicy()` to
+   * update a policy during read-modify-write. (policies.get)
    *
    * @param string $name Required. Resource name of the policy. See Policy for
    * naming requirements.
@@ -93,7 +94,7 @@ public function get($name, $optParams = [])
   /**
    * Gets the effective policy on a resource. This is the result of merging
    * policies in the resource hierarchy and evaluating conditions. The returned
-   * policy will not have an `etag` or `condition` set because it is an evaluated
+   * policy will not have an ETag or `condition` set because it is an evaluated
    * policy across multiple resources. Subtrees of Resource Manager resource
    * hierarchy with 'under:' prefix will not be expanded.
    * (policies.getEffectivePolicy)
@@ -138,15 +139,15 @@ public function listFoldersPolicies($parent, $optParams = [])
   }
   /**
    * Updates a policy. Returns a `google.rpc.Status` with
-   * `google.rpc.Code.NOT_FOUND` if the constraint or the policy do not exist.
-   * Returns a `google.rpc.Status` with `google.rpc.Code.ABORTED` if the etag
-   * supplied in the request does not match the persisted etag of the policy Note:
+   * `google.rpc.Code.NOT_FOUND` if the constraint or the policy doesn't exist.
+   * Returns a `google.rpc.Status` with `google.rpc.Code.ABORTED` if the ETag
+   * supplied in the request doesn't match the persisted ETag of the policy. Note:
    * the supplied policy will perform a full overwrite of all fields.
    * (policies.patch)
    *
    * @param string $name Immutable. The resource name of the policy. Must be one
    * of the following forms, where `constraint_name` is the name of the constraint
-   * which this policy configures: *
+   * that this policy configures: *
    * `projects/{project_number}/policies/{constraint_name}` *
    * `folders/{folder_id}/policies/{constraint_name}` *
    * `organizations/{organization_id}/policies/{constraint_name}` For example,
@@ -158,8 +159,8 @@ public function listFoldersPolicies($parent, $optParams = [])
    * @param array $optParams Optional parameters.
    *
    * @opt_param string updateMask Field mask used to specify the fields to be
-   * overwritten in the policy by the set. The fields specified in the update_mask
-   * are relative to the policy, not the full request.
+   * overwritten in the policy. The fields specified in the update_mask are
+   * relative to the policy, not the full request.
    * @return GoogleCloudOrgpolicyV2Policy
    * @throws \Google\Service\Exception
    */

src/OrgPolicyAPI/Resource/OrganizationsPolicies.php

@@ -61,9 +61,10 @@ public function create($parent, GoogleCloudOrgpolicyV2Policy $postBody, $optPara
    * entry for naming rules.
    * @param array $optParams Optional parameters.
    *
-   * @opt_param string etag Optional. The current etag of policy. If an etag is
-   * provided and does not match the current etag of the policy, deletion will be
-   * blocked and an ABORTED error will be returned.
+   * @opt_param string etag Optional. The current entity tag (ETag) of the
+   * organization policy. If an ETag is provided and doesn't match the current
+   * ETag of the policy, deletion of the policy will be blocked and an `ABORTED`
+   * error will be returned.
    * @return GoogleProtobufEmpty
    * @throws \Google\Service\Exception
    */
@@ -75,8 +76,8 @@ public function delete($name, $optParams = [])
   }
   /**
    * Gets a policy on a resource. If no policy is set on the resource, `NOT_FOUND`
-   * is returned. The `etag` value can be used with `UpdatePolicy()` to update a
-   * policy during read-modify-write. (policies.get)
+   * is returned. The entity tag (ETag) can be used with `UpdatePolicy()` to
+   * update a policy during read-modify-write. (policies.get)
    *
    * @param string $name Required. Resource name of the policy. See Policy for
    * naming requirements.
@@ -93,7 +94,7 @@ public function get($name, $optParams = [])
   /**
    * Gets the effective policy on a resource. This is the result of merging
    * policies in the resource hierarchy and evaluating conditions. The returned
-   * policy will not have an `etag` or `condition` set because it is an evaluated
+   * policy will not have an ETag or `condition` set because it is an evaluated
    * policy across multiple resources. Subtrees of Resource Manager resource
    * hierarchy with 'under:' prefix will not be expanded.
    * (policies.getEffectivePolicy)
@@ -138,15 +139,15 @@ public function listOrganizationsPolicies($parent, $optParams = [])
   }
   /**
    * Updates a policy. Returns a `google.rpc.Status` with
-   * `google.rpc.Code.NOT_FOUND` if the constraint or the policy do not exist.
-   * Returns a `google.rpc.Status` with `google.rpc.Code.ABORTED` if the etag
-   * supplied in the request does not match the persisted etag of the policy Note:
+   * `google.rpc.Code.NOT_FOUND` if the constraint or the policy doesn't exist.
+   * Returns a `google.rpc.Status` with `google.rpc.Code.ABORTED` if the ETag
+   * supplied in the request doesn't match the persisted ETag of the policy. Note:
    * the supplied policy will perform a full overwrite of all fields.
    * (policies.patch)
    *
    * @param string $name Immutable. The resource name of the policy. Must be one
    * of the following forms, where `constraint_name` is the name of the constraint
-   * which this policy configures: *
+   * that this policy configures: *
    * `projects/{project_number}/policies/{constraint_name}` *
    * `folders/{folder_id}/policies/{constraint_name}` *
    * `organizations/{organization_id}/policies/{constraint_name}` For example,
@@ -158,8 +159,8 @@ public function listOrganizationsPolicies($parent, $optParams = [])
    * @param array $optParams Optional parameters.
    *
    * @opt_param string updateMask Field mask used to specify the fields to be
-   * overwritten in the policy by the set. The fields specified in the update_mask
-   * are relative to the policy, not the full request.
+   * overwritten in the policy. The fields specified in the update_mask are
+   * relative to the policy, not the full request.
    * @return GoogleCloudOrgpolicyV2Policy
    * @throws \Google\Service\Exception
    */

src/OrgPolicyAPI/Resource/ProjectsPolicies.php

@@ -61,9 +61,10 @@ public function create($parent, GoogleCloudOrgpolicyV2Policy $postBody, $optPara
    * entry for naming rules.
    * @param array $optParams Optional parameters.
    *
-   * @opt_param string etag Optional. The current etag of policy. If an etag is
-   * provided and does not match the current etag of the policy, deletion will be
-   * blocked and an ABORTED error will be returned.
+   * @opt_param string etag Optional. The current entity tag (ETag) of the
+   * organization policy. If an ETag is provided and doesn't match the current
+   * ETag of the policy, deletion of the policy will be blocked and an `ABORTED`
+   * error will be returned.
    * @return GoogleProtobufEmpty
    * @throws \Google\Service\Exception
    */
@@ -75,8 +76,8 @@ public function delete($name, $optParams = [])
   }
   /**
    * Gets a policy on a resource. If no policy is set on the resource, `NOT_FOUND`
-   * is returned. The `etag` value can be used with `UpdatePolicy()` to update a
-   * policy during read-modify-write. (policies.get)
+   * is returned. The entity tag (ETag) can be used with `UpdatePolicy()` to
+   * update a policy during read-modify-write. (policies.get)
    *
    * @param string $name Required. Resource name of the policy. See Policy for
    * naming requirements.
@@ -93,7 +94,7 @@ public function get($name, $optParams = [])
   /**
    * Gets the effective policy on a resource. This is the result of merging
    * policies in the resource hierarchy and evaluating conditions. The returned
-   * policy will not have an `etag` or `condition` set because it is an evaluated
+   * policy will not have an ETag or `condition` set because it is an evaluated
    * policy across multiple resources. Subtrees of Resource Manager resource
    * hierarchy with 'under:' prefix will not be expanded.
    * (policies.getEffectivePolicy)
@@ -138,15 +139,15 @@ public function listProjectsPolicies($parent, $optParams = [])
   }
   /**
    * Updates a policy. Returns a `google.rpc.Status` with
-   * `google.rpc.Code.NOT_FOUND` if the constraint or the policy do not exist.
-   * Returns a `google.rpc.Status` with `google.rpc.Code.ABORTED` if the etag
-   * supplied in the request does not match the persisted etag of the policy Note:
+   * `google.rpc.Code.NOT_FOUND` if the constraint or the policy doesn't exist.
+   * Returns a `google.rpc.Status` with `google.rpc.Code.ABORTED` if the ETag
+   * supplied in the request doesn't match the persisted ETag of the policy. Note:
    * the supplied policy will perform a full overwrite of all fields.
    * (policies.patch)
    *
    * @param string $name Immutable. The resource name of the policy. Must be one
    * of the following forms, where `constraint_name` is the name of the constraint
-   * which this policy configures: *
+   * that this policy configures: *
    * `projects/{project_number}/policies/{constraint_name}` *
    * `folders/{folder_id}/policies/{constraint_name}` *
    * `organizations/{organization_id}/policies/{constraint_name}` For example,
@@ -158,8 +159,8 @@ public function listProjectsPolicies($parent, $optParams = [])
    * @param array $optParams Optional parameters.
    *
    * @opt_param string updateMask Field mask used to specify the fields to be
-   * overwritten in the policy by the set. The fields specified in the update_mask
-   * are relative to the policy, not the full request.
+   * overwritten in the policy. The fields specified in the update_mask are
+   * relative to the policy, not the full request.
    * @return GoogleCloudOrgpolicyV2Policy
    * @throws \Google\Service\Exception
    */