Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Load Testing
  • Getting started
  • Access management
  • Pricing policy
  • Terraform reference
    • API authentication
      • Overview
        • Overview
        • Create
        • Get
        • List
        • Delete
        • Update
  • Audit Trails events
  • Release notes

In this article:

  • HTTP request
  • Path parameters
  • Response
  • LogSettings
  1. API reference
  2. REST
  3. Agent
  4. Get

Load Testing API, REST: Agent.Get

Written by
Yandex Cloud
Updated at August 8, 2025
  • HTTP request
  • Path parameters
  • Response
  • LogSettings

Returns the specified agent.

To get the list of all available agents, make a List request.

HTTP requestHTTP request

GET https://loadtesting.api.cloud.yandex.net/loadtesting/api/v1/agent/{agentId}

Path parametersPath parameters

Field

Description

agentId

string

Required field. ID of the agent to return.

ResponseResponse

HTTP Code: 200 - OK

{
  "id": "string",
  "folderId": "string",
  "name": "string",
  "description": "string",
  "computeInstanceId": "string",
  "status": "string",
  "errors": [
    "string"
  ],
  "currentJobId": "string",
  "agentVersionId": "string",
  "labels": "object",
  "logSettings": {
    "cloudLogGroupId": "string"
  }
}

Load testing agent on which tests are executed.

Field

Description

id

string

ID of the agent. Generated at creation time.

folderId

string

ID of the folder that the agent belongs to.

name

string

Name of the agent.

description

string

Description of the agent.

computeInstanceId

string

ID of the compute instance managed by the agent.

Empty if there is no such instance (i.e. the case of external agent).

status

enum (Status)

Status of the agent.

  • STATUS_UNSPECIFIED: Status is not specified.
  • PREPARING_TEST: Agent is preparing a test to be executed.
  • READY_FOR_TEST: Agent is ready to take a test.
  • TESTING: Agent is executing a test.
  • TANK_FAILED: Agent application encountered an error and cannot operate normally.
  • PROVISIONING: Agent is waiting for resources to be allocated.
  • STOPPING: Agent is being stopped.
  • STOPPED: Agent is stopped.
  • STARTING: Agent is being started.
  • RESTARTING: Agent is being restarted.
  • UPDATING: Agent is being updated.
  • ERROR: Agent encountered an error and cannot operate.
  • CRASHED: Agent is crashed and will be restarted automatically.
  • DELETING: Agent is being deleted.
  • INITIALIZING_CONNECTION: Service is waiting for connection with agent to be established.
  • LOST_CONNECTION_WITH_AGENT: Service has lost connection with agent.
  • UPLOADING_ARTIFACTS: Agent is uploading test artifacts.

errors[]

string

List of errors reported by the agent.

currentJobId

string

ID of the test that is currently being executed by the agent.

agentVersionId

string

Version of the agent.

labels

object (map<string, string>)

Agent labels as key:value pairs.

logSettings

LogSettings

Agent log settings

LogSettingsLogSettings

Field

Description

cloudLogGroupId

string

Id of Yandex Cloud log group to upload agent logs to

Was the article helpful?

Previous
Create
Next
List
© 2025 Direct Cursus Technology L.L.C.