Subscriptions - Pro

Add region to Active-Active subscription

Changed on Oct 2, 2026

Adds a new region to an Active-Active subscription.

post/v1/subscriptions/{subscriptionId}/regions

Request

Base URL
https://api.redislabs.com
URL
https://api.redislabs.com/v1/subscriptions/{subscriptionId}/regions
Auth
API key in header x-api-key and API key in header x-api-secret-key and API key in header x-auth-token

Path parameters

subscriptionIdinteger required

Subscription ID.

Request body

subscriptionIdinteger

regionstring

Name of region to add as defined by the cloud provider.

vpcIdstring

Optional. Enter a VPC identifier that exists in the hosted AWS account. Creates a new VPC if not set. VPC Identifier must be in a valid format and must exist within the hosting account.

deploymentCIDRstring

Deployment CIDR mask. Must be a valid CIDR format with a range of 256 IP addresses.

subnetIdsstring[]

Optional. Enter a list of subnets identifiers that exists in the hosted AWS account. Subnet Identifier must exist within the hosting account.

securityGroupIdstring

Optional. Enter a security group identifier that exists in the hosted AWS account. Security group Identifier must be in a valid format (for example: 'sg-0125be68a4625884ad') and must exist within the hosting account.

multipleAvailabilityZonesboolean

Optional. Support deployment on multiple availability zones within the selected region. When omitted, defaults to true unless the region is explicitly marked as not supporting multi-AZ.

preferredAvailabilityZonesstring[]

Optional. List the zone IDs for your preferred availability zones for the cloud provider and region.

dryRunboolean

Optional. When 'false': Creates a deployment plan and deploys it, creating any resources required by the plan. When 'true': creates a read-only deployment plan, and does not create any resources. Default: 'false'

respVersion'resp2' | 'resp3'

Optional. RESP version must be compatible with Redis version.

customerManagedKeyResourceNamestring

Required for subscriptions where 'persistentStorageEncryptionType' is 'customer-managed-key'. The resource name of the customer-managed encryption key for the region.

commandTypestring

Example request

{
  "vpcId": "vpc-0125be68a4625884ad",
  "deploymentCIDR": "10.0.0.0/24",
  "subnetIds": [
    "['subnet-0125be68a4625884ad', 'subnet-0125be68a4625884ad','subnet-0125be68a4625884ad']"
  ],
  "securityGroupId": "sg-0125be68a4625884ad",
  "databases": [
    {
      "localThroughputMeasurement": {
        "writeOperationsPerSecond": 1000,
        "readOperationsPerSecond": 1000
      }
    }
  ],
  "respVersion": "resp3",
  "customerManagedKeyResourceName": "projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
}

Response

taskIdstring uuid

commandTypestring

status'initialized' | 'received' | 'processing-in-progress' | 'processing-completed' | 'processing-error'

descriptionstring

timestampstring date-time

linksobject[]

Changes

Oct 2, 20266b256e1bb946 Revision changes
- warning
  added the new AGENT_MEMORY_IS_DISABLED enum value to the / response property for the response status
- warning
  added the new AGENT_MEMORY_STORE_DEPENDENCY_FAILED enum value to the / response property for the response status
- warning
  added the new AGENT_MEMORY_STORE_FORBIDDEN enum value to the / response property for the response status
- warning
  added the new AGENT_MEMORY_STORE_INVALID_REQUEST enum value to the / response property for the response status
- warning
  added the new AGENT_MEMORY_STORE_NOT_FOUND enum value to the / response property for the response status
Sep 8, 2026c09dc0db14e1 Revision changes
- warning
  added the new DATABASE_IN_ACTIVE_ENDPOINTS_REDIRECTION enum value to the / response property for the response status
- warning
  added the new DATABASE_TRAFFIC_NOT_STOPPED enum value to the / response property for the response status
- warning
  added the new DATABASE_TRAFFIC_RESUME_IN_PROGRESS enum value to the / response property for the response status
- warning
  added the new DATABASE_TRAFFIC_RESUME_NOT_ELIGIBLE enum value to the / response property for the response status
- warning
  added the new DATABASE_TRAFFIC_STATE_NOT_FOUND enum value to the / response property for the response status
- warning
  added the new DB_ENDPOINTS_SERVICE_NOT_FOUND enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_ACCOUNT_MISMATCH enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_ALREADY_EXISTS enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_CONNECTIVITY_MISMATCH enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_DATABASES_NOT_COMPATIBLE enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_DATABASE_STATE_NOT_SUPPORTED enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_DNS_SERVICE_NOT_AVAILABLE enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_INVALID_ENDPOINT_TYPE enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_NOT_COMPLETED enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_NOT_FOUND enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_NOT_LATEST enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_REVERT_WINDOW_EXCEEDED enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_SOURCE_HAS_NO_ENDPOINTS enum value to the / response property for the response status
- warning
  added the new ENDPOINTS_REDIRECTION_TARGET_HAS_NO_ENDPOINTS enum value to the / response property for the response status
- warning
  added the new FIXED_DATABASE_MEMCACHED_PROTOCOL_IS_NOT_SUPPORTED_FOR_FREE_PLAN enum value to the / response property for the response status

Operation history (4 revisions)