Create AWS Protection Policy
API to create AWS protection policy
Path Parameters
- accountId int64 required
Cloud Rewind account ID.
- projectId string required
Cloud Rewind project ID.
- cloudAssemblyId int64 required
AWS cloud assembly ID.
- application/json
Request Body required
- policyTemplateId int64
ID of the AWS policy template to be used for the protection policy.
This is optional. If provided, it must be a valid identifier for the policy template. No other details are required for the Policy Create request except policy activation. - name string
Possible values:
>= 3and<= 50, Value must match regular expression^[a-zA-Z][a-zA-Z0-9-]*$Name of the policy template.
Constraints: It must begin with a letter and may include only letters, numbers, and hyphens. - description string
Possible values:
<= 1000Description of the policy template.
- frequencyType string
Possible values: [
fifteen-minutes,thirty-minutes,hourly,two-hours,three-hours,four-hours,six-hours,eight-hours,twelve-hours,daily,weekly,monthly,yearly,custom]Frequency type for the policy.
Value Description fifteen-minutes This defines a protection schedule that occurs every 15 minutes. thirty-minutes This defines a protection schedule that occurs every 30 minutes. hourly This defines a protection schedule that occurs every hour. two-hours This defines a protection schedule that occurs every 2 hours. three-hours This defines a protection schedule that occurs every 3 hours. four-hours This defines a protection schedule that occurs every 4 hours. six-hours This defines a protection schedule that occurs every 6 hours. eight-hours This defines a protection schedule that occurs every 8 hours. twelve-hours This defines a protection schedule that occurs every 12 hours. daily This defines a protection schedule that occurs every day. weekly This defines a protection schedule that occurs every week. monthly This defines a protection schedule that occurs every month. yearly This defines a protection schedule that occurs every year. Custom This defines that create a custom protection schedule - timeZone string
Specifies the time zone to be used in interpreting schedule.
The value of this field must be a time zone name from the Tz database
Example: "America/New_York" frequencyDetails object
daysOfWeek string[]Possible values: [
MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY,SATURDAY,SUNDAY]Days of the week (e.g., SUNDAY, MONDAY).
months string[]Possible values: [
JANUARY,FEBRUARY,MARCH,APRIL,MAY,JUNE,JULY,AUGUST,SEPTEMBER,OCTOBER,NOVEMBER,DECEMBER]Months of the year (e.g., JANUARY, FEBRUARY).
daysOfMonth int32[]Days of the month (1 to 31).
hours int32[]Hours of the day (0 to 23).
offset int32Delays the defined scheduled execution time (in minutes), increasing in 5-minute steps from 0 to 55.
minutes int32Minutes of the hour (16 to 59).
- retentionCount int32
Possible values:
>= 3and<= 3500Specifies the number of protections to retain.
- replicaRetentionCount int32
Possible values:
>= 3and<= 3500Specifies the number of replications to retain.
- policyActivation string required
Possible values: [
immediate,by-policy]Activation option for the protection policy.
Value Description immediate Once the policy is created, it is activated immediately and triggers one protection run right away. by-policy The scheduled policy triggers at the specified date and time.
- 201
- 401
- 403
- 404
- 409
- 412
- 500
Created
- application/json
- Schema
- Example (from schema)
Schema
- accountId int64
Cloud Rewind account ID.
- projectId string
Cloud Rewind project ID.
- id int64
Unique identifier for the protection policy
- name string
Name of the protection policy
- description string
Description of the protection policy
- frequencyType string
AWS resource type for the protection policy
- timeZone string
Time zone for the protection policy schedule
frequencyDetails object
Details about the frequency configuration of the policy template
daysOfWeek string[]Days of the week
months string[]Months of the year
daysOfMonth int32[]Days of the month
hours int32[]Hours of the day
offset int32Delays the defined scheduled execution time (in minutes)
minutes int32Minutes of the hour
- status string
Possible values: [
enabled,disabled,paused,error,schedule-create-failed,delete-pending,delete-in-progress,delete-snapshots,delete-resources,delete-failed]Status of the policy.
Value Description enabled The policy is enabled. disabled The policy is disabled. paused The policy is paused. error The policy is in error state. schedule-create-failed The policy scheduler creation failed. delete-pending The policy delete process is pending. delete-in-progress The policy delete process is in progress. delete-snapshots The policy delete process is deleting snapshots. delete-resources The policy delete process is deleting resources. delete-failed The policy delete process failed. - createdAt date-time
Timestamp indicating when the protection policy was created
- retentionCount int32
Number of backups to retain
replicationPolicies object[]
List of replication policies associated with the protection policy
cloudConnectionId int64AWS replication policy configured cloud connection Id
region stringAWS replication policy configured region
status stringPossible values: [
enabled,disabled,paused,error,schedule-create-failed,delete-pending,delete-in-progress,delete-snapshots,delete-resources,delete-failed]Status of the policy.
Value Description enabled The policy is enabled. disabled The policy is disabled. paused The policy is paused. error The policy is in error state. schedule-create-failed The policy scheduler creation failed. delete-pending The policy delete process is pending. delete-in-progress The policy delete process is in progress. delete-snapshots The policy delete process is deleting snapshots. delete-resources The policy delete process is deleting resources. delete-failed The policy delete process failed. replicaRetentionCount int32Number of replica backups to retain in the configured region
- policyActivation string
Activation status of the protection policy
{
"accountId": 0,
"projectId": "string",
"id": 0,
"name": "string",
"description": "string",
"frequencyType": "string",
"timeZone": "string",
"frequencyDetails": {
"daysOfWeek": [
"string"
],
"months": [
"string"
],
"daysOfMonth": [
0
],
"hours": [
0
],
"offset": 0,
"minutes": 0
},
"status": "enabled",
"createdAt": "2025-10-23",
"retentionCount": 0,
"replicationPolicies": [
{
"cloudConnectionId": 0,
"region": "string",
"status": "enabled",
"replicaRetentionCount": 0
}
],
"policyActivation": "string"
}
Unauthorized
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Forbidden
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Not Found
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Conflict
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Precondition Failed
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Internal Server Error
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}