@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSBackupGatewayClient extends AmazonWebServiceClient implements AWSBackupGateway
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.
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIX| Modifier and Type | Method and Description |
|---|---|
AssociateGatewayToServerResult |
associateGatewayToServer(AssociateGatewayToServerRequest request)
Associates a backup gateway with your server.
|
static AWSBackupGatewayClientBuilder |
builder() |
CreateGatewayResult |
createGateway(CreateGatewayRequest request)
Creates a backup gateway.
|
DeleteGatewayResult |
deleteGateway(DeleteGatewayRequest request)
Deletes a backup gateway.
|
DeleteHypervisorResult |
deleteHypervisor(DeleteHypervisorRequest request)
Deletes a hypervisor.
|
DisassociateGatewayFromServerResult |
disassociateGatewayFromServer(DisassociateGatewayFromServerRequest request)
Disassociates a backup gateway from the specified server.
|
GetBandwidthRateLimitScheduleResult |
getBandwidthRateLimitSchedule(GetBandwidthRateLimitScheduleRequest request)
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 request)
By providing the ARN (Amazon Resource Name), this API returns the gateway.
|
GetHypervisorResult |
getHypervisor(GetHypervisorRequest request)
This action requests information about the specified hypervisor to which the gateway will connect.
|
GetHypervisorPropertyMappingsResult |
getHypervisorPropertyMappings(GetHypervisorPropertyMappingsRequest request)
This action retrieves the property mappings for the specified hypervisor.
|
GetVirtualMachineResult |
getVirtualMachine(GetVirtualMachineRequest request)
By providing the ARN (Amazon Resource Name), this API returns the virtual machine.
|
ImportHypervisorConfigurationResult |
importHypervisorConfiguration(ImportHypervisorConfigurationRequest request)
Connect to a hypervisor by importing its configuration.
|
ListGatewaysResult |
listGateways(ListGatewaysRequest request)
Lists backup gateways owned by an Amazon Web Services account in an Amazon Web Services Region.
|
ListHypervisorsResult |
listHypervisors(ListHypervisorsRequest request)
Lists your hypervisors.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
Lists the tags applied to the resource identified by its Amazon Resource Name (ARN).
|
ListVirtualMachinesResult |
listVirtualMachines(ListVirtualMachinesRequest request)
Lists your virtual machines.
|
PutBandwidthRateLimitScheduleResult |
putBandwidthRateLimitSchedule(PutBandwidthRateLimitScheduleRequest request)
This action sets the bandwidth rate limit schedule for a specified gateway.
|
PutHypervisorPropertyMappingsResult |
putHypervisorPropertyMappings(PutHypervisorPropertyMappingsRequest request)
This action sets the property mappings for the specified hypervisor.
|
PutMaintenanceStartTimeResult |
putMaintenanceStartTime(PutMaintenanceStartTimeRequest request)
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 request)
This action sends a request to sync metadata across the specified virtual machines.
|
TagResourceResult |
tagResource(TagResourceRequest request)
Tag the resource.
|
TestHypervisorConfigurationResult |
testHypervisorConfiguration(TestHypervisorConfigurationRequest request)
Tests your hypervisor configuration to validate that backup gateway can connect with the hypervisor and its
resources.
|
UntagResourceResult |
untagResource(UntagResourceRequest request)
Removes tags from the resource.
|
UpdateGatewayInformationResult |
updateGatewayInformation(UpdateGatewayInformationRequest request)
Updates a gateway's name.
|
UpdateGatewaySoftwareNowResult |
updateGatewaySoftwareNow(UpdateGatewaySoftwareNowRequest request)
Updates the gateway virtual machine (VM) software.
|
UpdateHypervisorResult |
updateHypervisor(UpdateHypervisorRequest request)
Updates a hypervisor metadata, including its host, username, and password.
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetpublic static AWSBackupGatewayClientBuilder builder()
public AssociateGatewayToServerResult associateGatewayToServer(AssociateGatewayToServerRequest request)
Associates a backup gateway with your server. After you complete the association process, you can back up and restore your VMs through the gateway.
associateGatewayToServer in interface AWSBackupGatewayassociateGatewayToServerRequest - 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.public CreateGatewayResult createGateway(CreateGatewayRequest request)
Creates a backup gateway. After you create a gateway, you can associate it with a server using the
AssociateGatewayToServer operation.
createGateway in interface AWSBackupGatewaycreateGatewayRequest - 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.public DeleteGatewayResult deleteGateway(DeleteGatewayRequest request)
Deletes a backup gateway.
deleteGateway in interface AWSBackupGatewaydeleteGatewayRequest - 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.public DeleteHypervisorResult deleteHypervisor(DeleteHypervisorRequest request)
Deletes a hypervisor.
deleteHypervisor in interface AWSBackupGatewaydeleteHypervisorRequest - 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.public DisassociateGatewayFromServerResult disassociateGatewayFromServer(DisassociateGatewayFromServerRequest request)
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.
disassociateGatewayFromServer in interface AWSBackupGatewaydisassociateGatewayFromServerRequest - 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.public GetBandwidthRateLimitScheduleResult getBandwidthRateLimitSchedule(GetBandwidthRateLimitScheduleRequest request)
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.
getBandwidthRateLimitSchedule in interface AWSBackupGatewaygetBandwidthRateLimitScheduleRequest - 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.public GetGatewayResult getGateway(GetGatewayRequest request)
By providing the ARN (Amazon Resource Name), this API returns the gateway.
getGateway in interface AWSBackupGatewaygetGatewayRequest - 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.public GetHypervisorResult getHypervisor(GetHypervisorRequest request)
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.
getHypervisor in interface AWSBackupGatewaygetHypervisorRequest - 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.public GetHypervisorPropertyMappingsResult getHypervisorPropertyMappings(GetHypervisorPropertyMappingsRequest request)
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.
getHypervisorPropertyMappings in interface AWSBackupGatewaygetHypervisorPropertyMappingsRequest - 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.public GetVirtualMachineResult getVirtualMachine(GetVirtualMachineRequest request)
By providing the ARN (Amazon Resource Name), this API returns the virtual machine.
getVirtualMachine in interface AWSBackupGatewaygetVirtualMachineRequest - 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.public ImportHypervisorConfigurationResult importHypervisorConfiguration(ImportHypervisorConfigurationRequest request)
Connect to a hypervisor by importing its configuration.
importHypervisorConfiguration in interface AWSBackupGatewayimportHypervisorConfigurationRequest - 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.public ListGatewaysResult listGateways(ListGatewaysRequest request)
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).
listGateways in interface AWSBackupGatewaylistGatewaysRequest - 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.public ListHypervisorsResult listHypervisors(ListHypervisorsRequest request)
Lists your hypervisors.
listHypervisors in interface AWSBackupGatewaylistHypervisorsRequest - 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.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Lists the tags applied to the resource identified by its Amazon Resource Name (ARN).
listTagsForResource in interface AWSBackupGatewaylistTagsForResourceRequest - 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.public ListVirtualMachinesResult listVirtualMachines(ListVirtualMachinesRequest request)
Lists your virtual machines.
listVirtualMachines in interface AWSBackupGatewaylistVirtualMachinesRequest - 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.public PutBandwidthRateLimitScheduleResult putBandwidthRateLimitSchedule(PutBandwidthRateLimitScheduleRequest request)
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.
putBandwidthRateLimitSchedule in interface AWSBackupGatewayputBandwidthRateLimitScheduleRequest - 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.public PutHypervisorPropertyMappingsResult putHypervisorPropertyMappings(PutHypervisorPropertyMappingsRequest request)
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.
putHypervisorPropertyMappings in interface AWSBackupGatewayputHypervisorPropertyMappingsRequest - 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.public PutMaintenanceStartTimeResult putMaintenanceStartTime(PutMaintenanceStartTimeRequest request)
Set the maintenance start time for a gateway.
putMaintenanceStartTime in interface AWSBackupGatewayputMaintenanceStartTimeRequest - 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.public StartVirtualMachinesMetadataSyncResult startVirtualMachinesMetadataSync(StartVirtualMachinesMetadataSyncRequest request)
This action sends a request to sync metadata across the specified virtual machines.
startVirtualMachinesMetadataSync in interface AWSBackupGatewaystartVirtualMachinesMetadataSyncRequest - 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.public TagResourceResult tagResource(TagResourceRequest request)
Tag the resource.
tagResource in interface AWSBackupGatewaytagResourceRequest - 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.public TestHypervisorConfigurationResult testHypervisorConfiguration(TestHypervisorConfigurationRequest request)
Tests your hypervisor configuration to validate that backup gateway can connect with the hypervisor and its resources.
testHypervisorConfiguration in interface AWSBackupGatewaytestHypervisorConfigurationRequest - 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.public UntagResourceResult untagResource(UntagResourceRequest request)
Removes tags from the resource.
untagResource in interface AWSBackupGatewayuntagResourceRequest - 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.public UpdateGatewayInformationResult updateGatewayInformation(UpdateGatewayInformationRequest request)
Updates a gateway's name. Specify which gateway to update using the Amazon Resource Name (ARN) of the gateway in your request.
updateGatewayInformation in interface AWSBackupGatewayupdateGatewayInformationRequest - 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.public UpdateGatewaySoftwareNowResult updateGatewaySoftwareNow(UpdateGatewaySoftwareNowRequest request)
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.
updateGatewaySoftwareNow in interface AWSBackupGatewayupdateGatewaySoftwareNowRequest - 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.public UpdateHypervisorResult updateHypervisor(UpdateHypervisorRequest request)
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.
updateHypervisor in interface AWSBackupGatewayupdateHypervisorRequest - 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.public 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 the request.
getCachedResponseMetadata in interface AWSBackupGatewayrequest - The originally executed requestpublic void shutdown()
AmazonWebServiceClientshutdown in interface AWSBackupGatewayshutdown in class AmazonWebServiceClient