Skip to main content

List Connection Groups​

Returns a list of active connection groups that are managing AWS account connections.

Query Parameters
  • limit int64

    Limits the size of the response on each page to the specified number of items.

  • start string

    Sets the page token used to browse the collection. Leave this parameter empty to get the first page. Other pages can be traversed using HATEOAS links.

  • filter string

    Narrows down the results to only the items that satisfy the filter criteria. The following table lists the supported filter fields for this resource and the operations that can be performed on the field:

    FieldFilter ConditionDescription
    account_native_id$inThe AWS account ID that belongs to a connection group to be searched. {"account_native_id":{"$in":["111111111111", "222222222222"]}}
    organizational_unit_id$inLists connection groups in the specified organizational units. {"organizational_unit_id":{"$in":["ca849d10-7ea1-4869-b2d0-46c42b5f2bea", "27b9ee09-c59c-466f-b2c4-223e9h8df7c8"]}}
    account_alias$containsA substring within the account alias (if available) to search for. {"account_alias":{"$contains":"foo"}}
    services_enabled$contains, $eqLists the connection groups that have at least these asset_types enabled or groups that have the exact asset_types enabled. Supported types are: ['rds', 's3', 'ebs', 'ec2mssql','dynamodb']. {"services_enabled":{"$contains":["rds"]}} {"services_enabled":{"$eq":["rds"]}}
    For more information about filtering, refer to the Filtering section of this guide.
Responses

Success

Schema
  • _embedded object

    Embedded responses related to the resource.

  • items object[]

    A collection of requested items.

  • _embedded object

    Embedded responses related to the resource.

  • _etag string

    The ETag value.

  • _links object

    URLs to pages related to the resource.

  • _self object

    The HATEOAS link to this resource.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • read-organizational-unit object

    A resource-specific HATEOAS link.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • account_name string

    The alias given to the associated account in AWS.

  • account_native_ids string[]

    The AWS-assigned IDs of the accounts associated with the Connection Group.

  • asset_types_enabled string[]

    List of asset types connected via the connection-group. Valid values are any of ["EC2/EBS", "RDS", "DynamoDB", "EC2MSSQL", "S3", "EBS"].

    NOTE -

    1. EC2/EBS is required for EC2MSSQL.
    2. EBS as a value is deprecated in favor of EC2/EBS.
  • aws_regions string[]

    The AWS regions associated with the with the Connection Group.

  • 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 string

    The current version of the feature.

  • ebs object

    EbsAssetInfo The installed information for the EBS feature.

  • installed_template_version string

    The current version of the feature.

  • ec2 object

    Ec2AssetInfo The installed information for the EC2 feature.

  • installed_template_version string

    The current version of the feature.

  • ec2_mssql object

    EC2MSSQLProtectConfig The installed information for the EC2_MSSQL feature.

  • installed_template_version string

    The current version of the feature.

  • installed_template_version string

    The current version of the feature.

  • rds object

    RdsAssetInfo The installed information for the RDS feature.

  • installed_template_version string

    The current version of the feature.

  • s3 object

    S3AssetInfo The installed information for the S3 feature.

  • installed_template_version string

    The 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 string

    The current version of the feature.

  • installed_template_version string

    The current version of the feature.

  • created_timestamp string

    The timestamp of when the connection was created.

  • deployment_template_url string

    Clumio's S3 URL that contains the template to create the required resources in the given account(s) according to the request.

  • description string

    User-provided description for this connection group.

  • external_id string

    Clumio assigned external ID for the connection group, should be used while creating the AWS stack.

  • id string

    The Clumio-assigned ID of the Connection Group, should be used as the token while creating the stack in AWS.

  • intended_account_native_ids string[]

    The AWS Account IDs that are intended to be associated with the Connection Group.

  • intended_asset_types string[]

    THe asset types that are intended to be connected via connection-group.

  • intended_aws_regions string[]

    The AWS regions that are intended to be connected with the Connection Group.

  • master_aws_account_id string

    The master account which manages the connection-group's stack.

  • master_region string

    The master region which manages the connection-group's stack.

  • ongoing_stack_operation string

    Possible values: [creating_stack, updating_stack, deleting_stack, no_active_operation]

    Ongoing Operation of the deployed and active stack of ConnectionGroup.

  • 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.

  • stack_arn string

    The Amazon Resource Name of the installed CloudFormation stack in AWS.

  • stack_name string

    The name given to the installed CloudFormation stack in AWS.

  • status string

    Possible values: [connecting, fully_connected, partially_connected, deployment_failed, connected_with_no_managed_stacks, unlinked]

    The status of the Connection Group based on the stack in associated AWS account.

  • _links object

    URLs to pages related to the resource.

  • _first object

    The HATEOAS link to the first page of results.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • _next object

    The HATEOAS link to the next page of results.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • _self object

    The HATEOAS link to this resource.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • create-aws-connection object

    A resource-specific HATEOAS link.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • create-aws-connection-group object

    A resource-specific HATEOAS link.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • current_count int64

    The number of items listed on the current page.

  • filter_applied string

    The filter used in the request. The filter includes both manually-specified and system-generated filters.

  • limit int64

    The maximum number of items displayed per page in the response.

  • start string

    The page token used to get this response.

GET /connections/aws/connection-groups

Authorization

Request

Click Edit to configure Base URL
https://us-west-2.api.clumio.com
Bearer Token
limit — query
start — query
filter — query
curl -L -X GET 'https://us-west-2.api.clumio.com/connections/aws/connection-groups' \
-H 'Accept: application/api.clumio.aws-connection-groups=v1+json' \
-H 'Authorization: Bearer <TOKEN>'