AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Creates a new Amazon File Cache resource.
You can use this operation with a client request token in the request that Amazon
File Cache uses to ensure idempotent creation. If a cache with the specified client
request token exists and the parameters match, CreateFileCache returns the
description of the existing cache. If a cache with the specified client request token
exists and the parameters don't match, this call returns IncompatibleParameterError.
If a file cache with the specified client request token doesn't exist, CreateFileCache
does the following:
Creates a new, empty Amazon File Cache resource with an assigned ID, and an initial
lifecycle state of CREATING.
Returns the description of the cache in JSON format.
The CreateFileCache call returns while the cache's lifecycle state is still
CREATING. You can check the cache creation status by calling the DescribeFileCaches
operation, which returns the cache state along with other information.
For .NET Core this operation is only available in asynchronous form. Please refer to CreateFileCacheAsync.
Namespace: Amazon.FSx
Assembly: AWSSDK.FSx.dll
Version: 3.x.y.z
public abstract CreateFileCacheResponse CreateFileCache( CreateFileCacheRequest request )
Container for the necessary parameters to execute the CreateFileCache service method.
| Exception | Condition |
|---|---|
| BadRequestException | A generic error indicating a failure with a client request. |
| IncompatibleParameterErrorException | The error returned when a second request is received with the same client request token but different parameters settings. A client request token should always uniquely identify a single request. |
| InternalServerErrorException | A generic error indicating a server-side failure. |
| InvalidNetworkSettingsException | One or more network settings specified in the request are invalid. |
| InvalidPerUnitStorageThroughputException | An invalid value for PerUnitStorageThroughput was provided. Please create your file system again, using a valid value. |
| MissingFileCacheConfigurationException | A cache configuration is required for this operation. |
| ServiceLimitExceededException | An error indicating that a particular service limit was exceeded. You can increase some service limits by contacting Amazon Web Services Support. |
.NET Framework:
Supported in: 4.7.2 and newer