amazonka-scheduler-2.0: Amazon EventBridge Scheduler 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.Scheduler.GetSchedule

Description

Retrieves the specified schedule.

Synopsis

Creating a Request

data GetSchedule Source #

See: newGetSchedule smart constructor.

Constructors

GetSchedule' 

Fields

  • groupName :: Maybe Text

    The name of the schedule group associated with this schedule. If you omit this, EventBridge Scheduler assumes that the schedule is associated with the default group.

  • name :: Text

    The name of the schedule to retrieve.

Instances

Instances details
ToHeaders GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

Methods

toHeaders :: GetSchedule -> [Header] #

ToPath GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

ToQuery GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

AWSRequest GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

Associated Types

type AWSResponse GetSchedule #

Generic GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

Associated Types

type Rep GetSchedule :: Type -> Type #

Read GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

Show GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

NFData GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

Methods

rnf :: GetSchedule -> () #

Eq GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

Hashable GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

type AWSResponse GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

type Rep GetSchedule Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

type Rep GetSchedule = D1 ('MetaData "GetSchedule" "Amazonka.Scheduler.GetSchedule" "amazonka-scheduler-2.0-8LKlva3Whvt7TpHIvtcn6a" 'False) (C1 ('MetaCons "GetSchedule'" 'PrefixI 'True) (S1 ('MetaSel ('Just "groupName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))

newGetSchedule Source #

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

GetSchedule, getSchedule_groupName - The name of the schedule group associated with this schedule. If you omit this, EventBridge Scheduler assumes that the schedule is associated with the default group.

GetSchedule, getSchedule_name - The name of the schedule to retrieve.

Request Lenses

getSchedule_groupName :: Lens' GetSchedule (Maybe Text) Source #

The name of the schedule group associated with this schedule. If you omit this, EventBridge Scheduler assumes that the schedule is associated with the default group.

getSchedule_name :: Lens' GetSchedule Text Source #

The name of the schedule to retrieve.

Destructuring the Response

data GetScheduleResponse Source #

See: newGetScheduleResponse smart constructor.

Constructors

GetScheduleResponse' 

Fields

  • arn :: Maybe Text

    The Amazon Resource Name (ARN) of the schedule.

  • creationDate :: Maybe POSIX

    The time at which the schedule was created.

  • description :: Maybe Text

    The description of the schedule.

  • endDate :: Maybe POSIX

    The date, in UTC, before which the schedule can invoke its target. Depending on the schedule's recurrence expression, invocations might stop on, or before, the EndDate you specify. EventBridge Scheduler ignores EndDate for one-time schedules.

  • flexibleTimeWindow :: Maybe FlexibleTimeWindow

    Allows you to configure a time window during which EventBridge Scheduler invokes the schedule.

  • groupName :: Maybe Text

    The name of the schedule group associated with this schedule.

  • kmsKeyArn :: Maybe Text

    The ARN for a customer managed KMS Key that is be used to encrypt and decrypt your data.

  • lastModificationDate :: Maybe POSIX

    The time at which the schedule was last modified.

  • name :: Maybe Text

    The name of the schedule.

  • scheduleExpression :: Maybe Text

    The expression that defines when the schedule runs. The following formats are supported.

    • at expression - at(yyyy-mm-ddThh:mm:ss)
    • rate expression - rate(unit value)
    • cron expression - cron(fields)

    You can use at expressions to create one-time schedules that invoke a target once, at the time and in the time zone, that you specify. You can use rate and cron expressions to create recurring schedules. Rate-based schedules are useful when you want to invoke a target at regular intervals, such as every 15 minutes or every five days. Cron-based schedules are useful when you want to invoke a target periodically at a specific time, such as at 8:00 am (UTC+0) every 1st day of the month.

    A cron expression consists of six fields separated by white spaces: (minutes hours day_of_month month day_of_week year).

    A rate expression consists of a value as a positive integer, and a unit with the following options: minute | minutes | hour | hours | day | days

    For more information and examples, see Schedule types on EventBridge Scheduler in the EventBridge Scheduler User Guide.

  • scheduleExpressionTimezone :: Maybe Text

    The timezone in which the scheduling expression is evaluated.

  • startDate :: Maybe POSIX

    The date, in UTC, after which the schedule can begin invoking its target. Depending on the schedule's recurrence expression, invocations might occur on, or after, the StartDate you specify. EventBridge Scheduler ignores StartDate for one-time schedules.

  • state :: Maybe ScheduleState

    Specifies whether the schedule is enabled or disabled.

  • target :: Maybe Target

    The schedule target.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic GetScheduleResponse Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

