amazonka-route53-1.4.5: Amazon Route 53 SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.Route53.ListTrafficPolicyInstancesByPolicy

Contents

Description

Gets information about the traffic policy instances that you created by using a specify traffic policy version.

Send a GET request to the /Route 53 API version /trafficpolicyinstance resource and include the ID and version of the traffic policy.

Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

The response includes five values that help you navigate from one group of MaxItems traffic policy instances to the next:

  • IsTruncated

If the value of IsTruncated in the response is true , there are more traffic policy instances associated with the specified traffic policy.

If IsTruncated is false , this response includes the last traffic policy instance that is associated with the specified traffic policy.

  • MaxItems

The value that you specified for the MaxItems parameter in the request that produced the current response.

  • HostedZoneIdMarker , TrafficPolicyInstanceNameMarker , and TrafficPolicyInstanceTypeMarker

If IsTruncated is true , these values in the response represent the first traffic policy instance in the next group of MaxItems traffic policy instances. To list more traffic policy instances, make another call to ListTrafficPolicyInstancesByPolicy , and specify these values in the corresponding request parameters.

If IsTruncated is false , all three elements are omitted from the response.

Synopsis

Creating a Request

listTrafficPolicyInstancesByPolicy Source #

Creates a value of ListTrafficPolicyInstancesByPolicy with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

  • ltpibpTrafficPolicyInstanceTypeMarker - For the first request to ListTrafficPolicyInstancesByPolicy , omit this value. If the value of IsTruncated in the previous response was true , TrafficPolicyInstanceTypeMarker is the DNS type of the first traffic policy instance in the next group of MaxItems traffic policy instances. If the value of IsTruncated in the previous response was false , there are no more traffic policy instances to get for this hosted zone.
  • ltpibpMaxItems - The maximum number of traffic policy instances to be included in the response body for this request. If you have more than MaxItems traffic policy instances, the value of the IsTruncated element in the response is true , and the values of HostedZoneIdMarker , TrafficPolicyInstanceNameMarker , and TrafficPolicyInstanceTypeMarker represent the first traffic policy instance in the next group of MaxItems traffic policy instances.
  • ltpibpHostedZoneIdMarker - For the first request to ListTrafficPolicyInstancesByPolicy , omit this value. If the value of IsTruncated in the previous response was true , HostedZoneIdMarker is the ID of the hosted zone for the first traffic policy instance in the next group of MaxItems traffic policy instances. If the value of IsTruncated in the previous response was false , there are no more traffic policy instances to get for this hosted zone. If the value of IsTruncated in the previous response was false , omit this value.
  • ltpibpTrafficPolicyInstanceNameMarker - For the first request to ListTrafficPolicyInstancesByPolicy , omit this value. If the value of IsTruncated in the previous response was true , TrafficPolicyInstanceNameMarker is the name of the first traffic policy instance in the next group of MaxItems traffic policy instances. If the value of IsTruncated in the previous response was false , there are no more traffic policy instances to get for this hosted zone. If the value of IsTruncated in the previous response was false , omit this value.
  • ltpibpTrafficPolicyId - The ID of the traffic policy for which you want to list traffic policy instances.
  • ltpibpTrafficPolicyVersion - The version of the traffic policy for which you want to list traffic policy instances. The version must be associated with the traffic policy that is specified by TrafficPolicyId .

data ListTrafficPolicyInstancesByPolicy Source #

A complex type that contains the information about the request to list your traffic policy instances.

See: listTrafficPolicyInstancesByPolicy smart constructor.

Instances

Eq ListTrafficPolicyInstancesByPolicy Source # 
Data ListTrafficPolicyInstancesByPolicy Source # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ListTrafficPolicyInstancesByPolicy -> c ListTrafficPolicyInstancesByPolicy #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ListTrafficPolicyInstancesByPolicy #

toConstr :: ListTrafficPolicyInstancesByPolicy -> Constr #

