---
title: "Create cluster service group"
method: POST
path: "/clusters/{ClusterName}/servicegroups"
tags: ["ServiceGroups"]
---

# Create cluster service group

`POST /clusters/{ClusterName}/servicegroups`

## Request

- Base URL: `https://sort.veritas.com/infoscale/api/2.0`
- URL: `https://sort.veritas.com/infoscale/api/2.0/clusters/{ClusterName}/servicegroups`
- Auth: none declared
- TypeScript: <https://skmtc.dev/veritas/apis/veritas-infoscale-api/docs/clusters/:ClusterName/servicegroups/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a cluster service group.

## Path parameters

- `ClusterName` string, required

## Request body

- ServicegroupV2v0
  - `ActiveCount` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AdministratorGroups` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Administrators` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Authority` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoClearCount` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoClearInterval` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoClearLimit` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoDisabled` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoFailOver` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoRestart` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoStart` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoStartIfPartial` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoStartList` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `AutoStartPolicy` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `CapacityReserved` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `ClusterFailOverPolicy` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `ClusterList` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `ContainerInfo` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `CurrentCount` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `DeferAutoStart` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Dependency` ServicegroupV2v0Dependency
    - `Parents` Servicegroupdependency[]
      - `GroupName` string, required
      - `DependencyType` 'online_local_firm' | 'online_local_soft' | 'online_local_hard' | 'online_global_firm' | 'online_global_soft' | 'online_global_hard' | 'online_remote_firm' | 'online_remote_soft' | 'online_remote_hard' | 'offline_local' | 'none', required: type of dependency; none indicates removal of dependency in PATCH operation
    - `Children` Servicegroupdependency[], required
      - `GroupName` string, required
      - `DependencyType` 'online_local_firm' | 'online_local_soft' | 'online_local_hard' | 'online_global_firm' | 'online_global_soft' | 'online_global_hard' | 'online_remote_firm' | 'online_remote_soft' | 'online_remote_hard' | 'offline_local' | 'none', required: type of dependency; none indicates removal of dependency in PATCH operation
  - `DisableFaultMessages` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Enabled` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Evacuate` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Evacuating` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `EvacList` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `EvacuatingForGroup` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Failover` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `FailOverPolicy` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `FaultPropagation` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `FromQ` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Frozen` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `FrozenState` GroupfreezeV2v0
    - `Frozen` boolean: Indicates freeze or unfreeze
    - `Persistent` boolean: Indicates persistent or temporary freeze
  - `GroupOwner` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `GroupRecipients` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Guests` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `IntentOnline` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `IntentionalOnlineList` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `LastSuccess` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Load` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `ManageFaults` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `ManualOps` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `MeterWeight` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `MigrateQ` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Name` string: Name of the service group
  - `NumRetries` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `OnlineAtUnfreeze` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `OnlineClearParent` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `OnlineRetryInterval` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `OnlineRetryLimit` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `OperatorGroups` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Operators` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Parallel` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `PathCount` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `PCVAllowOnline` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `PolicyIntention` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `PreOnline` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `PreOnlining` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `PreonlineTimeout` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Prerequisites` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `PreSwitch` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `PreSwitching` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `PrintTree` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Priority` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Probed` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `ProbesPending` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `ProPCV` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Responding` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `SourceFile` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `States` GroupstateV2v0[]
    - `System` string: Indicates system name for state change operation.
    - `State` string, required: group state online offline clear
    - `Propagate` boolean: use for online/offline operation only
    - `Ifprobed` boolean: use for offline operation only
    - `Force` boolean: use for online/offline operation only
  - `SysDownPolicy` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `SystemList` GroupsystemV2v0[]: SystemList
    - `System` string: system name
    - `Priority` integer: System priority
  - `SystemZones` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `Tag` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `TargetCount` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `TFrozen` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `ToQ` Readonlyattribute
    - `Value` unknown
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `TriggerPath` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `TriggerResFault` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `TriggerResRestart` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `TriggerResStateChange` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `TriggersEnabled` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `TypeDependencies` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `UnSteadyCount` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `UserAssoc` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `UserIntGlobal` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `UserStrGlobal` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `UserIntLocal` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `UserStrLocal` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute
  - `VCSi3Info` Servicegroupattribute
    - `Value` unknown, required
    - `Scope` 'global' | 'local': Scope of the attribute.
    - `Type` 'scalar' | 'vector' | 'keylist' | 'associate': Type of the attribute

## Response `200`

The request has succeeded.

- Response
  - `detail` string: Error details.
  - `status` integer: http code

## Other responses

- `400`: Bad request
- `401`: The requested operation requires authentication.
- `403`: Forbidden
- `404`: Object that the endpoint is working on is not found.

---

[API](https://skmtc.dev/veritas/apis/veritas-infoscale-api.md) - [All operations](https://skmtc.dev/veritas/apis/veritas-infoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/veritas/apis/veritas-infoscale-api/revisions/1e3d3f7145bb?raw)
