public static final class OSPolicy.Resource.ExecResource extends GeneratedMessageV3 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.v1alpha.OSPolicy.Resource.ExecResource
Static Fields
ENFORCE_FIELD_NUMBER
public static final int ENFORCE_FIELD_NUMBER
Field Value |
---|
Type | Description |
int | |
VALIDATE_FIELD_NUMBER
public static final int VALIDATE_FIELD_NUMBER
Field Value |
---|
Type | Description |
int | |
Static Methods
getDefaultInstance()
public static OSPolicy.Resource.ExecResource getDefaultInstance()
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
newBuilder()
public static OSPolicy.Resource.ExecResource.Builder newBuilder()
newBuilder(OSPolicy.Resource.ExecResource prototype)
public static OSPolicy.Resource.ExecResource.Builder newBuilder(OSPolicy.Resource.ExecResource prototype)
public static OSPolicy.Resource.ExecResource parseDelimitedFrom(InputStream input)
public static OSPolicy.Resource.ExecResource parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
parseFrom(byte[] data)
public static OSPolicy.Resource.ExecResource parseFrom(byte[] data)
Parameter |
---|
Name | Description |
data | byte[]
|
parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
public static OSPolicy.Resource.ExecResource parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
parseFrom(ByteString data)
public static OSPolicy.Resource.ExecResource parseFrom(ByteString data)
parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static OSPolicy.Resource.ExecResource parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static OSPolicy.Resource.ExecResource parseFrom(CodedInputStream input)
public static OSPolicy.Resource.ExecResource parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public static OSPolicy.Resource.ExecResource parseFrom(InputStream input)
public static OSPolicy.Resource.ExecResource parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
parseFrom(ByteBuffer data)
public static OSPolicy.Resource.ExecResource parseFrom(ByteBuffer data)
parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
public static OSPolicy.Resource.ExecResource parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
parser()
public static Parser<OSPolicy.Resource.ExecResource> parser()
Methods
equals(Object obj)
public boolean equals(Object obj)
Parameter |
---|
Name | Description |
obj | Object
|
Overrides
getDefaultInstanceForType()
public OSPolicy.Resource.ExecResource getDefaultInstanceForType()
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.v1alpha.OSPolicy.Resource.ExecResource.Exec enforce = 2;
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.v1alpha.OSPolicy.Resource.ExecResource.Exec enforce = 2;
getParserForType()
public Parser<OSPolicy.Resource.ExecResource> getParserForType()
Overrides
getSerializedSize()
public int getSerializedSize()
Returns |
---|
Type | Description |
int | |
Overrides
getUnknownFields()
public final UnknownFieldSet getUnknownFields()
Overrides
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.v1alpha.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
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.v1alpha.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
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.v1alpha.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.v1alpha.OSPolicy.Resource.ExecResource.Exec validate = 1 [(.google.api.field_behavior) = REQUIRED];
Returns |
---|
Type | Description |
boolean | Whether the validate field is set.
|
hashCode()
Returns |
---|
Type | Description |
int | |
Overrides
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Overrides
isInitialized()
public final boolean isInitialized()
Overrides
newBuilderForType()
public OSPolicy.Resource.ExecResource.Builder newBuilderForType()
newBuilderForType(GeneratedMessageV3.BuilderParent parent)
protected OSPolicy.Resource.ExecResource.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Overrides
newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Overrides
toBuilder()
public OSPolicy.Resource.ExecResource.Builder toBuilder()
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Overrides