describe_maintenance_start_time

describe_maintenance_start_time(**kwargs)

Returns your gateway's weekly maintenance start time including the day and time of the week. Note that values are in terms of the gateway's time zone.

See also: AWS API Documentation

Request Syntax

response = client.describe_maintenance_start_time(
    GatewayARN='string'
)

Parameters

GatewayARN (string) --

[REQUIRED]

The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.

Return type

dict

Returns

Response Syntax

{
    'GatewayARN': 'string',
    'HourOfDay': 123,
    'MinuteOfHour': 123,
    'DayOfWeek': 123,
    'DayOfMonth': 123,
    'Timezone': 'string'
}

Response Structure

• (dict) --

  A JSON object containing the following fields:

  • DescribeMaintenanceStartTimeOutput$DayOfMonth
  • DescribeMaintenanceStartTimeOutput$DayOfWeek
  • DescribeMaintenanceStartTimeOutput$HourOfDay
  • DescribeMaintenanceStartTimeOutput$MinuteOfHour
  • DescribeMaintenanceStartTimeOutput$Timezone
  • GatewayARN (string) --

    The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.

  • HourOfDay (integer) --

    The hour component of the maintenance start time represented as hh , where hh is the hour (0 to 23). The hour of the day is in the time zone of the gateway.

  • MinuteOfHour (integer) --

    The minute component of the maintenance start time represented as mm , where mm is the minute (0 to 59). The minute of the hour is in the time zone of the gateway.

  • DayOfWeek (integer) --

    An ordinal number between 0 and 6 that represents the day of the week, where 0 represents Sunday and 6 represents Saturday. The day of week is in the time zone of the gateway.

  • DayOfMonth (integer) --

    The day of the month component of the maintenance start time represented as an ordinal number from 1 to 28, where 1 represents the first day of the month and 28 represents the last day of the month.

  • Timezone (string) --

    A value that indicates the time zone that is set for the gateway. The start time and day of week specified should be in the time zone of the gateway.

Exceptions

• StorageGateway.Client.exceptions.InvalidGatewayRequestException
• StorageGateway.Client.exceptions.InternalServerError

Examples

Returns your gateway's weekly maintenance start time including the day and time of the week.

response = client.describe_maintenance_start_time(
    GatewayARN='arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B',
)

print(response)

Expected Output:

{
    'DayOfWeek': 2,
    'GatewayARN': 'arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B',
    'HourOfDay': 15,
    'MinuteOfHour': 35,
    'Timezone': 'GMT+7:00',
    'ResponseMetadata': {
        '...': '...',
    },
}