Load Testing API, REST: Agent.Update
Updates the specified agent.
HTTP request
PATCH https://loadtesting.api.cloud.yandex.net/loadtesting/api/v1/agent/{agentId}
Path parameters
Field |
Description |
agentId |
string Required field. ID of the agent to update. |
Body parameters
{
"updateMask": "string",
"name": "string",
"description": "string",
"computeInstanceParams": {
"labels": "string",
"zoneId": "string",
"resourcesSpec": {
"memory": "string",
"cores": "string",
"coreFraction": "string",
"gpus": "string"
},
"metadata": "string",
"bootDiskSpec": {
"mode": "string",
"deviceName": "string",
"autoDelete": "boolean",
// Includes only one of the fields `diskSpec`, `diskId`
"diskSpec": {
"name": "string",
"description": "string",
"typeId": "string",
"size": "string",
// Includes only one of the fields `imageId`, `snapshotId`
"imageId": "string",
"snapshotId": "string",
// end of the list of possible fields
"diskPlacementPolicy": {
"placementGroupId": "string",
"placementGroupPartition": "string"
},
"blockSize": "string",
"kmsKeyId": "string"
},
"diskId": "string"
// end of the list of possible fields
},
"networkInterfaceSpecs": [
{
"subnetId": "string",
"primaryV4AddressSpec": {
"address": "string",
"oneToOneNatSpec": {
"ipVersion": "string",
"address": "string",
"dnsRecordSpecs": [
{
"fqdn": "string",
"dnsZoneId": "string",
"ttl": "string",
"ptr": "boolean"
}
]
},
"dnsRecordSpecs": [
{
"fqdn": "string",
"dnsZoneId": "string",
"ttl": "string",
"ptr": "boolean"
}
]
},
"primaryV6AddressSpec": {
"address": "string",
"oneToOneNatSpec": {
"ipVersion": "string",
"address": "string",
"dnsRecordSpecs": [
{
"fqdn": "string",
"dnsZoneId": "string",
"ttl": "string",
"ptr": "boolean"
}
]
},
"dnsRecordSpecs": [
{
"fqdn": "string",
"dnsZoneId": "string",
"ttl": "string",
"ptr": "boolean"
}
]
},
"securityGroupIds": [
"string"
],
"index": "string"
}
],
"serviceAccountId": "string",
"platformId": "string"
},
"labels": "string"
}
Field |
Description |
updateMask |
string (field-mask) Required field. A comma-separated names off ALL fields to be updated. If |
name |
string New name of the agent. |
description |
string New description of the agent. |
computeInstanceParams |
New parameters of compute instance managed by the agent. |
labels |
string New labels of the agent. |
CreateComputeInstance
Field |
Description |
labels |
string Resource labels as |
zoneId |
string Required field. ID of the availability zone where the instance resides. |
resourcesSpec |
Required field. Computing resources of the instance, such as the amount of memory and number of cores. |
metadata |
string The metadata Values are free-form strings, and only have meaning as interpreted by the programs which configure the instance. For example, you may use the metadata in order to provide your public SSH key to the instance. |
bootDiskSpec |
Required field. Boot disk to attach to the instance. |
networkInterfaceSpecs[] |
Network configuration for the instance. Specifies how the network interface is configured |
serviceAccountId |
string ID of the service account to use for authentication inside the instance. |
platformId |
string ID of the Compute VM platform on which the agent will be created. |
ResourcesSpec
Field |
Description |
memory |
string (int64) Required field. The amount of memory available to the instance, specified in bytes. |
cores |
string (int64) Required field. The number of cores available to the instance. |
coreFraction |
string (int64) Baseline level of CPU performance with the ability to burst performance above that baseline level. For example, if you need only 5% of the CPU performance, you can set core_fraction=5. |
gpus |
string (int64) The number of GPUs available to the instance. |
AttachedDiskSpec
Field |
Description |
mode |
enum (Mode) The mode in which to attach this disk.
|
deviceName |
string Specifies a unique serial number of your choice that is reflected into the /dev/disk/by-id/ tree This value can be used to reference the device for mounting, resizing, and so on, from within the instance. |
autoDelete |
boolean Specifies whether the disk will be auto-deleted when the instance is deleted. |
diskSpec |
Disk specification. Includes only one of the fields |
diskId |
string ID of the disk that should be attached. Includes only one of the fields |
DiskSpec
Field |
Description |
name |
string Name of the disk. |
description |
string Description of the disk. |
typeId |
string ID of the disk type. |
size |
string (int64) Required field. Size of the disk, specified in bytes. |
imageId |
string ID of the image to create the disk from. Includes only one of the fields |
snapshotId |
string ID of the snapshot to restore the disk from. Includes only one of the fields |
diskPlacementPolicy |
Placement policy configuration. |
blockSize |
string (int64) Block size of the disk, specified in bytes. The default is 4096. |
kmsKeyId |
string ID of KMS key for disk encryption |
DiskPlacementPolicy
Field |
Description |
placementGroupId |
string Placement group ID. |
placementGroupPartition |
string (int64) |
NetworkInterfaceSpec
Field |
Description |
subnetId |
string Required field. ID of the subnet. |
primaryV4AddressSpec |
Primary IPv4 address that will be assigned to the instance for this network interface. |
primaryV6AddressSpec |
Primary IPv6 address that will be assigned to the instance for this network interface. IPv6 not available yet. |
securityGroupIds[] |
string ID's of security groups attached to the interface |
index |
string The index of the network interface, will be generated by the server, 0,1,2... etc if not specified. |
PrimaryAddressSpec
Field |
Description |
address |
string An IPv4 internal network address that is assigned to the instance for this network interface. |
oneToOneNatSpec |
An external IP address configuration. |
dnsRecordSpecs[] |
Internal DNS configuration |
OneToOneNatSpec
Field |
Description |
ipVersion |
enum (IpVersion) External IP address version.
|
address |
string set static IP by value |
dnsRecordSpecs[] |
External DNS configuration |
DnsRecordSpec
Field |
Description |
fqdn |
string Required field. FQDN (required) |
dnsZoneId |
string DNS zone id (optional, if not set, private zone used) |
ttl |
string (int64) DNS record ttl, values in 0-86400 (optional) |
ptr |
boolean When set to true, also create PTR DNS record (optional) |
Response
HTTP Code: 200 - OK
{
"id": "string",
"description": "string",
"createdAt": "string",
"createdBy": "string",
"modifiedAt": "string",
"done": "boolean",
"metadata": {
"agentId": "string"
},
// Includes only one of the fields `error`, `response`
"error": {
"code": "integer",
"message": "string",
"details": [
"object"
]
},
"response": {
"id": "string",
"folderId": "string",
"name": "string",
"description": "string",
"computeInstanceId": "string",
"status": "string",
"errors": [
"string"
],
"currentJobId": "string",
"agentVersionId": "string",
"labels": "string",
"logSettings": {
"cloudLogGroupId": "string"
}
}
// end of the list of possible fields
}
An Operation resource. For more information, see Operation.
Field |
Description |
id |
string ID of the operation. |
description |
string Description of the operation. 0-256 characters long. |
createdAt |
string (date-time) Creation timestamp. String in RFC3339 To work with values in this field, use the APIs described in the |
createdBy |
string ID of the user or service account who initiated the operation. |
modifiedAt |
string (date-time) The time when the Operation resource was last modified. String in RFC3339 To work with values in this field, use the APIs described in the |
done |
boolean If the value is |
metadata |
Service-specific metadata associated with the operation. |
error |
The error result of the operation in case of failure or cancellation. Includes only one of the fields The operation result. |
response |
The normal response of the operation in case of success. Includes only one of the fields The operation result. |
UpdateAgentMetadata
Field |
Description |
agentId |
string ID of the agent that is being updated. |
Status
The error result of the operation in case of failure or cancellation.
Field |
Description |
code |
integer (int32) Error code. An enum value of google.rpc.Code |
message |
string An error message. |
details[] |
object A list of messages that carry the error details. |
Agent
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.
|
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 |
string Agent labels as |
logSettings |
Agent log settings |
LogSettings
Field |
Description |
cloudLogGroupId |
string Id of Yandex Cloud log group to upload agent logs to |