@Generated(value="software.amazon.awssdk:codegen") public final class Server extends Object implements SdkPojo, Serializable, ToCopyableBuilder<Server.Builder,Server>
Describes a configuration management server.
Modifier and Type | Class and Description |
---|---|
static interface |
Server.Builder |
Modifier and Type | Method and Description |
---|---|
Boolean |
associatePublicIpAddress()
Associate a public IP address with a server that you are launching.
|
Integer |
backupRetentionCount()
The number of automated backups to keep.
|
static Server.Builder |
builder() |
String |
cloudFormationStackArn()
The ARN of the CloudFormation stack that was used to create the server.
|
Instant |
createdAt()
Time stamp of server creation.
|
Boolean |
disableAutomatedBackup()
Disables automated backups.
|
String |
endpoint()
A DNS name that can be used to access the engine.
|
String |
engine()
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.
|
String |
engineModel()
The engine model of the server.
|
String |
engineVersion()
The engine version of the server.
|
boolean |
equals(Object obj) |
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz) |
int |
hashCode() |
String |
instanceProfileArn()
The instance profile ARN of the server.
|
String |
instanceType()
The instance type for the server, as specified in the CloudFormation stack.
|
String |
keyPair()
The key pair associated with the server.
|
MaintenanceStatus |
maintenanceStatus()
The status of the most recent server maintenance run.
|
String |
maintenanceStatusAsString()
The status of the most recent server maintenance run.
|
String |
preferredBackupWindow()
The preferred backup period specified for the server.
|
String |
preferredMaintenanceWindow()
The preferred maintenance period specified for the server.
|
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() |
String |
serverArn()
The ARN of the server.
|
String |
serverName()
The name of the server.
|
String |
serviceRoleArn()
The service role ARN used to create the server.
|
ServerStatus |
status()
The server's status.
|
String |
statusAsString()
The server's status.
|
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).
|
List<String> |
subnetIds()
The subnet IDs specified in a CreateServer request.
|
Server.Builder |
toBuilder()
Take this object and create a builder that contains all of the current property values of this object.
|
String |
toString() |
copy
public Boolean associatePublicIpAddress()
Associate a public IP address with a server that you are launching.
public Integer backupRetentionCount()
The number of automated backups to keep.
public String serverName()
The name of the server.
public Instant createdAt()
Time stamp of server creation. Example 2016-07-29T13:38:47.520Z
2016-07-29T13:38:47.520Z
public String cloudFormationStackArn()
The ARN of the CloudFormation stack that was used to create the server.
public Boolean disableAutomatedBackup()
Disables automated backups. The number of stored backups is dependent on the value of PreferredBackupCount.
public String endpoint()
A DNS name that can be used to access the engine. Example: myserver-asdfghjkl.us-east-1.opsworks.io
myserver-asdfghjkl.us-east-1.opsworks.io
public String engine()
The engine type of the server. Valid values in this release include Chef
and Puppet
.
Chef
and
Puppet
.public String engineModel()
The engine model of the server. Valid values in this release include Monolithic
for Puppet and
Single
for Chef.
Monolithic
for Puppet
and Single
for Chef.public 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_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.
Attributes returned in a createServer response for Chef
CHEF_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.
public String engineVersion()
The engine version of the server. For a Chef server, the valid value for EngineVersion is currently
12
. For a Puppet server, the valid value is 2017
.
12
. For a Puppet server, the valid value is 2017
.public String instanceProfileArn()
The instance profile ARN of the server.
public 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.
public String keyPair()
The key pair associated with the server.
public MaintenanceStatus maintenanceStatus()
The status of the most recent server maintenance run. Shows SUCCESS
or FAILED
.
If the service returns an enum value that is not available in the current SDK version, maintenanceStatus
will return MaintenanceStatus.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available
from maintenanceStatusAsString()
.
SUCCESS
or FAILED
.MaintenanceStatus
public String maintenanceStatusAsString()
The status of the most recent server maintenance run. Shows SUCCESS
or FAILED
.
If the service returns an enum value that is not available in the current SDK version, maintenanceStatus
will return MaintenanceStatus.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available
from maintenanceStatusAsString()
.
SUCCESS
or FAILED
.MaintenanceStatus
public String preferredMaintenanceWindow()
The preferred maintenance period specified for the server.
public String preferredBackupWindow()
The preferred backup period specified for the server.
public 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.
public String serviceRoleArn()
The service role ARN used to create the server.
public 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, status
will
return ServerStatus.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
statusAsString()
.
ServerStatus
public 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, status
will
return ServerStatus.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
statusAsString()
.
ServerStatus
public 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).
public 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.
public String serverArn()
The ARN of the server.
public Server.Builder toBuilder()
ToCopyableBuilder
toBuilder
in interface ToCopyableBuilder<Server.Builder,Server>
public static Server.Builder builder()
public static Class<? extends Server.Builder> serializableBuilderClass()
Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.