v51

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-01169142751.2 KB
Subscriptions - Pro - Connectivity

Add principal to Private Link for a specific region

(Active-Active subscriptions only) Adds a principal (AWS ARN) to the Private Link configuration for a specific region.

post/v1/subscriptions/{subscriptionId}/regions/{regionId}/private-link/principals

Path parameters

subscriptionIdinteger required

Subscription ID.

regionIdinteger required

Region ID - required for Active-Active subscription

Request body

subscriptionIdinteger
regionIdinteger required

Deployment region id as defined by cloud provider

principalstring required

AWS account ID or ARN of the principal (IAM user, role, or account)

type'aws_account' | 'organization' | 'organization_unit' | 'iam_role' | 'iam_user' | 'service_principal'

Type of the principal

aliasstring

Alias or friendly name for the principal

commandTypestring

Example request

{
  "principal": "123456789012",
  "type": "aws_account",
  "alias": "Production Account"
}

Response

No Content

taskIdstring uuid
commandTypestring
status'initialized' | 'received' | 'processing-in-progress' | 'processing-completed' | 'processing-error'
descriptionstring
timestampstring date-time
linksobject[]