Class OrgPolicyGrpc.OrgPolicyFutureStub (2.41.0)

public static final class OrgPolicyGrpc.OrgPolicyFutureStub extends AbstractFutureStub<OrgPolicyGrpc.OrgPolicyFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service OrgPolicy.

An interface for managing organization policies. The Organization Policy Service provides a simple mechanism for organizations to restrict the allowed configurations across their entire resource hierarchy. You can use a policy to configure restrictions on resources. For example, you can enforce a policy that restricts which Google Cloud APIs can be activated in a certain part of your resource hierarchy, or prevents serial port access to VM instances in a particular folder. Policies are inherited down through the resource hierarchy. A policy applied to a parent resource automatically applies to all its child resources unless overridden with a policy lower in the hierarchy. A constraint defines an aspect of a resource's configuration that can be controlled by an organization's policy administrator. Policies are a collection of constraints that defines their allowable configuration on a particular resource and its child resources.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > OrgPolicyGrpc.OrgPolicyFutureStub

Methods

build(Channel channel, CallOptions callOptions)

protected OrgPolicyGrpc.OrgPolicyFutureStub build(Channel channel, CallOptions callOptions)
Parameters
NameDescription
channelio.grpc.Channel
callOptionsio.grpc.CallOptions
Returns
TypeDescription
OrgPolicyGrpc.OrgPolicyFutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

createCustomConstraint(CreateCustomConstraintRequest request)

public ListenableFuture<CustomConstraint> createCustomConstraint(CreateCustomConstraintRequest request)

Creates a custom constraint. Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the organization does not exist. Returns a google.rpc.Status with google.rpc.Code.ALREADY_EXISTS if the constraint already exists on the given organization.

Parameter
NameDescription
requestCreateCustomConstraintRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<CustomConstraint>

createPolicy(CreatePolicyRequest request)

public ListenableFuture<Policy> createPolicy(CreatePolicyRequest request)

Creates a policy. Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the constraint does not exist. Returns a google.rpc.Status with google.rpc.Code.ALREADY_EXISTS if the policy already exists on the given Google Cloud resource.

Parameter
NameDescription
requestCreatePolicyRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Policy>

deleteCustomConstraint(DeleteCustomConstraintRequest request)

public ListenableFuture<Empty> deleteCustomConstraint(DeleteCustomConstraintRequest request)

Deletes a custom constraint. Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the constraint does not exist.

Parameter
NameDescription
requestDeleteCustomConstraintRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

deletePolicy(DeletePolicyRequest request)

public ListenableFuture<Empty> deletePolicy(DeletePolicyRequest request)

Deletes a policy. Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the constraint or organization policy does not exist.

Parameter
NameDescription
requestDeletePolicyRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

getCustomConstraint(GetCustomConstraintRequest request)

public ListenableFuture<CustomConstraint> getCustomConstraint(GetCustomConstraintRequest request)

Gets a custom constraint. Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the custom constraint does not exist.

Parameter
NameDescription
requestGetCustomConstraintRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<CustomConstraint>

getEffectivePolicy(GetEffectivePolicyRequest request)

public ListenableFuture<Policy> getEffectivePolicy(GetEffectivePolicyRequest request)

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 across multiple resources. Subtrees of Resource Manager resource hierarchy with 'under:' prefix will not be expanded.

Parameter
NameDescription
requestGetEffectivePolicyRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Policy>

getPolicy(GetPolicyRequest request)

public ListenableFuture<Policy> getPolicy(GetPolicyRequest request)

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.

Parameter
NameDescription
requestGetPolicyRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Policy>

listConstraints(ListConstraintsRequest request)

public ListenableFuture<ListConstraintsResponse> listConstraints(ListConstraintsRequest request)

Lists constraints that could be applied on the specified resource.

Parameter
NameDescription
requestListConstraintsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListConstraintsResponse>

listCustomConstraints(ListCustomConstraintsRequest request)

public ListenableFuture<ListCustomConstraintsResponse> listCustomConstraints(ListCustomConstraintsRequest request)

Retrieves all of the custom constraints that exist on a particular organization resource.

Parameter
NameDescription
requestListCustomConstraintsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListCustomConstraintsResponse>

listPolicies(ListPoliciesRequest request)

public ListenableFuture<ListPoliciesResponse> listPolicies(ListPoliciesRequest request)

Retrieves all of the policies that exist on a particular resource.

Parameter
NameDescription
requestListPoliciesRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListPoliciesResponse>

updateCustomConstraint(UpdateCustomConstraintRequest request)

public ListenableFuture<CustomConstraint> updateCustomConstraint(UpdateCustomConstraintRequest request)

Updates a custom constraint. Returns a google.rpc.Status with google.rpc.Code.NOT_FOUND if the constraint does not exist. Note: the supplied policy will perform a full overwrite of all fields.

Parameter
NameDescription
requestUpdateCustomConstraintRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<CustomConstraint>

updatePolicy(UpdatePolicyRequest request)

public ListenableFuture<Policy> updatePolicy(UpdatePolicyRequest request)

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: the supplied policy will perform a full overwrite of all fields.

Parameter
NameDescription
requestUpdatePolicyRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Policy>