Load Testing API, gRPC: AgentService.Update
Updates the specified agent.
gRPC request
rpc Update (UpdateAgentRequest) returns (operation.Operation)
UpdateAgentRequest
{
"agentId": "string",
"updateMask": "google.protobuf.FieldMask",
"name": "string",
"description": "string",
"computeInstanceParams": {
"labels": "string",
"zoneId": "string",
"resourcesSpec": {
"memory": "int64",
"cores": "int64",
"coreFraction": "int64",
"gpus": "int64"
},
"metadata": "string",
"bootDiskSpec": {
"mode": "Mode",
"deviceName": "string",
"autoDelete": "bool",
// Includes only one of the fields `diskSpec`, `diskId`
"diskSpec": {
"name": "string",
"description": "string",
"typeId": "string",
"size": "int64",
// Includes only one of the fields `imageId`, `snapshotId`
"imageId": "string",
"snapshotId": "string",
// end of the list of possible fields
"diskPlacementPolicy": {
"placementGroupId": "string",
"placementGroupPartition": "int64"
},
"blockSize": "int64",
"kmsKeyId": "string"
},
"diskId": "string"
// end of the list of possible fields
},
"networkInterfaceSpecs": [
{
"subnetId": "string",
"primaryV4AddressSpec": {
"address": "string",
"oneToOneNatSpec": {
"ipVersion": "IpVersion",
"address": "string",
"dnsRecordSpecs": [
{
"fqdn": "string",
"dnsZoneId": "string",
"ttl": "int64",
"ptr": "bool"
}
]
},
"dnsRecordSpecs": [
{
"fqdn": "string",
"dnsZoneId": "string",
"ttl": "int64",
"ptr": "bool"
}
]
},
"primaryV6AddressSpec": {
"address": "string",
"oneToOneNatSpec": {
"ipVersion": "IpVersion",
"address": "string",
"dnsRecordSpecs": [
{
"fqdn": "string",
"dnsZoneId": "string",
"ttl": "int64",
"ptr": "bool"
}
]
},
"dnsRecordSpecs": [
{
"fqdn": "string",
"dnsZoneId": "string",
"ttl": "int64",
"ptr": "bool"
}
]
},
"securityGroupIds": [
"string"
],
"index": "string"
}
],
"serviceAccountId": "string",
"platformId": "string"
},
"labels": "string"
}
Field |
Description |
agentId |
string Required field. ID of the agent to update. |
updateMask |
Required field. Field mask that specifies which attributes of the agent are going to be updated. |
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 |
int64 Required field. The amount of memory available to the instance, specified in bytes. |
cores |
int64 Required field. The number of cores available to the instance. |
coreFraction |
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 |
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 |
bool 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 |
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 |
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 |
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 |
int64 DNS record ttl, values in 0-86400 (optional) |
ptr |
bool When set to true, also create PTR DNS record (optional) |
operation.Operation
{
"id": "string",
"description": "string",
"createdAt": "google.protobuf.Timestamp",
"createdBy": "string",
"modifiedAt": "google.protobuf.Timestamp",
"done": "bool",
"metadata": {
"agentId": "string"
},
// Includes only one of the fields `error`, `response`
"error": "google.rpc.Status",
"response": {
"id": "string",
"folderId": "string",
"name": "string",
"description": "string",
"computeInstanceId": "string",
"status": "Status",
"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 |
Creation timestamp. |
createdBy |
string ID of the user or service account who initiated the operation. |
modifiedAt |
The time when the Operation resource was last modified. |
done |
bool 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. |
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 |