| « PreviousNext » | |
   | Did this page help you? Yes | No | Tell us about it... |
UpdateGatewaySoftwareNow
Description
This operation updates the gateway virtual machine (VM) software if an update is available. The request immediately triggers the software update.
Note
When you make this request, you get a 200 OK success response immediately.
However, it might take some time for the update to complete. You can call DescribeGatewayInformation to verify
the gateway is in the STATE_RUNNING state. For more information, see DescribeGatewayInformation.
Important
A software update forces a system restart of your gateway. You can minimize the chance of any disruption to your applications by increasing your iSCSI Initiators’ timeouts. For more information about increasing iSCSI Initiator timeouts for Windows and Linux, see Customizing Your Windows iSCSI Settings and Customizing Your Linux iSCSI Settings, respectively.
Request
Syntax
POST / HTTP/1.1 Host: storagegateway.region.amazonaws.com Authorization:authorizationContent-Type: application/x-amz-json-1.1 x-amz-date:datex-amz-target: StorageGateway_20120630.UpdateGatewaySoftwareNow { "GatewayARN": "String" }
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
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.
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 initiates a gateway VM update.
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.UpdateGatewaySoftwareNow
{
"GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/mygateway"
}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"
} 
