Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.DataSync.DescribeAgent

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Returns metadata such as the name, the network interfaces, and the status (that is, whether the agent is running or not) for an agent. To specify which agent to describe, use the Amazon Resource Name (ARN) of the agent in your request.

Synopsis

data DescribeAgent = DescribeAgent' {
- agentArn :: Text
}
newDescribeAgent :: Text -> DescribeAgent
describeAgent_agentArn :: Lens' DescribeAgent Text
data DescribeAgentResponse = DescribeAgentResponse' {
- creationTime :: Maybe POSIX
- status :: Maybe AgentStatus
- privateLinkConfig :: Maybe PrivateLinkConfig
- endpointType :: Maybe EndpointType
- lastConnectionTime :: Maybe POSIX
- agentArn :: Maybe Text
- name :: Maybe Text
- httpStatus :: Int
}
newDescribeAgentResponse :: Int -> DescribeAgentResponse
describeAgentResponse_creationTime :: Lens' DescribeAgentResponse (Maybe UTCTime)
describeAgentResponse_status :: Lens' DescribeAgentResponse (Maybe AgentStatus)
describeAgentResponse_privateLinkConfig :: Lens' DescribeAgentResponse (Maybe PrivateLinkConfig)
describeAgentResponse_endpointType :: Lens' DescribeAgentResponse (Maybe EndpointType)
describeAgentResponse_lastConnectionTime :: Lens' DescribeAgentResponse (Maybe UTCTime)
describeAgentResponse_agentArn :: Lens' DescribeAgentResponse (Maybe Text)
describeAgentResponse_name :: Lens' DescribeAgentResponse (Maybe Text)
describeAgentResponse_httpStatus :: Lens' DescribeAgentResponse Int

Creating a Request

data DescribeAgent Source #

DescribeAgent

See: newDescribeAgent smart constructor.

Constructors

DescribeAgent'
Fields agentArn :: Text The Amazon Resource Name (ARN) of the agent to describe.

Instances

Instances details

Eq DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods (==) :: DescribeAgent -> DescribeAgent -> Bool # (/=) :: DescribeAgent -> DescribeAgent -> Bool #
Read DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods readsPrec :: Int -> ReadS DescribeAgent # readList :: ReadS [DescribeAgent] # readPrec :: ReadPrec DescribeAgent # readListPrec :: ReadPrec [DescribeAgent] #
Show DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods showsPrec :: Int -> DescribeAgent -> ShowS # show :: DescribeAgent -> String # showList :: [DescribeAgent] -> ShowS #
Generic DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Associated Types type Rep DescribeAgent :: Type -> Type # Methods from :: DescribeAgent -> Rep DescribeAgent x # to :: Rep DescribeAgent x -> DescribeAgent #
NFData DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods rnf :: DescribeAgent -> () #
Hashable DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods hashWithSalt :: Int -> DescribeAgent -> Int # hash :: DescribeAgent -> Int #
ToJSON DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods toJSON :: DescribeAgent -> Value # toEncoding :: DescribeAgent -> Encoding # toJSONList :: [DescribeAgent] -> Value # toEncodingList :: [DescribeAgent] -> Encoding #
AWSRequest DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Associated Types type AWSResponse DescribeAgent # Methods request :: DescribeAgent -> Request DescribeAgent # response :: MonadResource m => Logger -> Service -> Proxy DescribeAgent -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DescribeAgent))) #
ToHeaders DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods toHeaders :: DescribeAgent -> [Header] #
ToPath DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods toPath :: DescribeAgent -> ByteString #
ToQuery DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods toQuery :: DescribeAgent -> QueryString #
type Rep DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent type Rep DescribeAgent = D1 ('MetaData "DescribeAgent" "Amazonka.DataSync.DescribeAgent" "libZSservicesZSamazonka-datasyncZSamazonka-datasync" 'False) (C1 ('MetaCons "DescribeAgent'" 'PrefixI 'True) (S1 ('MetaSel ('Just "agentArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))
type AWSResponse DescribeAgent Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent type AWSResponse DescribeAgent = DescribeAgentResponse

newDescribeAgent Source #

Arguments

:: Text	`$sel:agentArn:DescribeAgent'`
-> DescribeAgent

Create a value of DescribeAgent with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:agentArn:DescribeAgent', describeAgent_agentArn - The Amazon Resource Name (ARN) of the agent to describe.

Request Lenses

describeAgent_agentArn :: Lens' DescribeAgent Text Source #

The Amazon Resource Name (ARN) of the agent to describe.

Destructuring the Response

data DescribeAgentResponse Source #

DescribeAgentResponse

See: newDescribeAgentResponse smart constructor.

Constructors

DescribeAgentResponse'

Fields