Associated Types

type Rep GetScheduleResponse :: Type -> Type #

Read GetScheduleResponse Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

Show GetScheduleResponse Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

NFData GetScheduleResponse Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

Methods

rnf :: GetScheduleResponse -> () #

Eq GetScheduleResponse Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

type Rep GetScheduleResponse Source # 
Instance details

Defined in Amazonka.Scheduler.GetSchedule

type Rep GetScheduleResponse = D1 ('MetaData "GetScheduleResponse" "Amazonka.Scheduler.GetSchedule" "amazonka-scheduler-2.0-8LKlva3Whvt7TpHIvtcn6a" 'False) (C1 ('MetaCons "GetScheduleResponse'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "arn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "creationDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :*: S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "endDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :*: S1 ('MetaSel ('Just "flexibleTimeWindow") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe FlexibleTimeWindow))) :*: (S1 ('MetaSel ('Just "groupName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "kmsKeyArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))) :*: (((S1 ('MetaSel ('Just "lastModificationDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :*: S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "scheduleExpression") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "scheduleExpressionTimezone") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "startDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :*: S1 ('MetaSel ('Just "state") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ScheduleState))) :*: (S1 ('MetaSel ('Just "target") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Target)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))))

newGetScheduleResponse Source #

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

GetScheduleResponse, getScheduleResponse_arn - The Amazon Resource Name (ARN) of the schedule.

GetScheduleResponse, getScheduleResponse_creationDate - The time at which the schedule was created.

$sel:description:GetScheduleResponse', getScheduleResponse_description - The description of the schedule.

$sel:endDate:GetScheduleResponse', getScheduleResponse_endDate - The date, in UTC, before which the schedule can invoke its target. Depending on the schedule's recurrence expression, invocations might stop on, or before, the EndDate you specify. EventBridge Scheduler ignores EndDate for one-time schedules.

$sel:flexibleTimeWindow:GetScheduleResponse', getScheduleResponse_flexibleTimeWindow - Allows you to configure a time window during which EventBridge Scheduler invokes the schedule.

GetSchedule, getScheduleResponse_groupName - The name of the schedule group associated with this schedule.

$sel:kmsKeyArn:GetScheduleResponse', getScheduleResponse_kmsKeyArn - The ARN for a customer managed KMS Key that is be used to encrypt and decrypt your data.

GetScheduleResponse, getScheduleResponse_lastModificationDate - The time at which the schedule was last modified.

GetSchedule, getScheduleResponse_name - The name of the schedule.

$sel:scheduleExpression:GetScheduleResponse', getScheduleResponse_scheduleExpression - The expression that defines when the schedule runs. The following formats are supported.

  • at expression - at(yyyy-mm-ddThh:mm:ss)
  • rate expression - rate(unit value)
  • cron expression - cron(fields)

You can use at expressions to create one-time schedules that invoke a target once, at the time and in the time zone, that you specify. You can use rate and cron expressions to create recurring schedules. Rate-based schedules are useful when you want to invoke a target at regular intervals, such as every 15 minutes or every five days. Cron-based schedules are useful when you want to invoke a target periodically at a specific time, such as at 8:00 am (UTC+0) every 1st day of the month.

A cron expression consists of six fields separated by white spaces: (minutes hours day_of_month month day_of_week year).

