AWS Storage Gateway
User Guide (API Version 2012-06-30)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

UpdateMaintenanceStartTime

Description

This operation updates a gateway's weekly maintenance start time information, including day and time of the week. The maintenance time is the time in your gateway's time zone.

Request

Syntax

POST / HTTP/1.1 
Host: storagegateway.region.amazonaws.com
Authorization: authorization
Content-Type: application/x-amz-json-1.1
x-amz-date: date
x-amz-target: StorageGateway_20120630.UpdateMaintenanceStartTime

{
 "GatewayARN": "String",
 "HourOfDay": "Number",
 "MinuteOfHour": "Number",
 "DayOfWeek": Number
}

JSON Fields

GatewayARN

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

Required: yes

Type: String

HourOfDay

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

Length: 2

Valid Values: hh, where hh is the hour (00 to 23).

Required: Yes

Type: Number

MinuteOfHour

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

Length: 2

Valid Values: mm, where mm is the minute (00 to 59).

Required: Yes

Type: Number

DayOfWeek

The maintenance start time day of the week.

Length: 1

Valid Values An integer between 0 and 6, where 0 represents Sunday and 6 represents Saturday.

Required: Yes

Type: Number

Response

Syntax

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Content-Type: application/x-amz-json-1.1
Content-length: payloadLength
Date: date

{
 "GatewayARN": "String"
}

JSON Fields

GatewayARN

The Amazon Resource Name (ARN) of the gateway whose maintenance start time is updated.

Type: String

Errors

This operation returns the following error codes in addition to exceptions common to all operations. For information about these errors and common exceptions, see Error Responses.

  • GatewayInternalError

  • GatewayNotConnected

  • GatewayNotFound

  • GatewayProxyNetworkConnectionBusy

  • InternalError

  • InvalidParameters

  • NotSupported

Examples

Example Request

The following example shows a request that updates the maintenance start time of mygateway.

POST / HTTP/1.1 
Host: storagegateway.us-east-1.amazonaws.com
Content-Type: application/x-amz-json-1.1
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120425/us-east-1/storagegateway/aws4_request, SignedHeaders=content-type;host;x-amz-date;x-amz-target, Signature=9cd5a3584d1d67d57e61f120f35102d6b3649066abdd4bf4bbcf05bd9f2f8fe2
x-amz-date: 20120912T120000Z
x-amz-target: StorageGateway_20120630.UpdateMaintenanceStartTime

{
 "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/mygateway",
 "TimeOfDay": 0,
 "MinuteOfHour": 30
 "DayOfWeek": 2
}

Example Response

HTTP/1.1 200 OK
x-amzn-RequestId: gur28r2rqlgb8vvs0mq17hlgij1q8glle1qeu3kpgg6f0kstauu0
Date: Wed, 12 Sep 2012 12:00:02 GMT
Content-Type: application/x-amz-json-1.1
Content-length: 85

{
  "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/mygateway"
}