Update an AWS Connection
Returns a new template url for the specified configuration.
Path Parameters
- connection_id string required
Updates the connection with the specified connection ID
- application/json
Request Body required
- asset_types_enabled string[]
Asset types enabled with the given resource ARNs. This field is only applicable to manually configured connections. Valid values are any of ["EC2/EBS", "RDS", "DynamoDB", "EC2MSSQL", "S3", "EBS"].
NOTE -
- EC2/EBS is required for EC2MSSQL.
- EBS as a value is deprecated in favor of EC2/EBS.
- description string
An optional, user-provided description for this connection.
resources object
Partial updates are not supported, therefore you must provide ARNs for all configured resources, including those for resources that are not being updated.
clumio_event_pub_arn stringSNS topic created in the account to receive relevant events.
clumio_iam_role_arn stringARN of the IAM role created in the account, which will be assumed by Clumio.
clumio_support_role_arn stringARN of the support role which will be used by the Clumio support team.
event_rules object
cloudtrail_rule_arn stringCloudtrail rule for the service if any.
cloudwatch_rule_arn stringCloudwatch rule for the service if any.
service_instance_profiles object
mssql object
ec2_ssm_instance_profile_arn stringPolicy created for ec2 instance profile role
service_roles object
mssql object
ec2_instance_profile_role_arn stringRole assumable by ec2 service.
ec2_ssm_instance_profile_arn stringInstance created for ec2 instance profile role
ssm_notification_role_arn stringRole assumable by ssm service.
s3 object
continuous_backups_role_arn stringRole assumable by Event Bridge to send event notifications.
- 200
- default
Success
- application/api.clumio.aws-connections=v1+json
- Schema
- Example (from schema)
Schema
_links object
URLs to pages related to the resource.
_self object
The HATEOAS link to this resource.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
delete-connection-aws object
A resource-specific HATEOAS link.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
read-organizational-unit object
A resource-specific HATEOAS link.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
- account_name string
The alias given to the account on AWS.
- account_native_id string
The AWS-assigned ID of the account associated with the connection.
- aws_region string
The AWS region associated with the connection. For example,
us-east-1
. - clumio_aws_account_id string
AWS account ID of the Clumio control plane.
- clumio_aws_region string
AWS region of the Clumio control plane
config object
The consolidated configuration of the Clumio Cloud Protect and Clumio Cloud Discover products for this connection. If this connection is deprecated to use unconsolidated configuration, then this field has a value of
null
.asset_types_enabled string[]The asset types supported on the current version of the feature
dynamodb object
DynamodbAssetInfo The installed information for the DynamoDB feature.
installed_template_version stringThe current version of the feature.
ebs object
EbsAssetInfo The installed information for the EBS feature.
installed_template_version stringThe current version of the feature.
ec2 object
Ec2AssetInfo The installed information for the EC2 feature.
installed_template_version stringThe current version of the feature.
ec2_mssql object
EC2MSSQLProtectConfig The installed information for the EC2_MSSQL feature.
installed_template_version stringThe current version of the feature.
installed_template_version stringThe current version of the feature.
rds object
RdsAssetInfo The installed information for the RDS feature.
installed_template_version stringThe current version of the feature.
s3 object
S3AssetInfo The installed information for the S3 feature.
installed_template_version stringThe current version of the feature.
warm_tier_protect object
The configuration of the Clumio Cloud Warm-Tier Protect product for this connection.
dynamodb object
DynamodbAssetInfo The installed information for the DynamoDB feature.
installed_template_version stringThe current version of the feature.
installed_template_version stringThe current version of the feature.
- connection_group_id string
Clumio assigned ID of the associated connection group.
- connection_management_status string
Possible values: [
managed
,unmanaged
]Management status of connection.
- connection_status string
Possible values: [
connecting
,connected
,unlinked
,failed-deployment
]The status of the connection considering all the deployments made for it.
- created_timestamp string
The timestamp of when the connection was created.
- data_plane_account_id string
AWS account ID of the data plane for the connection.
- deployment_type string
Possible values: [
group_cft
,self_cft
,self_tf
,manual
,manual_tf
,none
]The deployment method with which the currently active connection was established.
- description string
The user-provided description for this connection.
discover object
The configuration of the Clumio Discover product for this connection. If this connection is not configured for Clumio Discover, then this field has a value of
null
.asset_types_enabled string[]The asset types supported on the current version of the feature
installed_template_version stringThe current version of the feature.
- external_id string
Clumio assigned external ID of the connection or of the associated connection group.
- id string
The Clumio-assigned ID of the connection.
- ingestion_status string
Status denoting whether Ingestion has started for the connection. Valid values are "initial", "in_progress", "failed", "completed".
- namespace string
K8S Namespace
- organizational_unit_id string
The Clumio-assigned ID of the organizational unit associated with the AWS environment. If this parameter is not provided, then the value defaults to the first organizational unit assigned to the requesting user. For more information about organizational units, refer to the Organizational-Units documentation.
protect object
The configuration of the Clumio Cloud Protect product for this connection. If this connection is not configured for Clumio Cloud Protect, then this field has a value of
null
.asset_types_enabled string[]The asset types supported on the current version of the feature
ebs object
EbsAssetInfo The installed information for the EBS feature.
installed_template_version stringThe current version of the feature.
installed_template_version stringThe current version of the feature.
rds object
RdsAssetInfo The installed information for the RDS feature.
installed_template_version stringThe current version of the feature.
- protect_asset_types_enabled string[]
The asset types enabled for protect. Valid values are any of ["EC2/EBS", "RDS", "DynamoDB", "EC2MSSQL", "S3", "EBS"].
NOTE -
- EC2/EBS is required for EC2MSSQL.
- EBS as a value is deprecated in favor of EC2/EBS.
resources object
clumio_event_pub_arn stringSNS topic created in the account to receive relevant events.
clumio_iam_role_arn stringARN of the IAM role created in the account, which will be assumed by Clumio.
clumio_support_role_arn stringARN of the support role which will be used by the Clumio support team.
event_rules object
cloudtrail_rule_arn stringCloudtrail rule for the service if any.
cloudwatch_rule_arn stringCloudwatch rule for the service if any.
service_roles object
mssql object
ec2_instance_profile_role_arn stringRole assumable by ec2 service.
ec2_ssm_instance_profile_arn stringInstance created for ec2 instance profile role
ssm_notification_role_arn stringRole assumable by ssm service.
s3 object
continuous_backups_role_arn stringRole assumable by Event Bridge to send event notifications.
- retired_stack_arn string
The Amazon Resource Name of the stale CloudFormation stack when the connection was migrated to connection groups. NOTE - This has to be removed from AWS as well to delete the connection completely.
- services_enabled string[]
The services to be enabled for this configuration. Valid values are ["discover"], ["discover", "protect"]. This is only set when the registration is created, the enabled services are obtained directly from the installed template after that. (Deprecated as all connections will have both discover and protect enabled)
- stack_arn string
The Amazon Resource Name of the installed and active CloudFormation stack(if any) in AWS.
- stack_name string
The name given to the installed and active CloudFormation stack(if any) in AWS.
- target_setup_status string
Status denoting whether Target Setup has started for the connection. Valid values are "initial", "in_progress", "failed", "completed".
- template_permission_set string
- token string
The 36-character Clumio AWS integration ID token used to identify the installation of the CloudFormation template on the account. This value will be pasted into the ClumioToken field when creating the CloudFormation stack.
{
"_links": {
"_self": {
"href": "string",
"templated": true,
"type": "string"
},
"delete-connection-aws": {
"href": "string",
"templated": true,
"type": "string"
},
"read-organizational-unit": {
"href": "string",
"templated": true,
"type": "string"
}
},
"account_name": "string",
"account_native_id": "string",
"aws_region": "string",
"clumio_aws_account_id": "string",
"clumio_aws_region": "string",
"config": {
"asset_types_enabled": [
"string"
],
"dynamodb": {
"installed_template_version": "string"
},
"ebs": {
"installed_template_version": "string"
},
"ec2": {
"installed_template_version": "string"
},
"ec2_mssql": {
"installed_template_version": "string"
},
"installed_template_version": "string",
"rds": {
"installed_template_version": "string"
},
"s3": {
"installed_template_version": "string"
},
"warm_tier_protect": {
"dynamodb": {
"installed_template_version": "string"
},
"installed_template_version": "string"
}
},
"connection_group_id": "string",
"connection_management_status": "managed",
"connection_status": "connecting",
"created_timestamp": "string",
"data_plane_account_id": "string",
"deployment_type": "group_cft",
"description": "string",
"discover": {
"asset_types_enabled": [
"string"
],
"installed_template_version": "string"
},
"external_id": "string",
"id": "string",
"ingestion_status": "string",
"namespace": "string",
"organizational_unit_id": "string",
"protect": {
"asset_types_enabled": [
"string"
],
"ebs": {
"installed_template_version": "string"
},
"installed_template_version": "string",
"rds": {
"installed_template_version": "string"
}
},
"protect_asset_types_enabled": [
"string"
],
"resources": {
"clumio_event_pub_arn": "string",
"clumio_iam_role_arn": "string",
"clumio_support_role_arn": "string",
"event_rules": {
"cloudtrail_rule_arn": "string",
"cloudwatch_rule_arn": "string"
},
"service_roles": {
"mssql": {
"ec2_instance_profile_role_arn": "string",
"ec2_ssm_instance_profile_arn": "string",
"ssm_notification_role_arn": "string"
},
"s3": {
"continuous_backups_role_arn": "string"
}
}
},
"retired_stack_arn": "string",
"services_enabled": [
"string"
],
"stack_arn": "string",
"stack_name": "string",
"target_setup_status": "string",
"template_permission_set": "string",
"token": "string"
}
Error
- application/json
- Schema
- Example (from schema)
Schema
errors object[]
A list of errors encountered during runtime.
error_code uint32error_message stringThe reason for the error.
{
"errors": [
{
"error_code": 0,
"error_message": "string"
}
]
}