openapi: 3.2.0 info: description: "Use the Oracle Cloud VMware API to create SDDCs and manage ESXi hosts and software. \nFor more information, see [Oracle Cloud VMware Solution](/iaas/Content/VMware/Concepts/ocvsoverview.htm).\n" title: Oracle Cloud VMware Solution Datastore Cluster API version: '20230701' x-provenance: method: harvested first_party: true publisher: Oracle source: https://docs.oracle.com/en-us/iaas/api/specs/0ad4a7e38b48f3a2cbc0d7ed0bde083759a3aaafa2b2bd5a8e5ced4dbe7541d0.yaml harvested: '2026-08-04' note: Published by Oracle as the contract for the Oracle Cloud VMware Solution API OCI service and stored verbatim; API Evangelist added only this provenance block. x-evidence: - url: https://docs.oracle.com/en-us/iaas/api/specs/index.json what: Oracle's own index of every OCI service specification - url: https://docs.oracle.com/en-us/iaas/api/specs/0ad4a7e38b48f3a2cbc0d7ed0bde083759a3aaafa2b2bd5a8e5ced4dbe7541d0.yaml what: the harvested document for Oracle Cloud VMware Solution API servers: - url: http://127.0.0.1/20230701 - url: https://127.0.0.1/20230701 tags: - name: datastoreCluster paths: /datastoreClusters: get: description: 'List the Datastore Clusters in the specified compartment. The list can be filtered by compartment, Datastore Cluster, Display name and Lifecycle state. Either compartmentId or datastoreClusterId must be provided. ' operationId: ListDatastoreClusters parameters: - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam' - $ref: '#/components/parameters/DisplayNameQueryParam' - $ref: '#/components/parameters/DatastoreClusterIdentifierQueryParam' - $ref: '#/components/parameters/ClusterIdentifierQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' - $ref: '#/components/parameters/SortByQueryParam' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/LifecycleState' responses: 200: description: The list is being retrieved. headers: opc-next-page: description: 'For list pagination. When this header appears in the response, additional pages of results remain. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/DatastoreClusterCollection' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: List the Datastore Clusters in specified compartment tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' post: description: 'Creates a Oracle Cloud VMware Solution Datastore Cluster. ' operationId: CreateDatastoreCluster parameters: - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore Cluster will be created. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Creates a Datastore Cluster tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateDatastoreClusterDetails' description: Details for the Datastore Cluster. required: true /datastoreClusters/{datastoreClusterId}: delete: description: 'Deletes the specified Datastore Cluster. ' operationId: DeleteDatastoreCluster parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore Cluster will be deleted. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Deletes the specified Datastore Cluster tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' get: description: Get the specified Datastore Cluster information. operationId: GetDatastoreCluster parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The Datastore Cluster was retrieved. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/DatastoreCluster' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Get Datastore Cluster tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' put: description: 'Updates the specified Datastore Cluster. **Important:** Updating a Datastore Cluster affects only certain attributes in the `Datastore Cluster` object and does not affect the VMware environment currently running. ' operationId: UpdateDatastoreCluster parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore Cluster will be updated. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Updates the specified Datastore Cluster tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateDatastoreClusterDetails' description: The information to be updated. required: true /datastoreClusters/{datastoreClusterId}/actions/addDatastore: post: description: 'Add the specified Datastore to the provided Datastore Cluster. ' operationId: AddDatastoreToDatastoreCluster parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore will be added to the Datastore Cluster. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Add Datastore to the provided Datastore Cluster tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' requestBody: content: application/json: schema: $ref: '#/components/schemas/AddDatastoreToDatastoreClusterDetails' description: The information about datastore addition to the Datastore Cluster. required: true /datastoreClusters/{datastoreClusterId}/actions/attachToCluster: post: description: 'Attach the specified Datastore Cluster to the provided Vmware Cluster. Use the [WorkRequest](#/en/vmware/20200501/WorkRequest/) operations to track the attachment of the Datastore. ' operationId: AttachDatastoreClusterToCluster parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore Cluster will be attached to the VMware cluster. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Attach Datastore Cluster to the provided Vmware Cluster tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' requestBody: content: application/json: schema: $ref: '#/components/schemas/AttachDatastoreClusterToClusterDetails' description: The information about Datastore Cluster attachment. required: true /datastoreClusters/{datastoreClusterId}/actions/attachToEsxiHost: post: description: 'Attach the specified Datastore Cluster to the provided ESXi Hosts. Use the [WorkRequest](#/en/vmware/20200501/WorkRequest/) operations to track the attachment of the Datastore. ' operationId: AttachDatastoreClusterToEsxiHost parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore Cluster will be attached to the ESXi hosts. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Attach Datastore Cluster to the provided ESXi Hosts tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' requestBody: content: application/json: schema: $ref: '#/components/schemas/AttachDatastoreClusterToEsxiHostDetails' description: The information about Datastore Cluster attachment. required: true /datastoreClusters/{datastoreClusterId}/actions/changeCompartment: post: description: 'Moves an Datastore Cluster into a different compartment within the same tenancy. For information about moving resources between compartments, see [Moving Resources to a Different Compartment](/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes). ' operationId: ChangeDatastoreClusterCompartment parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/RetryTokenHeader' responses: 204: description: The Datastore Cluster has been moved to the specified compartment. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Moves an Datastore Cluster into a different compartment within the same tenancy tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' requestBody: content: application/json: schema: $ref: '#/components/schemas/ChangeDatastoreClusterCompartmentDetails' description: Request to change the compartment of the specified Datastore Cluster. required: true /datastoreClusters/{datastoreClusterId}/actions/detachFromCluster: post: description: 'Detach the specified Datastore Cluster from the provided Vmware Cluster. Use the [WorkRequest](#/en/vmware/20200501/WorkRequest/) operations to track the detachment of the Datastore. ' operationId: DetachDatastoreClusterFromCluster parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore Cluster will be detached from the Vmware Cluster. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Detach Datastore Cluster from the provided Vmware Cluster. tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' /datastoreClusters/{datastoreClusterId}/actions/detachFromEsxiHost: post: description: 'Detach the specified Datastore Cluster from the provided ESXi Hosts. Use the [WorkRequest](#/en/vmware/20200501/WorkRequest/) operations to track the detachment of the Datastore. ' operationId: DetachDatastoreClusterFromEsxiHost parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore Cluster will be detached from the ESXi hosts. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Detach Datastore Cluster from the provided ESXi Hosts tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' requestBody: content: application/json: schema: $ref: '#/components/schemas/DetachDatastoreClusterFromEsxiHostDetails' description: The information about Datastore Cluster detachment. required: true /datastoreClusters/{datastoreClusterId}/actions/removeDatastore: post: description: 'Remove the specified Datastore from the provided Datastore Cluster. ' operationId: RemoveDatastoreFromDatastoreCluster parameters: - $ref: '#/components/parameters/DatastoreClusterIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore will be removed from the Datastore Cluster. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' default: $ref: '#/components/responses/default' summary: Remove Datastore from the provided Datastore Cluster tags: - datastoreCluster x-related-resource: '#/definitions/DatastoreCluster' requestBody: content: application/json: schema: $ref: '#/components/schemas/RemoveDatastoreFromDatastoreClusterDetails' description: The information about datastore removal from the Datastore Cluster. required: true components: parameters: PaginationTokenQueryParam: description: 'For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' in: query name: page x-default-description: 'null' schema: type: string maxLength: 1024 minLength: 1 SortByQueryParam: description: 'The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. **Note:** In general, some "List" operations (for example, `ListInstances`) let you optionally filter by availability domain if the scope of the resource type is within a single availability domain. If you call one of these "List" operations without specifying an availability domain, the resources are grouped by availability domain, then sorted. ' in: query name: sortBy schema: type: string enum: - timeCreated - displayName default: timeCreated DatastoreClusterIdentifierPathParam: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore Cluster. ' in: path name: datastoreClusterId required: true schema: type: string ClusterIdentifierQueryParam: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the SDDC Cluster. ' in: query name: clusterId required: false x-default-description: 'null' schema: type: string IfMatchHeader: description: 'For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource''s current etag value. ' in: header name: if-match required: false schema: type: string DatastoreClusterIdentifierQueryParam: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore Cluster. ' in: query name: datastoreClusterId required: false x-default-description: 'null' schema: type: string PaginationLimitQueryParam: description: 'For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' in: query name: limit x-default-description: 'null' schema: type: integer default: 10 maximum: 1000 minimum: 1 SortOrderQueryParam: description: 'The sort order to use, either ascending (`ASC`) or descending (`DESC`). The DISPLAYNAME sort order is case sensitive. ' in: query name: sortOrder x-obmcs-top-level-enum: '#/definitions/SortOrders' schema: type: string enum: - ASC - DESC default: ASC RetryTokenHeader: description: 'A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected). ' in: header name: opc-retry-token required: false schema: type: string maxLength: 64 minLength: 1 DisplayNameQueryParam: description: A filter to return only resources that match the given display name exactly. in: query name: displayName x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 RequestIdHeader: description: 'Unique identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' in: header name: opc-request-id schema: type: string LifecycleState: description: The lifecycle state of the resource. in: query name: lifecycleState required: false x-default-description: 'null' x-obmcs-top-level-enum: '#/definitions/LifecycleStates' schema: type: string enum: - CREATING - UPDATING - ACTIVE - DELETING - DELETED - FAILED CompartmentIdOptionalQueryParam: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment as optional parameter. in: query name: compartmentId required: false schema: type: string schemas: DatastoreClusterSummary: description: "An [Oracle Cloud VMware Solution](/iaas/Content/VMware/Concepts/ocvsoverview.htm) Datastore Cluster for software-defined data center. \n\nThe Datastore Cluster combines multiple datastores into a single datastore cluster.\n" properties: availabilityDomain: description: 'The availability domain of the Datastore Cluster. ' maxLength: 64 minLength: 1 type: string capacityInGBs: description: Total size of all datastores associated with the datastore cluster in GB. format: double type: number clusterId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the VMware Cluster that Datastore Cluster is attached to. ' type: string compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment that contains the Datastore Cluster. ' type: string datastoreClusterType: description: Type of the datastore cluster. enum: - MANAGEMENT - WORKLOAD type: string x-obmcs-top-level-enum: '#/definitions/DatastoreClusterTypes' datastoreIds: description: 'The [OCIDs](/Content/General/Concepts/identifiers.htm) of the Datastores that belong to the Datastore Cluster ' items: maxLength: 255 minLength: 1 type: string maxItems: 64 type: array definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: 'A descriptive name for the Datastore Cluster. It must be unique within a SDDC, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information. ' type: string esxiHostIds: description: 'The [OCIDs](/Content/General/Concepts/identifiers.htm) of the ESXi hosts attached to Datastore Cluster. ' items: maxLength: 255 minLength: 1 type: string maxItems: 64 type: array freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore. ' type: string lifecycleState: description: The current state of the Datastore Cluster. enum: - CREATING - UPDATING - ACTIVE - DELETING - DELETED - FAILED type: string x-obmcs-top-level-enum: '#/definitions/LifecycleStates' sddcId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the SDDC that Datastore Cluster is associated with. ' type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing system tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{orcl-cloud: {free-tier-retain: true}}` ' type: object timeCreated: description: 'The date and time the Datastore Cluster was created, in the format defined by [RFC3339](https://tools.ietf.org/html/rfc3339). Example: `2016-08-25T21:10:29.600Z` ' format: date-time type: string required: - id - compartmentId - displayName - datastoreIds - lifecycleState - availabilityDomain - timeCreated type: object Error: description: Error Information. properties: code: description: 'A short error code that defines the error, meant for programmatic parsing. See [API Errors](/Content/API/References/apierrors.htm). ' type: string message: description: A human-readable error string. type: string required: - code - message AddDatastoreToDatastoreClusterDetails: description: Details for the datastore attachment to Datastore Cluster. properties: datastoreIds: description: A list of datastores to be added. items: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore to add to Datastore Cluster. maxLength: 255 minLength: 1 type: string minItems: 1 type: array required: - datastoreIds type: object AttachDatastoreClusterToClusterDetails: description: Details for the datastore cluster attachment to Vmware Cluster. properties: clusterId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the VMware cluster to attach the datastore cluster to. ' maxLength: 255 minLength: 1 type: string required: - clusterId type: object DetachDatastoreClusterFromEsxiHostDetails: description: Details for the datastore cluster detachment from ESXi hosts. properties: esxiHostId: description: "The [OCID](/Content/General/Concepts/identifiers.htm) of the ESXi host to detach the \ndatastore cluster from.\n" maxLength: 255 minLength: 1 type: string required: - esxiHostId type: object DatastoreCluster: description: "An [Oracle Cloud VMware Solution](/iaas/Content/VMware/Concepts/ocvsoverview.htm) Datastore Cluster for software-defined data center. \n\nThe Datastore Cluster combines multiple datastores into a single datastore cluster.\n" properties: availabilityDomain: description: 'The availability domain of the Datastore Cluster. ' maxLength: 64 minLength: 1 type: string capacityInGBs: description: Total size of all datastores associated with the datastore cluster in GB. format: double type: number clusterId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the VMware Cluster that Datastore cluster is attached to. ' type: string compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment that contains the Datastore. ' type: string datastoreClusterType: description: Type of the datastore cluster. enum: - MANAGEMENT - WORKLOAD type: string x-obmcs-top-level-enum: '#/definitions/DatastoreClusterTypes' datastoreIds: description: 'The [OCIDs](/Content/General/Concepts/identifiers.htm) of the Datastores that belong to the Datastore Cluster ' items: maxLength: 255 minLength: 1 type: string maxItems: 64 type: array definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: 'A descriptive name for the Datastore Cluster. It must be unique within a SDDC, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information. ' type: string esxiHostIds: description: 'The [OCIDs](/Content/General/Concepts/identifiers.htm) of the ESXi hosts to attach the datastore to. All ESXi hosts must belong to the same VMware cluster. ' items: maxLength: 255 minLength: 1 type: string maxItems: 64 type: array freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore cluster. ' type: string lifecycleState: description: The current state of the Datastore Cluster. enum: - CREATING - UPDATING - ACTIVE - DELETING - DELETED - FAILED type: string x-obmcs-top-level-enum: '#/definitions/LifecycleStates' sddcId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the SDDC that Datastore cluster is associated with. ' type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing system tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{orcl-cloud: {free-tier-retain: true}}` ' type: object timeCreated: description: 'The date and time the Datastore Cluster was created, in the format defined by [RFC3339](https://tools.ietf.org/html/rfc3339). Example: `2016-08-25T21:10:29.600Z` ' format: date-time type: string timeUpdated: description: 'The date and time the Datastore Cluster was updated, in the format defined by [RFC3339](https://tools.ietf.org/html/rfc3339). ' format: date-time type: string required: - id - compartmentId - displayName - datastoreIds - lifecycleState - datastoreClusterType - availabilityDomain - timeCreated - timeUpdated type: object UpdateDatastoreClusterDetails: description: The Datastore Cluster information to be updated. properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: 'A descriptive name for the Datastore Cluster. It must be unique within a SDDC, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information. ' type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object type: object AttachDatastoreClusterToEsxiHostDetails: description: Details for the datastore cluster attachment to ESXi hosts. properties: esxiHostId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the ESXi host to attach the datastore cluster to. ' maxLength: 255 minLength: 1 type: string required: - esxiHostId type: object ChangeDatastoreClusterCompartmentDetails: description: The configuration details for the move operation. properties: compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment to move the Datastore Cluster to. ' maxLength: 255 minLength: 1 type: string required: - compartmentId CreateDatastoreClusterDetails: description: Details of the Datastore Cluster. properties: availabilityDomain: description: 'The availability domain to create the Datastore Cluster in. ' maxLength: 64 minLength: 1 type: string compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment to contain the Datastore Cluster. ' type: string datastoreClusterType: description: Type of the datastore. enum: - MANAGEMENT - WORKLOAD type: string x-obmcs-top-level-enum: '#/definitions/DatastoreClusterTypes' datastoreIds: description: 'The [OCIDs](/Content/General/Concepts/identifiers.htm) of the Datastores that belong to the Datastore Cluster. ' items: maxLength: 255 minLength: 1 type: string maxItems: 32 type: array definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: 'A descriptive name for the Datastore Cluster. It must be unique within a SDDC, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information. ' type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object required: - displayName - compartmentId - datastoreClusterType - availabilityDomain type: object RemoveDatastoreFromDatastoreClusterDetails: description: Details for the datastore removal from Datastore Cluster. properties: datastoreIds: description: A list of datastores to be removed. items: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore to remove from Datastore Cluster. maxLength: 255 minLength: 1 type: string minItems: 1 type: array required: - datastoreIds type: object DatastoreClusterCollection: description: A list of Datastore Clusters. properties: items: description: A list of Datastore Clusters. items: $ref: '#/components/schemas/DatastoreClusterSummary' type: array required: - items type: object responses: default: description: Unknown Error headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/Error' x-anchors: x-headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' type: string opc-next-page: description: 'For list pagination. When this header appears in the response, additional pages of results remain. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' type: string opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' type: string retry-after: description: A decimal number representing the number of seconds the client should wait before polling this endpoint again. format: float type: number x-properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing system tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{orcl-cloud: {free-tier-retain: true}}` ' type: object x-obmcs-client-retries-enabled: true x-oracle-package: com.oracle.pic.vmware.ocvp