AWS::BackupGateway::Hypervisor - Amazon CloudFormation
SyntaxPropertiesReturn values
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::BackupGateway::Hypervisor

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.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::BackupGateway::Hypervisor",
  "Properties" : {
      "Host" : String,
      "KmsKeyArn" : String,
      "LogGroupArn" : String,
      "Name" : String,
      "Password" : String,
      "Tags" : [ Tag, ... ],
      "Username" : String
    }
}

YAML

Type: AWS::BackupGateway::Hypervisor
Properties: 
  Host: String
  KmsKeyArn: String
  LogGroupArn: String
  Name: String
  Password: String
  Tags: 
    - Tag
  Username: String

Properties

Host

The server host of the hypervisor. This can be either an IP address or a fully-qualified domain name (FQDN).

Required: No

Type: String

Minimum: 3

Maximum: 128

Pattern: .+

Update requires: No interruption

KmsKeyArn

The Amazon Resource Name (ARN) of the Amazon Key Management Service used to encrypt the hypervisor.

Required: No

Type: String

Minimum: 50

Maximum: 500

Pattern: (^arn:(aws|aws-cn|aws-us-gov):kms:([a-zA-Z0-9-]+):([0-9]+):(key|alias)/(\S+)$)|(^alias/(\S+)$)

Update requires: Replacement

LogGroupArn

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

Required: No

Type: String

Minimum: 0

Maximum: 2048

Pattern: $|^arn:(aws|aws-cn|aws-us-gov):logs:([a-zA-Z0-9-]+):([0-9]+):log-group:[a-zA-Z0-9_\-\/\.]+:\*

Update requires: No interruption

Name

The name of the hypervisor.

Required: No

Type: String

Minimum: 1

Maximum: 100

Pattern: [a-zA-Z0-9-]*

Update requires: No interruption

Password

The password for the hypervisor.

Required: No

Type: String

Minimum: 1

Maximum: 100

Pattern: [ -~]+

Update requires: No interruption

Tags

The tags of the hypervisor configuration to import.

Required: No

Type: List of Tag

Update requires: Replacement

Username

The username for the hypervisor.

Required: No

Type: String

Minimum: 1

Maximum: 100

Pattern: [ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Reffunction, Refreturns HypervisorArn.

For more information about using the Reffunction, see Ref.

Fn::GetAtt

The Fn::GetAttintrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAttintrinsic function, see Fn::GetAtt.

HypervisorArn

Returns HypervisorArn, an Amazon Resource Name (ARN) that uniquely identifies a Hypervisor. For example: arn:aws:backup-gateway:us-east-1:123456789012:hypervisor/hype-1234D67D