{ "$id": "http://redfish.dmtf.org/schemas/v1/CollectionCapabilities.v1_4_1.json", "$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json", "copyright": "Copyright 2014-2024 DMTF. For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright", "definitions": { "Capability": { "additionalProperties": false, "description": "This type describes a capability of a collection for a specific use case.", "longDescription": "This type shall describe a capability of a resource collection in terms of how a client can create resources within the collection for the specified use case.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "CapabilitiesObject": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/idRef", "description": "The link to the resource the client can issue a `GET` request against to understand how to form a `POST` request for a collection.", "longDescription": "This property shall contain a link to a resource that matches the type for a resource collection and shall contain annotations that describe the properties allowed in the `POST` request.", "readonly": true }, "Links": { "$ref": "#/definitions/Links", "description": "The links to other resources that are related to this resource.", "longDescription": "This property shall contain links to resources that are related to but are not contained by, or subordinate to, this resource." }, "UseCase": { "$ref": "#/definitions/UseCase", "description": "The use case in which a client can issue a `POST` request to the collection.", "longDescription": "This property shall contain an enumerated value that describes the use case for this capability instance.", "readonly": true } }, "required": [ "CapabilitiesObject", "UseCase", "Links" ], "type": "object" }, "CollectionCapabilities": { "additionalProperties": false, "description": "This type describes the capabilities of a collection.", "longDescription": "This type shall describe any capabilities of a resource collection in terms of how a client can create resources within the resource collection.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "Capabilities": { "description": "The list of capabilities supported by this resource.", "items": { "$ref": "#/definitions/Capability" }, "longDescription": "This property shall contain an array of objects that describe the capabilities of this resource collection.", "type": "array" }, "MaxMembers": { "description": "The maximum number of members allowed in this collection.", "longDescription": "This property shall contain the maximum number of members allowed in this resource collection.", "minimum": 1, "readonly": true, "type": "integer", "versionAdded": "v1_2_0" } }, "type": "object" }, "Links": { "additionalProperties": false, "description": "The links to other resources that are related to this resource.", "longDescription": "This Redfish Specification-described type shall contain links to resources that are related to but are not contained by, or subordinate to, this resource.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "Oem": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", "description": "The OEM extension property.", "longDescription": "This property shall contain the OEM extensions. All values for properties contained in this object shall conform to the Redfish Specification-described requirements." }, "RelatedItem": { "description": "An array of links to resources associated with this capability.", "items": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/idRef" }, "longDescription": "This property shall contain an array of links to resources that are related to this capability.", "readonly": true, "type": "array" }, "RelatedItem@odata.count": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count" }, "TargetCollection": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/ResourceCollection", "description": "The link to the collection that this capabilities structure is describing.", "longDescription": "This property shall contain a link to a resource collection that this structure describes. A client can use this structure to understand how to form the `POST` request for the collection.", "readonly": true } }, "required": [ "TargetCollection" ], "type": "object" }, "UseCase": { "enum": [ "ComputerSystemComposition", "ComputerSystemConstrainedComposition", "VolumeCreation", "ResourceBlockComposition", "ResourceBlockConstrainedComposition", "RegisterResourceBlock" ], "enumDescriptions": { "ComputerSystemComposition": "This capability describes a client creating a new computer system resource from a set of disaggregated hardware.", "ComputerSystemConstrainedComposition": "This capability describes a client creating a new computer system resource from a set of constraints.", "RegisterResourceBlock": "This capability describes a client creating a new resource block from an existing computer system to enable it to be used by the composition service.", "ResourceBlockComposition": "This capability describes a client creating a new resource block from a set of other resource blocks.", "ResourceBlockConstrainedComposition": "This capability describes a client creating a new resource block from a set of constraints.", "VolumeCreation": "This capability describes a client creating a new volume resource as part of an existing storage subsystem." }, "enumVersionAdded": { "ComputerSystemConstrainedComposition": "v1_1_0", "RegisterResourceBlock": "v1_4_0", "ResourceBlockComposition": "v1_3_0", "ResourceBlockConstrainedComposition": "v1_3_0" }, "type": "string" } }, "language": "en", "owningEntity": "DMTF", "release": "2022.1", "title": "#CollectionCapabilities.v1_4_1" }