dataTypeOf :: ListTrafficPolicyInstancesByPolicy -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c ListTrafficPolicyInstancesByPolicy) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ListTrafficPolicyInstancesByPolicy) #

gmapT :: (forall b. Data b => b -> b) -> ListTrafficPolicyInstancesByPolicy -> ListTrafficPolicyInstancesByPolicy #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ListTrafficPolicyInstancesByPolicy -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ListTrafficPolicyInstancesByPolicy -> r #

gmapQ :: (forall d. Data d => d -> u) -> ListTrafficPolicyInstancesByPolicy -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> ListTrafficPolicyInstancesByPolicy -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ListTrafficPolicyInstancesByPolicy -> m ListTrafficPolicyInstancesByPolicy #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ListTrafficPolicyInstancesByPolicy -> m ListTrafficPolicyInstancesByPolicy #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ListTrafficPolicyInstancesByPolicy -> m ListTrafficPolicyInstancesByPolicy #

Read ListTrafficPolicyInstancesByPolicy Source # 
Show ListTrafficPolicyInstancesByPolicy Source # 
Generic ListTrafficPolicyInstancesByPolicy Source # 
Hashable ListTrafficPolicyInstancesByPolicy Source # 
NFData ListTrafficPolicyInstancesByPolicy Source # 
AWSRequest ListTrafficPolicyInstancesByPolicy Source # 
ToPath ListTrafficPolicyInstancesByPolicy Source # 
ToHeaders ListTrafficPolicyInstancesByPolicy Source # 
ToQuery ListTrafficPolicyInstancesByPolicy Source # 
type Rep ListTrafficPolicyInstancesByPolicy Source # 
type Rep ListTrafficPolicyInstancesByPolicy = D1 (MetaData "ListTrafficPolicyInstancesByPolicy" "Network.AWS.Route53.ListTrafficPolicyInstancesByPolicy" "amazonka-route53-1.4.5-DoQ7bXPvDC1HwWocjSAILy" False) (C1 (MetaCons "ListTrafficPolicyInstancesByPolicy'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_ltpibpTrafficPolicyInstanceTypeMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe RecordType))) ((:*:) (S1 (MetaSel (Just Symbol "_ltpibpMaxItems") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_ltpibpHostedZoneIdMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ResourceId))))) ((:*:) (S1 (MetaSel (Just Symbol "_ltpibpTrafficPolicyInstanceNameMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_ltpibpTrafficPolicyId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_ltpibpTrafficPolicyVersion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Nat))))))
type Rs ListTrafficPolicyInstancesByPolicy Source # 

Request Lenses

ltpibpTrafficPolicyInstanceTypeMarker :: Lens' ListTrafficPolicyInstancesByPolicy (Maybe RecordType) Source #

For the first request to ListTrafficPolicyInstancesByPolicy , omit this value. If the value of IsTruncated in the previous response was true , TrafficPolicyInstanceTypeMarker is the DNS type of the first traffic policy instance in the next group of MaxItems traffic policy instances. If the value of IsTruncated in the previous response was false , there are no more traffic policy instances to get for this hosted zone.

ltpibpMaxItems :: Lens' ListTrafficPolicyInstancesByPolicy (Maybe Text) Source #

The maximum number of traffic policy instances to be included in the response body for this request. If you have more than MaxItems traffic policy instances, the value of the IsTruncated element in the response is true , and the values of HostedZoneIdMarker , TrafficPolicyInstanceNameMarker , and TrafficPolicyInstanceTypeMarker represent the first traffic policy instance in the next group of MaxItems traffic policy instances.

ltpibpHostedZoneIdMarker :: Lens' ListTrafficPolicyInstancesByPolicy (Maybe ResourceId) Source #

For the first request to ListTrafficPolicyInstancesByPolicy , omit this value. If the value of IsTruncated in the previous response was true , HostedZoneIdMarker is the ID of the hosted zone for the first traffic policy instance in the next group of MaxItems traffic policy instances. If the value of IsTruncated in the previous response was false , there are no more traffic policy instances to get for this hosted zone. If the value of IsTruncated in the previous response was false , omit this value.

