@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AWSBackupGateway
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAWSBackupGateway
instead.
Backup gateway connects Backup to your hypervisor, so you can create, store, and restore backups of your virtual machines (VMs) anywhere, whether on-premises or in the VMware Cloud (VMC) on Amazon Web Services.
Add on-premises resources by connecting to a hypervisor through a gateway. Backup will automatically discover the resources in your hypervisor.
Use Backup to assign virtual or on-premises resources to a backup plan, or run on-demand backups. Once you have backed up your resources, you can view them and restore them like any resource supported by Backup.
To download the Amazon Web Services software to get started, navigate to the Backup console, choose Gateways, then choose Create gateway.
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
AssociateGatewayToServerResult |
associateGatewayToServer(AssociateGatewayToServerRequest associateGatewayToServerRequest)
Associates a backup gateway with your server.
|
CreateGatewayResult |
createGateway(CreateGatewayRequest createGatewayRequest)
Creates a backup gateway.
|
DeleteGatewayResult |
deleteGateway(DeleteGatewayRequest deleteGatewayRequest)
Deletes a backup gateway.
|
DeleteHypervisorResult |
deleteHypervisor(DeleteHypervisorRequest deleteHypervisorRequest)
Deletes a hypervisor.
|
DisassociateGatewayFromServerResult |
disassociateGatewayFromServer(DisassociateGatewayFromServerRequest disassociateGatewayFromServerRequest)
Disassociates a backup gateway from the specified server.
|
GetBandwidthRateLimitScheduleResult |
getBandwidthRateLimitSchedule(GetBandwidthRateLimitScheduleRequest getBandwidthRateLimitScheduleRequest)
Retrieves the bandwidth rate limit schedule for a specified gateway.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetGatewayResult |
getGateway(GetGatewayRequest getGatewayRequest)
By providing the ARN (Amazon Resource Name), this API returns the gateway.
|
GetHypervisorResult |
getHypervisor(GetHypervisorRequest getHypervisorRequest)
This action requests information about the specified hypervisor to which the gateway will connect.
|
GetHypervisorPropertyMappingsResult |
getHypervisorPropertyMappings(GetHypervisorPropertyMappingsRequest getHypervisorPropertyMappingsRequest)
This action retrieves the property mappings for the specified hypervisor.
|
GetVirtualMachineResult |
getVirtualMachine(GetVirtualMachineRequest getVirtualMachineRequest)
By providing the ARN (Amazon Resource Name), this API returns the virtual machine.
|
ImportHypervisorConfigurationResult |
importHypervisorConfiguration(ImportHypervisorConfigurationRequest importHypervisorConfigurationRequest)
Connect to a hypervisor by importing its configuration.
|
ListGatewaysResult |
listGateways(ListGatewaysRequest listGatewaysRequest)
Lists backup gateways owned by an Amazon Web Services account in an Amazon Web Services Region.
|
ListHypervisorsResult |
listHypervisors(ListHypervisorsRequest listHypervisorsRequest)
Lists your hypervisors.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags applied to the resource identified by its Amazon Resource Name (ARN).
|
ListVirtualMachinesResult |
listVirtualMachines(ListVirtualMachinesRequest listVirtualMachinesRequest)
Lists your virtual machines.
|
PutBandwidthRateLimitScheduleResult |
putBandwidthRateLimitSchedule(PutBandwidthRateLimitScheduleRequest putBandwidthRateLimitScheduleRequest)
This action sets the bandwidth rate limit schedule for a specified gateway.
|
PutHypervisorPropertyMappingsResult |
putHypervisorPropertyMappings(PutHypervisorPropertyMappingsRequest putHypervisorPropertyMappingsRequest)
This action sets the property mappings for the specified hypervisor.
|
PutMaintenanceStartTimeResult |
putMaintenanceStartTime(PutMaintenanceStartTimeRequest putMaintenanceStartTimeRequest)
Set the maintenance start time for a gateway.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartVirtualMachinesMetadataSyncResult |
startVirtualMachinesMetadataSync(StartVirtualMachinesMetadataSyncRequest startVirtualMachinesMetadataSyncRequest)
This action sends a request to sync metadata across the specified virtual machines.
|
TagResourceResult |
tagResource(TagResourceRequest tagResourceRequest)
Tag the resource.
|
TestHypervisorConfigurationResult |
testHypervisorConfiguration(TestHypervisorConfigurationRequest testHypervisorConfigurationRequest)
Tests your hypervisor configuration to validate that backup gateway can connect with the hypervisor and its
resources.
|
UntagResourceResult |
untagResource(UntagResourceRequest untagResourceRequest)
Removes tags from the resource.
|
UpdateGatewayInformationResult |
updateGatewayInformation(UpdateGatewayInformationRequest updateGatewayInformationRequest)
Updates a gateway's name.
|
UpdateGatewaySoftwareNowResult |
updateGatewaySoftwareNow(UpdateGatewaySoftwareNowRequest updateGatewaySoftwareNowRequest)
Updates the gateway virtual machine (VM) software.
|
UpdateHypervisorResult |
updateHypervisor(UpdateHypervisorRequest updateHypervisorRequest)
Updates a hypervisor metadata, including its host, username, and password.
|
static final String ENDPOINT_PREFIX
AssociateGatewayToServerResult associateGatewayToServer(AssociateGatewayToServerRequest associateGatewayToServerRequest)
Associates a backup gateway with your server. After you complete the association process, you can back up and restore your VMs through the gateway.
associateGatewayToServerRequest
- ValidationException
- The operation did not succeed because a validation error occurred.ConflictException
- The operation cannot proceed because it is not supported.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.CreateGatewayResult createGateway(CreateGatewayRequest createGatewayRequest)
Creates a backup gateway. After you create a gateway, you can associate it with a server using the
AssociateGatewayToServer
operation.
createGatewayRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.DeleteGatewayResult deleteGateway(DeleteGatewayRequest deleteGatewayRequest)
Deletes a backup gateway.
deleteGatewayRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.DeleteHypervisorResult deleteHypervisor(DeleteHypervisorRequest deleteHypervisorRequest)
Deletes a hypervisor.
deleteHypervisorRequest
- ValidationException
- The operation did not succeed because a validation error occurred.ConflictException
- The operation cannot proceed because it is not supported.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.AccessDeniedException
- The operation cannot proceed because you have insufficient permissions.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.DisassociateGatewayFromServerResult disassociateGatewayFromServer(DisassociateGatewayFromServerRequest disassociateGatewayFromServerRequest)
Disassociates a backup gateway from the specified server. After the disassociation process finishes, the gateway can no longer access the virtual machines on the server.
disassociateGatewayFromServerRequest
- ValidationException
- The operation did not succeed because a validation error occurred.ConflictException
- The operation cannot proceed because it is not supported.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.GetBandwidthRateLimitScheduleResult getBandwidthRateLimitSchedule(GetBandwidthRateLimitScheduleRequest getBandwidthRateLimitScheduleRequest)
Retrieves the bandwidth rate limit schedule for a specified gateway. By default, gateways do not have bandwidth rate limit schedules, which means no bandwidth rate limiting is in effect. Use this to get a gateway's bandwidth rate limit schedule.
getBandwidthRateLimitScheduleRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.GetGatewayResult getGateway(GetGatewayRequest getGatewayRequest)
By providing the ARN (Amazon Resource Name), this API returns the gateway.
getGatewayRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.GetHypervisorResult getHypervisor(GetHypervisorRequest getHypervisorRequest)
This action requests information about the specified hypervisor to which the gateway will connect. A hypervisor is hardware, software, or firmware that creates and manages virtual machines, and allocates resources to them.
getHypervisorRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.GetHypervisorPropertyMappingsResult getHypervisorPropertyMappings(GetHypervisorPropertyMappingsRequest getHypervisorPropertyMappingsRequest)
This action retrieves the property mappings for the specified hypervisor. A hypervisor property mapping displays the relationship of entity properties available from the on-premises hypervisor to the properties available in Amazon Web Services.
getHypervisorPropertyMappingsRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.GetVirtualMachineResult getVirtualMachine(GetVirtualMachineRequest getVirtualMachineRequest)
By providing the ARN (Amazon Resource Name), this API returns the virtual machine.
getVirtualMachineRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.ImportHypervisorConfigurationResult importHypervisorConfiguration(ImportHypervisorConfigurationRequest importHypervisorConfigurationRequest)
Connect to a hypervisor by importing its configuration.
importHypervisorConfigurationRequest
- ValidationException
- The operation did not succeed because a validation error occurred.ConflictException
- The operation cannot proceed because it is not supported.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.AccessDeniedException
- The operation cannot proceed because you have insufficient permissions.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.ListGatewaysResult listGateways(ListGatewaysRequest listGatewaysRequest)
Lists backup gateways owned by an Amazon Web Services account in an Amazon Web Services Region. The returned list is ordered by gateway Amazon Resource Name (ARN).
listGatewaysRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.ListHypervisorsResult listHypervisors(ListHypervisorsRequest listHypervisorsRequest)
Lists your hypervisors.
listHypervisorsRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags applied to the resource identified by its Amazon Resource Name (ARN).
listTagsForResourceRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.ListVirtualMachinesResult listVirtualMachines(ListVirtualMachinesRequest listVirtualMachinesRequest)
Lists your virtual machines.
listVirtualMachinesRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.PutBandwidthRateLimitScheduleResult putBandwidthRateLimitSchedule(PutBandwidthRateLimitScheduleRequest putBandwidthRateLimitScheduleRequest)
This action sets the bandwidth rate limit schedule for a specified gateway. By default, gateways do not have a bandwidth rate limit schedule, which means no bandwidth rate limiting is in effect. Use this to initiate a gateway's bandwidth rate limit schedule.
putBandwidthRateLimitScheduleRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.PutHypervisorPropertyMappingsResult putHypervisorPropertyMappings(PutHypervisorPropertyMappingsRequest putHypervisorPropertyMappingsRequest)
This action sets the property mappings for the specified hypervisor. A hypervisor property mapping displays the relationship of entity properties available from the on-premises hypervisor to the properties available in Amazon Web Services.
putHypervisorPropertyMappingsRequest
- ValidationException
- The operation did not succeed because a validation error occurred.ConflictException
- The operation cannot proceed because it is not supported.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.AccessDeniedException
- The operation cannot proceed because you have insufficient permissions.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.PutMaintenanceStartTimeResult putMaintenanceStartTime(PutMaintenanceStartTimeRequest putMaintenanceStartTimeRequest)
Set the maintenance start time for a gateway.
putMaintenanceStartTimeRequest
- ValidationException
- The operation did not succeed because a validation error occurred.ConflictException
- The operation cannot proceed because it is not supported.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.StartVirtualMachinesMetadataSyncResult startVirtualMachinesMetadataSync(StartVirtualMachinesMetadataSyncRequest startVirtualMachinesMetadataSyncRequest)
This action sends a request to sync metadata across the specified virtual machines.
startVirtualMachinesMetadataSyncRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.AccessDeniedException
- The operation cannot proceed because you have insufficient permissions.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
Tag the resource.
tagResourceRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.TestHypervisorConfigurationResult testHypervisorConfiguration(TestHypervisorConfigurationRequest testHypervisorConfigurationRequest)
Tests your hypervisor configuration to validate that backup gateway can connect with the hypervisor and its resources.
testHypervisorConfigurationRequest
- ValidationException
- The operation did not succeed because a validation error occurred.ConflictException
- The operation cannot proceed because it is not supported.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
Removes tags from the resource.
untagResourceRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.UpdateGatewayInformationResult updateGatewayInformation(UpdateGatewayInformationRequest updateGatewayInformationRequest)
Updates a gateway's name. Specify which gateway to update using the Amazon Resource Name (ARN) of the gateway in your request.
updateGatewayInformationRequest
- ValidationException
- The operation did not succeed because a validation error occurred.ConflictException
- The operation cannot proceed because it is not supported.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.UpdateGatewaySoftwareNowResult updateGatewaySoftwareNow(UpdateGatewaySoftwareNowRequest updateGatewaySoftwareNowRequest)
Updates the gateway virtual machine (VM) software. The request immediately triggers the software update.
When you make this request, you get a 200 OK
success response immediately. However, it might take
some time for the update to complete.
updateGatewaySoftwareNowRequest
- ValidationException
- The operation did not succeed because a validation error occurred.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.UpdateHypervisorResult updateHypervisor(UpdateHypervisorRequest updateHypervisorRequest)
Updates a hypervisor metadata, including its host, username, and password. Specify which hypervisor to update using the Amazon Resource Name (ARN) of the hypervisor in your request.
updateHypervisorRequest
- ValidationException
- The operation did not succeed because a validation error occurred.ConflictException
- The operation cannot proceed because it is not supported.InternalServerException
- The operation did not succeed because an internal error occurred. Try again later.AccessDeniedException
- The operation cannot proceed because you have insufficient permissions.ResourceNotFoundException
- A resource that is required for the action wasn't found.ThrottlingException
- TPS has been limited to protect against intentional or unintentional high request volumes.void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
request
- The originally executed request.