Amazon ElastiCache Amazon ElastiCache API API

openapi: 3.1.0
info:
  title: Amazon ElastiCache Amazon ElastiCache API API
  description: Amazon ElastiCache is a fully managed in-memory caching service supporting Redis and Memcached for improving the performance of web applications.
  version: '2015-02-02'
  contact:
    name: Kin Lane
    email: kin@apievangelist.com
    url: https://aws.amazon.com/elasticache/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://elasticache.amazonaws.com
  description: Amazon ElastiCache API endpoint
tags:
- name: Amazon ElastiCache API
paths:
  /:
    post:
      operationId: createCacheCluster
      summary: Amazon ElastiCache Create Cache Cluster
      description: Creates a cache cluster. All nodes in the cache cluster run the same protocol-compliant cache engine software, either Memcached or Redis.
      parameters:
      - name: Action
        in: query
        required: true
        schema:
          type: string
          enum:
          - CreateCacheCluster
      - name: Version
        in: query
        required: true
        schema:
          type: string
          default: '2015-02-02'
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - CacheClusterId
              properties:
                CacheClusterId:
                  type: string
                  description: The node group (shard) identifier.
                Engine:
                  type: string
                  enum:
                  - memcached
                  - redis
                  description: The name of the cache engine to be used for this cluster.
                EngineVersion:
                  type: string
                  description: The version number of the cache engine to be used for this cluster.
                CacheNodeType:
                  type: string
                  description: The compute and memory capacity of the nodes in the node group.
                NumCacheNodes:
                  type: integer
                  description: The initial number of cache nodes that the cluster has.
                CacheSubnetGroupName:
                  type: string
                  description: The name of the subnet group to be used for the cluster.
                CacheParameterGroupName:
                  type: string
                  description: The name of the parameter group to associate with this cluster.
                SecurityGroupIds:
                  type: array
                  items:
                    type: string
                  description: One or more VPC security groups associated with the cluster.
                PreferredAvailabilityZone:
                  type: string
                  description: The EC2 Availability Zone in which the cluster is created.
                Port:
                  type: integer
                  description: The port number on which each of the cache nodes accepts connections.
                AutoMinorVersionUpgrade:
                  type: boolean
                  description: If true, minor engine upgrades will be applied automatically during maintenance windows.
                SnapshotRetentionLimit:
                  type: integer
                  description: The number of days for which ElastiCache retains automatic snapshots.
            examples:
              createCacheClusterRequestExample:
                summary: Default createCacheCluster request
                x-microcks-default: true
                value:
                  CacheClusterId: example-id-12345
                  Engine: memcached
                  EngineVersion: '2025-01-01'
                  CacheNodeType: example
                  NumCacheNodes: 1
      responses:
        '200':
          description: Successful response with the created cache cluster details.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/CreateCacheClusterResult'
              examples:
                createCacheCluster200Example:
                  summary: Default createCacheCluster 200 response
                  x-microcks-default: true
                  value:
                    CacheCluster:
                      CacheClusterId: example-id-12345
                      CacheClusterStatus: Active
                      Engine: example
                      EngineVersion: '2025-01-01'
                      CacheNodeType: example
        '400':
          description: Bad request error.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      tags:
      - Amazon ElastiCache API
    get:
      operationId: describeCacheClusters
      summary: Amazon ElastiCache Describe Cache Clusters
      description: Returns information about all provisioned clusters if no cluster identifier is specified, or about a specific cache cluster if a cluster identifier is supplied.
      parameters:
      - name: Action
        in: query
        required: true
        schema:
          type: string
          enum:
          - DescribeCacheClusters
      - name: Version
        in: query
        required: true
        schema:
          type: string
          default: '2015-02-02'
      - name: CacheClusterId
        in: query
        schema:
          type: string
        description: The user-supplied cluster identifier.
      - name: ShowCacheNodeInfo
        in: query
        schema:
          type: boolean
        description: If true, lists individual cache node information.
      - name: MaxRecords
        in: query
        schema:
          type: integer
        description: The maximum number of records to include in the response.
      - name: Marker
        in: query
        schema:
          type: string
        description: An optional marker returned from a prior request.
      responses:
        '200':
          description: Successful response with cache cluster details.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/DescribeCacheClustersResult'
              examples:
                describeCacheClusters200Example:
                  summary: Default describeCacheClusters 200 response
                  x-microcks-default: true
                  value:
                    CacheClusters: []
                    Marker: example
        '404':
          description: Cache cluster not found.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      tags:
      - Amazon ElastiCache API
components:
  schemas:
    DescribeCacheClustersResult:
      type: object
      properties:
        CacheClusters:
          type: array
          items:
            $ref: '#/components/schemas/CacheCluster'
        Marker:
          type: string
    CreateCacheClusterResult:
      type: object
      properties:
        CacheCluster:
          $ref: '#/components/schemas/CacheCluster'
    CacheCluster:
      type: object
      properties:
        CacheClusterId:
          type: string
          description: The user-supplied identifier of the cluster.
        CacheClusterStatus:
          type: string
          description: The current state of this cluster.
        Engine:
          type: string
          description: The name of the cache engine used for this cluster.
        EngineVersion:
          type: string
          description: The version of the cache engine that is used in this cluster.
        CacheNodeType:
          type: string
          description: The name of the compute and memory capacity node type for the cluster.
        NumCacheNodes:
          type: integer
          description: The number of cache nodes in the cluster.
        PreferredAvailabilityZone:
          type: string
          description: The name of the Availability Zone in which the cluster is located.
        CacheClusterCreateTime:
          type: string
          format: date-time
          description: The date and time when the cluster was created.
        PreferredMaintenanceWindow:
          type: string
          description: Specifies the weekly time range during which maintenance on the cluster is performed.
        CacheSubnetGroupName:
          type: string
          description: The name of the cache subnet group associated with the cluster.
        CacheNodes:
          type: array
          items:
            type: object
            properties:
              CacheNodeId:
                type: string
              CacheNodeStatus:
                type: string
              Endpoint:
                type: object
                properties:
                  Address:
                    type: string
                  Port:
                    type: integer
          description: A list of cache nodes that are members of the cluster.
        AutoMinorVersionUpgrade:
          type: boolean
          description: If true, then minor version patches are applied automatically.
        SecurityGroups:
          type: array
          items:
            type: object
            properties:
              SecurityGroupId:
                type: string
              Status:
                type: string
          description: A list of VPC Security Groups associated with the cluster.
        ReplicationGroupId:
          type: string
          description: The replication group to which this cluster belongs.
        SnapshotRetentionLimit:
          type: integer
          description: The number of days for which ElastiCache retains automatic cluster snapshots.
        ARN:
          type: string
          description: The ARN of the cache cluster.
  securitySchemes:
    aws_sigv4:
      type: apiKey
      name: Authorization
      in: header
      description: AWS Signature Version 4 authentication.