Class GuestPolicies.SoftwareRecipe.Builder (2.56.0) 

public static final class GuestPolicies.SoftwareRecipe.Builder extends GeneratedMessageV3.Builder<GuestPolicies.SoftwareRecipe.Builder> implements GuestPolicies.SoftwareRecipeOrBuilder

A software recipe is a set of instructions for installing and configuring a piece of software. It consists of a set of artifacts that are downloaded, and a set of steps that install, configure, and/or update the software.

Recipes support installing and updating software from artifacts in the following formats: Zip archive, Tar archive, Windows MSI, Debian package, and RPM package.

Additionally, recipes support executing a script (either defined in a file or directly in this api) in bash, sh, cmd, and powershell.

Updating a software recipe

If a recipe is assigned to an instance and there is a recipe with the same name but a lower version already installed and the assigned state of the recipe is UPDATED, then the recipe is updated to the new version.

Script Working Directories

Each script or execution step is run in its own temporary directory which is deleted after completing the step.

Protobuf type google.cloud.osconfig.v1beta.SoftwareRecipe

Inheritance

Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > GuestPolicies.SoftwareRecipe.Builder

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

Methods

addAllArtifacts(Iterable<? extends GuestPolicies.SoftwareRecipe.Artifact> values)

public GuestPolicies.SoftwareRecipe.Builder addAllArtifacts(Iterable<? extends GuestPolicies.SoftwareRecipe.Artifact> values)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameter
Name Description
values Iterable<? extends com.google.cloud.osconfig.v1beta.GuestPolicies.SoftwareRecipe.Artifact>
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addAllInstallSteps(Iterable<? extends GuestPolicies.SoftwareRecipe.Step> values)

public GuestPolicies.SoftwareRecipe.Builder addAllInstallSteps(Iterable<? extends GuestPolicies.SoftwareRecipe.Step> values)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameter
Name Description
values Iterable<? extends com.google.cloud.osconfig.v1beta.GuestPolicies.SoftwareRecipe.Step>
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addAllUpdateSteps(Iterable<? extends GuestPolicies.SoftwareRecipe.Step> values)

public GuestPolicies.SoftwareRecipe.Builder addAllUpdateSteps(Iterable<? extends GuestPolicies.SoftwareRecipe.Step> values)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameter
Name Description
values Iterable<? extends com.google.cloud.osconfig.v1beta.GuestPolicies.SoftwareRecipe.Step>
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addArtifacts(GuestPolicies.SoftwareRecipe.Artifact value)

public GuestPolicies.SoftwareRecipe.Builder addArtifacts(GuestPolicies.SoftwareRecipe.Artifact value)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameter
Name Description
value GuestPolicies.SoftwareRecipe.Artifact
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addArtifacts(GuestPolicies.SoftwareRecipe.Artifact.Builder builderForValue)

public GuestPolicies.SoftwareRecipe.Builder addArtifacts(GuestPolicies.SoftwareRecipe.Artifact.Builder builderForValue)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameter
Name Description
builderForValue GuestPolicies.SoftwareRecipe.Artifact.Builder
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addArtifacts(int index, GuestPolicies.SoftwareRecipe.Artifact value)

public GuestPolicies.SoftwareRecipe.Builder addArtifacts(int index, GuestPolicies.SoftwareRecipe.Artifact value)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameters
Name Description
index int
value GuestPolicies.SoftwareRecipe.Artifact
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addArtifacts(int index, GuestPolicies.SoftwareRecipe.Artifact.Builder builderForValue)

public GuestPolicies.SoftwareRecipe.Builder addArtifacts(int index, GuestPolicies.SoftwareRecipe.Artifact.Builder builderForValue)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameters
Name Description
index int
builderForValue GuestPolicies.SoftwareRecipe.Artifact.Builder
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addArtifactsBuilder()

public GuestPolicies.SoftwareRecipe.Artifact.Builder addArtifactsBuilder()

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Returns
Type Description
GuestPolicies.SoftwareRecipe.Artifact.Builder

addArtifactsBuilder(int index)

public GuestPolicies.SoftwareRecipe.Artifact.Builder addArtifactsBuilder(int index)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Artifact.Builder

addInstallSteps(GuestPolicies.SoftwareRecipe.Step value)

