openapi: 3.0.0
info:
title: OpenStorage SDK OpenStorageAlerts OpenStorageClusterDomains API
version: 0.186.0
security:
- bearerAuth: []
tags:
- name: OpenStorageClusterDomains
paths:
/v1/clusterdomains:
get:
operationId: OpenStorageClusterDomains_Enumerate
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/apiSdkClusterDomainsEnumerateResponse'
description: A successful response.
default:
content:
application/json:
schema:
$ref: '#/components/schemas/runtimeError'
description: An unexpected error response.
summary: Enumerate returns names of all the cluster domains in the cluster
tags:
- OpenStorageClusterDomains
/v1/clusterdomains/activate/{cluster_domain_name}:
post:
operationId: OpenStorageClusterDomains_Activate
parameters:
- description: Name of the cluster domain to activate
in: path
name: cluster_domain_name
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/apiSdkClusterDomainActivateResponse'
description: A successful response.
default:
content:
application/json:
schema:
$ref: '#/components/schemas/runtimeError'
description: An unexpected error response.
summary: 'Activates a cluster domain in the cluster.
All the nodes which are part of an active cluster domain
will participate in cluster quorum calculation'
tags:
- OpenStorageClusterDomains
/v1/clusterdomains/deactivate/{cluster_domain_name}:
post:
operationId: OpenStorageClusterDomains_Deactivate
parameters:
- description: Name of the cluster domain to deactivate
in: path
name: cluster_domain_name
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/apiSdkClusterDomainDeactivateResponse'
description: A successful response.
default:
content:
application/json:
schema:
$ref: '#/components/schemas/runtimeError'
description: An unexpected error response.
summary: 'Deactivates a cluster domain in the cluster.
All the nodes which are part of a deactivated cluster domain.
will not participate in cluster quorum calculation'
tags:
- OpenStorageClusterDomains
/v1/clusterdomains/inspect/{cluster_domain_name}:
get:
operationId: OpenStorageClusterDomains_Inspect
parameters:
- description: Name of the cluster domain to inspect
in: path
name: cluster_domain_name
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/apiSdkClusterDomainInspectResponse'
description: A successful response.
default:
content:
application/json:
schema:
$ref: '#/components/schemas/runtimeError'
description: An unexpected error response.
summary: 'Inspect returns information about a cluster domain and a
status indicating whether the cluster domain is active'
tags:
- OpenStorageClusterDomains
components:
schemas:
protobufAny:
properties:
type_url:
type: string
value:
format: byte
type: string
type: object
apiSdkClusterDomainsEnumerateResponse:
properties:
cluster_domain_names:
items:
type: string
title: List of names of all the cluster domains in a cluster
type: array
title: Defines a response when enumerating cluster domains
type: object
apiSdkClusterDomainActivateResponse:
title: Empty response
type: object
runtimeError:
properties:
code:
format: int32
type: integer
details:
items:
$ref: '#/components/schemas/protobufAny'
type: array
error:
type: string
message:
type: string
type: object
apiSdkClusterDomainDeactivateResponse:
title: Empty response
type: object
apiSdkClusterDomainInspectResponse:
properties:
cluster_domain_name:
title: Name of the cluster domain
type: string
is_active:
title: IsActive indicates whether this cluster domain is active
type: boolean
title: Defines a response to inspecting a cluster domain
type: object
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT