get_hypervisor

get_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'
)
Parameters
HypervisorArn (string) --

[REQUIRED]

The Amazon Resource Name (ARN) of the hypervisor.

Return type
dict
Returns
Response Syntax
{
    '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

  • (dict) --
    • Hypervisor (dict) --

      Details about the requested hypervisor.

      • 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 KMS used to encrypt the hypervisor.

      • LastSuccessfulMetadataSyncTime (datetime) --

        This is the time when the most recent successful sync of metadata occurred.

      • LatestMetadataSyncStatus (string) --

        This is the most recent status for the indicated metadata sync.

      • LatestMetadataSyncStatusMessage (string) --

        This is the most recent status for the indicated metadata sync.

      • LogGroupArn (string) --

        The Amazon Resource Name (ARN) of the group of gateways within the requested log.

      • Name (string) --

        This is the name of the specified hypervisor.

      • State (string) --

        This is the current state of the specified hypervisor.

        The possible states are PENDING , ONLINE , OFFLINE , or ERROR .

Exceptions

  • BackupGateway.Client.exceptions.ValidationException
  • BackupGateway.Client.exceptions.InternalServerException
  • BackupGateway.Client.exceptions.ResourceNotFoundException
  • BackupGateway.Client.exceptions.ThrottlingException