Specifying Conditions: Using Condition Keys Example Policies: Using Conditions for Fine-Grained Parameter Control

Using condition keys

You can specify conditions that determine how an IAM policy takes effect. In ElastiCache, you can use the Condition element of a JSON policy to compare keys in the request context with key values that you specify in your policy. For more information, see IAM JSON policy elements: Condition. For a list of global condition keys, see Amazon global condition context keys.

Specifying Conditions: Using Condition Keys

To implement fine-grained control, you write an IAM permissions policy that specifies conditions to control a set of individual parameters on certain requests. You then apply the policy to IAM users, groups, or roles that you create using the IAM console.

To apply a condition, you add the condition information to the IAM policy statement. In the following example, you specify the condition that any cache cluster created will be of node type cache.r5.large.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateCacheCluster"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:parametergroup:*",
                "arn:aws:elasticache:*:*:subnetgroup:*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateCacheCluster"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:cluster:*"
            ],
            "Condition": {
                "StringEquals": {
                    "elasticache:CacheNodeType": [
                        "cache.r5.large"
                    ]
                }
            }
        }
    ]
}

The following table shows the service-specific condition keys that apply to ElastiCache and the actions that use them.

Key name	Description	Datatype	Used by	Affected resource type (* If marked with an asterisk, only this resource will be affected if present in the request.)
`elasticache:CacheNodeType`	Filters access by the cacheNodeType parameter present in the request. This key can be used to restrict which cache node types can be used on cluster creation or scaling operations.	`String`	`CreateCacheCluster`	`Cluster`
`elasticache:CacheNodeType`		`String`	`ModifyCacheClusters`	`Cluster`
`elasticache:EngineVersion`	Filters access by the `engineVersion` parameter present in creation or cluster modification requests.	`String`	`CreateCacheCluster`	`Cluster`
`elasticache:EngineVersion`		`String`	`ModifyCacheClusters`	`Cluster`
`elasticache:EngineType`	Filters access by the engine type present in creation requests. For replication group creations, default engine "redis" is used as key if parameter is not present.	`String`	`CreateCacheCluster`	`Cluster`
`elasticache:AuthTokenEnabled`	Filters access by the presence of non empty `AuthToken` parameter in the request.	`Bool`	`CreateCacheCluster`	`Cluster`
`elasticache:AuthTokenEnabled`		`Bool`	`ModifyCacheClusters`	`Cluster`
`elasticache:CacheParameterGroupName`	Filters access by the the `CacheParameterGroupName` parameter in the request.	`String`	`CreateCacheCluster`	`Cluster, ReplicationGroup*`
			`ModifyCacheClusters`	`Cluster`
			`CreateCacheParameterGroup`	`ParameterGroup`
			`ModifyCacheParameterGroup`	`ParameterGroup`
			`DeleteCacheParameterGroup`	`ParameterGroup`
			`ResetCacheParameterGroup`	`ParameterGroup`

For more information, see Tag-Based access control policy examples.

For more information on using policy condition operators, see ElastiCache API permissions: Actions, resources, and conditions reference.

Example Policies: Using Conditions for Fine-Grained Parameter Control

This section shows example policies for implementing fine-grained access control on the previously listed ElastiCache parameters.

elasticache:CacheNodeType: Specify which NodeType(s) a user can create. Using the provided conditions, the customer can specify a single or a range value for a node type.


{
    "Version": "2012-10-17",
    "Statement": [
         {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateCacheCluster"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:parametergroup:*",
                "arn:aws:elasticache:*:*:subnetgroup:*"
            ]
        },

        {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateCacheCluster"
                "elasticache:CreateReplicationGroup"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:cluster:*"
                "arn:aws:elasticache:*:*:replicationgroup:*"
            ],
            "Condition": {
                "StringEquals": {
                    "elasticache:CacheNodeType": [
                        "cache.t2.micro",
                        "cache.t2.medium"
                    ]
                }
            }
        }
    ]
}

elasticache:EngineVersion: Specify usage of engine version 1.6.6


{
    "Version": "2012-10-17",
    "Statement": [
		 {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateCacheCluster"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:parametergroup:*",
                "arn:aws:elasticache:*:*:subnetgroup:*"
            ]
        },

        {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateCacheCluster"
                "elasticache:CreateReplicationGroup"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:cluster:*"
                "arn:aws:elasticache:*:*:replicationgroup:*"
            ],
            "Condition": {
                "StringEquals": {

                    "elasticache:EngineVersion": "1.6.6"
                }
            }
        }
    ]
}

elasticache:CacheParameterGroupName: Specify a non default parameter group with specific parameters from an organization on your clusters. You could also specify a naming pattern for your parameter groups or block delete on a specific parameter group name. Following is an example constraining usage of only "my-org-param-group".


{
    "Version": "2012-10-17",
    "Statement": [

         {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateCacheCluster"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:parametergroup:*",
                "arn:aws:elasticache:*:*:subnetgroup:*"
            ]
        },

        {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateReplicationGroup"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:cluster:*"
            ],
            "Condition": {
                "StringEquals": {
                    "elasticache:CacheParameterGroupName": "my-org-param-group"
                }
            }
        }
    ]
}

elasticache:CreateCacheCluster: Denying CreateCacheCluster action if the request tag Project is missing or is not equal to Dev, QA or Prod.


{
    "Version": "2012-10-17",
    "Statement": [
          {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateCacheCluster"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:parametergroup:*",
                "arn:aws:elasticache:*:*:subnetgroup:*",
                "arn:aws:elasticache:*:*:securitygroup:*",
                "arn:aws:elasticache:*:*:replicationgroup:*"
            ]
        },
        {
            "Effect": "Deny",
            "Action": [
                "elasticache:CreateCacheCluster"
            ],
            "Resource": [
                "arn:aws:elasticache:*:*:cluster:*"
            ],
            "Condition": {
                "Null": {
                    "aws:RequestTag/Project": "true"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "elasticache:CreateCacheCluster",
                "elasticache:AddTagsToResource"
            ],
            "Resource": "arn:aws:elasticache:*:*:cluster:*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/Project": [
                        "Dev",
                        "Prod",
                        "QA"
                    ]
                }
            }
        }
    ]
}

elasticache:createcachecluster: Allowing CreateCacheCluster with cacheNodeType cache.r5.large or cache.r6g.4xlarge and tag Project=XYZ.


{
	"Version": "2012-10-17",
	"Statement": [
	  	{
			"Effect": "Allow",
			"Action": [
				"elasticache:CreateCacheCluster"
			],
			"Resource": [
				"arn:aws:elasticache:*:*:parametergroup:*",
				"arn:aws:elasticache:*:*:subnetgroup:*"
			]
		},
		{
			"Effect": "Allow",
			"Action": [
				"elasticache:CreateCacheCluster"
			],
			"Resource": [
				"arn:aws:elasticache:*:*:cluster:*"
			],
			"Condition": {
				"StringEqualsIfExists": {
					"elasticache:CacheNodeType": [
						"cache.r5.large",
						"cache.r6g.4xlarge"
					]
				},
				"StringEquals": {
					"aws:RequestTag/Project": "XYZ"
				}
			}
		}
	]
}

Note

When creating polices to enforce tags and other condition keys together, the conditional IfExists may be required on condition key elements due to the extra elasticache:AddTagsToResource policy requirements for creation requests with the --tags parameter.

Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Resource-level permissions

Using Service-Linked Roles