AmazonStorageGatewayClient.UpdateGatewaySoftwareNow Method (UpdateGatewaySoftwareNowRequest)

Updates the gateway virtual machine (VM) software. The request immediately triggers the software update.

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.

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.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to UpdateGatewaySoftwareNowAsync.

Namespace: Amazon.StorageGateway
Assembly: AWSSDK.StorageGateway.dll
Version: 3.x.y.z

Syntax

public virtual UpdateGatewaySoftwareNowResponse UpdateGatewaySoftwareNow(
         UpdateGatewaySoftwareNowRequest request
)

Parameters

request: Type: Amazon.StorageGateway.Model.UpdateGatewaySoftwareNowRequest

Container for the necessary parameters to execute the UpdateGatewaySoftwareNow service method.

Return Value

Type: UpdateGatewaySoftwareNowResponse

The response from the UpdateGatewaySoftwareNow service method, as returned by StorageGateway.

Exceptions

Exception	Condition
InternalServerErrorException	An internal server error has occurred during the request. For more information, see the error and message fields.
InvalidGatewayRequestException	An exception occurred because an invalid gateway request was issued to the service. For more information, see the error and message fields.

Examples

Updates the gateway virtual machine (VM) software. The request immediately triggers the software update.

To update a gateway's VM software


var client = new AmazonStorageGatewayClient();
var response = client.UpdateGatewaySoftwareNow(new UpdateGatewaySoftwareNowRequest 
{
    GatewayARN = "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B"
});

string gatewayARN = response.GatewayARN;

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

AmazonStorageGatewayClient.UpdateGatewaySoftwareNow (UpdateGatewaySoftwareNowRequest)

Method