Table of Contents
BackupGateway.Client¶A low-level client representing AWS Backup Gateway
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 .
import boto3
client = boto3.client('backup-gateway')
These are the available methods:
associate_gateway_to_server()can_paginate()close()create_gateway()delete_gateway()delete_hypervisor()disassociate_gateway_from_server()get_bandwidth_rate_limit_schedule()get_gateway()get_hypervisor()get_hypervisor_property_mappings()get_paginator()get_virtual_machine()get_waiter()import_hypervisor_configuration()list_gateways()list_hypervisors()list_tags_for_resource()list_virtual_machines()put_bandwidth_rate_limit_schedule()put_hypervisor_property_mappings()put_maintenance_start_time()start_virtual_machines_metadata_sync()tag_resource()test_hypervisor_configuration()untag_resource()update_gateway_information()update_gateway_software_now()update_hypervisor()associate_gateway_to_server(**kwargs)¶Associates a backup gateway with your server. After you complete the association process, you can back up and restore your VMs through the gateway.
See also: AWS API Documentation
Request Syntax
response = client.associate_gateway_to_server(
GatewayArn='string',
ServerArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.
[REQUIRED]
The Amazon Resource Name (ARN) of the server that hosts your virtual machines.
dict
Response Syntax
{
'GatewayArn': 'string'
}
Response Structure
(dict) --
GatewayArn (string) --
The Amazon Resource Name (ARN) of a gateway.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.ConflictExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ThrottlingExceptioncan_paginate(operation_name)¶Check if an operation can be paginated.
create_foo, and you'd normally invoke the
operation as client.create_foo(**kwargs), if the
create_foo operation can be paginated, you can use the
call client.get_paginator("create_foo").True if the operation can be paginated,
False otherwise.close()¶Closes underlying endpoint connections.
create_gateway(**kwargs)¶Creates a backup gateway. After you create a gateway, you can associate it with a server using the AssociateGatewayToServer operation.
See also: AWS API Documentation
Request Syntax
response = client.create_gateway(
ActivationKey='string',
GatewayDisplayName='string',
GatewayType='BACKUP_VM',
Tags=[
{
'Key': 'string',
'Value': 'string'
},
]
)
[REQUIRED]
The activation key of the created gateway.
[REQUIRED]
The display name of the created gateway.
[REQUIRED]
The type of created gateway.
A list of up to 50 tags to assign to the gateway. Each tag is a key-value pair.
A key-value pair you can use to manage, filter, and search for your resources. Allowed characters include UTF-8 letters, numbers, spaces, and the following characters: + - = . _ : /.
The key part of a tag's key-value pair. The key can't start with aws: .
The value part of a tag's key-value pair.
dict
Response Syntax
{
'GatewayArn': 'string'
}
Response Structure
(dict) --
GatewayArn (string) --
The Amazon Resource Name (ARN) of the gateway you create.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ThrottlingExceptiondelete_gateway(**kwargs)¶Deletes a backup gateway.
See also: AWS API Documentation
Request Syntax
response = client.delete_gateway(
GatewayArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the gateway to delete.
{
'GatewayArn': 'string'
}
Response Structure
The Amazon Resource Name (ARN) of the gateway you deleted.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptiondelete_hypervisor(**kwargs)¶Deletes a hypervisor.
See also: AWS API Documentation
Request Syntax
response = client.delete_hypervisor(
HypervisorArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the hypervisor to delete.
{
'HypervisorArn': 'string'
}
Response Structure
The Amazon Resource Name (ARN) of the hypervisor you deleted.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.ConflictExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.AccessDeniedExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptiondisassociate_gateway_from_server(**kwargs)¶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.
See also: AWS API Documentation
Request Syntax
response = client.disassociate_gateway_from_server(
GatewayArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the gateway to disassociate.
{
'GatewayArn': 'string'
}
Response Structure
The Amazon Resource Name (ARN) of the gateway you disassociated.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.ConflictExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionget_bandwidth_rate_limit_schedule(**kwargs)¶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.
See also: AWS API Documentation
Request Syntax
response = client.get_bandwidth_rate_limit_schedule(
GatewayArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.
{
'BandwidthRateLimitIntervals': [
{
'AverageUploadRateLimitInBitsPerSec': 123,
'DaysOfWeek': [
123,
],
'EndHourOfDay': 123,
'EndMinuteOfHour': 123,
'StartHourOfDay': 123,
'StartMinuteOfHour': 123
},
],
'GatewayArn': 'string'
}
Response Structure
An array containing bandwidth rate limit schedule intervals for a gateway. When no bandwidth rate limit intervals have been scheduled, the array is empty.
Describes a bandwidth rate limit interval for a gateway. A bandwidth rate limit schedule consists of one or more bandwidth rate limit intervals. A bandwidth rate limit interval defines a period of time on one or more days of the week, during which bandwidth rate limits are specified for uploading, downloading, or both.
The average upload rate limit component of the bandwidth rate limit interval, in bits per second. This field does not appear in the response if the upload rate limit is not set.
Note
For Backup Gateway, the minimum value is (Value) .
The days of the week component of the bandwidth rate limit interval, represented as ordinal numbers from 0 to 6, where 0 represents Sunday and 6 represents Saturday.
The hour of the day to end the bandwidth rate limit interval.
The minute of the hour to end the bandwidth rate limit interval.
Warning
The bandwidth rate limit interval ends at the end of the minute. To end an interval at the end of an hour, use the value 59 .
The hour of the day to start the bandwidth rate limit interval.
The minute of the hour to start the bandwidth rate limit interval. The interval begins at the start of that minute. To begin an interval exactly at the start of the hour, use the value 0 .
The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionget_gateway(**kwargs)¶By providing the ARN (Amazon Resource Name), this API returns the gateway.
See also: AWS API Documentation
Request Syntax
response = client.get_gateway(
GatewayArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the gateway.
{
'Gateway': {
'GatewayArn': 'string',
'GatewayDisplayName': 'string',
'GatewayType': 'BACKUP_VM',
'HypervisorId': 'string',
'LastSeenTime': datetime(2015, 1, 1),
'MaintenanceStartTime': {
'DayOfMonth': 123,
'DayOfWeek': 123,
'HourOfDay': 123,
'MinuteOfHour': 123
},
'NextUpdateAvailabilityTime': datetime(2015, 1, 1),
'VpcEndpoint': 'string'
}
}
Response Structure
By providing the ARN (Amazon Resource Name), this API returns the gateway.
The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.
The display name of the gateway.
The type of the gateway type.
The hypervisor ID of the gateway.
Details showing the last time Backup gateway communicated with the cloud, in Unix format and UTC time.
Returns your gateway's weekly maintenance start time including the day and time of the week. Note that values are in terms of the gateway's time zone. Can be weekly or monthly.
The day of the month component of the maintenance start time represented as an ordinal number from 1 to 28, where 1 represents the first day of the month and 28 represents the last day of the month.
An ordinal number between 0 and 6 that represents the day of the week, where 0 represents Sunday and 6 represents Saturday. The day of week is in the time zone of the gateway.
The hour component of the maintenance start time represented as hh , where hh is the hour (0 to 23). The hour of the day is in the time zone of the gateway.
The minute component of the maintenance start time represented as mm , where mm is the minute (0 to 59). The minute of the hour is in the time zone of the gateway.
Details showing the next update availability time of the gateway.
The DNS name for the virtual private cloud (VPC) endpoint the gateway uses to connect to the cloud for backup gateway.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionget_hypervisor(**kwargs)¶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.
See also: AWS API Documentation
Request Syntax
response = client.get_hypervisor(
HypervisorArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the hypervisor.
{
'Hypervisor': {
'Host': 'string',
'HypervisorArn': 'string',
'KmsKeyArn': 'string',
'LastSuccessfulMetadataSyncTime': datetime(2015, 1, 1),
'LatestMetadataSyncStatus': 'CREATED'|'RUNNING'|'FAILED'|'PARTIALLY_FAILED'|'SUCCEEDED',
'LatestMetadataSyncStatusMessage': 'string',
'LogGroupArn': 'string',
'Name': 'string',
'State': 'PENDING'|'ONLINE'|'OFFLINE'|'ERROR'
}
}
Response Structure
Details about the requested hypervisor.
The server host of the hypervisor. This can be either an IP address or a fully-qualified domain name (FQDN).
The Amazon Resource Name (ARN) of the hypervisor.
The Amazon Resource Name (ARN) of the KMS used to encrypt the hypervisor.
This is the time when the most recent successful sync of metadata occurred.
This is the most recent status for the indicated metadata sync.
This is the most recent status for the indicated metadata sync.
The Amazon Resource Name (ARN) of the group of gateways within the requested log.
This is the name of the specified hypervisor.
This is the current state of the specified hypervisor.
The possible states are PENDING , ONLINE , OFFLINE , or ERROR .
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionget_hypervisor_property_mappings(**kwargs)¶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.
See also: AWS API Documentation
Request Syntax
response = client.get_hypervisor_property_mappings(
HypervisorArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the hypervisor.
{
'HypervisorArn': 'string',
'IamRoleArn': 'string',
'VmwareToAwsTagMappings': [
{
'AwsTagKey': 'string',
'AwsTagValue': 'string',
'VmwareCategory': 'string',
'VmwareTagName': 'string'
},
]
}
Response Structure
The Amazon Resource Name (ARN) of the hypervisor.
The Amazon Resource Name (ARN) of the IAM role.
This is a display of the mappings of on-premises VMware tags to the Amazon Web Services tags.
This displays the mapping of on-premises VMware tags to the corresponding Amazon Web Services tags.
The key part of the Amazon Web Services tag's key-value pair.
The value part of the Amazon Web Services tag's key-value pair.
The is the category of VMware.
This is the user-defined name of a VMware tag.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionget_paginator(operation_name)¶Create a paginator for an operation.
create_foo, and you'd normally invoke the
operation as client.create_foo(**kwargs), if the
create_foo operation can be paginated, you can use the
call client.get_paginator("create_foo").client.can_paginate method to
check if an operation is pageable.get_virtual_machine(**kwargs)¶By providing the ARN (Amazon Resource Name), this API returns the virtual machine.
See also: AWS API Documentation
Request Syntax
response = client.get_virtual_machine(
ResourceArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the virtual machine.
{
'VirtualMachine': {
'HostName': 'string',
'HypervisorId': 'string',
'LastBackupDate': datetime(2015, 1, 1),
'Name': 'string',
'Path': 'string',
'ResourceArn': 'string',
'VmwareTags': [
{
'VmwareCategory': 'string',
'VmwareTagDescription': 'string',
'VmwareTagName': 'string'
},
]
}
}
Response Structure
This object contains the basic attributes of VirtualMachine contained by the output of GetVirtualMachine
The host name of the virtual machine.
The ID of the virtual machine's hypervisor.
The most recent date a virtual machine was backed up, in Unix format and UTC time.
The name of the virtual machine.
The path of the virtual machine.
The Amazon Resource Name (ARN) of the virtual machine. For example, arn:aws:backup-gateway:us-west-1:0000000000000:vm/vm-0000ABCDEFGIJKL .
These are the details of the VMware tags associated with the specified virtual machine.
A VMware tag is a tag attached to a specific virtual machine. A tag is a key-value pair you can use to manage, filter, and search for your resources.
The content of VMware tags can be matched to Amazon Web Services tags.
The is the category of VMware.
This is a user-defined description of a VMware tag.
This is the user-defined name of a VMware tag.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionget_waiter(waiter_name)¶Returns an object that can wait for some condition.
import_hypervisor_configuration(**kwargs)¶Connect to a hypervisor by importing its configuration.
See also: AWS API Documentation
Request Syntax
response = client.import_hypervisor_configuration(
Host='string',
KmsKeyArn='string',
Name='string',
Password='string',
Tags=[
{
'Key': 'string',
'Value': 'string'
},
],
Username='string'
)
[REQUIRED]
The server host of the hypervisor. This can be either an IP address or a fully-qualified domain name (FQDN).
[REQUIRED]
The name of the hypervisor.
The tags of the hypervisor configuration to import.
A key-value pair you can use to manage, filter, and search for your resources. Allowed characters include UTF-8 letters, numbers, spaces, and the following characters: + - = . _ : /.
The key part of a tag's key-value pair. The key can't start with aws: .
The value part of a tag's key-value pair.
dict
Response Syntax
{
'HypervisorArn': 'string'
}
Response Structure
(dict) --
HypervisorArn (string) --
The Amazon Resource Name (ARN) of the hypervisor you disassociated.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.ConflictExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.AccessDeniedExceptionBackupGateway.Client.exceptions.ThrottlingExceptionlist_gateways(**kwargs)¶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).
See also: AWS API Documentation
Request Syntax
response = client.list_gateways(
MaxResults=123,
NextToken='string'
)
MaxResults number of resources, NextToken allows you to return more items in your list starting at the location pointed to by the next token.dict
Response Syntax
{
'Gateways': [
{
'GatewayArn': 'string',
'GatewayDisplayName': 'string',
'GatewayType': 'BACKUP_VM',
'HypervisorId': 'string',
'LastSeenTime': datetime(2015, 1, 1)
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Gateways (list) --
A list of your gateways.
(dict) --
A gateway is an Backup Gateway appliance that runs on the customer's network to provide seamless connectivity to backup storage in the Amazon Web Services Cloud.
GatewayArn (string) --
The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.
GatewayDisplayName (string) --
The display name of the gateway.
GatewayType (string) --
The type of the gateway.
HypervisorId (string) --
The hypervisor ID of the gateway.
LastSeenTime (datetime) --
The last time Backup gateway communicated with the gateway, in Unix format and UTC time.
NextToken (string) --
The next item following a partial list of returned resources. For example, if a request is made to return maxResults number of resources, NextToken allows you to return more items in your list starting at the location pointed to by the next token.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ThrottlingExceptionlist_hypervisors(**kwargs)¶Lists your hypervisors.
See also: AWS API Documentation
Request Syntax
response = client.list_hypervisors(
MaxResults=123,
NextToken='string'
)
maxResults number of resources, NextToken allows you to return more items in your list starting at the location pointed to by the next token.dict
Response Syntax
{
'Hypervisors': [
{
'Host': 'string',
'HypervisorArn': 'string',
'KmsKeyArn': 'string',
'Name': 'string',
'State': 'PENDING'|'ONLINE'|'OFFLINE'|'ERROR'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Hypervisors (list) --
A list of your Hypervisor objects, ordered by their Amazon Resource Names (ARNs).
(dict) --
Represents the hypervisor's permissions to which the gateway will connect.
A hypervisor is hardware, software, or firmware that creates and manages virtual machines, and allocates resources to them.
Host (string) --
The server host of the hypervisor. This can be either an IP address or a fully-qualified domain name (FQDN).
HypervisorArn (string) --
The Amazon Resource Name (ARN) of the hypervisor.
KmsKeyArn (string) --
The Amazon Resource Name (ARN) of the Key Management Service used to encrypt the hypervisor.
Name (string) --
The name of the hypervisor.
State (string) --
The state of the hypervisor.
NextToken (string) --
The next item following a partial list of returned resources. For example, if a request is made to return maxResults number of resources, NextToken allows you to return more items in your list starting at the location pointed to by the next token.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ThrottlingExceptionLists the tags applied to the resource identified by its Amazon Resource Name (ARN).
See also: AWS API Documentation
Request Syntax
response = client.list_tags_for_resource(
ResourceArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the resource's tags to list.
{
'ResourceArn': 'string',
'Tags': [
{
'Key': 'string',
'Value': 'string'
},
]
}
Response Structure
The Amazon Resource Name (ARN) of the resource's tags that you listed.
A list of the resource's tags.
A key-value pair you can use to manage, filter, and search for your resources. Allowed characters include UTF-8 letters, numbers, spaces, and the following characters: + - = . _ : /.
The key part of a tag's key-value pair. The key can't start with aws: .
The value part of a tag's key-value pair.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionlist_virtual_machines(**kwargs)¶Lists your virtual machines.
See also: AWS API Documentation
Request Syntax
response = client.list_virtual_machines(
HypervisorArn='string',
MaxResults=123,
NextToken='string'
)
maxResults number of resources, NextToken allows you to return more items in your list starting at the location pointed to by the next token.dict
Response Syntax
{
'NextToken': 'string',
'VirtualMachines': [
{
'HostName': 'string',
'HypervisorId': 'string',
'LastBackupDate': datetime(2015, 1, 1),
'Name': 'string',
'Path': 'string',
'ResourceArn': 'string'
},
]
}
Response Structure
(dict) --
NextToken (string) --
The next item following a partial list of returned resources. For example, if a request is made to return maxResults number of resources, NextToken allows you to return more items in your list starting at the location pointed to by the next token.
VirtualMachines (list) --
A list of your VirtualMachine objects, ordered by their Amazon Resource Names (ARNs).
(dict) --
A virtual machine that is on a hypervisor.
HostName (string) --
The host name of the virtual machine.
HypervisorId (string) --
The ID of the virtual machine's hypervisor.
LastBackupDate (datetime) --
The most recent date a virtual machine was backed up, in Unix format and UTC time.
Name (string) --
The name of the virtual machine.
Path (string) --
The path of the virtual machine.
ResourceArn (string) --
The Amazon Resource Name (ARN) of the virtual machine. For example, arn:aws:backup-gateway:us-west-1:0000000000000:vm/vm-0000ABCDEFGIJKL .
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ThrottlingExceptionput_bandwidth_rate_limit_schedule(**kwargs)¶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.
See also: AWS API Documentation
Request Syntax
response = client.put_bandwidth_rate_limit_schedule(
BandwidthRateLimitIntervals=[
{
'AverageUploadRateLimitInBitsPerSec': 123,
'DaysOfWeek': [
123,
],
'EndHourOfDay': 123,
'EndMinuteOfHour': 123,
'StartHourOfDay': 123,
'StartMinuteOfHour': 123
},
],
GatewayArn='string'
)
[REQUIRED]
An array containing bandwidth rate limit schedule intervals for a gateway. When no bandwidth rate limit intervals have been scheduled, the array is empty.
Describes a bandwidth rate limit interval for a gateway. A bandwidth rate limit schedule consists of one or more bandwidth rate limit intervals. A bandwidth rate limit interval defines a period of time on one or more days of the week, during which bandwidth rate limits are specified for uploading, downloading, or both.
The average upload rate limit component of the bandwidth rate limit interval, in bits per second. This field does not appear in the response if the upload rate limit is not set.
Note
For Backup Gateway, the minimum value is (Value) .
The days of the week component of the bandwidth rate limit interval, represented as ordinal numbers from 0 to 6, where 0 represents Sunday and 6 represents Saturday.
The hour of the day to end the bandwidth rate limit interval.
The minute of the hour to end the bandwidth rate limit interval.
Warning
The bandwidth rate limit interval ends at the end of the minute. To end an interval at the end of an hour, use the value 59 .
The hour of the day to start the bandwidth rate limit interval.
The minute of the hour to start the bandwidth rate limit interval. The interval begins at the start of that minute. To begin an interval exactly at the start of the hour, use the value 0 .
[REQUIRED]
The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.
dict
Response Syntax
{
'GatewayArn': 'string'
}
Response Structure
(dict) --
GatewayArn (string) --
The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionput_hypervisor_property_mappings(**kwargs)¶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.
See also: AWS API Documentation
Request Syntax
response = client.put_hypervisor_property_mappings(
HypervisorArn='string',
IamRoleArn='string',
VmwareToAwsTagMappings=[
{
'AwsTagKey': 'string',
'AwsTagValue': 'string',
'VmwareCategory': 'string',
'VmwareTagName': 'string'
},
]
)
[REQUIRED]
The Amazon Resource Name (ARN) of the hypervisor.
[REQUIRED]
The Amazon Resource Name (ARN) of the IAM role.
[REQUIRED]
This action requests the mappings of on-premises VMware tags to the Amazon Web Services tags.
This displays the mapping of on-premises VMware tags to the corresponding Amazon Web Services tags.
The key part of the Amazon Web Services tag's key-value pair.
The value part of the Amazon Web Services tag's key-value pair.
The is the category of VMware.
This is the user-defined name of a VMware tag.
dict
Response Syntax
{
'HypervisorArn': 'string'
}
Response Structure
(dict) --
HypervisorArn (string) --
The Amazon Resource Name (ARN) of the hypervisor.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.ConflictExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.AccessDeniedExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionput_maintenance_start_time(**kwargs)¶Set the maintenance start time for a gateway.
See also: AWS API Documentation
Request Syntax
response = client.put_maintenance_start_time(
DayOfMonth=123,
DayOfWeek=123,
GatewayArn='string',
HourOfDay=123,
MinuteOfHour=123
)
The day of the month start maintenance on a gateway.
Valid values range from Sunday to Saturday .
[REQUIRED]
The Amazon Resource Name (ARN) for the gateway, used to specify its maintenance start time.
[REQUIRED]
The hour of the day to start maintenance on a gateway.
[REQUIRED]
The minute of the hour to start maintenance on a gateway.
dict
Response Syntax
{
'GatewayArn': 'string'
}
Response Structure
(dict) --
GatewayArn (string) --
The Amazon Resource Name (ARN) of a gateway for which you set the maintenance start time.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.ConflictExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionstart_virtual_machines_metadata_sync(**kwargs)¶This action sends a request to sync metadata across the specified virtual machines.
See also: AWS API Documentation
Request Syntax
response = client.start_virtual_machines_metadata_sync(
HypervisorArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the hypervisor.
{
'HypervisorArn': 'string'
}
Response Structure
The Amazon Resource Name (ARN) of the hypervisor.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.AccessDeniedExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptiontag_resource(**kwargs)¶Tag the resource.
See also: AWS API Documentation
Request Syntax
response = client.tag_resource(
ResourceARN='string',
Tags=[
{
'Key': 'string',
'Value': 'string'
},
]
)
[REQUIRED]
The Amazon Resource Name (ARN) of the resource to tag.
[REQUIRED]
A list of tags to assign to the resource.
A key-value pair you can use to manage, filter, and search for your resources. Allowed characters include UTF-8 letters, numbers, spaces, and the following characters: + - = . _ : /.
The key part of a tag's key-value pair. The key can't start with aws: .
The value part of a tag's key-value pair.
dict
Response Syntax
{
'ResourceARN': 'string'
}
Response Structure
(dict) --
ResourceARN (string) --
The Amazon Resource Name (ARN) of the resource you tagged.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptiontest_hypervisor_configuration(**kwargs)¶Tests your hypervisor configuration to validate that backup gateway can connect with the hypervisor and its resources.
See also: AWS API Documentation
Request Syntax
response = client.test_hypervisor_configuration(
GatewayArn='string',
Host='string',
Password='string',
Username='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the gateway to the hypervisor to test.
[REQUIRED]
The server host of the hypervisor. This can be either an IP address or a fully-qualified domain name (FQDN).
dict
Response Syntax
{}
Response Structure
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.ConflictExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionuntag_resource(**kwargs)¶Removes tags from the resource.
See also: AWS API Documentation
Request Syntax
response = client.untag_resource(
ResourceARN='string',
TagKeys=[
'string',
]
)
[REQUIRED]
The Amazon Resource Name (ARN) of the resource from which to remove tags.
[REQUIRED]
The list of tag keys specifying which tags to remove.
dict
Response Syntax
{
'ResourceARN': 'string'
}
Response Structure
(dict) --
ResourceARN (string) --
The Amazon Resource Name (ARN) of the resource from which you removed tags.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionupdate_gateway_information(**kwargs)¶Updates a gateway's name. Specify which gateway to update using the Amazon Resource Name (ARN) of the gateway in your request.
See also: AWS API Documentation
Request Syntax
response = client.update_gateway_information(
GatewayArn='string',
GatewayDisplayName='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the gateway to update.
dict
Response Syntax
{
'GatewayArn': 'string'
}
Response Structure
(dict) --
GatewayArn (string) --
The Amazon Resource Name (ARN) of the gateway you updated.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.ConflictExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionupdate_gateway_software_now(**kwargs)¶Updates the gateway virtual machine (VM) software. The request immediately triggers the software update.
Note
When you make this request, you get a 200 OK success response immediately. However, it might take some time for the update to complete.
See also: AWS API Documentation
Request Syntax
response = client.update_gateway_software_now(
GatewayArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the gateway to be updated.
{
'GatewayArn': 'string'
}
Response Structure
The Amazon Resource Name (ARN) of the gateway you updated.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionupdate_hypervisor(**kwargs)¶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.
See also: AWS API Documentation
Request Syntax
response = client.update_hypervisor(
Host='string',
HypervisorArn='string',
LogGroupArn='string',
Name='string',
Password='string',
Username='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the hypervisor to update.
dict
Response Syntax
{
'HypervisorArn': 'string'
}
Response Structure
(dict) --
HypervisorArn (string) --
The Amazon Resource Name (ARN) of the hypervisor you updated.
Exceptions
BackupGateway.Client.exceptions.ValidationExceptionBackupGateway.Client.exceptions.ConflictExceptionBackupGateway.Client.exceptions.InternalServerExceptionBackupGateway.Client.exceptions.AccessDeniedExceptionBackupGateway.Client.exceptions.ResourceNotFoundExceptionBackupGateway.Client.exceptions.ThrottlingExceptionThe available paginators are:
BackupGateway.Paginator.ListGatewaysBackupGateway.Paginator.ListHypervisorsBackupGateway.Paginator.ListVirtualMachinesBackupGateway.Paginator.ListGateways¶paginator = client.get_paginator('list_gateways')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BackupGateway.Client.list_gateways().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'Gateways': [
{
'GatewayArn': 'string',
'GatewayDisplayName': 'string',
'GatewayType': 'BACKUP_VM',
'HypervisorId': 'string',
'LastSeenTime': datetime(2015, 1, 1)
},
],
}
Response Structure
A list of your gateways.
A gateway is an Backup Gateway appliance that runs on the customer's network to provide seamless connectivity to backup storage in the Amazon Web Services Cloud.
The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.
The display name of the gateway.
The type of the gateway.
The hypervisor ID of the gateway.
The last time Backup gateway communicated with the gateway, in Unix format and UTC time.
BackupGateway.Paginator.ListHypervisors¶paginator = client.get_paginator('list_hypervisors')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BackupGateway.Client.list_hypervisors().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'Hypervisors': [
{
'Host': 'string',
'HypervisorArn': 'string',
'KmsKeyArn': 'string',
'Name': 'string',
'State': 'PENDING'|'ONLINE'|'OFFLINE'|'ERROR'
},
],
}
Response Structure
A list of your Hypervisor objects, ordered by their Amazon Resource Names (ARNs).
Represents the hypervisor's permissions to which the gateway will connect.
A hypervisor is hardware, software, or firmware that creates and manages virtual machines, and allocates resources to them.
The server host of the hypervisor. This can be either an IP address or a fully-qualified domain name (FQDN).
The Amazon Resource Name (ARN) of the hypervisor.
The Amazon Resource Name (ARN) of the Key Management Service used to encrypt the hypervisor.
The name of the hypervisor.
The state of the hypervisor.
BackupGateway.Paginator.ListVirtualMachines¶paginator = client.get_paginator('list_virtual_machines')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BackupGateway.Client.list_virtual_machines().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
HypervisorArn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'VirtualMachines': [
{
'HostName': 'string',
'HypervisorId': 'string',
'LastBackupDate': datetime(2015, 1, 1),
'Name': 'string',
'Path': 'string',
'ResourceArn': 'string'
},
]
}
Response Structure
(dict) --
VirtualMachines (list) --
A list of your VirtualMachine objects, ordered by their Amazon Resource Names (ARNs).
(dict) --
A virtual machine that is on a hypervisor.
HostName (string) --
The host name of the virtual machine.
HypervisorId (string) --
The ID of the virtual machine's hypervisor.
LastBackupDate (datetime) --
The most recent date a virtual machine was backed up, in Unix format and UTC time.
Name (string) --
The name of the virtual machine.
Path (string) --
The path of the virtual machine.
ResourceArn (string) --
The Amazon Resource Name (ARN) of the virtual machine. For example, arn:aws:backup-gateway:us-west-1:0000000000000:vm/vm-0000ABCDEFGIJKL .