A rate expression consists of a value as a positive integer, and a unit with the following options: minute | minutes | hour | hours | day | days

For more information and examples, see Schedule types on EventBridge Scheduler in the EventBridge Scheduler User Guide.

$sel:scheduleExpressionTimezone:GetScheduleResponse', getScheduleResponse_scheduleExpressionTimezone - The timezone in which the scheduling expression is evaluated.

$sel:startDate:GetScheduleResponse', getScheduleResponse_startDate - The date, in UTC, after which the schedule can begin invoking its target. Depending on the schedule's recurrence expression, invocations might occur on, or after, the StartDate you specify. EventBridge Scheduler ignores StartDate for one-time schedules.

GetScheduleResponse, getScheduleResponse_state - Specifies whether the schedule is enabled or disabled.

GetScheduleResponse, getScheduleResponse_target - The schedule target.

$sel:httpStatus:GetScheduleResponse', getScheduleResponse_httpStatus - The response's http status code.

Response Lenses

getScheduleResponse_arn :: Lens' GetScheduleResponse (Maybe Text) Source #

The Amazon Resource Name (ARN) of the schedule.

getScheduleResponse_creationDate :: Lens' GetScheduleResponse (Maybe UTCTime) Source #

The time at which the schedule was created.

getScheduleResponse_endDate :: Lens' GetScheduleResponse (Maybe UTCTime) Source #

The date, in UTC, before which the schedule can invoke its target. Depending on the schedule's recurrence expression, invocations might stop on, or before, the EndDate you specify. EventBridge Scheduler ignores EndDate for one-time schedules.

getScheduleResponse_flexibleTimeWindow :: Lens' GetScheduleResponse (Maybe FlexibleTimeWindow) Source #

Allows you to configure a time window during which EventBridge Scheduler invokes the schedule.

getScheduleResponse_groupName :: Lens' GetScheduleResponse (Maybe Text) Source #

The name of the schedule group associated with this schedule.

getScheduleResponse_kmsKeyArn :: Lens' GetScheduleResponse (Maybe Text) Source #

The ARN for a customer managed KMS Key that is be used to encrypt and decrypt your data.

getScheduleResponse_lastModificationDate :: Lens' GetScheduleResponse (Maybe UTCTime) Source #

The time at which the schedule was last modified.

getScheduleResponse_scheduleExpression :: Lens' GetScheduleResponse (Maybe Text) Source #

The expression that defines when the schedule runs. The following formats are supported.

  • at expression - at(yyyy-mm-ddThh:mm:ss)
  • rate expression - rate(unit value)
  • cron expression - cron(fields)

You can use at expressions to create one-time schedules that invoke a target once, at the time and in the time zone, that you specify. You can use rate and cron expressions to create recurring schedules. Rate-based schedules are useful when you want to invoke a target at regular intervals, such as every 15 minutes or every five days. Cron-based schedules are useful when you want to invoke a target periodically at a specific time, such as at 8:00 am (UTC+0) every 1st day of the month.

A cron expression consists of six fields separated by white spaces: (minutes hours day_of_month month day_of_week year).

A rate expression consists of a value as a positive integer, and a unit with the following options: minute | minutes | hour | hours | day | days

For more information and examples, see Schedule types on EventBridge Scheduler in the EventBridge Scheduler User Guide.

getScheduleResponse_scheduleExpressionTimezone :: Lens' GetScheduleResponse (Maybe Text) Source #

The timezone in which the scheduling expression is evaluated.

getScheduleResponse_startDate :: Lens' GetScheduleResponse (Maybe UTCTime) Source #

The date, in UTC, after which the schedule can begin invoking its target. Depending on the schedule's recurrence expression, invocations might occur on, or after, the StartDate you specify. EventBridge Scheduler ignores StartDate for one-time schedules.

getScheduleResponse_state :: Lens' GetScheduleResponse (Maybe ScheduleState) Source #

Specifies whether the schedule is enabled or disabled.