GET

/#Action=ModifyClusterIamRoles

http://redshift.{region}.amazonaws.com/#Action=ModifyClusterIamRoles

Modifies the list of Identity and Access Management (IAM) roles that can be used by the cluster to access other Amazon Web Services services. The maximum number of IAM roles that you can associate is subject to a quota. For more information, go to <a href="https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-limits.html">Quotas and limits</a> in the Amazon Redshift Cluster Management Guide.

Access Token Required: API Key

Query Params

ClusterIdentifierstringrequired

The unique identifier of the cluster for which you want to associate or disassociate IAM roles.

AddIamRolesarray

Zero or more IAM roles to associate with the cluster. The roles must be in their Amazon Resource Name (ARN) format.

RemoveIamRolesarray

Zero or more IAM roles in ARN format to disassociate from the cluster.

DefaultIamRoleArnstring

The Amazon Resource Name (ARN) for the IAM role that was set as default for the cluster when the cluster was last modified.

Actionstringrequired

Allowed:

Versionstringrequired

Allowed:

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://redshift.{region}.amazonaws.com/#Action=ModifyClusterIamRoles' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}