Class: Google::Apis::ComputeAlpha::Operation
- Inherits:
-
Object
- Object
- Google::Apis::ComputeAlpha::Operation
- Includes:
- Google::Apis::Core::Hashable, Google::Apis::Core::JsonObjectSupport
- Defined in:
- lib/google/apis/compute_alpha/classes.rb,
lib/google/apis/compute_alpha/representations.rb,
lib/google/apis/compute_alpha/representations.rb
Overview
Represents an Operation resource. Google Compute Engine has three Operation resources:
- Global * Regional * Zonal You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses. Operations can be global, regional or zonal.
- For global operations, use the
globalOperationsresource. - For regional operations, use the
regionOperationsresource. - For zonal operations, use the
zonalOperationsresource. For more information, read Global, Regional, and Zonal Resources. (== resource_for$api_version.globalOperations ==) (== resource_for$ api_version.regionOperations ==) (== resource_for$api_version. zoneOperations ==)
Defined Under Namespace
Instance Attribute Summary collapse
-
#client_operation_id ⇒ String
[Output Only] The value of
requestIdif you provided it in the request. -
#creation_timestamp ⇒ String
[Deprecated] This field is deprecated.
-
#description ⇒ String
[Output Only] A textual description of the operation, which is set when the operation is created.
-
#end_time ⇒ String
[Output Only] The time that this operation was completed.
-
#error ⇒ Google::Apis::ComputeAlpha::Operation::Error
[Output Only] If errors are generated during processing of the operation, this field will be populated.
-
#http_error_message ⇒ String
[Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as
NOT FOUND. -
#http_error_status_code ⇒ Fixnum
[Output Only] If the operation fails, this field contains the HTTP error status code that was returned.
-
#id ⇒ Fixnum
[Output Only] The unique identifier for the operation.
-
#insert_time ⇒ String
[Output Only] The time that this operation was requested.
-
#kind ⇒ String
[Output Only] Type of the resource.
-
#metadata ⇒ Google::Apis::ComputeAlpha::Any
Anycontains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. -
#name ⇒ String
[Output Only] Name of the operation.
-
#operation_type ⇒ String
[Output Only] The type of operation, such as
insert,update, ordelete, and so on. -
#progress ⇒ Fixnum
[Output Only] An optional progress indicator that ranges from 0 to 100.
-
#region ⇒ String
[Output Only] The URL of the region where the operation resides.
-
#self_link ⇒ String
[Output Only] Server-defined URL for the resource.
-
#self_link_with_id ⇒ String
[Output Only] Server-defined URL for this resource with the resource id.
-
#start_time ⇒ String
[Output Only] The time that this operation was started by the server.
-
#status ⇒ String
[Output Only] The status of the operation, which can be one of the following:
PENDING,RUNNING, orDONE. -
#status_message ⇒ String
[Output Only] An optional textual description of the current status of the operation.
-
#target_id ⇒ Fixnum
[Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
-
#target_link ⇒ String
[Output Only] The URL of the resource that the operation modifies.
-
#user ⇒ String
[Output Only] User who requested the operation, for example:
user@example.com. -
#warnings ⇒ Array<Google::Apis::ComputeAlpha::Operation::Warning>
[Output Only] If warning messages are generated during processing of the operation, this field will be populated.
-
#zone ⇒ String
[Output Only] The URL of the zone where the operation resides.
Instance Method Summary collapse
-
#initialize(**args) ⇒ Operation
constructor
A new instance of Operation.
-
#update!(**args) ⇒ Object
Update properties of this object.
Constructor Details
#initialize(**args) ⇒ Operation
Returns a new instance of Operation.
25705 25706 25707 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25705 def initialize(**args) update!(**args) end |
Instance Attribute Details
#client_operation_id ⇒ String
[Output Only] The value of requestId if you provided it in the request. Not
present otherwise.
Corresponds to the JSON property clientOperationId
25530 25531 25532 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25530 def client_operation_id @client_operation_id end |
#creation_timestamp ⇒ String
[Deprecated] This field is deprecated.
Corresponds to the JSON property creationTimestamp
25535 25536 25537 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25535 def @creation_timestamp end |
#description ⇒ String
[Output Only] A textual description of the operation, which is set when the
operation is created.
Corresponds to the JSON property description
25541 25542 25543 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25541 def description @description end |
#end_time ⇒ String
[Output Only] The time that this operation was completed. This value is in
RFC3339 text format.
Corresponds to the JSON property endTime
25547 25548 25549 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25547 def end_time @end_time end |
#error ⇒ Google::Apis::ComputeAlpha::Operation::Error
[Output Only] If errors are generated during processing of the operation, this
field will be populated.
Corresponds to the JSON property error
25553 25554 25555 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25553 def error @error end |
#http_error_message ⇒ String
[Output Only] If the operation fails, this field contains the HTTP error
message that was returned, such as NOT FOUND.
Corresponds to the JSON property httpErrorMessage
25559 25560 25561 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25559 def @http_error_message end |
#http_error_status_code ⇒ Fixnum
[Output Only] If the operation fails, this field contains the HTTP error
status code that was returned. For example, a 404 means the resource was not
found.
Corresponds to the JSON property httpErrorStatusCode
25566 25567 25568 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25566 def http_error_status_code @http_error_status_code end |
#id ⇒ Fixnum
[Output Only] The unique identifier for the operation. This identifier is
defined by the server.
Corresponds to the JSON property id
25572 25573 25574 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25572 def id @id end |
#insert_time ⇒ String
[Output Only] The time that this operation was requested. This value is in
RFC3339 text format.
Corresponds to the JSON property insertTime
25578 25579 25580 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25578 def insert_time @insert_time end |
#kind ⇒ String
[Output Only] Type of the resource. Always compute#operation for Operation
resources.
Corresponds to the JSON property kind
25584 25585 25586 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25584 def kind @kind end |
#metadata ⇒ Google::Apis::ComputeAlpha::Any
Any contains an arbitrary serialized protocol buffer message along with a
URL that describes the type of the serialized message.
Protobuf library provides support to pack/unpack Any values in the form of
utility functions or additional generated methods of the Any type.
Example 1: Pack and unpack a message in C++.
Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) ...
Example 2: Pack and unpack a message in Java.
Foo foo = ...; Any any = Any.pack(foo); ... if (any.is(Foo.class)) foo = any.
unpack(Foo.class);
Example 3: Pack and unpack a message in Python.
foo = Foo(...) any = Any() any.Pack(foo) ... if any.Is(Foo.DESCRIPTOR): any.
Unpack(foo) ...
Example 4: Pack and unpack a message in Go
foo := &pb.Foo... any, err := anypb.New(foo) if err != nil ... ... foo :=
&pb.Foo`if err := any.UnmarshalTo(foo); err != nil ...
The pack methods provided by protobuf library will by default use 'type.
googleapis.com/full.type.name' as the type URL and the unpack methods only use
the fully qualified type name after the last '/' in the type URL, for example "
foo.bar.com/x/y.z" will yield type name "y.z".
JSON ==== The JSON representation of anAnyvalue uses the regular
representation of the deserialized, embedded message, with an additional field
@typewhich contains the type URL. Example:
package google.profile; message Person string first_name = 1; string
last_name = 2;
"@type": "type.googleapis.com/google.profile.Person", "firstName": , "
lastName":
If the embedded message type is well-known and has a custom JSON
representation, that representation will be embedded adding a fieldvalue
which holds the custom JSON in addition to the@typefield. Example (for
message [google.protobuf.Duration][]):
"@type": "type.googleapis.com/google.protobuf.Duration", "value": "1.212s"
Corresponds to the JSON propertymetadata`
25619 25620 25621 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25619 def @metadata end |
#name ⇒ String
[Output Only] Name of the operation.
Corresponds to the JSON property name
25624 25625 25626 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25624 def name @name end |
#operation_type ⇒ String
[Output Only] The type of operation, such as insert, update, or delete,
and so on.
Corresponds to the JSON property operationType
25630 25631 25632 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25630 def operation_type @operation_type end |
#progress ⇒ Fixnum
[Output Only] An optional progress indicator that ranges from 0 to 100. There
is no requirement that this be linear or support any granularity of operations.
This should not be used to guess when the operation will be complete. This
number should monotonically increase as the operation progresses.
Corresponds to the JSON property progress
25638 25639 25640 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25638 def progress @progress end |
#region ⇒ String
[Output Only] The URL of the region where the operation resides. Only
applicable when performing regional operations.
Corresponds to the JSON property region
25644 25645 25646 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25644 def region @region end |
#self_link ⇒ String
[Output Only] Server-defined URL for the resource.
Corresponds to the JSON property selfLink
25649 25650 25651 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25649 def self_link @self_link end |
#self_link_with_id ⇒ String
[Output Only] Server-defined URL for this resource with the resource id.
Corresponds to the JSON property selfLinkWithId
25654 25655 25656 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25654 def self_link_with_id @self_link_with_id end |
#start_time ⇒ String
[Output Only] The time that this operation was started by the server. This
value is in RFC3339 text format.
Corresponds to the JSON property startTime
25660 25661 25662 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25660 def start_time @start_time end |
#status ⇒ String
[Output Only] The status of the operation, which can be one of the following:
PENDING, RUNNING, or DONE.
Corresponds to the JSON property status
25666 25667 25668 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25666 def status @status end |
#status_message ⇒ String
[Output Only] An optional textual description of the current status of the
operation.
Corresponds to the JSON property statusMessage
25672 25673 25674 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25672 def @status_message end |
#target_id ⇒ Fixnum
[Output Only] The unique target ID, which identifies a specific incarnation of
the target resource.
Corresponds to the JSON property targetId
25678 25679 25680 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25678 def target_id @target_id end |
#target_link ⇒ String
[Output Only] The URL of the resource that the operation modifies. For
operations related to creating a snapshot, this points to the persistent disk
that the snapshot was created from.
Corresponds to the JSON property targetLink
25685 25686 25687 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25685 def target_link @target_link end |
#user ⇒ String
[Output Only] User who requested the operation, for example: user@example.com
.
Corresponds to the JSON property user
25691 25692 25693 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25691 def user @user end |
#warnings ⇒ Array<Google::Apis::ComputeAlpha::Operation::Warning>
[Output Only] If warning messages are generated during processing of the
operation, this field will be populated.
Corresponds to the JSON property warnings
25697 25698 25699 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25697 def warnings @warnings end |
#zone ⇒ String
[Output Only] The URL of the zone where the operation resides. Only applicable
when performing per-zone operations.
Corresponds to the JSON property zone
25703 25704 25705 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25703 def zone @zone end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
25710 25711 25712 25713 25714 25715 25716 25717 25718 25719 25720 25721 25722 25723 25724 25725 25726 25727 25728 25729 25730 25731 25732 25733 25734 25735 25736 |
# File 'lib/google/apis/compute_alpha/classes.rb', line 25710 def update!(**args) @client_operation_id = args[:client_operation_id] if args.key?(:client_operation_id) @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp) @description = args[:description] if args.key?(:description) @end_time = args[:end_time] if args.key?(:end_time) @error = args[:error] if args.key?(:error) @http_error_message = args[:http_error_message] if args.key?(:http_error_message) @http_error_status_code = args[:http_error_status_code] if args.key?(:http_error_status_code) @id = args[:id] if args.key?(:id) @insert_time = args[:insert_time] if args.key?(:insert_time) @kind = args[:kind] if args.key?(:kind) @metadata = args[:metadata] if args.key?(:metadata) @name = args[:name] if args.key?(:name) @operation_type = args[:operation_type] if args.key?(:operation_type) @progress = args[:progress] if args.key?(:progress) @region = args[:region] if args.key?(:region) @self_link = args[:self_link] if args.key?(:self_link) @self_link_with_id = args[:self_link_with_id] if args.key?(:self_link_with_id) @start_time = args[:start_time] if args.key?(:start_time) @status = args[:status] if args.key?(:status) @status_message = args[:status_message] if args.key?(:status_message) @target_id = args[:target_id] if args.key?(:target_id) @target_link = args[:target_link] if args.key?(:target_link) @user = args[:user] if args.key?(:user) @warnings = args[:warnings] if args.key?(:warnings) @zone = args[:zone] if args.key?(:zone) end |