Retrieve a Failover Cluster
Returns a representation of the specified failover cluster.
Path Parameters
- failover_cluster_id string required
Performs the operation on the fci 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.
For more information about embedded links, refer to the Embedding Referenced Resources section of this guide.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-failover-cluster-stats Embeds the stats information associated with failover cluster. For example, ?embed=get-ec2-mssql-failover-cluster-stats
.get-ec2-mssql-failover-cluster-hosts-info Embeds the stats information associated with Hosts part of failover cluster. For example, ?embed=get-ec2-mssql-failover-cluster-hosts-info
.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
- lookback_days int64
Calculate backup status for the last
lookback_days
days.
- 200
- default
Success
- application/api.clumio.ec2-mssql-failover-cluster=v1+json
- Schema
- Example (from schema)
Schema
_embedded object
Embedded responses related to the resource.
get-ec2-mssql-failover-cluster-backup-status-statsFCIBackupStatusStats contain information about the backup status of the databases in the cluster
get-ec2-mssql-failover-cluster-hosts-infoConnectedHostsInfo contains information about the hosts associated with the cluster
get-ec2-mssql-failover-cluster-statsFCIStats contain information about the compliant databases in the cluster
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 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-policy-definition object
A HATEOAS link to the policy protecting this resource. Will be omitted for unprotected entities.
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.
- id string
The Clumio-assigned ID of the failover cluster.
- name string
The Microsoft SQL-assigned name of the failover cluster.
- organizational_unit_id string
The Clumio-assigned ID of the organizational unit associated with the FCI.
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 stringThe 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 stringThe 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 stringA system-generated ID assigned to the policy protecting this resource.
- protection_status string
ProtectionStatus of the FCI
- status string
The status of the FCI, Possible values include 'active' and 'inactive'.
{
"_embedded": {},
"_links": {
"_self": {
"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"
},
"protection_status": "string",
"status": "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"
}
]
}