{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-platform/json-schema/google-cloud-platform-boundary-schema.json",
  "title": "Boundary",
  "description": "A Boundary is a collection of projects defined by a filtering criteria on an organization or a folder.",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-platform-cloudresourcemanager-folders-api-openapi.yml#/components/schemas/Boundary",
  "properties": {
    "updateTime": {
      "format": "google-datetime",
      "description": "Output only. The most recent time this Boundary was modified.",
      "readOnly": true,
      "type": "string"
    },
    "managementProject": {
      "description": "Output only. The Management Project of the CapabilityConfig this Boundary is associated with. Will be empty if the Boundary is not associated with any CapabilityConfig. Format: `projects/{project_number}` Example: `projects/123456789012`",
      "type": "string",
      "readOnly": true
    },
    "resourceFilter": {
      "$ref": "#/$defs/ResourceFilter",
      "description": "Optional. The filter defining the criteria for descendant projects to be included in the Boundary. Descendant projects are dynamically included in the Boundary based on this filter."
    },
    "state": {
      "description": "Output only. The lifecycle state of the Boundary.",
      "readOnly": true,
      "type": "string",
      "enum": [
        "STATE_UNSPECIFIED",
        "CREATING",
        "ACTIVE"
      ]
    },
    "displayName": {
      "type": "string",
      "description": "Optional. Human-readable display name of the Boundary. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point. Example: `My Production Boundary`"
    },
    "createTime": {
      "format": "google-datetime",
      "description": "Output only. The creation time of the Boundary.",
      "readOnly": true,
      "type": "string"
    },
    "etag": {
      "type": "string",
      "description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding."
    },
    "name": {
      "type": "string",
      "description": "Identifier. The unique resource name of the Boundary. Format: - `organizations/{organization_id}/boundaries/{boundary_id}` - `folders/{folder_id}/boundaries/{boundary_id}` Example: `folders/123456789/boundaries/my-boundary`"
    }
  },
  "type": "object",
  "$defs": {
    "ResourceFilter": {
      "properties": {
        "tagFilter": {
          "$ref": "#/$defs/TagFilter",
          "description": "A tag based filter. A project must match it to be included."
        }
      },
      "description": "Filter to define the criteria for including projects in the Boundary.",
      "type": "object"
    },
    "TagFilter": {
      "type": "object",
      "properties": {
        "tagValue": {
          "type": "string",
          "description": "Required. The allowed value for the tag key. A project matches this tag filter if its effective tag value for the given `tag_key` matches this value. Format: short name of the tag value. Example: `production` or `staging`."
        },
        "tagKey": {
          "type": "string",
          "description": "Required. Immutable. The namespaced name of the tag key. Format: `{parent_id}/{tag_key_short_name}` Example: `123456789012/env` (where 123456789012 is the organization ID)."
        }
      },
      "description": "Matches projects based on a specific tag key and a specific tag value."
    }
  }
}