public GuestPolicies.SoftwareRecipe.Builder addInstallSteps(GuestPolicies.SoftwareRecipe.Step value)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameter
Name Description
value GuestPolicies.SoftwareRecipe.Step
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addInstallSteps(GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

public GuestPolicies.SoftwareRecipe.Builder addInstallSteps(GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameter
Name Description
builderForValue GuestPolicies.SoftwareRecipe.Step.Builder
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addInstallSteps(int index, GuestPolicies.SoftwareRecipe.Step value)

public GuestPolicies.SoftwareRecipe.Builder addInstallSteps(int index, GuestPolicies.SoftwareRecipe.Step value)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameters
Name Description
index int
value GuestPolicies.SoftwareRecipe.Step
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addInstallSteps(int index, GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

public GuestPolicies.SoftwareRecipe.Builder addInstallSteps(int index, GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameters
Name Description
index int
builderForValue GuestPolicies.SoftwareRecipe.Step.Builder
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addInstallStepsBuilder()

public GuestPolicies.SoftwareRecipe.Step.Builder addInstallStepsBuilder()

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Returns
Type Description
GuestPolicies.SoftwareRecipe.Step.Builder

addInstallStepsBuilder(int index)

public GuestPolicies.SoftwareRecipe.Step.Builder addInstallStepsBuilder(int index)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Step.Builder

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public GuestPolicies.SoftwareRecipe.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

addUpdateSteps(GuestPolicies.SoftwareRecipe.Step value)

public GuestPolicies.SoftwareRecipe.Builder addUpdateSteps(GuestPolicies.SoftwareRecipe.Step value)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameter
Name Description
value GuestPolicies.SoftwareRecipe.Step
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addUpdateSteps(GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

public GuestPolicies.SoftwareRecipe.Builder addUpdateSteps(GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameter
Name Description
builderForValue GuestPolicies.SoftwareRecipe.Step.Builder
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addUpdateSteps(int index, GuestPolicies.SoftwareRecipe.Step value)

public GuestPolicies.SoftwareRecipe.Builder addUpdateSteps(int index, GuestPolicies.SoftwareRecipe.Step value)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameters
Name Description
index int
value GuestPolicies.SoftwareRecipe.Step
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addUpdateSteps(int index, GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

public GuestPolicies.SoftwareRecipe.Builder addUpdateSteps(int index, GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameters
Name Description
index int
builderForValue GuestPolicies.SoftwareRecipe.Step.Builder
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

addUpdateStepsBuilder()

public GuestPolicies.SoftwareRecipe.Step.Builder addUpdateStepsBuilder()

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Returns
Type Description
GuestPolicies.SoftwareRecipe.Step.Builder

addUpdateStepsBuilder(int index)

public GuestPolicies.SoftwareRecipe.Step.Builder addUpdateStepsBuilder(int index)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Step.Builder

build()

public GuestPolicies.SoftwareRecipe build()
Returns
Type Description
GuestPolicies.SoftwareRecipe

buildPartial()

public GuestPolicies.SoftwareRecipe buildPartial()
Returns
Type Description
GuestPolicies.SoftwareRecipe

clear()

public GuestPolicies.SoftwareRecipe.Builder clear()
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

clearArtifacts()

public GuestPolicies.SoftwareRecipe.Builder clearArtifacts()

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

clearDesiredState()

public GuestPolicies.SoftwareRecipe.Builder clearDesiredState()

Default is INSTALLED. The desired state the agent should maintain for this recipe.

INSTALLED: The software recipe is installed on the instance but won't be updated to new versions. UPDATED: The software recipe is installed on the instance. The recipe is updated to a higher version, if a higher version of the recipe is assigned to this instance. REMOVE: Remove is unsupported for software recipes and attempts to create or update a recipe to the REMOVE state is rejected.

.google.cloud.osconfig.v1beta.DesiredState desired_state = 6;

Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

This builder for chaining.

clearField(Descriptors.FieldDescriptor field)

public GuestPolicies.SoftwareRecipe.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
Name Description
field FieldDescriptor
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

clearInstallSteps()

public GuestPolicies.SoftwareRecipe.Builder clearInstallSteps()

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

clearName()

public GuestPolicies.SoftwareRecipe.Builder clearName()

Required. Unique identifier for the recipe. Only one recipe with a given name is installed on an instance.

Names are also used to identify resources which helps to determine whether guest policies have conflicts. This means that requests to create multiple recipes with the same name and version are rejected since they could potentially have conflicting assignments.

string name = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public GuestPolicies.SoftwareRecipe.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
Name Description
oneof OneofDescriptor
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

clearUpdateSteps()

public GuestPolicies.SoftwareRecipe.Builder clearUpdateSteps()

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

clearVersion()

public GuestPolicies.SoftwareRecipe.Builder clearVersion()

The version of this software recipe. Version can be up to 4 period separated numbers (e.g. 12.34.56.78).

string version = 2;

Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

This builder for chaining.

clone()

public GuestPolicies.SoftwareRecipe.Builder clone()
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

getArtifacts(int index)

public GuestPolicies.SoftwareRecipe.Artifact getArtifacts(int index)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Artifact

getArtifactsBuilder(int index)

public GuestPolicies.SoftwareRecipe.Artifact.Builder getArtifactsBuilder(int index)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Artifact.Builder

getArtifactsBuilderList()

public List<GuestPolicies.SoftwareRecipe.Artifact.Builder> getArtifactsBuilderList()

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Returns
Type Description
List<Builder>

getArtifactsCount()

public int getArtifactsCount()

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Returns
Type Description
int

getArtifactsList()

public List<GuestPolicies.SoftwareRecipe.Artifact> getArtifactsList()

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Returns
Type Description
List<Artifact>

getArtifactsOrBuilder(int index)

public GuestPolicies.SoftwareRecipe.ArtifactOrBuilder getArtifactsOrBuilder(int index)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.ArtifactOrBuilder

getArtifactsOrBuilderList()

public List<? extends GuestPolicies.SoftwareRecipe.ArtifactOrBuilder> getArtifactsOrBuilderList()

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Returns
Type Description
List<? extends com.google.cloud.osconfig.v1beta.GuestPolicies.SoftwareRecipe.ArtifactOrBuilder>

getDefaultInstanceForType()

public GuestPolicies.SoftwareRecipe getDefaultInstanceForType()
Returns
Type Description
GuestPolicies.SoftwareRecipe

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getDesiredState()

public GuestPolicies.DesiredState getDesiredState()

Default is INSTALLED. The desired state the agent should maintain for this recipe.

INSTALLED: The software recipe is installed on the instance but won't be updated to new versions. UPDATED: The software recipe is installed on the instance. The recipe is updated to a higher version, if a higher version of the recipe is assigned to this instance. REMOVE: Remove is unsupported for software recipes and attempts to create or update a recipe to the REMOVE state is rejected.

.google.cloud.osconfig.v1beta.DesiredState desired_state = 6;

Returns
Type Description
GuestPolicies.DesiredState

The desiredState.

getDesiredStateValue()

public int getDesiredStateValue()

Default is INSTALLED. The desired state the agent should maintain for this recipe.

INSTALLED: The software recipe is installed on the instance but won't be updated to new versions. UPDATED: The software recipe is installed on the instance. The recipe is updated to a higher version, if a higher version of the recipe is assigned to this instance. REMOVE: Remove is unsupported for software recipes and attempts to create or update a recipe to the REMOVE state is rejected.

.google.cloud.osconfig.v1beta.DesiredState desired_state = 6;

Returns
Type Description
int

The enum numeric value on the wire for desiredState.

getInstallSteps(int index)

public GuestPolicies.SoftwareRecipe.Step getInstallSteps(int index)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Step

getInstallStepsBuilder(int index)

public GuestPolicies.SoftwareRecipe.Step.Builder getInstallStepsBuilder(int index)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Step.Builder

getInstallStepsBuilderList()

public List<GuestPolicies.SoftwareRecipe.Step.Builder> getInstallStepsBuilderList()

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Returns
Type Description
List<Builder>

getInstallStepsCount()

public int getInstallStepsCount()

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Returns
Type Description
int

getInstallStepsList()

public List<GuestPolicies.SoftwareRecipe.Step> getInstallStepsList()

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Returns
Type Description
List<Step>

getInstallStepsOrBuilder(int index)

public GuestPolicies.SoftwareRecipe.StepOrBuilder getInstallStepsOrBuilder(int index)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.StepOrBuilder

getInstallStepsOrBuilderList()

public List<? extends GuestPolicies.SoftwareRecipe.StepOrBuilder> getInstallStepsOrBuilderList()

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Returns
Type Description
List<? extends com.google.cloud.osconfig.v1beta.GuestPolicies.SoftwareRecipe.StepOrBuilder>

getName()

public String getName()

Required. Unique identifier for the recipe. Only one recipe with a given name is installed on an instance.

Names are also used to identify resources which helps to determine whether guest policies have conflicts. This means that requests to create multiple recipes with the same name and version are rejected since they could potentially have conflicting assignments.

string name = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
String

The name.

getNameBytes()

public ByteString getNameBytes()

Required. Unique identifier for the recipe. Only one recipe with a given name is installed on an instance.

Names are also used to identify resources which helps to determine whether guest policies have conflicts. This means that requests to create multiple recipes with the same name and version are rejected since they could potentially have conflicting assignments.

string name = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
ByteString

The bytes for name.

getUpdateSteps(int index)

public GuestPolicies.SoftwareRecipe.Step getUpdateSteps(int index)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Step

getUpdateStepsBuilder(int index)

public GuestPolicies.SoftwareRecipe.Step.Builder getUpdateStepsBuilder(int index)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Step.Builder

getUpdateStepsBuilderList()

public List<GuestPolicies.SoftwareRecipe.Step.Builder> getUpdateStepsBuilderList()

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Returns
Type Description
List<Builder>

getUpdateStepsCount()

public int getUpdateStepsCount()

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Returns
Type Description
int

getUpdateStepsList()

public List<GuestPolicies.SoftwareRecipe.Step> getUpdateStepsList()

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Returns
Type Description
List<Step>

getUpdateStepsOrBuilder(int index)

public GuestPolicies.SoftwareRecipe.StepOrBuilder getUpdateStepsOrBuilder(int index)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.StepOrBuilder

getUpdateStepsOrBuilderList()

public List<? extends GuestPolicies.SoftwareRecipe.StepOrBuilder> getUpdateStepsOrBuilderList()

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Returns
Type Description
List<? extends com.google.cloud.osconfig.v1beta.GuestPolicies.SoftwareRecipe.StepOrBuilder>

getVersion()

public String getVersion()

The version of this software recipe. Version can be up to 4 period separated numbers (e.g. 12.34.56.78).

string version = 2;

Returns
Type Description
String

The version.

getVersionBytes()

public ByteString getVersionBytes()

The version of this software recipe. Version can be up to 4 period separated numbers (e.g. 12.34.56.78).

string version = 2;

Returns
Type Description
ByteString

The bytes for version.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeFrom(GuestPolicies.SoftwareRecipe other)

public GuestPolicies.SoftwareRecipe.Builder mergeFrom(GuestPolicies.SoftwareRecipe other)
Parameter
Name Description
other GuestPolicies.SoftwareRecipe
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public GuestPolicies.SoftwareRecipe.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public GuestPolicies.SoftwareRecipe.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

mergeUnknownFields(UnknownFieldSet unknownFields)

public final GuestPolicies.SoftwareRecipe.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

removeArtifacts(int index)

public GuestPolicies.SoftwareRecipe.Builder removeArtifacts(int index)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

removeInstallSteps(int index)

public GuestPolicies.SoftwareRecipe.Builder removeInstallSteps(int index)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

removeUpdateSteps(int index)

public GuestPolicies.SoftwareRecipe.Builder removeUpdateSteps(int index)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameter
Name Description
index int
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

setArtifacts(int index, GuestPolicies.SoftwareRecipe.Artifact value)

public GuestPolicies.SoftwareRecipe.Builder setArtifacts(int index, GuestPolicies.SoftwareRecipe.Artifact value)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameters
Name Description
index int
value GuestPolicies.SoftwareRecipe.Artifact
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

setArtifacts(int index, GuestPolicies.SoftwareRecipe.Artifact.Builder builderForValue)

public GuestPolicies.SoftwareRecipe.Builder setArtifacts(int index, GuestPolicies.SoftwareRecipe.Artifact.Builder builderForValue)

Resources available to be used in the steps in the recipe.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;

Parameters
Name Description
index int
builderForValue GuestPolicies.SoftwareRecipe.Artifact.Builder
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

setDesiredState(GuestPolicies.DesiredState value)

public GuestPolicies.SoftwareRecipe.Builder setDesiredState(GuestPolicies.DesiredState value)

Default is INSTALLED. The desired state the agent should maintain for this recipe.

INSTALLED: The software recipe is installed on the instance but won't be updated to new versions. UPDATED: The software recipe is installed on the instance. The recipe is updated to a higher version, if a higher version of the recipe is assigned to this instance. REMOVE: Remove is unsupported for software recipes and attempts to create or update a recipe to the REMOVE state is rejected.

.google.cloud.osconfig.v1beta.DesiredState desired_state = 6;

Parameter
Name Description
value GuestPolicies.DesiredState

The desiredState to set.
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

This builder for chaining.

setDesiredStateValue(int value)

public GuestPolicies.SoftwareRecipe.Builder setDesiredStateValue(int value)

Default is INSTALLED. The desired state the agent should maintain for this recipe.

INSTALLED: The software recipe is installed on the instance but won't be updated to new versions. UPDATED: The software recipe is installed on the instance. The recipe is updated to a higher version, if a higher version of the recipe is assigned to this instance. REMOVE: Remove is unsupported for software recipes and attempts to create or update a recipe to the REMOVE state is rejected.

.google.cloud.osconfig.v1beta.DesiredState desired_state = 6;

Parameter
Name Description
value int

The enum numeric value on the wire for desiredState to set.
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

This builder for chaining.

setField(Descriptors.FieldDescriptor field, Object value)

public GuestPolicies.SoftwareRecipe.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

setInstallSteps(int index, GuestPolicies.SoftwareRecipe.Step value)

public GuestPolicies.SoftwareRecipe.Builder setInstallSteps(int index, GuestPolicies.SoftwareRecipe.Step value)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameters
Name Description
index int
value GuestPolicies.SoftwareRecipe.Step
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

setInstallSteps(int index, GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

public GuestPolicies.SoftwareRecipe.Builder setInstallSteps(int index, GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

Actions to be taken for installing this recipe. On failure it stops executing steps and does not attempt another installation. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;

Parameters
Name Description
index int
builderForValue GuestPolicies.SoftwareRecipe.Step.Builder
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

setName(String value)

public GuestPolicies.SoftwareRecipe.Builder setName(String value)

Required. Unique identifier for the recipe. Only one recipe with a given name is installed on an instance.

Names are also used to identify resources which helps to determine whether guest policies have conflicts. This means that requests to create multiple recipes with the same name and version are rejected since they could potentially have conflicting assignments.

string name = 1 [(.google.api.field_behavior) = REQUIRED];

Parameter
Name Description
value String

The name to set.
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

This builder for chaining.

setNameBytes(ByteString value)

public GuestPolicies.SoftwareRecipe.Builder setNameBytes(ByteString value)

Required. Unique identifier for the recipe. Only one recipe with a given name is installed on an instance.

Names are also used to identify resources which helps to determine whether guest policies have conflicts. This means that requests to create multiple recipes with the same name and version are rejected since they could potentially have conflicting assignments.

string name = 1 [(.google.api.field_behavior) = REQUIRED];

Parameter
Name Description
value ByteString

The bytes for name to set.
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public GuestPolicies.SoftwareRecipe.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
Name Description
field FieldDescriptor
index int
value Object
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

setUnknownFields(UnknownFieldSet unknownFields)

public final GuestPolicies.SoftwareRecipe.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder
Overrides

setUpdateSteps(int index, GuestPolicies.SoftwareRecipe.Step value)

public GuestPolicies.SoftwareRecipe.Builder setUpdateSteps(int index, GuestPolicies.SoftwareRecipe.Step value)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameters
Name Description
index int
value GuestPolicies.SoftwareRecipe.Step
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

setUpdateSteps(int index, GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

public GuestPolicies.SoftwareRecipe.Builder setUpdateSteps(int index, GuestPolicies.SoftwareRecipe.Step.Builder builderForValue)

Actions to be taken for updating this recipe. On failure it stops executing steps and does not attempt another update for this recipe. Any steps taken (including partially completed steps) are not rolled back.

repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;

Parameters
Name Description
index int
builderForValue GuestPolicies.SoftwareRecipe.Step.Builder
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

setVersion(String value)

public GuestPolicies.SoftwareRecipe.Builder setVersion(String value)

The version of this software recipe. Version can be up to 4 period separated numbers (e.g. 12.34.56.78).

string version = 2;

Parameter
Name Description
value String

The version to set.
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

This builder for chaining.

setVersionBytes(ByteString value)

public GuestPolicies.SoftwareRecipe.Builder setVersionBytes(ByteString value)

The version of this software recipe. Version can be up to 4 period separated numbers (e.g. 12.34.56.78).

string version = 2;

Parameter
Name Description
value ByteString

The bytes for version to set.
Returns
Type Description
GuestPolicies.SoftwareRecipe.Builder

This builder for chaining.