@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_METRIC
ENDPOINT_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, withTimeOffset
public 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 AWSBackupGateway
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.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 AWSBackupGateway
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.public DeleteGatewayResult deleteGateway(DeleteGatewayRequest request)
Deletes a backup gateway.
deleteGateway
in interface AWSBackupGateway
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.public DeleteHypervisorResult deleteHypervisor(DeleteHypervisorRequest request)
Deletes a hypervisor.
deleteHypervisor
in interface AWSBackupGateway
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.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 AWSBackupGateway
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.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 AWSBackupGateway
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.public GetGatewayResult getGateway(GetGatewayRequest request)
By providing the ARN (Amazon Resource Name), this API returns the gateway.
getGateway
in interface AWSBackupGateway
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.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 AWSBackupGateway
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.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 AWSBackupGateway
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.public GetVirtualMachineResult getVirtualMachine(GetVirtualMachineRequest request)
By providing the ARN (Amazon Resource Name), this API returns the virtual machine.
getVirtualMachine
in interface AWSBackupGateway
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.public ImportHypervisorConfigurationResult importHypervisorConfiguration(ImportHypervisorConfigurationRequest request)
Connect to a hypervisor by importing its configuration.
importHypervisorConfiguration
in interface AWSBackupGateway
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.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 AWSBackupGateway
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.public ListHypervisorsResult listHypervisors(ListHypervisorsRequest request)
Lists your hypervisors.
listHypervisors
in interface AWSBackupGateway
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.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Lists the tags applied to the resource identified by its Amazon Resource Name (ARN).
listTagsForResource
in interface AWSBackupGateway
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.public ListVirtualMachinesResult listVirtualMachines(ListVirtualMachinesRequest request)
Lists your virtual machines.
listVirtualMachines
in interface AWSBackupGateway
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.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 AWSBackupGateway
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.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 AWSBackupGateway
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.public PutMaintenanceStartTimeResult putMaintenanceStartTime(PutMaintenanceStartTimeRequest request)
Set the maintenance start time for a gateway.
putMaintenanceStartTime
in interface AWSBackupGateway
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.public StartVirtualMachinesMetadataSyncResult startVirtualMachinesMetadataSync(StartVirtualMachinesMetadataSyncRequest request)
This action sends a request to sync metadata across the specified virtual machines.
startVirtualMachinesMetadataSync
in interface AWSBackupGateway
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.public TagResourceResult tagResource(TagResourceRequest request)
Tag the resource.
tagResource
in interface AWSBackupGateway
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.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 AWSBackupGateway
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.public UntagResourceResult untagResource(UntagResourceRequest request)
Removes tags from the resource.
untagResource
in interface AWSBackupGateway
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.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 AWSBackupGateway
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.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 AWSBackupGateway
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.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 AWSBackupGateway
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.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 AWSBackupGateway
request
- The originally executed requestpublic void shutdown()
AmazonWebServiceClient
shutdown
in interface AWSBackupGateway
shutdown
in class AmazonWebServiceClient