Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 10 additions & 4 deletions src/OrgPolicyAPI/GoogleCloudOrgpolicyV2Constraint.php
Original file line number Diff line number Diff line change
Expand Up @@ -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
*/
Expand Down Expand Up @@ -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
*/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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[]
*/
Expand Down Expand Up @@ -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
*/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
*/
Expand Down Expand Up @@ -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
*/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
*/
Expand Down
16 changes: 8 additions & 8 deletions src/OrgPolicyAPI/GoogleCloudOrgpolicyV2Policy.php
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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
*/
Expand All @@ -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,
Expand Down
26 changes: 14 additions & 12 deletions src/OrgPolicyAPI/GoogleCloudOrgpolicyV2PolicySpec.php
Original file line number Diff line number Diff line change
Expand Up @@ -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
*/
Expand All @@ -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
Expand Down Expand Up @@ -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
*/
Expand All @@ -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
Expand Down Expand Up @@ -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
*/
Expand Down
25 changes: 13 additions & 12 deletions src/OrgPolicyAPI/Resource/FoldersPolicies.php
Original file line number Diff line number Diff line change
Expand Up @@ -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
*/
Expand All @@ -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.
Expand All @@ -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)
Expand Down Expand Up @@ -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,
Expand All @@ -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
*/
Expand Down
25 changes: 13 additions & 12 deletions src/OrgPolicyAPI/Resource/OrganizationsPolicies.php
Original file line number Diff line number Diff line change
Expand Up @@ -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
*/
Expand All @@ -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.
Expand All @@ -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)
Expand Down Expand Up @@ -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,
Expand All @@ -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
*/
Expand Down
25 changes: 13 additions & 12 deletions src/OrgPolicyAPI/Resource/ProjectsPolicies.php
Original file line number Diff line number Diff line change
Expand Up @@ -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
*/
Expand All @@ -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.
Expand All @@ -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)
Expand Down Expand Up @@ -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,
Expand All @@ -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
*/
Expand Down
Loading