Copyright | (c) 2013-2016 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
- opsWorksCM :: Service
- _ValidationException :: AsError a => Getting (First ServiceError) a ServiceError
- _ResourceAlreadyExistsException :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidNextTokenException :: AsError a => Getting (First ServiceError) a ServiceError
- _ResourceNotFoundException :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidStateException :: AsError a => Getting (First ServiceError) a ServiceError
- _LimitExceededException :: AsError a => Getting (First ServiceError) a ServiceError
- data BackupStatus
- data BackupType
- data MaintenanceStatus
- data NodeAssociationStatus
- data ServerStatus
- data AccountAttribute
- accountAttribute :: AccountAttribute
- aaUsed :: Lens' AccountAttribute (Maybe Int)
- aaMaximum :: Lens' AccountAttribute (Maybe Int)
- aaName :: Lens' AccountAttribute (Maybe Text)
- data Backup
- backup :: Backup
- bEngineVersion :: Lens' Backup (Maybe Text)
- bServiceRoleARN :: Lens' Backup (Maybe Text)
- bStatus :: Lens' Backup (Maybe BackupStatus)
- bInstanceProfileARN :: Lens' Backup (Maybe Text)
- bSecurityGroupIds :: Lens' Backup [Text]
- bStatusDescription :: Lens' Backup (Maybe Text)
- bServerName :: Lens' Backup (Maybe Text)
- bSubnetIds :: Lens' Backup [Text]
- bKeyPair :: Lens' Backup (Maybe Text)
- bCreatedAt :: Lens' Backup (Maybe UTCTime)
- bBackupId :: Lens' Backup (Maybe Text)
- bEngine :: Lens' Backup (Maybe Text)
- bInstanceType :: Lens' Backup (Maybe Text)
- bEngineModel :: Lens' Backup (Maybe Text)
- bPreferredMaintenanceWindow :: Lens' Backup (Maybe Text)
- bUserARN :: Lens' Backup (Maybe Text)
- bPreferredBackupWindow :: Lens' Backup (Maybe Text)
- bS3LogURL :: Lens' Backup (Maybe Text)
- bS3DataSize :: Lens' Backup (Maybe Int)
- bBackupARN :: Lens' Backup (Maybe Text)
- bS3DataURL :: Lens' Backup (Maybe Text)
- bDescription :: Lens' Backup (Maybe Text)
- bBackupType :: Lens' Backup (Maybe BackupType)
- bToolsVersion :: Lens' Backup (Maybe Text)
- data EngineAttribute
- engineAttribute :: EngineAttribute
- eaValue :: Lens' EngineAttribute (Maybe Text)
- eaName :: Lens' EngineAttribute (Maybe Text)
- data Server
- server :: Server
- sEngineVersion :: Lens' Server (Maybe Text)
- sServiceRoleARN :: Lens' Server (Maybe Text)
- sDisableAutomatedBackup :: Lens' Server (Maybe Bool)
- sStatus :: Lens' Server (Maybe ServerStatus)
- sInstanceProfileARN :: Lens' Server (Maybe Text)
- sSecurityGroupIds :: Lens' Server [Text]
- sServerName :: Lens' Server (Maybe Text)
- sSubnetIds :: Lens' Server [Text]
- sKeyPair :: Lens' Server (Maybe Text)
- sCreatedAt :: Lens' Server (Maybe UTCTime)
- sServerARN :: Lens' Server (Maybe Text)
- sEngine :: Lens' Server (Maybe Text)
- sMaintenanceStatus :: Lens' Server (Maybe MaintenanceStatus)
- sInstanceType :: Lens' Server (Maybe Text)
- sEngineModel :: Lens' Server (Maybe Text)
- sEngineAttributes :: Lens' Server [EngineAttribute]
- sPreferredMaintenanceWindow :: Lens' Server (Maybe Text)
- sPreferredBackupWindow :: Lens' Server (Maybe Text)
- sStatusReason :: Lens' Server (Maybe Text)
- sEndpoint :: Lens' Server (Maybe Text)
- sBackupRetentionCount :: Lens' Server (Maybe Int)
- data ServerEvent
- serverEvent :: ServerEvent
- seLogURL :: Lens' ServerEvent (Maybe Text)
- seServerName :: Lens' ServerEvent (Maybe Text)
- seCreatedAt :: Lens' ServerEvent (Maybe UTCTime)
- seMessage :: Lens' ServerEvent (Maybe Text)
Service Configuration
opsWorksCM :: Service Source #
API version 2016-11-01
of the Amazon OpsWorks for Chef Automate SDK configuration.
Errors
_ValidationException :: AsError a => Getting (First ServiceError) a ServiceError Source #
One or more of the provided request parameters are not valid.
_ResourceAlreadyExistsException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The requested resource cannot be created because it already exists.
_InvalidNextTokenException :: AsError a => Getting (First ServiceError) a ServiceError Source #
This occurs when the provided nextToken is not valid.
_ResourceNotFoundException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The requested resource does not exist, or access was denied.
_InvalidStateException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The resource is in a state that does not allow you to perform a specified action.
_LimitExceededException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The limit of servers or backups has been reached.
BackupStatus
data BackupStatus Source #
BackupType
data BackupType Source #
MaintenanceStatus
data MaintenanceStatus Source #
NodeAssociationStatus
data NodeAssociationStatus Source #
ServerStatus
data ServerStatus Source #
BackingUp | |
ConnectionLost | |
Creating | |
Deleting | |
Failed | |
Healthy | |
Modifying | |
Running | |
Setup | |
UnderMaintenance | |
Unhealthy |
AccountAttribute
data AccountAttribute Source #
Stores account attributes.
See: accountAttribute
smart constructor.
accountAttribute :: AccountAttribute Source #
Creates a value of AccountAttribute
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
aaUsed
- The current usage, such as the current number of servers associated with the account.aaMaximum
- The maximum allowed value.aaName
- The attribute name. The following are supported attribute names. * ServerLimit: The number of servers that currently existing maximal allowed. By default 10 servers can be created. * ManualBackupLimit: The number of manual backups that currently exist are maximal allowed. By default 50 manual backups can be created.
aaUsed :: Lens' AccountAttribute (Maybe Int) Source #
The current usage, such as the current number of servers associated with the account.
aaName :: Lens' AccountAttribute (Maybe Text) Source #
The attribute name. The following are supported attribute names. * ServerLimit: The number of servers that currently existing maximal allowed. By default 10 servers can be created. * ManualBackupLimit: The number of manual backups that currently exist are maximal allowed. By default 50 manual backups can be created.
Backup
Describes a single backup.
See: backup
smart constructor.
Creates a value of Backup
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
bEngineVersion
- The engine version that is obtained from the server when the backup is created.bServiceRoleARN
- The service role ARN that is obtained from the server when the backup is created.bStatus
- The status of a backup while in progress.bInstanceProfileARN
- The EC2 instance profile ARN that is obtained from the server when the backup is created. Because this value is stored, you are not required to provide the InstanceProfileArn again if you restore a backup.bSecurityGroupIds
- The security group IDs that are obtained from the server when the backup is created.bStatusDescription
- An informational message about backup status.bServerName
- The name of the server from which the backup was made.bSubnetIds
- The subnet IDs that are obtained from the server when the backup is created.bKeyPair
- The key pair that is obtained from the server when the backup is created.bCreatedAt
- The time stamp when the backup was created in the database. Example:2016-07-29T13:38:47.520Z
bBackupId
- The generated ID of the backup. Example:myServerName-yyyyMMddHHmmssSSS
bEngine
- The engine type that is obtained from the server when the backup is created.bInstanceType
- The instance type that is obtained from the server when the backup is created.bEngineModel
- The engine model that is obtained from the server when the backup is created.bPreferredMaintenanceWindow
- The preferred maintenance period that is obtained from the server when the backup is created.bUserARN
- The IAM user ARN of the requester for manual backups. This field is empty for automated backups.bPreferredBackupWindow
- The preferred backup period that is obtained from the server when the backup is created.bS3LogURL
- The Amazon S3 URL of the backup's log file.bS3DataSize
- The size of the backup, in bytes. The size is returned by the instance in the command results.bBackupARN
- The ARN of the backup.bS3DataURL
- The Amazon S3 URL of the backup's tar.gz file.bDescription
- A user-provided description for a manual backup. This field is empty for automated backups.bBackupType
- The backup type. Valid values areautomated
ormanual
.bToolsVersion
- The version of AWS OpsWorks for Chef Automate-specific tools that is obtained from the server when the backup is created.
bEngineVersion :: Lens' Backup (Maybe Text) Source #
The engine version that is obtained from the server when the backup is created.
bServiceRoleARN :: Lens' Backup (Maybe Text) Source #
The service role ARN that is obtained from the server when the backup is created.
bInstanceProfileARN :: Lens' Backup (Maybe Text) Source #
The EC2 instance profile ARN that is obtained from the server when the backup is created. Because this value is stored, you are not required to provide the InstanceProfileArn again if you restore a backup.
bSecurityGroupIds :: Lens' Backup [Text] Source #
The security group IDs that are obtained from the server when the backup is created.
bStatusDescription :: Lens' Backup (Maybe Text) Source #
An informational message about backup status.
bServerName :: Lens' Backup (Maybe Text) Source #
The name of the server from which the backup was made.
bSubnetIds :: Lens' Backup [Text] Source #
The subnet IDs that are obtained from the server when the backup is created.
bKeyPair :: Lens' Backup (Maybe Text) Source #
The key pair that is obtained from the server when the backup is created.
bCreatedAt :: Lens' Backup (Maybe UTCTime) Source #
The time stamp when the backup was created in the database. Example: 2016-07-29T13:38:47.520Z
bBackupId :: Lens' Backup (Maybe Text) Source #
The generated ID of the backup. Example: myServerName-yyyyMMddHHmmssSSS
bEngine :: Lens' Backup (Maybe Text) Source #
The engine type that is obtained from the server when the backup is created.
bInstanceType :: Lens' Backup (Maybe Text) Source #
The instance type that is obtained from the server when the backup is created.
bEngineModel :: Lens' Backup (Maybe Text) Source #
The engine model that is obtained from the server when the backup is created.
bPreferredMaintenanceWindow :: Lens' Backup (Maybe Text) Source #
The preferred maintenance period that is obtained from the server when the backup is created.
bUserARN :: Lens' Backup (Maybe Text) Source #
The IAM user ARN of the requester for manual backups. This field is empty for automated backups.
bPreferredBackupWindow :: Lens' Backup (Maybe Text) Source #
The preferred backup period that is obtained from the server when the backup is created.
bS3DataSize :: Lens' Backup (Maybe Int) Source #
The size of the backup, in bytes. The size is returned by the instance in the command results.
bDescription :: Lens' Backup (Maybe Text) Source #
A user-provided description for a manual backup. This field is empty for automated backups.
bBackupType :: Lens' Backup (Maybe BackupType) Source #
The backup type. Valid values are automated
or manual
.
bToolsVersion :: Lens' Backup (Maybe Text) Source #
The version of AWS OpsWorks for Chef Automate-specific tools that is obtained from the server when the backup is created.
EngineAttribute
data EngineAttribute Source #
A name/value pair that is specific to the engine of the server.
See: engineAttribute
smart constructor.
engineAttribute :: EngineAttribute Source #
Creates a value of EngineAttribute
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
Server
Describes a configuration management server.
See: server
smart constructor.
Creates a value of Server
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
sEngineVersion
- The engine version of the server. Because Chef is the engine available in this release, the valid value for EngineVersion is12
.sServiceRoleARN
- The service role ARN used to create the server.sDisableAutomatedBackup
- Disables automated backups. The number of stored backups is dependent on the value of PreferredBackupCount.sStatus
- 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 server health.sInstanceProfileARN
- The instance profile ARN of the server.sSecurityGroupIds
- 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.sServerName
- The name of the server.sSubnetIds
- The subnet IDs specified in a CreateServer request.sKeyPair
- The key pair associated with the server.sCreatedAt
- Time stamp of server creation. Example2016-07-29T13:38:47.520Z
sServerARN
- The ARN of the server.sEngine
- The engine type of the server. The valid value in this release isChef
.sMaintenanceStatus
- The status of the most recent server maintenance run. ShowsSUCCESS
orFAILED
.sInstanceType
- 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.sEngineModel
- The engine model of the server. The valid value in this release isSingle
.sEngineAttributes
- The response of a createServer() request returns the master credential to access the server in EngineAttributes. These credentials are not stored by AWS OpsWorks for Chef Automate; they are returned only as part of the result of createServer(). Attributes returned in a createServer response: *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.sPreferredMaintenanceWindow
- The preferred maintenance period specified for the server.sPreferredBackupWindow
- The preferred backup period specified for the server.sStatusReason
- 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).sEndpoint
- A DNS name that can be used to access the engine. Example:myserver-asdfghjkl.us-east-1.opsworks.io
sBackupRetentionCount
- The number of automated backups to keep.
sEngineVersion :: Lens' Server (Maybe Text) Source #
The engine version of the server. Because Chef is the engine available in this release, the valid value for EngineVersion is 12
.
sServiceRoleARN :: Lens' Server (Maybe Text) Source #
The service role ARN used to create the server.
sDisableAutomatedBackup :: Lens' Server (Maybe Bool) Source #
Disables automated backups. The number of stored backups is dependent on the value of PreferredBackupCount.
sStatus :: Lens' Server (Maybe ServerStatus) Source #
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 server health.
sSecurityGroupIds :: Lens' Server [Text] Source #
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.
sCreatedAt :: Lens' Server (Maybe UTCTime) Source #
Time stamp of server creation. Example 2016-07-29T13:38:47.520Z
sEngine :: Lens' Server (Maybe Text) Source #
The engine type of the server. The valid value in this release is Chef
.
sMaintenanceStatus :: Lens' Server (Maybe MaintenanceStatus) Source #
The status of the most recent server maintenance run. Shows SUCCESS
or FAILED
.
sInstanceType :: Lens' Server (Maybe Text) Source #
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.
sEngineModel :: Lens' Server (Maybe Text) Source #
The engine model of the server. The valid value in this release is Single
.
sEngineAttributes :: Lens' Server [EngineAttribute] Source #
The response of a createServer() request returns the master credential to access the server in EngineAttributes. These credentials are not stored by AWS OpsWorks for Chef Automate; they are returned only as part of the result of createServer(). Attributes returned in a createServer response: * 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.
sPreferredMaintenanceWindow :: Lens' Server (Maybe Text) Source #
The preferred maintenance period specified for the server.
sPreferredBackupWindow :: Lens' Server (Maybe Text) Source #
The preferred backup period specified for the server.
sStatusReason :: Lens' Server (Maybe Text) Source #
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).
sEndpoint :: Lens' Server (Maybe Text) Source #
A DNS name that can be used to access the engine. Example: myserver-asdfghjkl.us-east-1.opsworks.io
ServerEvent
data ServerEvent Source #
An event that is related to the server, such as the start of maintenance or backup.
See: serverEvent
smart constructor.
serverEvent :: ServerEvent Source #
Creates a value of ServerEvent
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
seLogURL
- The Amazon S3 URL of the event's log file.seServerName
- The name of the server on or for which the event occurred.seCreatedAt
- The time when the event occurred.seMessage
- A human-readable informational or status message.
seServerName :: Lens' ServerEvent (Maybe Text) Source #
The name of the server on or for which the event occurred.
seCreatedAt :: Lens' ServerEvent (Maybe UTCTime) Source #
The time when the event occurred.