Update
Updates the specified image.
- TypeScript
- Python
import {
cloudApi,
decodeMessage,
serviceClients,
Session,
waitForOperation,
} from "@yandex-cloud/nodejs-sdk";
const Image = cloudApi.compute.image.Image;
const UpdateImageRequest = cloudApi.compute.image_service.UpdateImageRequest;
(async () => {
const authToken = process.env["YC_OAUTH_TOKEN"];
const session = new Session({ oauthToken: authToken });
const client = session.client(serviceClients.ImageServiceClient);
const operation = await client.update(
UpdateImageRequest.fromPartial({
imageId: "imageId",
// updateMask: {
// paths: ["paths"]
// },
// name: "name",
// description: "description",
// minDiskSize: 0,
// labels: {"key": "labels"}
})
);
const finishedOp = await waitForOperation(operation, session);
if (finishedOp.response) {
const result = decodeMessage<typeof Image>(finishedOp.response);
console.log(result);
}
})();
import os
import grpc
import yandexcloud
from yandex.cloud.compute.v1.image_pb2 import Image
from yandex.cloud.compute.v1.image_service_pb2_grpc import ImageServiceStub
from yandex.cloud.compute.v1.image_service_pb2 import UpdateImageMetadata
from yandex.cloud.compute.v1.image_service_pb2 import UpdateImageRequest
token = os.getenv("YC_OAUTH_TOKEN")
sdk = yandexcloud.SDK(token=token)
service = sdk.client(ImageServiceStub)
operation = service.Update(
UpdateImageRequest(
image_id="imageId",
# update_mask = FieldMask.FromJsonString("field1,field2"),
# name = "name",
# description = "description",
# min_disk_size = 0,
# labels = {"key": "labels"}
)
)
operation_result = sdk.wait_operation_and_get_result(
operation,
response_type=Image,
meta_type=UpdateImageMetadata,
)
print(operation_result)
UpdateImageRequest
imageId
: string
ID of the Image resource to update. To get the image ID, use a ImageService.List request.
updateMask
: google.protobuf.FieldMask
Field mask that specifies which fields of the Image resource are going to be updated.
name
: string
Name of the image.
description
: string
Description of the image.
minDiskSize
: int64
Minimum size of the disk that can be created from this image. Specified in bytes. Should be more than the volume of source data and more than the virtual disk size.
labels
: string
Resource labels as key:value
pairs.
Existing set of labels
is completely replaced by the provided set.
Operation
An Operation resource. For more information, see Operation.
id
: string
ID of the operation.
description
: string
Description of the operation. 0-256 characters long.
createdAt
: google.protobuf.Timestamp
Creation timestamp.
createdBy
: string
ID of the user or service account who initiated the operation.
modifiedAt
: google.protobuf.Timestamp
The time when the Operation resource was last modified.
done
: bool
If the value is false
, it means the operation is still in progress.
If true
, the operation is completed, and either error
or response
is available.
metadata
: google.protobuf.Any
Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
One of result
The operation result.
If done == false
and there was no failure detected, neither error
nor response
is set.
If done == false
and there was a failure detected, error
is set.
If done == true
, exactly one of error
or response
is set.
error
: google.rpc.StatusThe error result of the operation in case of failure or cancellation.
response
: google.protobuf.AnyThe normal response of the operation in case of success.
If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any.