BackupGatewayClient

Index > BackupGateway > BackupGatewayClient

Auto-generated documentation for BackupGateway type annotations stubs module mypy-boto3-backup-gateway.

BackupGatewayClient

Type annotations and code completion for boto3.client("backup-gateway"). boto3 documentation

Usage example

from boto3.session import Session
from mypy_boto3_backup_gateway.client import BackupGatewayClient

def get_backup-gateway_client() -> BackupGatewayClient:
    return Session().client("backup-gateway")

Exceptions

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("backup-gateway").exceptions structure.

Usage example

client = boto3.client("backup-gateway")

try:
    do_something(client)
except (
    client.AccessDeniedException,
    client.ClientError,
    client.ConflictException,
    client.InternalServerException,
    client.ResourceNotFoundException,
    client.ThrottlingException,
    client.ValidationException,
) as e:
    print(e)

Type checking example

from mypy_boto3_backup_gateway.client import Exceptions

def handle_error(exc: Exceptions.AccessDeniedException) -> None:
    ...

Methods

associate_gateway_to_server

Associates a backup gateway with your server.

Type annotations and code completion for boto3.client("backup-gateway").associate_gateway_to_server method. boto3 documentation

Method definition

def associate_gateway_to_server(
    self,
    *,
    GatewayArn: str,
    ServerArn: str,
) -> AssociateGatewayToServerOutputTypeDef:  # (1)
    ...

1. See AssociateGatewayToServerOutputTypeDef

Usage example with kwargs

kwargs: AssociateGatewayToServerInputRequestTypeDef = {  # (1)
    "GatewayArn": ...,
    "ServerArn": ...,
}

parent.associate_gateway_to_server(**kwargs)

1. See AssociateGatewayToServerInputRequestTypeDef

can_paginate

Check if an operation can be paginated.

Type annotations and code completion for boto3.client("backup-gateway").can_paginate method. boto3 documentation

Method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

close

Closes underlying endpoint connections.

Type annotations and code completion for boto3.client("backup-gateway").close method. boto3 documentation

Method definition

def close(
    self,
) -> None:
    ...

create_gateway

Creates a backup gateway.

Type annotations and code completion for boto3.client("backup-gateway").create_gateway method. boto3 documentation

Method definition

