---
name: "ocf_heartbeat_awsvip"
section: "7"
platform: "linux"
package: "resource-agents"
version: "1:4.16.0-3+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ocf_heartbeat_awsvip"
---

# ocf\_heartbeat\_awsvip(7)

Amazon AWS Secondary Private IP Address Resource Agent

## NAME

ocf\_heartbeat\_awsvip - Amazon AWS Secondary Private IP Address Resource Agent

## SYNOPSIS

**awsvip** \[start \| stop \| monitor \| migrate\_to \| migrate\_from \| meta-data \| validate-all\]

## DESCRIPTION

Resource Agent for Amazon AWS Secondary Private IP Addresses.

It manages AWS Secondary Private IP Addresses with awscli.

Credentials needs to be setup by running "aws configure", or by using AWS Policies.

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")

**auth\_type**

Authentication type "key" for AccessKey and SecretAccessKey set via "aws configure", or "role" to use AWS Policies.

(optional, string, default "key")

**profile**

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

(optional, string, default "default")

**secondary\_private\_ip**

reserved secondary private ip for ec2 instance

(unique, required, string, no default)

**region**

Region for AWS resource (required for role-based authentication)

(optional, string, no default)

**api\_delay**

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

(optional, integer, default 3)

**curl\_retries**

curl retries before failing

(optional, integer, default 3)

**curl\_sleep**

curl sleep between tries

(optional, integer, default 1)

## 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 awsvip resource using the [**crm**(8)](/crm/8.md) shell:

```
primitive p_awsvip ocf:heartbeat:awsvip \
  params \
    secondary_private_ip=string \
  meta allow-migrate="true" \
  op monitor timeout="30s" interval="20s" depth="0"
```

## EXAMPLE PCS

The following is an example configuration for a awsvip resource using [**pcs**(8)](/pcs/8.md)

```
pcs resource create p_awsvip ocf:heartbeat:awsvip \
  secondary_private_ip=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)**