Class Server
- java.lang.Object
-
- software.amazon.awssdk.services.opsworkscm.model.Server
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<Server.Builder,Server>
@Generated("software.amazon.awssdk:codegen") public final class Server extends Object implements SdkPojo, Serializable, ToCopyableBuilder<Server.Builder,Server>
Describes a configuration management server.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceServer.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description BooleanassociatePublicIpAddress()Associate a public IP address with a server that you are launching.IntegerbackupRetentionCount()The number of automated backups to keep.static Server.Builderbuilder()StringcloudFormationStackArn()The ARN of the CloudFormation stack that was used to create the server.InstantcreatedAt()Time stamp of server creation.StringcustomDomain()An optional public endpoint of a server, such ashttps://aws.my-company.com.BooleandisableAutomatedBackup()Disables automated backups.Stringendpoint()A DNS name that can be used to access the engine.Stringengine()The engine type of the server.List<EngineAttribute>engineAttributes()The response of a createServer() request returns the master credential to access the server in EngineAttributes.StringengineModel()The engine model of the server.StringengineVersion()The engine version of the server.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasEngineAttributes()For responses, this returns true if the service returned a value for the EngineAttributes property.inthashCode()booleanhasSecurityGroupIds()For responses, this returns true if the service returned a value for the SecurityGroupIds property.booleanhasSubnetIds()For responses, this returns true if the service returned a value for the SubnetIds property.StringinstanceProfileArn()The instance profile ARN of the server.StringinstanceType()The instance type for the server, as specified in the CloudFormation stack.StringkeyPair()The key pair associated with the server.MaintenanceStatusmaintenanceStatus()The status of the most recent server maintenance run.StringmaintenanceStatusAsString()The status of the most recent server maintenance run.StringpreferredBackupWindow()The preferred backup period specified for the server.StringpreferredMaintenanceWindow()The preferred maintenance period specified for the server.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()List<String>securityGroupIds()The security group IDs for the server, as specified in the CloudFormation stack.static Class<? extends Server.Builder>serializableBuilderClass()StringserverArn()The ARN of the server.StringserverName()The name of the server.StringserviceRoleArn()The service role ARN used to create the server.ServerStatusstatus()The server's status.StringstatusAsString()The server's status.StringstatusReason()Depending on the server status, this field has either a human-readable message (such as a create or backup error), or an escaped block of JSON (used for health check results).List<String>subnetIds()The subnet IDs specified in a CreateServer request.Server.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
associatePublicIpAddress
public final Boolean associatePublicIpAddress()
Associate a public IP address with a server that you are launching.
- Returns:
- Associate a public IP address with a server that you are launching.
-
backupRetentionCount
public final Integer backupRetentionCount()
The number of automated backups to keep.
- Returns:
- The number of automated backups to keep.
-
serverName
public final String serverName()
The name of the server.
- Returns:
- The name of the server.
-
createdAt
public final Instant createdAt()
Time stamp of server creation. Example
2016-07-29T13:38:47.520Z- Returns:
- Time stamp of server creation. Example
2016-07-29T13:38:47.520Z
-
cloudFormationStackArn
public final String cloudFormationStackArn()
The ARN of the CloudFormation stack that was used to create the server.
- Returns:
- The ARN of the CloudFormation stack that was used to create the server.
-
customDomain
public final String customDomain()
An optional public endpoint of a server, such as
https://aws.my-company.com. You cannot access the server by using theEndpointvalue if the server has aCustomDomainspecified.- Returns:
- An optional public endpoint of a server, such as
https://aws.my-company.com. You cannot access the server by using theEndpointvalue if the server has aCustomDomainspecified.
-
disableAutomatedBackup
public final Boolean disableAutomatedBackup()
Disables automated backups. The number of stored backups is dependent on the value of PreferredBackupCount.
- Returns:
- Disables automated backups. The number of stored backups is dependent on the value of PreferredBackupCount.
-
endpoint
public final String endpoint()
A DNS name that can be used to access the engine. Example:
myserver-asdfghjkl.us-east-1.opsworks.io. You cannot access the server by using theEndpointvalue if the server has aCustomDomainspecified.- Returns:
- A DNS name that can be used to access the engine. Example:
myserver-asdfghjkl.us-east-1.opsworks.io. You cannot access the server by using theEndpointvalue if the server has aCustomDomainspecified.
-
engine
public final String engine()
The engine type of the server. Valid values in this release include
ChefAutomateandPuppet.- Returns:
- The engine type of the server. Valid values in this release include
ChefAutomateandPuppet.
-
engineModel
public final String engineModel()
The engine model of the server. Valid values in this release include
Monolithicfor Puppet andSinglefor Chef.- Returns:
- The engine model of the server. Valid values in this release include
Monolithicfor Puppet andSinglefor Chef.
-
hasEngineAttributes
public final boolean hasEngineAttributes()
For responses, this returns true if the service returned a value for the EngineAttributes property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
engineAttributes
public final List<EngineAttribute> engineAttributes()
The response of a createServer() request returns the master credential to access the server in EngineAttributes. These credentials are not stored by AWS OpsWorks CM; they are returned only as part of the result of createServer().
Attributes returned in a createServer response for Chef
-
CHEF_AUTOMATE_PIVOTAL_KEY: A base64-encoded RSA private key that is generated by AWS OpsWorks for Chef Automate. This private key is required to access the Chef API. -
CHEF_STARTER_KIT: A base64-encoded ZIP file. The ZIP file contains a Chef starter kit, which includes a README, a configuration file, and the required RSA private key. Save this file, unzip it, and then change to the directory where you've unzipped the file contents. From this directory, you can run Knife commands.
Attributes returned in a createServer response for Puppet
-
PUPPET_STARTER_KIT: A base64-encoded ZIP file. The ZIP file contains a Puppet starter kit, including a README and a required private key. Save this file, unzip it, and then change to the directory where you've unzipped the file contents. -
PUPPET_ADMIN_PASSWORD: An administrator password that you can use to sign in to the Puppet Enterprise console after the server is online.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasEngineAttributes()method.- Returns:
- The response of a createServer() request returns the master credential to access the server in
EngineAttributes. These credentials are not stored by AWS OpsWorks CM; they are returned only as part of
the result of createServer().
Attributes returned in a createServer response for Chef
-
CHEF_AUTOMATE_PIVOTAL_KEY: A base64-encoded RSA private key that is generated by AWS OpsWorks for Chef Automate. This private key is required to access the Chef API. -
CHEF_STARTER_KIT: A base64-encoded ZIP file. The ZIP file contains a Chef starter kit, which includes a README, a configuration file, and the required RSA private key. Save this file, unzip it, and then change to the directory where you've unzipped the file contents. From this directory, you can run Knife commands.
Attributes returned in a createServer response for Puppet
-
PUPPET_STARTER_KIT: A base64-encoded ZIP file. The ZIP file contains a Puppet starter kit, including a README and a required private key. Save this file, unzip it, and then change to the directory where you've unzipped the file contents. -
PUPPET_ADMIN_PASSWORD: An administrator password that you can use to sign in to the Puppet Enterprise console after the server is online.
-
-
-
engineVersion
public final String engineVersion()
The engine version of the server. For a Chef server, the valid value for EngineVersion is currently
2. For a Puppet server, specify either2019or2017.- Returns:
- The engine version of the server. For a Chef server, the valid value for EngineVersion is currently
2. For a Puppet server, specify either2019or2017.
-
instanceProfileArn
public final String instanceProfileArn()
The instance profile ARN of the server.
- Returns:
- The instance profile ARN of the server.
-
instanceType
public final String instanceType()
The instance type for the server, as specified in the CloudFormation stack. This might not be the same instance type that is shown in the EC2 console.
- Returns:
- The instance type for the server, as specified in the CloudFormation stack. This might not be the same instance type that is shown in the EC2 console.
-
keyPair
public final String keyPair()
The key pair associated with the server.
- Returns:
- The key pair associated with the server.
-
maintenanceStatus
public final MaintenanceStatus maintenanceStatus()
The status of the most recent server maintenance run. Shows
SUCCESSorFAILED.If the service returns an enum value that is not available in the current SDK version,
maintenanceStatuswill returnMaintenanceStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frommaintenanceStatusAsString().- Returns:
- The status of the most recent server maintenance run. Shows
SUCCESSorFAILED. - See Also:
MaintenanceStatus
-
maintenanceStatusAsString
public final String maintenanceStatusAsString()
The status of the most recent server maintenance run. Shows
SUCCESSorFAILED.If the service returns an enum value that is not available in the current SDK version,
maintenanceStatuswill returnMaintenanceStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frommaintenanceStatusAsString().- Returns:
- The status of the most recent server maintenance run. Shows
SUCCESSorFAILED. - See Also:
MaintenanceStatus
-
preferredMaintenanceWindow
public final String preferredMaintenanceWindow()
The preferred maintenance period specified for the server.
- Returns:
- The preferred maintenance period specified for the server.
-
preferredBackupWindow
public final String preferredBackupWindow()
The preferred backup period specified for the server.
- Returns:
- The preferred backup period specified for the server.
-
hasSecurityGroupIds
public final boolean hasSecurityGroupIds()
For responses, this returns true if the service returned a value for the SecurityGroupIds property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
securityGroupIds
public final List<String> securityGroupIds()
The security group IDs for the server, as specified in the CloudFormation stack. These might not be the same security groups that are shown in the EC2 console.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSecurityGroupIds()method.- Returns:
- The security group IDs for the server, as specified in the CloudFormation stack. These might not be the same security groups that are shown in the EC2 console.
-
serviceRoleArn
public final String serviceRoleArn()
The service role ARN used to create the server.
- Returns:
- The service role ARN used to create the server.
-
status
public final ServerStatus status()
The server's status. This field displays the states of actions in progress, such as creating, running, or backing up the server, as well as the server's health state.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnServerStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The server's status. This field displays the states of actions in progress, such as creating, running, or backing up the server, as well as the server's health state.
- See Also:
ServerStatus
-
statusAsString
public final String statusAsString()
The server's status. This field displays the states of actions in progress, such as creating, running, or backing up the server, as well as the server's health state.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnServerStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The server's status. This field displays the states of actions in progress, such as creating, running, or backing up the server, as well as the server's health state.
- See Also:
ServerStatus
-
statusReason
public final String statusReason()
Depending on the server status, this field has either a human-readable message (such as a create or backup error), or an escaped block of JSON (used for health check results).
- Returns:
- Depending on the server status, this field has either a human-readable message (such as a create or backup error), or an escaped block of JSON (used for health check results).
-
hasSubnetIds
public final boolean hasSubnetIds()
For responses, this returns true if the service returned a value for the SubnetIds property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
subnetIds
public final List<String> subnetIds()
The subnet IDs specified in a CreateServer request.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSubnetIds()method.- Returns:
- The subnet IDs specified in a CreateServer request.
-
serverArn
public final String serverArn()
The ARN of the server.
- Returns:
- The ARN of the server.
-
toBuilder
public Server.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<Server.Builder,Server>
-
builder
public static Server.Builder builder()
-
serializableBuilderClass
public static Class<? extends Server.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-