{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/oracle/json-schema/oracle-byol-allocation-collection-schema.json",
  "title": "ByolAllocationCollection",
  "description": "A list of BYOL Allocations.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/oracle-byolallocation-api-openapi.yml#/components/schemas/ByolAllocationCollection",
  "properties": {
    "items": {
      "description": "A list of BYOL Allocations.",
      "items": {
        "$ref": "#/$defs/ByolAllocationSummary"
      },
      "type": "array"
    }
  },
  "required": [
    "items"
  ],
  "type": "object",
  "$defs": {
    "ByolAllocationSummary": {
      "description": "An allocation of [Oracle Cloud VMware Solution](/iaas/Content/VMware/Concepts/ocvsoverview.htm) \nBring-Your-Own-License (BYOL).\n",
      "properties": {
        "allocatedUnits": {
          "description": "The quantity of licensed units that allocated to this region.\n",
          "type": "integer"
        },
        "availableUnits": {
          "description": "The quantity of licensed units that not yet consumed by resources.\n",
          "type": "integer"
        },
        "byolId": {
          "description": "The [OCID](/Content/General/Concepts/identifiers.htm) of the BYOL resource from which this BYOL Allocation is derived.\n",
          "type": "string"
        },
        "compartmentId": {
          "description": "The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment that\ncontains the BYOL Allocation.\n",
          "type": "string"
        },
        "definedTags": {
          "additionalProperties": {
            "additionalProperties": {
              "description": "The value of the tag. Only the String type is supported.\n",
              "type": "object"
            },
            "description": "Key-value pair representing a defined tag key and value, scoped to a namespace.\n\nExample: `{\"CostCenter\": \"42\"}`\n",
            "type": "object"
          },
          "description": "Defined tags for this resource. Each key is predefined and scoped to a\nnamespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm).\n\nExample: `{\"Operations\": {\"CostCenter\": \"42\"}}`\n",
          "type": "object"
        },
        "displayName": {
          "description": "A descriptive name for the BYOL Allocation.\n",
          "type": "string"
        },
        "freeformTags": {
          "additionalProperties": {
            "type": "string"
          },
          "description": "Free-form tags for this resource. Each tag is a simple key-value pair with no\npredefined name, type, or namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm).\n\nExample: `{\"Department\": \"Finance\"}`\n",
          "type": "object"
        },
        "id": {
          "description": "The [OCID](/Content/General/Concepts/identifiers.htm) of the BYOL Allocation.\n",
          "type": "string"
        },
        "lifecycleState": {
          "description": "The current state of the BYOL Allocation. \nAccepted values are:\n- CREATING\n- ACTIVE\n- INACTIVE\n- UPDATING\n- DELETING\n- DELETED\n- FAILED\n",
          "type": "string",
          "x-obmcs-enumref": "#/definitions/ByolAllocation/lifecycleState"
        },
        "softwareType": {
          "description": "The type of VMware software the BYOL Allocation applies to. \nSupported values:\n- VCF (VMware Cloud Foundation)\n- VSAN (VMware vSAN)\n- VDEFEND (VMware vDefend Firewall)\n- AVI_LOAD_BALANCER (VMware Avi Load Balancer)\n",
          "type": "string",
          "x-obmcs-enumref": "#/definitions/ByolAllocation/softwareType"
        },
        "systemTags": {
          "additionalProperties": {
            "additionalProperties": {
              "description": "The value of the tag. Only string, integer and boolean types are supported.\n",
              "type": "object"
            },
            "description": "Key-value pair representing system tags' keys and values scoped to a namespace.\nExample: `{\"bar-key\": \"value\"}`\n",
            "type": "object"
          },
          "description": "Usage of system tag keys. These predefined keys are scoped to namespaces.\nExample: `{orcl-cloud: {free-tier-retain: true}}`\n",
          "type": "object"
        },
        "timeCreated": {
          "description": "The date and time the BYOL Allocation was created, in the format defined by\n[RFC3339](https://tools.ietf.org/html/rfc3339).\nExample: `2016-08-25T21:10:29.600Z`\n",
          "format": "date-time",
          "type": "string"
        },
        "timeTermEnd": {
          "description": "The date and time when the BYOL Allocation expires and becomes inactive.\nIn the format defined by[RFC3339](https://tools.ietf.org/html/rfc3339).\n",
          "format": "date-time",
          "type": "string"
        },
        "timeTermStart": {
          "description": "The date and time when the BYOL Allocation becomes active. VMware software functionality cannot begin before this time.\nIn the format defined by[RFC3339](https://tools.ietf.org/html/rfc3339).\nExample: `2016-08-25T21:10:29.600Z`\n",
          "format": "date-time",
          "type": "string"
        },
        "timeUpdated": {
          "description": "The date and time the BYOL Allocation was updated, in the format defined by\n[RFC3339](https://tools.ietf.org/html/rfc3339).\n",
          "format": "date-time",
          "type": "string"
        }
      },
      "required": [
        "id",
        "compartmentId",
        "displayName",
        "lifecycleState",
        "softwareType",
        "allocatedUnits",
        "availableUnits",
        "timeTermStart",
        "timeTermEnd",
        "byolId",
        "timeCreated",
        "timeUpdated",
        "freeformTags",
        "definedTags",
        "systemTags"
      ],
      "type": "object"
    }
  }
}