Resource Changes

The topic provides information on operation, parameter and schema changes made in the Veeam Backup for AWS REST API 1.2-rev0.

Behavior Changes

The following behavior changes were introduced:

• The password request body parameter of the UserCreateSpec schema is not required if you specify the External value in the accountType parameter. This means that, if the user identity is received from the Identity Provider, you do not need to specify a password when creating a new user.
• The type of the hours request body parameter in the DailySchedule schema changed from boolean to integer($int32). This means that instead of specifying an array of true and false values, you must specify an array of hours (from 0 to 23) when a backup policy must run.

Collection Changes

The following changes in resource collections were made:

• The /policy resource collection that included both EC2 policy and RDS policy resources was depricated and replaced by the /rds/policies and /virtualMachines/policies collections.
• The ​/vmRestorePoints collection was replaced by the /virtualMachines/restorePoints collection.

For more information on new resource collections, see New Resources.

Path Parameter Changes

The following changes in path parameters of HTTP requests were made:

• Renamed the amazonAccountId path parameter to IAMRoleId in the following operations:

• POST ​/api​/v1​/accounts​/amazon​/{IAMRoleId}​/validateDelete — Validate Removing of IAM Role.
• GET ​/api​/v1​/accounts​/amazon​/{IAMRoleId} — Get IAM Role Data.
• PUT ​/api​/v1​/accounts​/amazon​/{IAMRoleId} — Modify IAM Role.
• DELETE ​/api​/v1​/accounts​/amazon​/{IAMRoleId} — Remove IAM Role.
• POST ​/api​/v1​/accounts​/amazon​/{IAMRoleId}​/rescan — Infrastructure Rescan for IAM Role.

• Renamed the userId path parameter to userName in the following operations:

• GET ​/api​/v1​/users​/{userName} — Get User Data.
• PUT ​/api​/v1​/users​/{userName} — Modify User Account.
• DELETE ​/api​/v1​/users​/{userName} — Remove User Account.
• POST ​/api​/v1​/users​/{userName}​/enableMfa — Get MFA Secret Key.
• POST ​/api​/v1​/users​/{userName}​/acceptMfa — Enable MFA for User.
• POST ​/api​/v1​/users​/{userName}​/disableMfa — Disable MFA for User.

Query Parameter Changes

The following changes in query parameters of HTTP requests were made:

• GET ​/api​/v1​/virtualMachines — Get Collection of EC2 Instances:

• Added the following query parameters: RegionId, ProtectedByPolicy, BackupType.
• Removed the following query parameters: ProtectionStatus, BackupDestination.

• GET ​/api​/v1​/rds — Get Collection of RDS Instances:

• Added the following query parameter: RegionId.

• GET ​/api​/v1​/cloudInfrastructure​/buckets — Get Collection of Amazon S3 Buckets:

• Renamed the AmazonAccountId query parameter to IAMRoleId.

Schema Changes

The following changes in the REST API schemas were made:

• VirtualMachineRestoreOptions schema:

• Added the imageId property.

• AmazonAccount schema:

• Renamed the awsid property to awsAccountId.

• VirtualMachine schema:

• Renamed the protectionStatus property to backupState.
• Renamed the backupDestinations property to backupTypes.

• BackupDestinations schema renamed to BackupTypes.
• VirtualMachineSnapshotSpec schema:

• Renamed the amazonAccountId request body parameter to IAMRoleId.

• Renamed the targetAmazonAccountIdToCopySnapshots request body parameter to targetIAMRoleIdToCopySnapshots.

• Rds schema:

• Renamed the awsAccount property to IAMRole.

• RdsSnapshotSpec schema:

• Renamed the amazonAccountId request body parameter to IAMRoleId.
• Renamed the targetAmazonAccountIdToCopySnapshots request body parameter to targetIAMRoleIdToCopySnapshots.

• RdsRestorePoint schema:

• Renamed the iAMDatabaseAuthenticationEnabled property to IAMDatabaseAuthenticationEnabled.

• RdsRestoreSpec schema:

• Renamed the awsAccountId request body parameter to IAMRoleId.

• VpcPolicySpecification schema:

• Renamed the awsAccountId request body parameter to IAMRoleId.

• VpcPolicySpecification/VpcPolicySourceSpecification/AccountRegionSpecification schema:

• Renamed the cloudAccountAwsId request body parameter to awsAccountId.

• VpcPolicy/VpcPolicySourceSettings/AccountRegion schema:

• Renamed the cloudAccountId property to IAMRoleId.
• Renamed the cloudAccountName property to IAMRoleName.
• Renamed the cloudAccountAwsId property to awsAccountId.

• VpcRestorePoint schema:

• Added the hasS3Backup property.

• VpcConfigurationRestoreSpecification schema:

• Renamed the amazonAccountId request body parameter to IAMRoleId.

• BucketFolder schema:

• Added the storageClass property.

• Repository schema:

• Renamed the amazonAccountId property to IAMRoleId.

• Added the storageClass property.
• Added the customerMasterKeyId property.

• RepositoryCreateSpec schema:

• Renamed the amazonAccountId request body parameter to IAMRoleId.

• Added the storageClass request body parameter.
• Added the customerMasterKeyId request body parameter.

• RepositoryUpdateSpec schema:

• Renamed the amazonAccountId request body parameter to IAMRoleId.

• Added the storageClass request body parameter.
• Added the customerMasterKeyId request body parameter.

• Session schema:

• Added the name property.

• AmazonConnectionSpec schema:

• Renamed the amazonAccountId request body parameter to IAMRoleId.

• CheckEc2Instance schema:

• Renamed the amazonAccountId property to IAMRoleId.
• Renamed the awsAccountName property to IAMRoleName.

• ValidateWorkerSpec schema:

• Removed the region request body parameter.
• Removed the vpcId request body parameter.
• Removed the securityGroup request body parameter.

• User schema:

• Removed the id property.

• ServiceAccountSettings schema:

• Renamed the serviceAmazonAccountId request body parameter to serviceIAMRoleId.
• Renamed the serviceAmazonAccountName request body parameter to serviceIAMRoleName.
• Renamed the serviceAmazonAccountRegionType request body parameter to serviceIAMRoleRegionType.