ltpibpTrafficPolicyInstanceNameMarker :: Lens' ListTrafficPolicyInstancesByPolicy (Maybe Text) Source #

For the first request to ListTrafficPolicyInstancesByPolicy , omit this value. If the value of IsTruncated in the previous response was true , TrafficPolicyInstanceNameMarker is the name of the first traffic policy instance in the next group of MaxItems traffic policy instances. If the value of IsTruncated in the previous response was false , there are no more traffic policy instances to get for this hosted zone. If the value of IsTruncated in the previous response was false , omit this value.

ltpibpTrafficPolicyId :: Lens' ListTrafficPolicyInstancesByPolicy Text Source #

The ID of the traffic policy for which you want to list traffic policy instances.

ltpibpTrafficPolicyVersion :: Lens' ListTrafficPolicyInstancesByPolicy Natural Source #

The version of the traffic policy for which you want to list traffic policy instances. The version must be associated with the traffic policy that is specified by TrafficPolicyId .

Destructuring the Response

listTrafficPolicyInstancesByPolicyResponse Source #

Creates a value of ListTrafficPolicyInstancesByPolicyResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

  • ltpibprsTrafficPolicyInstanceTypeMarker - If IsTruncated is true , TrafficPolicyInstanceTypeMarker is the DNS type of the resource record sets that are associated with the first traffic policy instance in the next group of MaxItems traffic policy instances.
  • ltpibprsHostedZoneIdMarker - If IsTruncated is true , HostedZoneIdMarker is the ID of the hosted zone of the first traffic policy instance in the next group of MaxItems traffic policy instances.
  • ltpibprsTrafficPolicyInstanceNameMarker - If IsTruncated is true , TrafficPolicyInstanceNameMarker is the name of the first traffic policy instance in the next group of MaxItems traffic policy instances.
  • ltpibprsResponseStatus - -- | The response status code.
  • ltpibprsTrafficPolicyInstances - A list that contains one TrafficPolicyInstance element for each traffic policy instance that matches the elements in the request.
  • ltpibprsIsTruncated - A flag that indicates whether there are more traffic policy instances to be listed. If the response was truncated, you can get the next group of MaxItems traffic policy instances by calling ListTrafficPolicyInstancesByPolicy again and specifying the values of the HostedZoneIdMarker , TrafficPolicyInstanceNameMarker , and TrafficPolicyInstanceTypeMarker elements in the corresponding request parameters.
  • ltpibprsMaxItems - The value that you specified for the MaxItems parameter in the call to ListTrafficPolicyInstancesByPolicy that produced the current response.

data ListTrafficPolicyInstancesByPolicyResponse Source #

A complex type that contains the response information for the request.

See: listTrafficPolicyInstancesByPolicyResponse smart constructor.

Instances

Eq ListTrafficPolicyInstancesByPolicyResponse Source # 
Data ListTrafficPolicyInstancesByPolicyResponse Source # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ListTrafficPolicyInstancesByPolicyResponse -> c ListTrafficPolicyInstancesByPolicyResponse #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ListTrafficPolicyInstancesByPolicyResponse #

toConstr :: ListTrafficPolicyInstancesByPolicyResponse -> Constr #

dataTypeOf :: ListTrafficPolicyInstancesByPolicyResponse -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c ListTrafficPolicyInstancesByPolicyResponse) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ListTrafficPolicyInstancesByPolicyResponse) #

gmapT :: (forall b. Data b => b -> b) -> ListTrafficPolicyInstancesByPolicyResponse -> ListTrafficPolicyInstancesByPolicyResponse #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ListTrafficPolicyInstancesByPolicyResponse -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ListTrafficPolicyInstancesByPolicyResponse -> r #

