Retrieve an availability group

Returns a representation of the specified availability group.

Path Parameters

availability_group_id string required
Performs the operation on the ag with the specified ID.

Query Parameters

embed string

Embeds the details of an associated resource. Set the parameter to one of the following embeddable links to include additional details associated with the resource.

Embeddable Link	Description
read-policy-definition	Embeds the definition of the policy associated with this resource. Unprotected resources will not have an associated policy. For example, `?embed=read-policy-definition`
get-ec2-mssql-stats-backup-status	Embeds the backup statistics for each resource into the response. For example, `?embed=get-ec2-mssql-stats-backup-status`

For more information about embedded links, refer to the Embedding Referenced Resources section of this guide.

lookback_days int64
Calculate backup status for the last lookback_days days.

Responses

200
default

Success

application/api.clumio.ec2-mssql-availability-groups=v1+json

Schema
Example (from schema)

Schema

_embedded object
Embedded responses related to the resource.
get-mssql-ec2-availability-group-backup-status-stats
availability group level backup status stats
get-mssql-ec2-availability-group-stats
availability group level protection stats
read-policy-definition Embeds the associated policy of a protected resource in the response if requested using the `embed` query parameter. Unprotected resources will not have an associated policy.
Embeds the associated policy of a protected resource in the response if requested using the embed query parameter. Unprotected resources will not have an associated policy.
_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.
get-mssql-ec2-availability-group-backup-status-stats 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.
get-mssql-ec2-availability-group-stats 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.
read-policy-definition object
A HATEOAS link to the policy protecting this resource. Will be omitted for unprotected entities.
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.
id string
The Clumio-assigned ID of the availability group.
name string
The Microsoft SQL-assigned name of the availability group.
organizational_unit_id string
The Clumio-assigned ID of the organizational unit associated with the availability group.
protection_info object
The protection policy applied to this resource. If the resource is not protected, then this field has a value of null.
inheriting_entity_id string
The ID of the entity from which protection was inherited. If protection was not inherited, then this field has a value of null.
inheriting_entity_type string
The type of entity from which protection was inherited. If protection was not inherited, then this field has a value of null.
Entities from which protection can be inherited include the following:

Inheriting Entity Type Details
aws_tag AWS tag.
policy_id string
A system-generated ID assigned to the policy protecting this resource.
status string
The status of the availability group, Possible values include 'active' and 'inactive'.

Inheriting Entity Type	Details
aws_tag	AWS tag.

{
  "_embedded": {},
  "_links": {
    "_self": {
      "href": "string",
      "templated": true,
      "type": "string"
    },
    "get-mssql-ec2-availability-group-backup-status-stats": {
      "href": "string",
      "templated": true,
      "type": "string"
    },
    "get-mssql-ec2-availability-group-stats": {
      "href": "string",
      "templated": true,
      "type": "string"
    },
    "read-policy-definition": {
      "href": "string",
      "templated": true,
      "type": "string"
    }
  },
  "id": "string",
  "name": "string",
  "organizational_unit_id": "string",
  "protection_info": {
    "inheriting_entity_id": "string",
    "inheriting_entity_type": "string",
    "policy_id": "string"
  },
  "status": "string"
}

Error

application/json

Schema
Example (from schema)

Schema

errors object[]
A list of errors encountered during runtime.
error_code uint32
error_message string
The reason for the error.

{
  "errors": [
    {
      "error_code": 0,
      "error_message": "string"
    }
  ]
}

GET /datasources/aws/ec2-mssql/availability-groups/:availability_group_id

Authorization

Request

Click Edit to configure Base URL

https://us-west-2.api.clumio.com

Bearer Token

availability_group_id — path required

embed — query

lookback_days — query

curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/aws/ec2-mssql/availability-groups/:availability_group_id' \
-H 'Accept: application/api.clumio.ec2-mssql-availability-groups=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/aws/ec2-mssql/availability-groups/:availability_group_id' \
-H 'Accept: application/api.clumio.ec2-mssql-availability-groups=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/aws/ec2-mssql/availability-groups/:availability_group_id' \
-H 'Accept: application/api.clumio.ec2-mssql-availability-groups=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/aws/ec2-mssql/availability-groups/:availability_group_id' \
-H 'Accept: application/api.clumio.ec2-mssql-availability-groups=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/aws/ec2-mssql/availability-groups/:availability_group_id' \
-H 'Accept: application/api.clumio.ec2-mssql-availability-groups=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/aws/ec2-mssql/availability-groups/:availability_group_id' \
-H 'Accept: application/api.clumio.ec2-mssql-availability-groups=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/aws/ec2-mssql/availability-groups/:availability_group_id' \
-H 'Accept: application/api.clumio.ec2-mssql-availability-groups=v1+json' \
-H 'Authorization: Bearer <TOKEN>'