def create_gateway(
    self,
    *,
    ActivationKey: str,
    GatewayDisplayName: str,
    GatewayType: GatewayTypeType,  # (1)
    Tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateGatewayOutputTypeDef:  # (3)
    ...

1. See GatewayTypeType
2. See TagTypeDef
3. See CreateGatewayOutputTypeDef

Usage example with kwargs

kwargs: CreateGatewayInputRequestTypeDef = {  # (1)
    "ActivationKey": ...,
    "GatewayDisplayName": ...,
    "GatewayType": ...,
}

parent.create_gateway(**kwargs)

1. See CreateGatewayInputRequestTypeDef

delete_gateway

Deletes a backup gateway.

Type annotations and code completion for boto3.client("backup-gateway").delete_gateway method. boto3 documentation

Method definition

def delete_gateway(
    self,
    *,
    GatewayArn: str,
) -> DeleteGatewayOutputTypeDef:  # (1)
    ...

1. See DeleteGatewayOutputTypeDef

Usage example with kwargs

kwargs: DeleteGatewayInputRequestTypeDef = {  # (1)
    "GatewayArn": ...,
}

parent.delete_gateway(**kwargs)

1. See DeleteGatewayInputRequestTypeDef

delete_hypervisor

Deletes a hypervisor.

Type annotations and code completion for boto3.client("backup-gateway").delete_hypervisor method. boto3 documentation

Method definition

def delete_hypervisor(
    self,
    *,
    HypervisorArn: str,
) -> DeleteHypervisorOutputTypeDef:  # (1)
    ...

1. See DeleteHypervisorOutputTypeDef

Usage example with kwargs

kwargs: DeleteHypervisorInputRequestTypeDef = {  # (1)
    "HypervisorArn": ...,
}

parent.delete_hypervisor(**kwargs)

1. See DeleteHypervisorInputRequestTypeDef

disassociate_gateway_from_server

Disassociates a backup gateway from the specified server.

Type annotations and code completion for boto3.client("backup-gateway").disassociate_gateway_from_server method. boto3 documentation

Method definition

def disassociate_gateway_from_server(
    self,
    *,
    GatewayArn: str,
) -> DisassociateGatewayFromServerOutputTypeDef:  # (1)
    ...

1. See DisassociateGatewayFromServerOutputTypeDef

Usage example with kwargs

kwargs: DisassociateGatewayFromServerInputRequestTypeDef = {  # (1)
    "GatewayArn": ...,
}

parent.disassociate_gateway_from_server(**kwargs)

1. See DisassociateGatewayFromServerInputRequestTypeDef

generate_presigned_url

Generate a presigned url given a client, its method, and arguments.

Type annotations and code completion for boto3.client("backup-gateway").generate_presigned_url method. boto3 documentation

Method definition

def generate_presigned_url(
    self,
    ClientMethod: str,
    Params: Mapping[str, Any] = ...,
    ExpiresIn: int = 3600,
    HttpMethod: str = ...,
) -> str:
    ...

get_bandwidth_rate_limit_schedule

Retrieves the bandwidth rate limit schedule for a specified gateway.

Type annotations and code completion for boto3.client("backup-gateway").get_bandwidth_rate_limit_schedule method. boto3 documentation

Method definition

def get_bandwidth_rate_limit_schedule(
    self,
    *,
    GatewayArn: str,
) -> GetBandwidthRateLimitScheduleOutputTypeDef:  # (1)
    ...

1. See GetBandwidthRateLimitScheduleOutputTypeDef

Usage example with kwargs

kwargs: GetBandwidthRateLimitScheduleInputRequestTypeDef = {  # (1)
    "GatewayArn": ...,
}

parent.get_bandwidth_rate_limit_schedule(**kwargs)

1. See GetBandwidthRateLimitScheduleInputRequestTypeDef

get_gateway

By providing the ARN (Amazon Resource Name), this API returns the gateway.

Type annotations and code completion for boto3.client("backup-gateway").get_gateway method. boto3 documentation

Method definition

def get_gateway(
    self,
    *,
    GatewayArn: str,
) -> GetGatewayOutputTypeDef:  # (1)
    ...

1. See GetGatewayOutputTypeDef

Usage example with kwargs

kwargs: GetGatewayInputRequestTypeDef = {  # (1)
    "GatewayArn": ...,
}

parent.get_gateway(**kwargs)

1. See GetGatewayInputRequestTypeDef

get_hypervisor

This action requests information about the specified hypervisor to which the gateway will connect.

Type annotations and code completion for boto3.client("backup-gateway").get_hypervisor method. boto3 documentation

Method definition

def get_hypervisor(
    self,
    *,
    HypervisorArn: str,
) -> GetHypervisorOutputTypeDef:  # (1)
    ...

1. See GetHypervisorOutputTypeDef

Usage example with kwargs

kwargs: GetHypervisorInputRequestTypeDef = {  # (1)
    "HypervisorArn": ...,
}

parent.get_hypervisor(**kwargs)

1. See GetHypervisorInputRequestTypeDef

get_hypervisor_property_mappings

This action retrieves the property mappings for the specified hypervisor.

Type annotations and code completion for boto3.client("backup-gateway").get_hypervisor_property_mappings method. boto3 documentation

Method definition

def get_hypervisor_property_mappings(
    self,
    *,
    HypervisorArn: str,
) -> GetHypervisorPropertyMappingsOutputTypeDef:  # (1)
    ...

1. See GetHypervisorPropertyMappingsOutputTypeDef

Usage example with kwargs

kwargs: GetHypervisorPropertyMappingsInputRequestTypeDef = {  # (1)
    "HypervisorArn": ...,
}

parent.get_hypervisor_property_mappings(**kwargs)

1. See GetHypervisorPropertyMappingsInputRequestTypeDef

get_virtual_machine

By providing the ARN (Amazon Resource Name), this API returns the virtual machine.

Type annotations and code completion for boto3.client("backup-gateway").get_virtual_machine method. boto3 documentation

Method definition

def get_virtual_machine(
    self,
    *,
    ResourceArn: str,
) -> GetVirtualMachineOutputTypeDef:  # (1)
    ...

1. See GetVirtualMachineOutputTypeDef

Usage example with kwargs

kwargs: GetVirtualMachineInputRequestTypeDef = {  # (1)
    "ResourceArn": ...,
}

parent.get_virtual_machine(**kwargs)

1. See GetVirtualMachineInputRequestTypeDef

import_hypervisor_configuration

Connect to a hypervisor by importing its configuration.

Type annotations and code completion for boto3.client("backup-gateway").import_hypervisor_configuration method. boto3 documentation

Method definition

def import_hypervisor_configuration(
    self,
    *,
    Host: str,
    Name: str,
    KmsKeyArn: str = ...,
    Password: str = ...,
    Tags: Sequence[TagTypeDef] = ...,  # (1)
    Username: str = ...,
) -> ImportHypervisorConfigurationOutputTypeDef:  # (2)
    ...

1. See TagTypeDef
2. See ImportHypervisorConfigurationOutputTypeDef

Usage example with kwargs

kwargs: ImportHypervisorConfigurationInputRequestTypeDef = {  # (1)
    "Host": ...,
    "Name": ...,
}

parent.import_hypervisor_configuration(**kwargs)

1. See ImportHypervisorConfigurationInputRequestTypeDef

list_gateways

Lists backup gateways owned by an Amazon Web Services account in an Amazon Web Services Region.

Type annotations and code completion for boto3.client("backup-gateway").list_gateways method. boto3 documentation

Method definition

def list_gateways(
    self,
    *,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListGatewaysOutputTypeDef:  # (1)
    ...

1. See ListGatewaysOutputTypeDef

Usage example with kwargs

kwargs: ListGatewaysInputRequestTypeDef = {  # (1)
    "MaxResults": ...,
}

parent.list_gateways(**kwargs)

1. See ListGatewaysInputRequestTypeDef

list_hypervisors

Lists your hypervisors.

Type annotations and code completion for boto3.client("backup-gateway").list_hypervisors method. boto3 documentation

Method definition

def list_hypervisors(
    self,
    *,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListHypervisorsOutputTypeDef:  # (1)
    ...

1. See ListHypervisorsOutputTypeDef

Usage example with kwargs

kwargs: ListHypervisorsInputRequestTypeDef = {  # (1)
    "MaxResults": ...,
}

parent.list_hypervisors(**kwargs)

1. See ListHypervisorsInputRequestTypeDef

list_tags_for_resource

Lists the tags applied to the resource identified by its Amazon Resource Name (ARN).

Type annotations and code completion for boto3.client("backup-gateway").list_tags_for_resource method. boto3 documentation

Method definition

def list_tags_for_resource(
    self,
    *,
    ResourceArn: str,
) -> ListTagsForResourceOutputTypeDef:  # (1)
    ...

1. See ListTagsForResourceOutputTypeDef

Usage example with kwargs

kwargs: ListTagsForResourceInputRequestTypeDef = {  # (1)
    "ResourceArn": ...,
}

parent.list_tags_for_resource(**kwargs)

1. See ListTagsForResourceInputRequestTypeDef

list_virtual_machines

Lists your virtual machines.

Type annotations and code completion for boto3.client("backup-gateway").list_virtual_machines method. boto3 documentation

Method definition

def list_virtual_machines(
    self,
    *,
    HypervisorArn: str = ...,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListVirtualMachinesOutputTypeDef:  # (1)
    ...

1. See ListVirtualMachinesOutputTypeDef

Usage example with kwargs

kwargs: ListVirtualMachinesInputRequestTypeDef = {  # (1)
    "HypervisorArn": ...,
}

parent.list_virtual_machines(**kwargs)

1. See ListVirtualMachinesInputRequestTypeDef

put_bandwidth_rate_limit_schedule

This action sets the bandwidth rate limit schedule for a specified gateway.

Type annotations and code completion for boto3.client("backup-gateway").put_bandwidth_rate_limit_schedule method. boto3 documentation

Method definition

def put_bandwidth_rate_limit_schedule(
    self,
    *,
    BandwidthRateLimitIntervals: Sequence[BandwidthRateLimitIntervalTypeDef],  # (1)
    GatewayArn: str,
) -> PutBandwidthRateLimitScheduleOutputTypeDef:  # (2)
    ...

1. See BandwidthRateLimitIntervalTypeDef
2. See PutBandwidthRateLimitScheduleOutputTypeDef

Usage example with kwargs

kwargs: PutBandwidthRateLimitScheduleInputRequestTypeDef = {  # (1)
    "BandwidthRateLimitIntervals": ...,
    "GatewayArn": ...,
}

parent.put_bandwidth_rate_limit_schedule(**kwargs)

1. See PutBandwidthRateLimitScheduleInputRequestTypeDef

put_hypervisor_property_mappings

This action sets the property mappings for the specified hypervisor.

Type annotations and code completion for boto3.client("backup-gateway").put_hypervisor_property_mappings method. boto3 documentation

Method definition

def put_hypervisor_property_mappings(
    self,
    *,
    HypervisorArn: str,
    IamRoleArn: str,
    VmwareToAwsTagMappings: Sequence[VmwareToAwsTagMappingTypeDef],  # (1)
) -> PutHypervisorPropertyMappingsOutputTypeDef:  # (2)
    ...

1. See VmwareToAwsTagMappingTypeDef
2. See PutHypervisorPropertyMappingsOutputTypeDef

Usage example with kwargs

kwargs: PutHypervisorPropertyMappingsInputRequestTypeDef = {  # (1)
    "HypervisorArn": ...,
    "IamRoleArn": ...,
    "VmwareToAwsTagMappings": ...,
}

parent.put_hypervisor_property_mappings(**kwargs)

1. See PutHypervisorPropertyMappingsInputRequestTypeDef

put_maintenance_start_time

Set the maintenance start time for a gateway.

Type annotations and code completion for boto3.client("backup-gateway").put_maintenance_start_time method. boto3 documentation

Method definition

def put_maintenance_start_time(
    self,
    *,
    GatewayArn: str,
    HourOfDay: int,
    MinuteOfHour: int,
    DayOfMonth: int = ...,
    DayOfWeek: int = ...,
) -> PutMaintenanceStartTimeOutputTypeDef:  # (1)
    ...

1. See PutMaintenanceStartTimeOutputTypeDef

Usage example with kwargs

kwargs: PutMaintenanceStartTimeInputRequestTypeDef = {  # (1)
    "GatewayArn": ...,
    "HourOfDay": ...,
    "MinuteOfHour": ...,
}

parent.put_maintenance_start_time(**kwargs)

1. See PutMaintenanceStartTimeInputRequestTypeDef

start_virtual_machines_metadata_sync

This action sends a request to sync metadata across the specified virtual machines.

Type annotations and code completion for boto3.client("backup-gateway").start_virtual_machines_metadata_sync method. boto3 documentation

Method definition

def start_virtual_machines_metadata_sync(
    self,
    *,
    HypervisorArn: str,
) -> StartVirtualMachinesMetadataSyncOutputTypeDef:  # (1)
    ...

1. See StartVirtualMachinesMetadataSyncOutputTypeDef

Usage example with kwargs

kwargs: StartVirtualMachinesMetadataSyncInputRequestTypeDef = {  # (1)
    "HypervisorArn": ...,
}

parent.start_virtual_machines_metadata_sync(**kwargs)

1. See StartVirtualMachinesMetadataSyncInputRequestTypeDef

tag_resource

Tag the resource.

Type annotations and code completion for boto3.client("backup-gateway").tag_resource method. boto3 documentation

Method definition

def tag_resource(
    self,
    *,
    ResourceARN: str,
    Tags: Sequence[TagTypeDef],  # (1)
) -> TagResourceOutputTypeDef:  # (2)
    ...

1. See TagTypeDef
2. See TagResourceOutputTypeDef

Usage example with kwargs

kwargs: TagResourceInputRequestTypeDef = {  # (1)
    "ResourceARN": ...,
    "Tags": ...,
}

parent.tag_resource(**kwargs)

1. See TagResourceInputRequestTypeDef

test_hypervisor_configuration

Tests your hypervisor configuration to validate that backup gateway can connect with the hypervisor and its resources.

Type annotations and code completion for boto3.client("backup-gateway").test_hypervisor_configuration method. boto3 documentation

Method definition

def test_hypervisor_configuration(
    self,
    *,
    GatewayArn: str,
    Host: str,
    Password: str = ...,
    Username: str = ...,
) -> Dict[str, Any]:
    ...

Usage example with kwargs

kwargs: TestHypervisorConfigurationInputRequestTypeDef = {  # (1)
    "GatewayArn": ...,
    "Host": ...,
}

parent.test_hypervisor_configuration(**kwargs)

1. See TestHypervisorConfigurationInputRequestTypeDef

untag_resource

Removes tags from the resource.

Type annotations and code completion for boto3.client("backup-gateway").untag_resource method. boto3 documentation

Method definition

def untag_resource(
    self,
    *,
    ResourceARN: str,
    TagKeys: Sequence[str],
) -> UntagResourceOutputTypeDef:  # (1)
    ...

1. See UntagResourceOutputTypeDef

Usage example with kwargs

kwargs: UntagResourceInputRequestTypeDef = {  # (1)
    "ResourceARN": ...,
    "TagKeys": ...,
}

parent.untag_resource(**kwargs)

1. See UntagResourceInputRequestTypeDef

update_gateway_information

Updates a gateway's name.

Type annotations and code completion for boto3.client("backup-gateway").update_gateway_information method. boto3 documentation

Method definition

def update_gateway_information(
    self,
    *,
    GatewayArn: str,
    GatewayDisplayName: str = ...,
) -> UpdateGatewayInformationOutputTypeDef:  # (1)
    ...

1. See UpdateGatewayInformationOutputTypeDef

Usage example with kwargs

kwargs: UpdateGatewayInformationInputRequestTypeDef = {  # (1)
    "GatewayArn": ...,
}

parent.update_gateway_information(**kwargs)

1. See UpdateGatewayInformationInputRequestTypeDef

update_gateway_software_now

Updates the gateway virtual machine (VM) software.

Type annotations and code completion for boto3.client("backup-gateway").update_gateway_software_now method. boto3 documentation

Method definition

def update_gateway_software_now(
    self,
    *,
    GatewayArn: str,
) -> UpdateGatewaySoftwareNowOutputTypeDef:  # (1)
    ...

1. See UpdateGatewaySoftwareNowOutputTypeDef

Usage example with kwargs

kwargs: UpdateGatewaySoftwareNowInputRequestTypeDef = {  # (1)
    "GatewayArn": ...,
}

parent.update_gateway_software_now(**kwargs)

1. See UpdateGatewaySoftwareNowInputRequestTypeDef

update_hypervisor

Updates a hypervisor metadata, including its host, username, and password.

Type annotations and code completion for boto3.client("backup-gateway").update_hypervisor method. boto3 documentation

Method definition

def update_hypervisor(
    self,
    *,
    HypervisorArn: str,
    Host: str = ...,
    LogGroupArn: str = ...,
    Name: str = ...,
    Password: str = ...,
    Username: str = ...,
) -> UpdateHypervisorOutputTypeDef:  # (1)
    ...

1. See UpdateHypervisorOutputTypeDef

Usage example with kwargs

kwargs: UpdateHypervisorInputRequestTypeDef = {  # (1)
    "HypervisorArn": ...,
}

parent.update_hypervisor(**kwargs)

1. See UpdateHypervisorInputRequestTypeDef

get_paginator

Type annotations and code completion for boto3.client("backup-gateway").get_paginator method with overloads.

• client.get_paginator("list_gateways") -> ListGatewaysPaginator
• client.get_paginator("list_hypervisors") -> ListHypervisorsPaginator
• client.get_paginator("list_virtual_machines") -> ListVirtualMachinesPaginator