openapi: 3.1.0
info:
title: YugabyteDB Aeon REST Access Keys Disaster Recovery API
description: The YugabyteDB Aeon REST API provides programmatic access to YugabyteDB's fully managed cloud database service. Developers and operators can use it to deploy and manage database clusters, configure read replicas, schedule and execute on-demand backups and restores, manage IP allow lists, and set up monitoring and alerts. Authentication is performed using API keys passed as bearer tokens in the Authorization header. All paths are scoped to an account and project, which can be obtained from the YugabyteDB Aeon UI profile page.
version: v1
contact:
name: Yugabyte Support
url: https://support.yugabyte.com
termsOfService: https://www.yugabyte.com/yugabytedb-managed-service-terms/
x-generated-from: documentation
x-source-url: https://api-docs.yugabyte.com/docs/managed-apis/
x-last-validated: '2026-05-03'
servers:
- url: https://cloud.yugabyte.com/api/public/v1
description: YugabyteDB Aeon Production Server
security:
- bearerAuth: []
tags:
- name: Disaster Recovery
paths:
/api/v1/customers/{cUUID}/dr_configs:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: createDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigCreateForm'
examples:
CreateDrConfigRequestExample:
summary: Default createDrConfig request
x-microcks-default: true
value:
targetUniverseUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
dryRun: true
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
dbs: '["0000412b000030008000000000000000", "0000412b000030008000000000000001"]'
name: Dr-config1
sourceUniverseUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
pitrParams:
snapshotIntervalSec: 1
retentionPeriodSec: 6
description: Disaster Recovery Create Form Data
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
CreateDrConfig200Example:
summary: Default createDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Create Disaster Recovery Config
tags:
- Disaster Recovery
x-codegen-request-body-name: disaster_recovery_create_form_data
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}:
delete:
description: 'WARNING: This is a preview API that could change.'
operationId: deleteXClusterConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: isForceDelete
schema:
default: false
type: boolean
example: false
- in: query
name: request
schema: {}
example: example-request
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
DeleteXClusterConfig200Example:
summary: Default deleteXClusterConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Delete Xcluster Config
tags:
- Disaster Recovery
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
get:
description: 'WARNING: This is a preview API that could change.'
operationId: getDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: syncWithDB
schema:
default: true
type: boolean
example: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigGetResp'
examples:
GetDrConfig200Example:
summary: Default getDrConfig 200 response
x-microcks-default: true
value:
paused: true
replicationGroupName: replicationGroupName
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
xclusterConfigUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
drReplicaUniverseState: Unconfigured for DR
type: Basic
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
xclusterConfigsUuid:
- 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: UNKNOWN
tables:
- tables
- tables
modifyTime: 2022-12-12 13:07:18+00:00
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
drReplicaUniverseActive: true
state: Initializing
primaryUniverseState: Unconfigured for DR
tableDetails:
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
streamId: a9d2470786694dc4b34e0e58e592da9e
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationStatusErrors:
- Unknown error
- Unknown error
sourceTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
replicationSetupDone: true
restoreTime: 2022-12-12 13:07:18+00:00
bootstrapCreateTime: 2022-12-12 13:07:18+00:00
indexTable: true
tableId: 000033df000030008000000000004005
targetTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
needBootstrap: true
status: Validated
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
streamId: a9d2470786694dc4b34e0e58e592da9e
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationStatusErrors:
- Unknown error
- Unknown error
sourceTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
replicationSetupDone: true
restoreTime: 2022-12-12 13:07:18+00:00
bootstrapCreateTime: 2022-12-12 13:07:18+00:00
indexTable: true
tableId: 000033df000030008000000000004005
targetTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
needBootstrap: true
status: Validated
dbDetails:
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId: sourceNamespaceId
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime: 2022-12-12 13:07:18+00:00
sourceNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
status: Validated
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId: sourceNamespaceId
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime: 2022-12-12 13:07:18+00:00
sourceNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
status: Validated
pitrConfigs:
- dbName: dbName
updateTime: 2022-12-12 13:07:18+00:00
createdForDr: true
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
minRecoverTimeInMillis: 1
scheduleInterval: 5
tableType: YQL_TABLE_TYPE
customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
createTime: 2022-12-12 13:07:18+00:00
intermittentMinRecoverTimeInMillis: 0
maxRecoverTimeInMillis: 6
name: name
disabled: true
usedForXCluster: true
state: UNKNOWN
retentionPeriod: 5
- dbName: dbName
updateTime: 2022-12-12 13:07:18+00:00
createdForDr: true
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
minRecoverTimeInMillis: 1
scheduleInterval: 5
tableType: YQL_TABLE_TYPE
customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
createTime: 2022-12-12 13:07:18+00:00
intermittentMinRecoverTimeInMillis: 0
maxRecoverTimeInMillis: 6
name: name
disabled: true
usedForXCluster: true
state: UNKNOWN
retentionPeriod: 5
primaryUniverseActive: true
automaticDdlMode: true
dbs:
- dbs
- dbs
createTime: 2022-12-12 13:07:18+00:00
webhooks:
- uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
url: url
- uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
url: url
name: name
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
keyspacePending: keyspacePending
pitrRetentionPeriodSec: 2
pitrSnapshotIntervalSec: 7
status: Initialized
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Get Disaster Recovery Config
tags:
- Disaster Recovery
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/edit:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: editDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigEditForm'
examples:
EditDrConfigRequestExample:
summary: Default editDrConfig request
x-microcks-default: true
value:
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
webhookUrls:
- webhookUrls
- webhookUrls
pitrParams:
snapshotIntervalSec: 1
retentionPeriodSec: 6
description: Disaster Recovery Edit Form Data
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
EditDrConfig200Example:
summary: Default editDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Edit Disaster Recovery Config
tags:
- Disaster Recovery
x-codegen-request-body-name: disaster_recovery_edit_form_data
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/failover:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: failoverDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigFailoverForm'
examples:
FailoverDrConfigRequestExample:
summary: Default failoverDrConfig request
x-microcks-default: true
value:
namespaceIdSafetimeEpochUsMap:
key: 0
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: Disaster Recovery Failover Form Data
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
FailoverDrConfig200Example:
summary: Default failoverDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Failover a Disaster Recovery Config
tags:
- Disaster Recovery
x-codegen-request-body-name: disaster_recovery_failover_form_data
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/pause:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: pauseDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
PauseDrConfig200Example:
summary: Default pauseDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Pause DR Config
tags:
- Disaster Recovery
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/pause_universes:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: pauseDrUniverses
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
PauseDrUniverses200Example:
summary: Default pauseDrUniverses 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Pause DR Config and Universes Associated with DR
tags:
- Disaster Recovery
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/replace_replica:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: replaceReplicaDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigReplaceReplicaForm'
examples:
ReplaceReplicaDrConfigRequestExample:
summary: Default replaceReplicaDrConfig request
x-microcks-default: true
value:
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: Disaster Recovery Replace Replica Form Data
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
ReplaceReplicaDrConfig200Example:
summary: Default replaceReplicaDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Replace Replica in a Disaster Recovery Config
tags:
- Disaster Recovery
x-codegen-request-body-name: disaster_recovery_replace_replica_form_data
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/restart:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: restartDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: isForceDelete
schema:
default: false
type: boolean
example: false
- in: query
name: request
schema: {}
example: example-request
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigRestartForm'
examples:
RestartDrConfigRequestExample:
summary: Default restartDrConfig request
x-microcks-default: true
value:
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
dbs: '["0000412b000030008000000000000000", "0000412b000030008000000000000001"]'
description: Disaster Recovery Restart Form Data
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
RestartDrConfig200Example:
summary: Default restartDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Restart Disaster Recovery Config
tags:
- Disaster Recovery
x-codegen-request-body-name: disaster_recovery_restart_form_data
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/resume:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: resumeDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
ResumeDrConfig200Example:
summary: Default resumeDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Resume DR Config
tags:
- Disaster Recovery
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/resume_universes:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: resumeDrUniverses
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
ResumeDrUniverses200Example:
summary: Default resumeDrUniverses 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Resume DR Config and Universes Associated with DR
tags:
- Disaster Recovery
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/safetime:
get:
description: 'WARNING: This is a preview API that could change.'
operationId: getDrConfigSafetime
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigSafetimeResp'
examples:
GetDrConfigSafetime200Example:
summary: Default getDrConfigSafetime 200 response
x-microcks-default: true
value:
safetimes:
- namespaceId: namespaceId
safetimeLagUs: 1
estimatedDataLossMs: 0.8008281904610115
safetimeEpochUs: 6
namespaceName: namespaceName
safetimeSkewUs: 5
- namespaceId: namespaceId
safetimeLagUs: 1
estimatedDataLossMs: 0.8008281904610115
safetimeEpochUs: 6
namespaceName: namespaceName
safetimeSkewUs: 5
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Get Disaster Recovery Config Safetime
tags:
- Disaster Recovery
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/set_dbs:
put:
description: 'WARNING: This is a preview API that could change.'
operationId: setDatabasesDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigSetDatabasesForm'
examples:
SetDatabasesDrConfigRequestExample:
summary: Default setDatabasesDrConfig request
x-microcks-default: true
value:
dbs: '["000033df000030008000000000004006", "000033df00003000800000000000400b"]'
description: Disaster Recovery Set Databases Form Data
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
SetDatabasesDrConfig200Example:
summary: Default setDatabasesDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Set Databases in Disaster Recovery Config
tags:
- Disaster Recovery
x-codegen-request-body-name: disaster_recovery_set_databases_form_data
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/set_tables:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: setTablesDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigSetTablesForm'
examples:
SetTablesDrConfigRequestExample:
summary: Default setTablesDrConfig request
x-microcks-default: true
value:
tables: '["000033df000030008000000000004006", "000033df00003000800000000000400b"]'
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
autoIncludeIndexTables: true
description: Disaster Recovery Set Tables Form Data
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
SetTablesDrConfig200Example:
summary: Default setTablesDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Set Tables in Disaster Recovery Config
tags:
- Disaster Recovery
x-codegen-request-body-name: disaster_recovery_set_tables_form_data
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/switchover:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: switchoverDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DrConfigSwitchoverForm'
examples:
SwitchoverDrConfigRequestExample:
summary: Default switchoverDrConfig request
x-microcks-default: true
value:
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: Disaster Recovery Switchover Form Data
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
SwitchoverDrConfig200Example:
summary: Default switchoverDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Switchover a Disaster Recovery Config
tags:
- Disaster Recovery
x-codegen-request-body-name: disaster_recovery_switchover_form_data
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/api/v1/customers/{cUUID}/dr_configs/{drUUID}/sync:
post:
description: 'WARNING: This is a preview API that could change.'
operationId: syncDrConfig
parameters:
- in: path
name: cUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: path
name: drUUID
required: true
schema:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- in: query
name: request
schema: {}
example: example-request
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/YBPTask'
examples:
SyncDrConfig200Example:
summary: Default syncDrConfig 200 response
x-microcks-default: true
value:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
description: successful operation
security:
- apiKeyAuth: []
summary: YugabyteDB Anywhere Sync Disaster Recovery Config
tags:
- Disaster Recovery
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
schemas:
DrConfigFailoverForm:
description: drConfig failover form
example:
namespaceIdSafetimeEpochUsMap:
key: 0
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
drReplicaUniverseUuid:
description: New dr replica universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
namespaceIdSafetimeEpochUsMap:
additionalProperties:
format: int64
type: integer
description: A map from database ID to its safetime since epoch in micro-seconds to use during unplanned failover
type: object
example: {}
primaryUniverseUuid:
description: New primary universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
type: object
NamespaceSafetime:
example:
namespaceId: namespaceId
safetimeLagUs: 1
estimatedDataLossMs: 0.8008281904610115
safetimeEpochUs: 6
namespaceName: namespaceName
safetimeSkewUs: 5
properties:
estimatedDataLossMs:
format: double
type: number
example: 1.5
namespaceId:
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
namespaceName:
type: string
example: example-namespaceName
safetimeEpochUs:
format: int64
type: integer
example: 1000
safetimeLagUs:
format: int64
type: integer
example: 1000
safetimeSkewUs:
format: int64
type: integer
example: 1000
required:
- estimatedDataLossMs
- namespaceId
- namespaceName
- safetimeEpochUs
- safetimeLagUs
- safetimeSkewUs
type: object
DrConfigSetTablesForm:
description: dr config set tables form
example:
tables: '["000033df000030008000000000004006", "000033df00003000800000000000400b"]'
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
autoIncludeIndexTables: true
properties:
autoIncludeIndexTables:
description: Whether or not YBA should also include all index tables from any provided main tables.
type: boolean
example: true
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
tables:
description: Source universe table IDs
example: '["000033df000030008000000000004006", "000033df00003000800000000000400b"]'
items:
type: string
type: array
uniqueItems: true
type: object
DrConfigSafetimeResp:
description: Get DR config safetime response
example:
safetimes:
- namespaceId: namespaceId
safetimeLagUs: 1
estimatedDataLossMs: 0.8008281904610115
safetimeEpochUs: 6
namespaceName: namespaceName
safetimeSkewUs: 5
- namespaceId: namespaceId
safetimeLagUs: 1
estimatedDataLossMs: 0.8008281904610115
safetimeEpochUs: 6
namespaceName: namespaceName
safetimeSkewUs: 5
properties:
safetimes:
description: The list of current safetime for each database
items:
$ref: '#/components/schemas/NamespaceSafetime'
type: array
example:
- namespaceId: namespaceId
safetimeLagUs: 1
estimatedDataLossMs: 0.8008281904610115
safetimeEpochUs: 6
namespaceName: namespaceName
safetimeSkewUs: 5
type: object
XClusterNamespaceConfig:
example:
restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId: sourceNamespaceId
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime: 2022-12-12 13:07:18+00:00
sourceNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
status: Validated
properties:
backupUuid:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime:
description: Time of replication setup, ie, table added to the replication group on the target universe
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
restoreUuid:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId:
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceInfo:
$ref: '#/components/schemas/NamespaceInfoResp'
status:
description: Status
enum:
- Validated
- Running
- Updating
- Warning
- Error
- Bootstrapping
- Failed
type: string
example: Validated
targetNamespaceInfo:
$ref: '#/components/schemas/NamespaceInfoResp'
required:
- backupUuid
- restoreUuid
- sourceNamespaceId
type: object
RestartBootstrapParams:
description: Bootstrap parameters for restarting
example:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
properties:
backupRequestParams:
$ref: '#/components/schemas/BootstrapBackupParams'
required:
- backupRequestParams
type: object
YBPTask:
example:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
resourceUUID:
description: UUID of the resource being modified by the task
format: uuid
readOnly: true
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
taskUUID:
description: Task UUID
format: uuid
readOnly: true
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
type: object
DrConfigGetResp:
description: disaster recovery get response
example:
paused: true
replicationGroupName: replicationGroupName
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
xclusterConfigUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
drReplicaUniverseState: Unconfigured for DR
type: Basic
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
xclusterConfigsUuid:
- 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: UNKNOWN
tables:
- tables
- tables
modifyTime: 2022-12-12 13:07:18+00:00
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
drReplicaUniverseActive: true
state: Initializing
primaryUniverseState: Unconfigured for DR
tableDetails:
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
streamId: a9d2470786694dc4b34e0e58e592da9e
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationStatusErrors:
- Unknown error
- Unknown error
sourceTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
replicationSetupDone: true
restoreTime: 2022-12-12 13:07:18+00:00
bootstrapCreateTime: 2022-12-12 13:07:18+00:00
indexTable: true
tableId: 000033df000030008000000000004005
targetTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
needBootstrap: true
status: Validated
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
streamId: a9d2470786694dc4b34e0e58e592da9e
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationStatusErrors:
- Unknown error
- Unknown error
sourceTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
replicationSetupDone: true
restoreTime: 2022-12-12 13:07:18+00:00
bootstrapCreateTime: 2022-12-12 13:07:18+00:00
indexTable: true
tableId: 000033df000030008000000000004005
targetTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
needBootstrap: true
status: Validated
dbDetails:
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId: sourceNamespaceId
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime: 2022-12-12 13:07:18+00:00
sourceNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
status: Validated
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId: sourceNamespaceId
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime: 2022-12-12 13:07:18+00:00
sourceNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
status: Validated
pitrConfigs:
- dbName: dbName
updateTime: 2022-12-12 13:07:18+00:00
createdForDr: true
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
minRecoverTimeInMillis: 1
scheduleInterval: 5
tableType: YQL_TABLE_TYPE
customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
createTime: 2022-12-12 13:07:18+00:00
intermittentMinRecoverTimeInMillis: 0
maxRecoverTimeInMillis: 6
name: name
disabled: true
usedForXCluster: true
state: UNKNOWN
retentionPeriod: 5
- dbName: dbName
updateTime: 2022-12-12 13:07:18+00:00
createdForDr: true
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
minRecoverTimeInMillis: 1
scheduleInterval: 5
tableType: YQL_TABLE_TYPE
customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
createTime: 2022-12-12 13:07:18+00:00
intermittentMinRecoverTimeInMillis: 0
maxRecoverTimeInMillis: 6
name: name
disabled: true
usedForXCluster: true
state: UNKNOWN
retentionPeriod: 5
primaryUniverseActive: true
automaticDdlMode: true
dbs:
- dbs
- dbs
createTime: 2022-12-12 13:07:18+00:00
webhooks:
- uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
url: url
- uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
url: url
name: name
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
keyspacePending: keyspacePending
pitrRetentionPeriodSec: 2
pitrSnapshotIntervalSec: 7
status: Initialized
properties:
automaticDdlMode:
description: Whether the config is using automatic DDL replication mode.
type: boolean
example: true
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
createTime:
description: Create time of the DR config
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
dbDetails:
description: 'WARNING: This is a preview API that could change. List of db details in replication'
items:
$ref: '#/components/schemas/XClusterNamespaceConfig'
type: array
uniqueItems: true
example:
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId: sourceNamespaceId
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime: '2022-12-12T13:07:18+00:00'
sourceNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
status: Validated
dbs:
description: 'WARNING: This is a preview API that could change. List of db ids in replication'
items:
type: string
type: array
uniqueItems: true
example:
- example-dbs
drReplicaUniverseActive:
description: Whether the dr replica universe is active
type: boolean
example: true
drReplicaUniverseState:
description: 'WARNING: This is a preview API that could change. The replication status of the dr replica universe.'
enum:
- Unconfigured for DR
- Bootstrapping
- Receiving data, Ready for reads
- Switching to DR primary
- Universe marked as DR failed
type: string
example: Unconfigured for DR
drReplicaUniverseUuid:
description: DR Replica Universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
keyspacePending:
description: 'WARNING: This is a preview API that could change. The keyspace name that the current task is working on.'
type: string
example: example-key
modifyTime:
description: Last modify time of the DR config
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
name:
description: Disaster recovery config name
type: string
example: example-name
paused:
description: Whether the underlying xCluster config is paused
type: boolean
example: true
pitrConfigs:
description: 'WARNING: This is a preview API that could change. The list of PITR configs used for the underlying txn xCluster config'
items:
$ref: '#/components/schemas/PitrConfig'
type: array
example:
- dbName: dbName
updateTime: '2022-12-12T13:07:18+00:00'
createdForDr: true
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
minRecoverTimeInMillis: 1
scheduleInterval: 5
tableType: YQL_TABLE_TYPE
customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
createTime: '2022-12-12T13:07:18+00:00'
intermittentMinRecoverTimeInMillis: 0
maxRecoverTimeInMillis: 6
name: name
disabled: true
usedForXCluster: true
state: UNKNOWN
retentionPeriod: 5
pitrRetentionPeriodSec:
description: 'WARNING: This is a preview API that could change. PITR Retention Period in seconds'
format: int64
type: integer
example: 1000
pitrSnapshotIntervalSec:
description: 'WARNING: This is a preview API that could change. PITR Retention Period in seconds'
format: int64
type: integer
example: 1000
primaryUniverseActive:
description: Whether the primary universe is active
type: boolean
example: true
primaryUniverseState:
description: 'WARNING: This is a preview API that could change. The replication status of the primary universe.'
enum:
- Unconfigured for DR
- Ready to replicate
- Waiting for DR
- Replicating data
- Preparing for switchover
- Switching to DR replica
- Universe marked as DR failed
type: string
example: Unconfigured for DR
primaryUniverseUuid:
description: Primary Universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationGroupName:
description: Replication group name in the dr replica universe cluster config
type: string
example: example-replicationGroupName
state:
description: The state of the DR config
enum:
- Initializing
- Replicating
- Switchover in Progress
- Failover in Progress
- Halted
- Updating
- Failed
type: string
example: Initializing
status:
description: Status
enum:
- Initialized
- Running
- Updating
- DeletedUniverse
- DeletionFailed
- Failed
type: string
example: Initialized
tableDetails:
description: Details for each table in replication
items:
$ref: '#/components/schemas/XClusterTableConfig'
type: array
uniqueItems: true
example:
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
streamId: a9d2470786694dc4b34e0e58e592da9e
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationStatusErrors:
- Unknown error
- Unknown error
sourceTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
replicationSetupDone: true
restoreTime: '2022-12-12T13:07:18+00:00'
bootstrapCreateTime: '2022-12-12T13:07:18+00:00'
indexTable: true
tableId: 000033df000030008000000000004005
targetTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
needBootstrap: true
status: Validated
tableType:
description: The type of tables that are being replicated
enum:
- UNKNOWN
- YSQL
- YCQL
type: string
example: UNKNOWN
tables:
description: List of table ids in replication
items:
type: string
type: array
uniqueItems: true
example:
- example-tables
type:
description: Whether the config is basic, txn, or db scoped xCluster
enum:
- Basic
- Txn
- Db
type: string
example: Basic
uuid:
description: DR config UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
webhooks:
items:
$ref: '#/components/schemas/GetWebhookResponse'
type: array
example:
- uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
url: url
xclusterConfigUuid:
description: UUID of the underlying xCluster config that is managing the replication
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
xclusterConfigsUuid:
description: YbaApi Internal. The list of xCluster configs' uuids that belong to this dr config
items:
format: uuid
type: string
type: array
example:
- 046b6c7f-0b8a-43b9-b35d-6489e6daee91
required:
- webhooks
type: object
DrConfigSetDatabasesForm:
description: dr config set databases form
example:
dbs: '["000033df000030008000000000004006", "000033df00003000800000000000400b"]'
properties:
dbs:
description: 'WARNING: This is a preview API that could change. Source universe database IDs'
example: '["000033df000030008000000000004006", "000033df00003000800000000000400b"]'
items:
type: string
type: array
uniqueItems: true
type: object
XClusterTableConfig:
example:
restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
streamId: a9d2470786694dc4b34e0e58e592da9e
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationStatusErrors:
- Unknown error
- Unknown error
sourceTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
replicationSetupDone: true
restoreTime: 2022-12-12 13:07:18+00:00
bootstrapCreateTime: 2022-12-12 13:07:18+00:00
indexTable: true
tableId: 000033df000030008000000000004005
targetTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
needBootstrap: true
status: Validated
properties:
backupUuid:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
bootstrapCreateTime:
description: Time of the bootstrap of the table
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
indexTable:
description: YbaApi Internal. Whether this table is an index table and its main table is in replication
type: boolean
example: true
needBootstrap:
description: YbaApi Internal. Whether this table needs bootstrap process for replication setup
type: boolean
example: true
replicationSetupDone:
description: YbaApi Internal. Whether replication is set up for this table
type: boolean
example: true
replicationStatusErrors:
description: Short human readable replication status error messages
items:
enum:
- Unknown error
- Missing op ID
- Schema mismatch
- Missing table
- Uninitialized
- Auto flag config mismatch
- Source unreachable
- System error
type: string
type: array
uniqueItems: true
example:
- Unknown error
restoreTime:
description: Time of the last try to restore data to the target universe
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
restoreUuid:
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceTableInfo:
$ref: '#/components/schemas/TableInfoResp'
status:
description: Status
enum:
- Validated
- Running
- Updating
- Warning
- Error
- Bootstrapping
- Failed
- UnableToFetch
type: string
example: Validated
streamId:
description: Stream ID if replication is setup; bootstrap ID if the table is bootstrapped
example: a9d2470786694dc4b34e0e58e592da9e
type: string
tableId:
description: Table ID
example: 000033df000030008000000000004005
type: string
targetTableInfo:
$ref: '#/components/schemas/TableInfoResp'
required:
- backupUuid
- restoreUuid
type: object
PitrConfig:
description: PITR config created on the universe
example:
dbName: dbName
updateTime: 2022-12-12 13:07:18+00:00
createdForDr: true
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
minRecoverTimeInMillis: 1
scheduleInterval: 5
tableType: YQL_TABLE_TYPE
customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
createTime: 2022-12-12 13:07:18+00:00
intermittentMinRecoverTimeInMillis: 0
maxRecoverTimeInMillis: 6
name: name
disabled: true
usedForXCluster: true
state: UNKNOWN
retentionPeriod: 5
properties:
createTime:
description: Create time of the PITR config
example: 2022-12-12 13:07:18+00:00
format: date-time
readOnly: true
type: string
createdForDr:
description: Created for DR
readOnly: true
type: boolean
example: true
customerUUID:
description: Customer UUID of this config
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
dbName:
description: DB Name
type: string
example: example-dbName
disabled:
description: Whether the PITR config is disabled
readOnly: true
type: boolean
example: true
intermittentMinRecoverTimeInMillis:
description: Intermittent min recovery time in millis if retention period is increased
format: int64
type: integer
example: 1000
maxRecoverTimeInMillis:
format: int64
type: integer
example: 10
minRecoverTimeInMillis:
format: int64
type: integer
example: 1000
name:
description: PITR config name
type: string
example: example-name
retentionPeriod:
description: Retention Period in seconds
format: int64
type: integer
example: 1000
scheduleInterval:
description: Interval between snasphots in seconds
format: int64
type: integer
example: 1000
state:
enum:
- UNKNOWN
- CREATING
- COMPLETE
- DELETING
- DELETED
- FAILED
- CANCELLED
- RESTORING
- RESTORED
type: string
example: UNKNOWN
tableType:
description: Table Type
enum:
- YQL_TABLE_TYPE
- REDIS_TABLE_TYPE
- PGSQL_TABLE_TYPE
- TRANSACTION_STATUS_TABLE_TYPE
type: string
example: YQL_TABLE_TYPE
updateTime:
description: Update time of the PITR con
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
usedForXCluster:
readOnly: true
type: boolean
example: true
uuid:
description: PITR config UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
required:
- maxRecoverTimeInMillis
- minRecoverTimeInMillis
- state
type: object
DrConfigCreateForm:
description: drConfig create form
example:
targetUniverseUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
dryRun: true
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
dbs: '["0000412b000030008000000000000000", "0000412b000030008000000000000001"]'
name: Dr-config1
sourceUniverseUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
pitrParams:
snapshotIntervalSec: 1
retentionPeriodSec: 6
properties:
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
dbs:
description: Source Universe DB IDs
example: '["0000412b000030008000000000000000", "0000412b000030008000000000000001"]'
items:
type: string
type: array
uniqueItems: true
dryRun:
description: Run the pre-checks without actually running the subtasks
type: boolean
example: true
name:
description: Name
example: Dr-config1
type: string
pitrParams:
$ref: '#/components/schemas/PitrParams'
sourceUniverseUUID:
description: Source Universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetUniverseUUID:
description: Target Universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
required:
- dbs
- name
- sourceUniverseUUID
- targetUniverseUUID
type: object
DrConfigEditForm:
description: drConfig edit form
example:
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
webhookUrls:
- webhookUrls
- webhookUrls
pitrParams:
snapshotIntervalSec: 1
retentionPeriodSec: 6
properties:
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
pitrParams:
$ref: '#/components/schemas/PitrParams'
webhookUrls:
description: List of urls for webhook
items:
type: string
type: array
example:
- https://example.com
type: object
TableInfoResp:
description: Table information response
example:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
properties:
colocated:
description: Flag, indicating colocated table
type: boolean
example: true
colocationParentId:
description: Colocation parent id
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
indexTableIDs:
description: Index Table IDs of main table
items:
type: string
type: array
example:
- example-indexTableIDs
keySpace:
description: Keyspace
type: string
example: example-key
mainTableUUID:
description: Main Table UUID of index tables
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
nameSpace:
description: Namespace or Schema
type: string
example: example-nameSpace
parentTableUUID:
description: Parent Table UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
pgSchemaName:
description: Postgres schema name of the table
example: public
type: string
relationType:
description: Relation type
enum:
- SYSTEM_TABLE_RELATION
- USER_TABLE_RELATION
- INDEX_TABLE_RELATION
- MATVIEW_TABLE_RELATION
- COLOCATED_PARENT_TABLE_RELATION
type: string
example: SYSTEM_TABLE_RELATION
sizeBytes:
description: SST size in bytes
format: double
readOnly: true
type: number
example: 1.5
tableID:
description: Table ID
readOnly: true
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableName:
description: Table name
type: string
example: example-tableName
tableSpace:
description: Table space
type: string
example: example-tableSpace
tableType:
description: Table type
enum:
- YQL_TABLE_TYPE
- REDIS_TABLE_TYPE
- PGSQL_TABLE_TYPE
- TRANSACTION_STATUS_TABLE_TYPE
type: string
example: YQL_TABLE_TYPE
tableUUID:
description: Table UUID
format: uuid
readOnly: true
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
walSizeBytes:
description: WAL size in bytes
format: double
readOnly: true
type: number
example: 1.5
type: object
DrConfigRestartForm:
description: dr config restart form
example:
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
dbs: '["0000412b000030008000000000000000", "0000412b000030008000000000000001"]'
properties:
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
dbs:
description: Primary Universe DB IDs
example: '["0000412b000030008000000000000000", "0000412b000030008000000000000001"]'
items:
type: string
type: array
uniqueItems: true
required:
- dbs
type: object
DrConfigSwitchoverForm:
description: drConfig failover form
example:
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
drReplicaUniverseUuid:
description: New dr replica universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid:
description: New primary universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
type: object
BootstrapBackupParams:
description: Backup parameters for bootstrapping
example:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
properties:
parallelism:
description: Number of concurrent commands used by yb_backup (not ybc) to run on nodes over SSH
format: int32
type: integer
example: 100
storageConfigUUID:
description: Storage configuration UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
required:
- storageConfigUUID
type: object
PitrParams:
description: PITR parameters
example:
snapshotIntervalSec: 1
retentionPeriodSec: 6
properties:
retentionPeriodSec:
description: Retention period of a snapshot in seconds
format: int64
type: integer
example: 1000
snapshotIntervalSec:
description: Deprecated since YBA version 2024.2.0.0. Time interval between snapshots in seconds
format: int64
type: integer
example: 1000
type: object
NamespaceInfoResp:
description: Namespace information response
example:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
name:
description: Namespace name
type: string
example: example-name
namespaceUUID:
description: Namespace UUID
format: uuid
readOnly: true
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType:
description: Table type
enum:
- YQL_TABLE_TYPE
- REDIS_TABLE_TYPE
- PGSQL_TABLE_TYPE
- TRANSACTION_STATUS_TABLE_TYPE
type: string
example: YQL_TABLE_TYPE
type: object
GetWebhookResponse:
description: Webhook get response
example:
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
url: url
properties:
url:
description: Webhook url
type: string
example: https://example.com
uuid:
description: Webhook UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
type: object
DrConfigReplaceReplicaForm:
description: drConfig edit form
example:
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
drReplicaUniverseUuid:
description: New dr replica universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid:
description: The current primary universe UUID
format: uuid
type: string
example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
type: object
DrConfigFailoverForm_2:
description: drConfig failover form
example:
namespaceIdSafetimeEpochUsMap:
key: 0
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
drReplicaUniverseUuid:
description: New dr replica universe UUID
format: uuid
type: string
namespaceIdSafetimeEpochUsMap:
additionalProperties:
format: int64
type: integer
description: A map from database ID to its safetime since epoch in micro-seconds to use during unplanned failover
type: object
primaryUniverseUuid:
description: New primary universe UUID
format: uuid
type: string
type: object
NamespaceSafetime_2:
example:
namespaceId: namespaceId
safetimeLagUs: 1
estimatedDataLossMs: 0.8008281904610115
safetimeEpochUs: 6
namespaceName: namespaceName
safetimeSkewUs: 5
properties:
estimatedDataLossMs:
format: double
type: number
namespaceId:
type: string
namespaceName:
type: string
safetimeEpochUs:
format: int64
type: integer
safetimeLagUs:
format: int64
type: integer
safetimeSkewUs:
format: int64
type: integer
required:
- estimatedDataLossMs
- namespaceId
- namespaceName
- safetimeEpochUs
- safetimeLagUs
- safetimeSkewUs
type: object
DrConfigSetTablesForm_2:
description: dr config set tables form
example:
tables: '["000033df000030008000000000004006", "000033df00003000800000000000400b"]'
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
autoIncludeIndexTables: true
properties:
autoIncludeIndexTables:
description: Whether or not YBA should also include all index tables from any provided main tables.
type: boolean
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
tables:
description: Source universe table IDs
example: '["000033df000030008000000000004006", "000033df00003000800000000000400b"]'
items:
type: string
type: array
uniqueItems: true
type: object
DrConfigSafetimeResp_2:
description: Get DR config safetime response
example:
safetimes:
- namespaceId: namespaceId
safetimeLagUs: 1
estimatedDataLossMs: 0.8008281904610115
safetimeEpochUs: 6
namespaceName: namespaceName
safetimeSkewUs: 5
- namespaceId: namespaceId
safetimeLagUs: 1
estimatedDataLossMs: 0.8008281904610115
safetimeEpochUs: 6
namespaceName: namespaceName
safetimeSkewUs: 5
properties:
safetimes:
description: The list of current safetime for each database
items:
$ref: '#/components/schemas/NamespaceSafetime_2'
type: array
type: object
XClusterNamespaceConfig_2:
example:
restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId: sourceNamespaceId
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime: 2022-12-12 13:07:18+00:00
sourceNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
status: Validated
properties:
backupUuid:
format: uuid
type: string
replicationSetupTime:
description: Time of replication setup, ie, table added to the replication group on the target universe
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
restoreUuid:
format: uuid
type: string
sourceNamespaceId:
type: string
sourceNamespaceInfo:
$ref: '#/components/schemas/NamespaceInfoResp_2'
status:
description: Status
enum:
- Validated
- Running
- Updating
- Warning
- Error
- Bootstrapping
- Failed
type: string
targetNamespaceInfo:
$ref: '#/components/schemas/NamespaceInfoResp_2'
required:
- backupUuid
- restoreUuid
- sourceNamespaceId
type: object
YBPTask_2:
example:
taskUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
resourceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
resourceUUID:
description: UUID of the resource being modified by the task
format: uuid
readOnly: true
type: string
taskUUID:
description: Task UUID
format: uuid
readOnly: true
type: string
type: object
DrConfigGetResp_2:
description: disaster recovery get response
example:
paused: true
replicationGroupName: replicationGroupName
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
xclusterConfigUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
drReplicaUniverseState: Unconfigured for DR
type: Basic
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
xclusterConfigsUuid:
- 046b6c7f-0b8a-43b9-b35d-6489e6daee91
- 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: UNKNOWN
tables:
- tables
- tables
modifyTime: 2022-12-12 13:07:18+00:00
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
drReplicaUniverseActive: true
state: Initializing
primaryUniverseState: Unconfigured for DR
tableDetails:
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
streamId: a9d2470786694dc4b34e0e58e592da9e
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationStatusErrors:
- Unknown error
- Unknown error
sourceTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
replicationSetupDone: true
restoreTime: 2022-12-12 13:07:18+00:00
bootstrapCreateTime: 2022-12-12 13:07:18+00:00
indexTable: true
tableId: 000033df000030008000000000004005
targetTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
needBootstrap: true
status: Validated
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
streamId: a9d2470786694dc4b34e0e58e592da9e
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationStatusErrors:
- Unknown error
- Unknown error
sourceTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
replicationSetupDone: true
restoreTime: 2022-12-12 13:07:18+00:00
bootstrapCreateTime: 2022-12-12 13:07:18+00:00
indexTable: true
tableId: 000033df000030008000000000004005
targetTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
needBootstrap: true
status: Validated
dbDetails:
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId: sourceNamespaceId
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime: 2022-12-12 13:07:18+00:00
sourceNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
status: Validated
- restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
sourceNamespaceId: sourceNamespaceId
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationSetupTime: 2022-12-12 13:07:18+00:00
sourceNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
targetNamespaceInfo:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
status: Validated
pitrConfigs:
- dbName: dbName
updateTime: 2022-12-12 13:07:18+00:00
createdForDr: true
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
minRecoverTimeInMillis: 1
scheduleInterval: 5
tableType: YQL_TABLE_TYPE
customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
createTime: 2022-12-12 13:07:18+00:00
intermittentMinRecoverTimeInMillis: 0
maxRecoverTimeInMillis: 6
name: name
disabled: true
usedForXCluster: true
state: UNKNOWN
retentionPeriod: 5
- dbName: dbName
updateTime: 2022-12-12 13:07:18+00:00
createdForDr: true
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
minRecoverTimeInMillis: 1
scheduleInterval: 5
tableType: YQL_TABLE_TYPE
customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
createTime: 2022-12-12 13:07:18+00:00
intermittentMinRecoverTimeInMillis: 0
maxRecoverTimeInMillis: 6
name: name
disabled: true
usedForXCluster: true
state: UNKNOWN
retentionPeriod: 5
primaryUniverseActive: true
automaticDdlMode: true
dbs:
- dbs
- dbs
createTime: 2022-12-12 13:07:18+00:00
webhooks:
- uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
url: url
- uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
url: url
name: name
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
keyspacePending: keyspacePending
pitrRetentionPeriodSec: 2
pitrSnapshotIntervalSec: 7
status: Initialized
properties:
automaticDdlMode:
description: Whether the config is using automatic DDL replication mode.
type: boolean
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
createTime:
description: Create time of the DR config
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
dbDetails:
description: 'WARNING: This is a preview API that could change. List of db details in replication'
items:
$ref: '#/components/schemas/XClusterNamespaceConfig_2'
type: array
uniqueItems: true
dbs:
description: 'WARNING: This is a preview API that could change. List of db ids in replication'
items:
type: string
type: array
uniqueItems: true
drReplicaUniverseActive:
description: Whether the dr replica universe is active
type: boolean
drReplicaUniverseState:
description: 'WARNING: This is a preview API that could change. The replication status of the dr replica universe.'
enum:
- Unconfigured for DR
- Bootstrapping
- Receiving data, Ready for reads
- Switching to DR primary
- Universe marked as DR failed
type: string
drReplicaUniverseUuid:
description: DR Replica Universe UUID
format: uuid
type: string
keyspacePending:
description: 'WARNING: This is a preview API that could change. The keyspace name that the current task is working on.'
type: string
modifyTime:
description: Last modify time of the DR config
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
name:
description: Disaster recovery config name
type: string
paused:
description: Whether the underlying xCluster config is paused
type: boolean
pitrConfigs:
description: 'WARNING: This is a preview API that could change. The list of PITR configs used for the underlying txn xCluster config'
items:
$ref: '#/components/schemas/PitrConfig_2'
type: array
pitrRetentionPeriodSec:
description: 'WARNING: This is a preview API that could change. PITR Retention Period in seconds'
format: int64
type: integer
pitrSnapshotIntervalSec:
description: 'WARNING: This is a preview API that could change. PITR Retention Period in seconds'
format: int64
type: integer
primaryUniverseActive:
description: Whether the primary universe is active
type: boolean
primaryUniverseState:
description: 'WARNING: This is a preview API that could change. The replication status of the primary universe.'
enum:
- Unconfigured for DR
- Ready to replicate
- Waiting for DR
- Replicating data
- Preparing for switchover
- Switching to DR replica
- Universe marked as DR failed
type: string
primaryUniverseUuid:
description: Primary Universe UUID
format: uuid
type: string
replicationGroupName:
description: Replication group name in the dr replica universe cluster config
type: string
state:
description: The state of the DR config
enum:
- Initializing
- Replicating
- Switchover in Progress
- Failover in Progress
- Halted
- Updating
- Failed
type: string
status:
description: Status
enum:
- Initialized
- Running
- Updating
- DeletedUniverse
- DeletionFailed
- Failed
type: string
tableDetails:
description: Details for each table in replication
items:
$ref: '#/components/schemas/XClusterTableConfig_2'
type: array
uniqueItems: true
tableType:
description: The type of tables that are being replicated
enum:
- UNKNOWN
- YSQL
- YCQL
type: string
tables:
description: List of table ids in replication
items:
type: string
type: array
uniqueItems: true
type:
description: Whether the config is basic, txn, or db scoped xCluster
enum:
- Basic
- Txn
- Db
type: string
uuid:
description: DR config UUID
format: uuid
type: string
webhooks:
items:
$ref: '#/components/schemas/GetWebhookResponse_2'
type: array
xclusterConfigUuid:
description: UUID of the underlying xCluster config that is managing the replication
format: uuid
type: string
xclusterConfigsUuid:
description: YbaApi Internal. The list of xCluster configs' uuids that belong to this dr config
items:
format: uuid
type: string
type: array
required:
- webhooks
type: object
XClusterTableConfig_2:
example:
restoreUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
streamId: a9d2470786694dc4b34e0e58e592da9e
backupUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
replicationStatusErrors:
- Unknown error
- Unknown error
sourceTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
replicationSetupDone: true
restoreTime: 2022-12-12 13:07:18+00:00
bootstrapCreateTime: 2022-12-12 13:07:18+00:00
indexTable: true
tableId: 000033df000030008000000000004005
targetTableInfo:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
needBootstrap: true
status: Validated
properties:
backupUuid:
format: uuid
type: string
bootstrapCreateTime:
description: Time of the bootstrap of the table
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
indexTable:
description: YbaApi Internal. Whether this table is an index table and its main table is in replication
type: boolean
needBootstrap:
description: YbaApi Internal. Whether this table needs bootstrap process for replication setup
type: boolean
replicationSetupDone:
description: YbaApi Internal. Whether replication is set up for this table
type: boolean
replicationStatusErrors:
description: Short human readable replication status error messages
items:
enum:
- Unknown error
- Missing op ID
- Schema mismatch
- Missing table
- Uninitialized
- Auto flag config mismatch
- Source unreachable
- System error
type: string
type: array
uniqueItems: true
restoreTime:
description: Time of the last try to restore data to the target universe
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
restoreUuid:
format: uuid
type: string
sourceTableInfo:
$ref: '#/components/schemas/TableInfoResp_2'
status:
description: Status
enum:
- Validated
- Running
- Updating
- Warning
- Error
- Bootstrapping
- Failed
- UnableToFetch
type: string
streamId:
description: Stream ID if replication is setup; bootstrap ID if the table is bootstrapped
example: a9d2470786694dc4b34e0e58e592da9e
type: string
tableId:
description: Table ID
example: 000033df000030008000000000004005
type: string
targetTableInfo:
$ref: '#/components/schemas/TableInfoResp_2'
required:
- backupUuid
- restoreUuid
type: object
PitrConfig_2:
description: PITR config created on the universe
example:
dbName: dbName
updateTime: 2022-12-12 13:07:18+00:00
createdForDr: true
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
minRecoverTimeInMillis: 1
scheduleInterval: 5
tableType: YQL_TABLE_TYPE
customerUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
createTime: 2022-12-12 13:07:18+00:00
intermittentMinRecoverTimeInMillis: 0
maxRecoverTimeInMillis: 6
name: name
disabled: true
usedForXCluster: true
state: UNKNOWN
retentionPeriod: 5
properties:
createTime:
description: Create time of the PITR config
example: 2022-12-12 13:07:18+00:00
format: date-time
readOnly: true
type: string
createdForDr:
description: Created for DR
readOnly: true
type: boolean
customerUUID:
description: Customer UUID of this config
format: uuid
type: string
dbName:
description: DB Name
type: string
disabled:
description: Whether the PITR config is disabled
readOnly: true
type: boolean
intermittentMinRecoverTimeInMillis:
description: Intermittent min recovery time in millis if retention period is increased
format: int64
type: integer
maxRecoverTimeInMillis:
format: int64
type: integer
minRecoverTimeInMillis:
format: int64
type: integer
name:
description: PITR config name
type: string
retentionPeriod:
description: Retention Period in seconds
format: int64
type: integer
scheduleInterval:
description: Interval between snasphots in seconds
format: int64
type: integer
state:
enum:
- UNKNOWN
- CREATING
- COMPLETE
- DELETING
- DELETED
- FAILED
- CANCELLED
- RESTORING
- RESTORED
type: string
tableType:
description: Table Type
enum:
- YQL_TABLE_TYPE
- REDIS_TABLE_TYPE
- PGSQL_TABLE_TYPE
- TRANSACTION_STATUS_TABLE_TYPE
type: string
updateTime:
description: Update time of the PITR con
example: 2022-12-12 13:07:18+00:00
format: date-time
type: string
usedForXCluster:
readOnly: true
type: boolean
uuid:
description: PITR config UUID
format: uuid
type: string
required:
- maxRecoverTimeInMillis
- minRecoverTimeInMillis
- state
type: object
DrConfigCreateForm_2:
description: drConfig create form
example:
targetUniverseUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
dryRun: true
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
dbs: '["0000412b000030008000000000000000", "0000412b000030008000000000000001"]'
name: Dr-config1
sourceUniverseUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
pitrParams:
snapshotIntervalSec: 1
retentionPeriodSec: 6
properties:
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
dbs:
description: Source Universe DB IDs
example: '["0000412b000030008000000000000000", "0000412b000030008000000000000001"]'
items:
type: string
type: array
uniqueItems: true
dryRun:
description: Run the pre-checks without actually running the subtasks
type: boolean
name:
description: Name
example: Dr-config1
type: string
pitrParams:
$ref: '#/components/schemas/PitrParams_2'
sourceUniverseUUID:
description: Source Universe UUID
format: uuid
type: string
targetUniverseUUID:
description: Target Universe UUID
format: uuid
type: string
required:
- dbs
- name
- sourceUniverseUUID
- targetUniverseUUID
type: object
DrConfigEditForm_2:
description: drConfig edit form
example:
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
webhookUrls:
- webhookUrls
- webhookUrls
pitrParams:
snapshotIntervalSec: 1
retentionPeriodSec: 6
properties:
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
pitrParams:
$ref: '#/components/schemas/PitrParams_2'
webhookUrls:
description: List of urls for webhook
items:
type: string
type: array
type: object
TableInfoResp_2:
description: Table information response
example:
relationType: SYSTEM_TABLE_RELATION
colocated: true
walSizeBytes: 3.616076749251911
indexTableIDs:
- indexTableIDs
- indexTableIDs
pgSchemaName: public
sizeBytes: 9.301444243932576
tableName: tableName
tableSpace: tableSpace
tableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
mainTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parentTableUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
tableType: YQL_TABLE_TYPE
keySpace: keySpace
tableID: tableID
nameSpace: nameSpace
colocationParentId: colocationParentId
properties:
colocated:
description: Flag, indicating colocated table
type: boolean
colocationParentId:
description: Colocation parent id
type: string
indexTableIDs:
description: Index Table IDs of main table
items:
type: string
type: array
keySpace:
description: Keyspace
type: string
mainTableUUID:
description: Main Table UUID of index tables
format: uuid
type: string
nameSpace:
description: Namespace or Schema
type: string
parentTableUUID:
description: Parent Table UUID
format: uuid
type: string
pgSchemaName:
description: Postgres schema name of the table
example: public
type: string
relationType:
description: Relation type
enum:
- SYSTEM_TABLE_RELATION
- USER_TABLE_RELATION
- INDEX_TABLE_RELATION
- MATVIEW_TABLE_RELATION
- COLOCATED_PARENT_TABLE_RELATION
type: string
sizeBytes:
description: SST size in bytes
format: double
readOnly: true
type: number
tableID:
description: Table ID
readOnly: true
type: string
tableName:
description: Table name
type: string
tableSpace:
description: Table space
type: string
tableType:
description: Table type
enum:
- YQL_TABLE_TYPE
- REDIS_TABLE_TYPE
- PGSQL_TABLE_TYPE
- TRANSACTION_STATUS_TABLE_TYPE
type: string
tableUUID:
description: Table UUID
format: uuid
readOnly: true
type: string
walSizeBytes:
description: WAL size in bytes
format: double
readOnly: true
type: number
type: object
DrConfigSwitchoverForm_2:
description: drConfig failover form
example:
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
drReplicaUniverseUuid:
description: New dr replica universe UUID
format: uuid
type: string
primaryUniverseUuid:
description: New primary universe UUID
format: uuid
type: string
type: object
BootstrapBackupParams_2:
description: Backup parameters for bootstrapping
example:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
properties:
parallelism:
description: Number of concurrent commands used by yb_backup (not ybc) to run on nodes over SSH
format: int32
type: integer
storageConfigUUID:
description: Storage configuration UUID
format: uuid
type: string
required:
- storageConfigUUID
type: object
PitrParams_2:
description: PITR parameters
example:
snapshotIntervalSec: 1
retentionPeriodSec: 6
properties:
retentionPeriodSec:
description: Retention period of a snapshot in seconds
format: int64
type: integer
snapshotIntervalSec:
description: Deprecated since YBA version 2024.2.0.0. Time interval between snapshots in seconds
format: int64
type: integer
type: object
NamespaceInfoResp_2:
description: Namespace information response
example:
tableType: YQL_TABLE_TYPE
name: name
namespaceUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
name:
description: Namespace name
type: string
namespaceUUID:
description: Namespace UUID
format: uuid
readOnly: true
type: string
tableType:
description: Table type
enum:
- YQL_TABLE_TYPE
- REDIS_TABLE_TYPE
- PGSQL_TABLE_TYPE
- TRANSACTION_STATUS_TABLE_TYPE
type: string
type: object
GetWebhookResponse_2:
description: Webhook get response
example:
uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
url: url
properties:
url:
description: Webhook url
type: string
uuid:
description: Webhook UUID
format: uuid
type: string
type: object
DrConfigReplaceReplicaForm_2:
description: drConfig edit form
example:
bootstrapParams:
backupRequestParams:
storageConfigUUID: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
parallelism: 0
drReplicaUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
primaryUniverseUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
properties:
bootstrapParams:
$ref: '#/components/schemas/RestartBootstrapParams'
drReplicaUniverseUuid:
description: New dr replica universe UUID
format: uuid
type: string
primaryUniverseUuid:
description: The current primary universe UUID
format: uuid
type: string
type: object
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key obtained from the YugabyteDB Aeon UI under User Profile > API Keys. Pass the key as a Bearer token in the Authorization header.
externalDocs:
description: YugabyteDB Aeon REST API Documentation
url: https://docs.yugabyte.com/stable/yugabyte-cloud/managed-automation/managed-api/