amazonka-opsworks-cm-2.0: Amazon OpsWorks CM SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.OpsWorksCM.DescribeEvents

Description

Describes events for a specified server. Results are ordered by time, with newest events first.

This operation is synchronous.

A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

This operation returns paginated results.

Synopsis

Creating a Request

data DescribeEvents Source #

See: newDescribeEvents smart constructor.

Constructors

DescribeEvents' 

Fields

  • maxResults :: Maybe Natural

    To receive a paginated response, use this parameter to specify the maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

  • nextToken :: Maybe Text

    NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeEvents again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

  • serverName :: Text

    The name of the server for which you want to view events.

Instances

Instances details
ToJSON DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

ToHeaders DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

ToPath DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

ToQuery DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

AWSPager DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

AWSRequest DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

Associated Types

type AWSResponse DescribeEvents #

Generic DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

Associated Types

type Rep DescribeEvents :: Type -> Type #

Read DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

Show DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

NFData DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

Methods

rnf :: DescribeEvents -> () #

Eq DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

Hashable DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

type AWSResponse DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

type Rep DescribeEvents Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

type Rep DescribeEvents = D1 ('MetaData "DescribeEvents" "Amazonka.OpsWorksCM.DescribeEvents" "amazonka-opsworks-cm-2.0-4eRKS676FdFBzYMnhnI9o" 'False) (C1 ('MetaCons "DescribeEvents'" 'PrefixI 'True) (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "serverName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))

newDescribeEvents Source #

Create a value of DescribeEvents 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:maxResults:DescribeEvents', describeEvents_maxResults - To receive a paginated response, use this parameter to specify the maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

DescribeEvents, describeEvents_nextToken - NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeEvents again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

DescribeEvents, describeEvents_serverName - The name of the server for which you want to view events.

Request Lenses

describeEvents_maxResults :: Lens' DescribeEvents (Maybe Natural) Source #

To receive a paginated response, use this parameter to specify the maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

describeEvents_nextToken :: Lens' DescribeEvents (Maybe Text) Source #

NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeEvents again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

describeEvents_serverName :: Lens' DescribeEvents Text Source #

The name of the server for which you want to view events.

Destructuring the Response

data DescribeEventsResponse Source #

See: newDescribeEventsResponse smart constructor.

Constructors

DescribeEventsResponse' 

Fields

  • nextToken :: Maybe Text

    NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeEvents again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

  • serverEvents :: Maybe [ServerEvent]

    Contains the response to a DescribeEvents request.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic DescribeEventsResponse Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

Associated Types

type Rep DescribeEventsResponse :: Type -> Type #

Read DescribeEventsResponse Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

Show DescribeEventsResponse Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

NFData DescribeEventsResponse Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

Methods

rnf :: DescribeEventsResponse -> () #

Eq DescribeEventsResponse Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

type Rep DescribeEventsResponse Source # 
Instance details

Defined in Amazonka.OpsWorksCM.DescribeEvents

type Rep DescribeEventsResponse = D1 ('MetaData "DescribeEventsResponse" "Amazonka.OpsWorksCM.DescribeEvents" "amazonka-opsworks-cm-2.0-4eRKS676FdFBzYMnhnI9o" 'False) (C1 ('MetaCons "DescribeEventsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "serverEvents") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [ServerEvent])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribeEventsResponse Source #

Create a value of DescribeEventsResponse 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:

DescribeEvents, describeEventsResponse_nextToken - NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeEvents again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

$sel:serverEvents:DescribeEventsResponse', describeEventsResponse_serverEvents - Contains the response to a DescribeEvents request.

$sel:httpStatus:DescribeEventsResponse', describeEventsResponse_httpStatus - The response's http status code.

Response Lenses

describeEventsResponse_nextToken :: Lens' DescribeEventsResponse (Maybe Text) Source #

NextToken is a string that is returned in some command responses. It indicates that not all entries have been returned, and that you must run at least one more request to get remaining items. To get remaining results, call DescribeEvents again, and assign the token from the previous results as the value of the nextToken parameter. If there are no more results, the response object's nextToken parameter value is null. Setting a nextToken value that was not returned in your previous results causes an InvalidNextTokenException to occur.

describeEventsResponse_serverEvents :: Lens' DescribeEventsResponse (Maybe [ServerEvent]) Source #

Contains the response to a DescribeEvents request.