public static final class OSPolicy.Resource.ExecResource.Builder extends GeneratedMessageV3.Builder<OSPolicy.Resource.ExecResource.Builder> implements OSPolicy.Resource.ExecResourceOrBuilder
A resource that allows executing scripts on the VM.
The ExecResource
has 2 stages: validate
and enforce
and both stages
accept a script as an argument to execute.
When the ExecResource
is applied by the agent, it first executes the
script in the validate
stage. The validate
stage can signal that the
ExecResource
is already in the desired state by returning an exit code
of 100
. If the ExecResource
is not in the desired state, it should
return an exit code of 101
. Any other exit code returned by this stage
is considered an error.
If the ExecResource
is not in the desired state based on the exit code
from the validate
stage, the agent proceeds to execute the script from
the enforce
stage. If the ExecResource
is already in the desired
state, the enforce
stage will not be run.
Similar to validate
stage, the enforce
stage should return an exit
code of 100
to indicate that the resource in now in its desired state.
Any other exit code is considered an error.
NOTE: An exit code of 100
was chosen over 0
(and 101
vs 1
) to
have an explicit indicator of in desired state
, not in desired state
and errors. Because, for example, Powershell will always return an exit
code of 0
unless an exit
statement is provided in the script. So, for
reasons of consistency and being explicit, exit codes 100
and 101
were chosen.
Protobuf type google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource
Static Methods
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns
Methods
addRepeatedField(Descriptors.FieldDescriptor field, Object value)
public OSPolicy.Resource.ExecResource.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
Returns
Overrides
build()
public OSPolicy.Resource.ExecResource build()
Returns
buildPartial()
public OSPolicy.Resource.ExecResource buildPartial()
Returns
clear()
public OSPolicy.Resource.ExecResource.Builder clear()
Returns
Overrides
clearEnforce()
public OSPolicy.Resource.ExecResource.Builder clearEnforce()
What to run to bring this resource into the desired state.
An exit code of 100 indicates "success", any other exit code indicates
a failure running enforce.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec enforce = 2;
Returns
clearField(Descriptors.FieldDescriptor field)
public OSPolicy.Resource.ExecResource.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
Returns
Overrides
clearOneof(Descriptors.OneofDescriptor oneof)
public OSPolicy.Resource.ExecResource.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
Returns
Overrides
clearValidate()
public OSPolicy.Resource.ExecResource.Builder clearValidate()
Required. What to run to validate this resource is in the desired
state. An exit code of 100 indicates "in desired state", and exit code
of 101 indicates "not in desired state". Any other exit code indicates
a failure running validate.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
Returns
clone()
public OSPolicy.Resource.ExecResource.Builder clone()
Returns
Overrides
getDefaultInstanceForType()
public OSPolicy.Resource.ExecResource getDefaultInstanceForType()
Returns
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()
Returns
Overrides
getEnforce()
public OSPolicy.Resource.ExecResource.Exec getEnforce()
What to run to bring this resource into the desired state.
An exit code of 100 indicates "success", any other exit code indicates
a failure running enforce.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec enforce = 2;
Returns
getEnforceBuilder()
public OSPolicy.Resource.ExecResource.Exec.Builder getEnforceBuilder()
What to run to bring this resource into the desired state.
An exit code of 100 indicates "success", any other exit code indicates
a failure running enforce.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec enforce = 2;
Returns
getEnforceOrBuilder()
public OSPolicy.Resource.ExecResource.ExecOrBuilder getEnforceOrBuilder()
What to run to bring this resource into the desired state.
An exit code of 100 indicates "success", any other exit code indicates
a failure running enforce.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec enforce = 2;
Returns
getValidate()
public OSPolicy.Resource.ExecResource.Exec getValidate()
Required. What to run to validate this resource is in the desired
state. An exit code of 100 indicates "in desired state", and exit code
of 101 indicates "not in desired state". Any other exit code indicates
a failure running validate.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
Returns
getValidateBuilder()
public OSPolicy.Resource.ExecResource.Exec.Builder getValidateBuilder()
Required. What to run to validate this resource is in the desired
state. An exit code of 100 indicates "in desired state", and exit code
of 101 indicates "not in desired state". Any other exit code indicates
a failure running validate.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
Returns
getValidateOrBuilder()
public OSPolicy.Resource.ExecResource.ExecOrBuilder getValidateOrBuilder()
Required. What to run to validate this resource is in the desired
state. An exit code of 100 indicates "in desired state", and exit code
of 101 indicates "not in desired state". Any other exit code indicates
a failure running validate.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
Returns
hasEnforce()
public boolean hasEnforce()
What to run to bring this resource into the desired state.
An exit code of 100 indicates "success", any other exit code indicates
a failure running enforce.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec enforce = 2;
Returns
Type | Description |
boolean | Whether the enforce field is set.
|
hasValidate()
public boolean hasValidate()
Required. What to run to validate this resource is in the desired
state. An exit code of 100 indicates "in desired state", and exit code
of 101 indicates "not in desired state". Any other exit code indicates
a failure running validate.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
Returns
Type | Description |
boolean | Whether the validate field is set.
|
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Overrides
isInitialized()
public final boolean isInitialized()
Returns
Overrides
mergeEnforce(OSPolicy.Resource.ExecResource.Exec value)
public OSPolicy.Resource.ExecResource.Builder mergeEnforce(OSPolicy.Resource.ExecResource.Exec value)
What to run to bring this resource into the desired state.
An exit code of 100 indicates "success", any other exit code indicates
a failure running enforce.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec enforce = 2;
Parameter
Returns
mergeFrom(OSPolicy.Resource.ExecResource other)
public OSPolicy.Resource.ExecResource.Builder mergeFrom(OSPolicy.Resource.ExecResource other)
Parameter
Returns
public OSPolicy.Resource.ExecResource.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Overrides
Exceptions
mergeFrom(Message other)
public OSPolicy.Resource.ExecResource.Builder mergeFrom(Message other)
Parameter
Returns
Overrides
mergeUnknownFields(UnknownFieldSet unknownFields)
public final OSPolicy.Resource.ExecResource.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
Returns
Overrides
mergeValidate(OSPolicy.Resource.ExecResource.Exec value)
public OSPolicy.Resource.ExecResource.Builder mergeValidate(OSPolicy.Resource.ExecResource.Exec value)
Required. What to run to validate this resource is in the desired
state. An exit code of 100 indicates "in desired state", and exit code
of 101 indicates "not in desired state". Any other exit code indicates
a failure running validate.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
Parameter
Returns
setEnforce(OSPolicy.Resource.ExecResource.Exec value)
public OSPolicy.Resource.ExecResource.Builder setEnforce(OSPolicy.Resource.ExecResource.Exec value)
What to run to bring this resource into the desired state.
An exit code of 100 indicates "success", any other exit code indicates
a failure running enforce.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec enforce = 2;
Parameter
Returns
setEnforce(OSPolicy.Resource.ExecResource.Exec.Builder builderForValue)
public OSPolicy.Resource.ExecResource.Builder setEnforce(OSPolicy.Resource.ExecResource.Exec.Builder builderForValue)
What to run to bring this resource into the desired state.
An exit code of 100 indicates "success", any other exit code indicates
a failure running enforce.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec enforce = 2;
Parameter
Returns
setField(Descriptors.FieldDescriptor field, Object value)
public OSPolicy.Resource.ExecResource.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
Returns
Overrides
setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
public OSPolicy.Resource.ExecResource.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
Returns
Overrides
setUnknownFields(UnknownFieldSet unknownFields)
public final OSPolicy.Resource.ExecResource.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
Returns
Overrides
setValidate(OSPolicy.Resource.ExecResource.Exec value)
public OSPolicy.Resource.ExecResource.Builder setValidate(OSPolicy.Resource.ExecResource.Exec value)
Required. What to run to validate this resource is in the desired
state. An exit code of 100 indicates "in desired state", and exit code
of 101 indicates "not in desired state". Any other exit code indicates
a failure running validate.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
Parameter
Returns
setValidate(OSPolicy.Resource.ExecResource.Exec.Builder builderForValue)
public OSPolicy.Resource.ExecResource.Builder setValidate(OSPolicy.Resource.ExecResource.Exec.Builder builderForValue)
Required. What to run to validate this resource is in the desired
state. An exit code of 100 indicates "in desired state", and exit code
of 101 indicates "not in desired state". Any other exit code indicates
a failure running validate.
.google.cloud.osconfig.v1.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
Parameter
Returns