gmapQ :: (forall d. Data d => d -> u) -> ListTrafficPolicyInstancesByPolicyResponse -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> ListTrafficPolicyInstancesByPolicyResponse -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ListTrafficPolicyInstancesByPolicyResponse -> m ListTrafficPolicyInstancesByPolicyResponse #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ListTrafficPolicyInstancesByPolicyResponse -> m ListTrafficPolicyInstancesByPolicyResponse #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ListTrafficPolicyInstancesByPolicyResponse -> m ListTrafficPolicyInstancesByPolicyResponse #

Read ListTrafficPolicyInstancesByPolicyResponse Source # 
Show ListTrafficPolicyInstancesByPolicyResponse Source # 
Generic ListTrafficPolicyInstancesByPolicyResponse Source # 
NFData ListTrafficPolicyInstancesByPolicyResponse Source # 
type Rep ListTrafficPolicyInstancesByPolicyResponse Source # 
type Rep ListTrafficPolicyInstancesByPolicyResponse = D1 (MetaData "ListTrafficPolicyInstancesByPolicyResponse" "Network.AWS.Route53.ListTrafficPolicyInstancesByPolicy" "amazonka-route53-1.4.5-DoQ7bXPvDC1HwWocjSAILy" False) (C1 (MetaCons "ListTrafficPolicyInstancesByPolicyResponse'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_ltpibprsTrafficPolicyInstanceTypeMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe RecordType))) ((:*:) (S1 (MetaSel (Just Symbol "_ltpibprsHostedZoneIdMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ResourceId))) (S1 (MetaSel (Just Symbol "_ltpibprsTrafficPolicyInstanceNameMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_ltpibprsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int)) (S1 (MetaSel (Just Symbol "_ltpibprsTrafficPolicyInstances") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 [TrafficPolicyInstance]))) ((:*:) (S1 (MetaSel (Just Symbol "_ltpibprsIsTruncated") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Bool)) (S1 (MetaSel (Just Symbol "_ltpibprsMaxItems") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))))

Response Lenses

ltpibprsTrafficPolicyInstanceTypeMarker :: Lens' ListTrafficPolicyInstancesByPolicyResponse (Maybe RecordType) Source #

If IsTruncated is true , TrafficPolicyInstanceTypeMarker is the DNS type of the resource record sets that are associated with the first traffic policy instance in the next group of MaxItems traffic policy instances.

ltpibprsHostedZoneIdMarker :: Lens' ListTrafficPolicyInstancesByPolicyResponse (Maybe ResourceId) Source #

If IsTruncated is true , HostedZoneIdMarker is the ID of the hosted zone of the first traffic policy instance in the next group of MaxItems traffic policy instances.

ltpibprsTrafficPolicyInstanceNameMarker :: Lens' ListTrafficPolicyInstancesByPolicyResponse (Maybe Text) Source #

If IsTruncated is true , TrafficPolicyInstanceNameMarker is the name of the first traffic policy instance in the next group of MaxItems traffic policy instances.

ltpibprsTrafficPolicyInstances :: Lens' ListTrafficPolicyInstancesByPolicyResponse [TrafficPolicyInstance] Source #

A list that contains one TrafficPolicyInstance element for each traffic policy instance that matches the elements in the request.

ltpibprsIsTruncated :: Lens' ListTrafficPolicyInstancesByPolicyResponse Bool Source #

A flag that indicates whether there are more traffic policy instances to be listed. If the response was truncated, you can get the next group of MaxItems traffic policy instances by calling ListTrafficPolicyInstancesByPolicy again and specifying the values of the HostedZoneIdMarker , TrafficPolicyInstanceNameMarker , and TrafficPolicyInstanceTypeMarker elements in the corresponding request parameters.

ltpibprsMaxItems :: Lens' ListTrafficPolicyInstancesByPolicyResponse Text Source #

The value that you specified for the MaxItems parameter in the call to ListTrafficPolicyInstancesByPolicy that produced the current response.