NAME

       ocf_heartbeat_awseip - Amazon AWS Elastic IP Address Resource Agent

SYNOPSIS

       awseip [start | stop | monitor | migrate_to | migrate_from | meta-data | validate-all]

DESCRIPTION

       Resource Agent for Amazon AWS Elastic IP Addresses.

       It manages AWS Elastic IP Addresses with awscli.

       Credentials needs to be setup by running "aws configure".

       See https://aws.amazon.com/cli/ for more information about awscli.

       This resource agent may be configured for native migration if available in the cluster manager. For
       Pacemaker, the allow-migrate="true" meta attribute enables native migration.

SUPPORTED PARAMETERS

       awscli
           command line tools for aws services

           (optional, string, default "/usr/bin/aws")

       profile
           Valid AWS CLI profile name (see ~/.aws/config and 'aws configure')

           (optional, string, default "default")

       elastic_ip
           reserved elastic ip for ec2 instance

           (unique, required, string, no default)

       allocation_id
           reserved allocation id for ec2 instance

           (unique, required, string, no default)

       private_ip_address
           predefined private ip address for ec2 instance

           (unique, optional, string, no default)

       api_delay
           a short delay between API calls, to avoid sending API too quick

           (optional, integer, default 3)

SUPPORTED ACTIONS

       This resource agent supports the following actions (operations):

       start
           Starts the resource. Suggested minimum timeout: 30s.

       stop
           Stops the resource. Suggested minimum timeout: 30s.

       monitor
           Performs a detailed status check. Suggested minimum timeout: 30s. Suggested interval: 20s.

       migrate_to
           Executes steps necessary for migrating the resource to the node. Suggested minimum timeout: 30s.

       migrate_from
           Executes steps necessary for migrating the resource away from the node. Suggested minimum timeout:
           30s.

       meta-data
           Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.

       validate
           Suggested minimum timeout: 10s.

       validate-all
           Performs a validation of the resource configuration. Suggested minimum timeout: 10s.

EXAMPLE CRM SHELL

       The following is an example configuration for a awseip resource using the crm(8) shell:

           primitive p_awseip ocf:heartbeat:awseip \
             params \
               elastic_ip=string \
               allocation_id=string \
             meta allow-migrate="true" \
             op monitor timeout="30s" interval="20s" depth="0"

EXAMPLE PCS

       The following is an example configuration for a awseip resource using pcs(8)

           pcs resource create p_awseip ocf:heartbeat:awseip \
             elastic_ip=string \
             allocation_id=string \
             op monitor timeout="30s" interval="20s" OCF_CHECK_LEVEL="0"

SEE ALSO

       http://clusterlabs.org/

AUTHOR

       ClusterLabs contributors (see the resource agent source for information about individual authors)

resource-agents 4.13.0-1ubuntu                     04/01/2024                            OCF_HEARTBEAT_AWSEIP(7)