AWS::DataSync::Agent - Amazon CloudFormation
SyntaxPropertiesReturn valuesExamples
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::DataSync::Agent

The AWS::DataSync::Agent resource activates an Amazon DataSync agent that you've deployed for storage discovery or data transfers. The activation process associates the agent with your Amazon Web Services account.

For more information, see the following topics in the Amazon DataSync User Guide:

Syntax

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

JSON

{
  "Type" : "AWS::DataSync::Agent",
  "Properties" : {
      "ActivationKey" : String,
      "AgentName" : String,
      "SecurityGroupArns" : [ String, ... ],
      "SubnetArns" : [ String, ... ],
      "Tags" : [ Tag, ... ],
      "VpcEndpointId" : String
    }
}

YAML

Type: AWS::DataSync::Agent
Properties:
  ActivationKey: String
  AgentName: String
  SecurityGroupArns: 
    - String
  SubnetArns: 
    - String
  Tags: 
    - Tag
  VpcEndpointId: String

Properties

ActivationKey

Specifies your DataSync agent's activation key. If you don't have an activation key, see Activate your agent.

Required: No

Type: String

Pattern: [A-Z0-9]{5}(-[A-Z0-9]{5}){4}

Maximum: 29

Update requires: Replacement

AgentName

Specifies a name for your agent. You can see this name in the DataSync console.

Required: No

Type: String

Pattern: ^[a-zA-Z0-9\s+=._:@/-]+$

Minimum: 1

Maximum: 256

Update requires: No interruption

SecurityGroupArns

The Amazon Resource Names (ARNs) of the security groups used to protect your data transfer task subnets. See SecurityGroupArns.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/.*$

Required: No

Type: Array of String

Maximum: 128

Update requires: Replacement

SubnetArns

Specifies the ARN of the subnet where you want to run your DataSync task when using a VPC endpoint. This is the subnet where DataSync creates and manages the network interfaces for your transfer. You can only specify one ARN.

Required: No

Type: Array of String

Maximum: 128

Update requires: Replacement

Tags

Specifies labels that help you categorize, filter, and search for your Amazon resources. We recommend creating at least one tag for your agent.

Required: No

Type: Array of Tag

Maximum: 50

Update requires: No interruption

VpcEndpointId

The ID of the virtual private cloud (VPC) endpoint that the agent has access to. This is the client-side VPC endpoint, powered by Amazon PrivateLink. If you don't have an Amazon PrivateLink VPC endpoint, see Amazon PrivateLink and VPC endpoints in the Amazon VPC User Guide.

For more information about activating your agent in a private network based on a VPC, see Using Amazon DataSync in a Virtual Private Cloud in the Amazon DataSync User Guide.

A VPC endpoint ID looks like this: vpce-01234d5aff67890e1.

Required: No

Type: String

Pattern: ^vpce-[0-9a-f]{17}$

Update requires: Replacement

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the agent Amazon Resource Name (ARN). For example:

arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44baca3

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic 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::GetAtt intrinsic function, see Fn::GetAtt.

AgentArn

The Amazon Resource Name (ARN) of the agent. Use the ListAgents operation to return a list of agents for your account and Amazon Web Services Region.

EndpointType

The type of endpoint that your agent is connected to. If the endpoint is a VPC endpoint, the agent is not accessible over the public internet.

Examples

DataSync Agent

The following example specifies a DataSync agent named MyAgent. The agent activation key is included in the template.

JSON


{
  "AWSTemplateFormatVersion": "2010-09-09",
  "Description": "Specifies a DataSync agent",
  "Resources": 
    {
      "Agent": {
        "Type": "AWS::DataSync::Agent",
        "Properties": {
          "ActivationKey": "AAAAA-7AAAA-GG7MC-3I9R3-27COD",
          "AgentName": "MyAgent"
          }
      }
    }
}

YAML


AWSTemplateFormatVersion: 2010-09-09
Description: Specifies a DataSync agent
Resources:
  Agent:
    Type: AWS::DataSync::Agent
    Properties:
      ActivationKey: AAAAA-7AAAA-GG7MC-3I9R3-27COD
      AgentName: MyAgent