Amazon Glue · JSON Structure

Glue Create Session Request Structure

Request to create a new session.

Type: object Properties: 15 Required: 3
AnalyticsData CatalogData IntegrationData PipelineETLServerless

CreateSessionRequest is a JSON Structure definition published by Amazon Glue, describing 15 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

Id Description Role Command Timeout IdleTimeout DefaultArguments Connections MaxCapacity NumberOfWorkers WorkerType SecurityConfiguration GlueVersion Tags RequestOrigin

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-glue/refs/heads/main/json-structure/glue-create-session-request-structure.json",
  "name": "CreateSessionRequest",
  "description": "Request to create a new session.",
  "type": "object",
  "properties": {
    "Id": {
      "allOf": [
        {
          "$ref": "#/components/schemas/NameString"
        },
        {
          "description": "The ID of the session request. "
        }
      ]
    },
    "Description": {
      "allOf": [
        {
          "$ref": "#/components/schemas/DescriptionString"
        },
        {
          "description": "The description of the session. "
        }
      ]
    },
    "Role": {
      "allOf": [
        {
          "$ref": "#/components/schemas/OrchestrationRoleArn"
        },
        {
          "description": "The IAM Role ARN "
        }
      ]
    },
    "Command": {
      "allOf": [
        {
          "$ref": "#/components/schemas/SessionCommand"
        },
        {
          "description": "The <code>SessionCommand</code> that runs the job. "
        }
      ]
    },
    "Timeout": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Timeout"
        },
        {
          "description": " The number of minutes before session times out. Default for Spark ETL jobs is 48 hours (2880 minutes), the maximum session lifetime for this job type. Consult the documentation for other job types. "
        }
      ]
    },
    "IdleTimeout": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Timeout"
        },
        {
          "description": " The number of minutes when idle before session times out. Default for Spark ETL jobs is value of Timeout. Consult the documentation for other job types. "
        }
      ]
    },
    "DefaultArguments": {
      "allOf": [
        {
          "$ref": "#/components/schemas/OrchestrationArgumentsMap"
        },
        {
          "description": "A map array of key-value pairs. Max is 75 pairs. "
        }
      ]
    },
    "Connections": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ConnectionsList"
        },
        {
          "description": "The number of connections to use for the session. "
        }
      ]
    },
    "MaxCapacity": {
      "allOf": [
        {
          "$ref": "#/components/schemas/NullableDouble"
        },
        {
          "description": "The number of Glue data processing units (DPUs) that can be allocated when the job runs. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB memory. "
        }
      ]
    },
    "NumberOfWorkers": {
      "allOf": [
        {
          "$ref": "#/components/schemas/NullableInteger"
        },
        {
          "description": "The number of workers of a defined <code>WorkerType</code> to use for the session. "
        }
      ]
    },
    "WorkerType": {
      "allOf": [
        {
          "$ref": "#/components/schemas/WorkerType"
        },
        {
          "description": "<p>The type of predefined worker that is allocated to use for the session. Accepts a value of Standard, G.1X, G.2X, or G.025X.</p> <ul> <li> <p>For the <code>Standard</code> worker type, each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.</p> </li> <li> <p>For the <code>G.1X</code> worker type, each worker maps to 1 DPU (4 vCPU, 16 GB of memory, 64 GB disk), and provides 1 executor per worker. We recommend this worker type for memory-intensive jobs.</p> </li> <li> <p>For the <code>G.2X</code> worker type, each worker maps to 2 DPU (8 vCPU, 32 GB of memory, 128 GB disk), and provides 1 executor per worker. We recommend this worker type for memory-intensive jobs.</p> </li> <li> <p>For the <code>G.025X</code> worker type, each worker maps to 0.25 DPU (2 vCPU, 4 GB of memory, 64 GB disk), and provides 1 executor per worker. We recommend this worker type for low volume streaming jobs. This worker type is only available for Glue version 3.0 streaming jobs.</p> </li> </ul>"
        }
      ]
    },
    "SecurityConfiguration": {
      "allOf": [
        {
          "$ref": "#/components/schemas/NameString"
        },
        {
          "description": "The name of the SecurityConfiguration structure to be used with the session "
        }
      ]
    },
    "GlueVersion": {
      "allOf": [
        {
          "$ref": "#/components/schemas/GlueVersionString"
        },
        {
          "description": "The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0. "
        }
      ]
    },
    "Tags": {
      "allOf": [
        {
          "$ref": "#/components/schemas/TagsMap"
        },
        {
          "description": "The map of key value pairs (tags) belonging to the session."
        }
      ]
    },
    "RequestOrigin": {
      "allOf": [
        {
          "$ref": "#/components/schemas/OrchestrationNameString"
        },
        {
          "description": "The origin of the request. "
        }
      ]
    }
  },
  "required": [
    "Id",
    "Role",
    "Command"
  ]
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/glue-create-session-request-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.