creationTime :: Maybe POSIX
The time that the agent was activated (that is, created in your account).
status :: Maybe AgentStatus
The status of the agent. If the status is ONLINE, then the agent is configured properly and is available to use. The Running status is the normal running status for an agent. If the status is OFFLINE, the agent's VM is turned off or the agent is in an unhealthy state. When the issue that caused the unhealthy state is resolved, the agent returns to ONLINE status.
privateLinkConfig :: Maybe PrivateLinkConfig
The subnet and the security group that DataSync used to access a VPC endpoint.
endpointType :: Maybe 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.
lastConnectionTime :: Maybe POSIX
The time that the agent last connected to DataSync.
agentArn :: Maybe Text
The Amazon Resource Name (ARN) of the agent.
name :: Maybe Text
The name of the agent.
httpStatus :: Int
The response's http status code.

Instances

Instances details

Eq DescribeAgentResponse Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods (==) :: DescribeAgentResponse -> DescribeAgentResponse -> Bool # (/=) :: DescribeAgentResponse -> DescribeAgentResponse -> Bool #
Read DescribeAgentResponse Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods readsPrec :: Int -> ReadS DescribeAgentResponse # readList :: ReadS [DescribeAgentResponse] # readPrec :: ReadPrec DescribeAgentResponse # readListPrec :: ReadPrec [DescribeAgentResponse] #
Show DescribeAgentResponse Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods showsPrec :: Int -> DescribeAgentResponse -> ShowS # show :: DescribeAgentResponse -> String # showList :: [DescribeAgentResponse] -> ShowS #
Generic DescribeAgentResponse Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Associated Types type Rep DescribeAgentResponse :: Type -> Type # Methods from :: DescribeAgentResponse -> Rep DescribeAgentResponse x # to :: Rep DescribeAgentResponse x -> DescribeAgentResponse #
NFData DescribeAgentResponse Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent Methods rnf :: DescribeAgentResponse -> () #
type Rep DescribeAgentResponse Source #
Instance details Defined in Amazonka.DataSync.DescribeAgent type Rep DescribeAgentResponse = D1 ('MetaData "DescribeAgentResponse" "Amazonka.DataSync.DescribeAgent" "libZSservicesZSamazonka-datasyncZSamazonka-datasync" 'False) (C1 ('MetaCons "DescribeAgentResponse'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "creationTime") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :: S1 ('MetaSel ('Just "status") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe AgentStatus))) :: (S1 ('MetaSel ('Just "privateLinkConfig") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe PrivateLinkConfig)) :: S1 ('MetaSel ('Just "endpointType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe EndpointType)))) :: ((S1 ('MetaSel ('Just "lastConnectionTime") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :: S1 ('MetaSel ('Just "agentArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))

newDescribeAgentResponse Source #

Arguments

:: Int	`$sel:httpStatus:DescribeAgentResponse'`
-> DescribeAgentResponse

Create a value of DescribeAgentResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:creationTime:DescribeAgentResponse', describeAgentResponse_creationTime - The time that the agent was activated (that is, created in your account).

$sel:status:DescribeAgentResponse', describeAgentResponse_status - The status of the agent. If the status is ONLINE, then the agent is configured properly and is available to use. The Running status is the normal running status for an agent. If the status is OFFLINE, the agent's VM is turned off or the agent is in an unhealthy state. When the issue that caused the unhealthy state is resolved, the agent returns to ONLINE status.

$sel:privateLinkConfig:DescribeAgentResponse', describeAgentResponse_privateLinkConfig - The subnet and the security group that DataSync used to access a VPC endpoint.

$sel:endpointType:DescribeAgentResponse', describeAgentResponse_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.

$sel:lastConnectionTime:DescribeAgentResponse', describeAgentResponse_lastConnectionTime - The time that the agent last connected to DataSync.

$sel:agentArn:DescribeAgent', describeAgentResponse_agentArn - The Amazon Resource Name (ARN) of the agent.

$sel:name:DescribeAgentResponse', describeAgentResponse_name - The name of the agent.

$sel:httpStatus:DescribeAgentResponse', describeAgentResponse_httpStatus - The response's http status code.

Response Lenses

describeAgentResponse_creationTime :: Lens' DescribeAgentResponse (Maybe UTCTime) Source #

The time that the agent was activated (that is, created in your account).

describeAgentResponse_status :: Lens' DescribeAgentResponse (Maybe AgentStatus) Source #

The status of the agent. If the status is ONLINE, then the agent is configured properly and is available to use. The Running status is the normal running status for an agent. If the status is OFFLINE, the agent's VM is turned off or the agent is in an unhealthy state. When the issue that caused the unhealthy state is resolved, the agent returns to ONLINE status.

describeAgentResponse_privateLinkConfig :: Lens' DescribeAgentResponse (Maybe PrivateLinkConfig) Source #

The subnet and the security group that DataSync used to access a VPC endpoint.

describeAgentResponse_endpointType :: Lens' DescribeAgentResponse (Maybe EndpointType) Source #

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.

describeAgentResponse_lastConnectionTime :: Lens' DescribeAgentResponse (Maybe UTCTime) Source #

The time that the agent last connected to DataSync.

describeAgentResponse_agentArn :: Lens' DescribeAgentResponse (Maybe Text) Source #

The Amazon Resource Name (ARN) of the agent.

describeAgentResponse_name :: Lens' DescribeAgentResponse (Maybe Text) Source #

The name of the agent.

describeAgentResponse_httpStatus :: Lens' DescribeAgentResponse Int Source #

The response's http status code.