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 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: datastore paths: /datastores: get: description: 'List the Datastores in the specified compartment. The list can be filtered by compartment, datastore id, display name and lifecycle state. Either compartmentId or datastoreId must be provided. ' operationId: ListDatastores parameters: - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam' - $ref: '#/components/parameters/DisplayNameQueryParam' - $ref: '#/components/parameters/ClusterIdentifierQueryParam' - $ref: '#/components/parameters/DatastoreIdentifierQueryParam' - $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/DatastoreCollection' 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 Datastores in specified compartment tags: - datastore x-related-resource: '#/definitions/Datastore' post: description: 'Creates a Oracle Cloud VMware Solution Datastore. Use the [WorkRequest](#/en/vmware/20200501/WorkRequest/) operations to track the creation of the Datastore. ' operationId: CreateDatastore parameters: - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore 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 tags: - datastore x-related-resource: '#/definitions/Datastore' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateDatastoreDetails' description: Details for the Datastore. required: true /datastores/{datastoreId}: delete: description: 'Deletes the specified Datastore. Use the [WorkRequest](#/en/vmware/20200501/WorkRequest/) operations to track the deletion of the Datastore. ' operationId: DeleteDatastore parameters: - $ref: '#/components/parameters/DatastoreIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore 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 tags: - datastore x-related-resource: '#/definitions/Datastore' get: description: Get the specified Datastore's information. operationId: GetDatastore parameters: - $ref: '#/components/parameters/DatastoreIdentifierPathParam' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The Datastore 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/Datastore' 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 tags: - datastore x-related-resource: '#/definitions/Datastore' put: description: 'Updates the specified Datastore. **Important:** Updating a Datastore affects only certain attributes in the `Datastore` object and does not affect the VMware environment currently running. ' operationId: UpdateDatastore parameters: - $ref: '#/components/parameters/DatastoreIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Datastore 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 tags: - datastore x-related-resource: '#/definitions/Datastore' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateDatastoreDetails' description: The information to be updated. required: true /datastores/{datastoreId}/actions/addBlockVolume: post: description: 'Add the specified Block Volume to the provided Datastore. Use the [WorkRequest](#/en/vmware/20200501/WorkRequest/) operations to track the addition of the block volume to the Datastore. ' operationId: AddBlockVolumeToDatastore parameters: - $ref: '#/components/parameters/DatastoreIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 202: description: The request was accepted and the Block Volume will be added to the Datastore. 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 Block Volume to the provided Datastore tags: - datastore x-related-resource: '#/definitions/Datastore' requestBody: content: application/json: schema: $ref: '#/components/schemas/AddBlockVolumeToDatastoreDetails' description: The information about Block Volume addition to datastore. required: true /datastores/{datastoreId}/actions/changeCompartment: post: description: 'Moves an Datastore 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: ChangeDatastoreCompartment parameters: - $ref: '#/components/parameters/DatastoreIdentifierPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/RetryTokenHeader' responses: 204: description: The Datastore 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 into a different compartment within the same tenancy tags: - datastore x-related-resource: '#/definitions/Datastore' requestBody: content: application/json: schema: $ref: '#/components/schemas/ChangeDatastoreCompartmentDetails' description: Request to change the compartment of the specified Datastore required: true components: schemas: CreateDatastoreDetails: description: Details of the Datastore properties: availabilityDomain: description: 'The availability domain to create the Datastore in. ' maxLength: 64 minLength: 1 type: string blockVolumeIds: description: 'The List of Block volume [OCID](/Content/General/Concepts/identifiers.htm)s that belong to the Datastore. ' items: type: string maxItems: 32 type: array compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment to contain the Datastore. ' maxItems: 64 type: string datastoreClusterId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the datastore cluster that Datastore belongs to. ' type: string 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. 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: - blockVolumeIds - displayName - compartmentId - availabilityDomain 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 DatastoreCollection: description: A list of Datastores. properties: items: description: A list of Datastores. items: $ref: '#/components/schemas/DatastoreSummary' type: array required: - items type: object ChangeDatastoreCompartmentDetails: 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 to. ' maxLength: 255 minLength: 1 type: string required: - compartmentId AddBlockVolumeToDatastoreDetails: description: Details for the Block Volume addition to the datastore properties: blockVolumeId: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the Block Volume to be added to the Datastore. maxLength: 255 minLength: 1 type: string required: - blockVolumeId type: object Datastore: description: 'An [Oracle Cloud VMware Solution](/iaas/Content/VMware/Concepts/ocvsoverview.htm) Datastore for software-defined data center. ' properties: availabilityDomain: description: 'The availability domain of the Datastore. ' maxLength: 64 minLength: 1 type: string blockVolumeDetails: description: 'The list of Block Volume details that belong to the datastore. ' items: $ref: '#/components/schemas/BlockVolumeDetails' maxItems: 32 type: array blockVolumeIds: description: 'The List of Block volume [OCID](/Content/General/Concepts/identifiers.htm)s that belong to the Datastore. ' items: type: string maxItems: 32 type: array capacityInGBs: description: Total size of the datastore in GB. format: double type: number clusterId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the VMware Cluster that Datastore is attached to. ' type: string compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment that contains the Datastore. ' type: string datastoreClusterId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the datastore cluster that Datastore belongs to. ' type: string 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. 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 id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore. ' type: string lifecycleState: description: The current state of the Datastore. 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 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 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 was updated, in the format defined by [RFC3339](https://tools.ietf.org/html/rfc3339). ' format: date-time type: string required: - id - blockVolumeIds - blockVolumeDetails - compartmentId - displayName - lifecycleState - availabilityDomain - timeCreated - timeUpdated type: object DatastoreSummary: description: "An [Oracle Cloud VMware Solution](/iaas/Content/VMware/Concepts/ocvsoverview.htm) Datastore for software-defined data center. \n\nThe Datastore can be attached to multiple ESXi hosts.\n" properties: availabilityDomain: description: 'The availability domain of the Datastore. ' maxLength: 64 minLength: 1 type: string blockVolumeDetails: description: 'The list of Block Volume details that belong to the datastore. ' items: $ref: '#/components/schemas/BlockVolumeDetails' maxItems: 32 type: array blockVolumeIds: description: 'The List of Block volume [OCID](/Content/General/Concepts/identifiers.htm)s that belong to the Datastore. ' items: type: string maxItems: 32 type: array capacityInGBs: description: Total size of the datastore in GB. format: double type: number clusterId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the VMware Cluster that Datastore is attached to. ' type: string compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment that contains the Datastore. ' type: string datastoreClusterId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the datastore cluster that Datastore belongs to. ' type: string 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. 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 id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore. ' type: string lifecycleState: description: The current state of the Datastore. 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 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 SDDC 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 - blockVolumeIds - blockVolumeDetails - compartmentId - displayName - lifecycleState - availabilityDomain - timeCreated type: object BlockVolumeAttachment: description: 'The details about the attachment of block volume. ' properties: esxiHostId: description: 'The [OCIDs](/Content/General/Concepts/identifiers.htm) of the ESXi host that block volume is attached to. ' maxLength: 255 minLength: 1 type: string ipAddress: description: The IP address of block volume attachment. maxLength: 255 minLength: 1 type: string port: description: The port of block volume attachment. type: integer required: - esxiHostId - ipAddress - port type: object UpdateDatastoreDetails: description: The Datastore 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. 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 BlockVolumeDetails: description: 'Block volume that is part of the Datastore. ' properties: attachments: description: List of BlockVolumeAttachment objects containing information about attachment details items: $ref: '#/components/schemas/BlockVolumeAttachment' maxItems: 32 type: array id: description: An [OCID](/Content/General/Concepts/identifiers.htm)s of the Block Storage Volume. maxLength: 255 minLength: 1 type: string iqn: description: An IQN of the Block Storage Volume. maxLength: 255 minLength: 1 type: string required: - id type: object 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 DatastoreIdentifierQueryParam: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore. ' in: query name: datastoreId required: false x-default-description: 'null' 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 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 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 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 CompartmentIdOptionalQueryParam: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment as optional parameter. in: query name: compartmentId required: false schema: type: string DatastoreIdentifierPathParam: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Datastore. ' in: path name: datastoreId required: true schema: type: string 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