AmazonStorageGatewayClient.AddCache Method (AddCacheRequest)

Configures one or more gateway local disks as cache for a gateway. This operation is only supported in the cached volume, tape, and file gateway type (see How Storage Gateway works (architecture).

In the request, you specify the gateway Amazon Resource Name (ARN) to which you want to add cache, and one or more disk IDs that you want to configure as cache.

Note:

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

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

Syntax

public virtual AddCacheResponse AddCache(
         AddCacheRequest request
)

Parameters

request: Type: Amazon.StorageGateway.Model.AddCacheRequest

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

Return Value

Type: AddCacheResponse

The response from the AddCache 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

The following example shows a request that activates a gateway-stored volume.

To add a cache


var client = new AmazonStorageGatewayClient();
var response = client.AddCache(new AddCacheRequest 
{
    DiskIds = new List<string> {
        "pci-0000:03:00.0-scsi-0:0:0:0",
        "pci-0000:03:00.0-scsi-0:0:1:0"
    },
    GatewayARN = "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B"
});

string gatewayARN = response.GatewayARN;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

AmazonStorageGatewayClient.AddCache (AddCacheRequest)

Method