Google LongRunning Client - Class Operation (0.3.0)

Reference documentation and code samples for the Google LongRunning Client class Operation.

This resource represents a long-running operation that is the result of a network API call.

Generated from protobuf message google.longrunning.Operation

Namespace

Google \ LongRunning

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ name string

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}.

↳ metadata Google\Protobuf\Any

Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.

↳ 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.

↳ error Google\Rpc\Status

The error result of the operation in case of failure or cancellation.

↳ response Google\Protobuf\Any

The 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 standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.

getName

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}.

Returns
TypeDescription
string

setName

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getMetadata

Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time.

Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.

Returns
TypeDescription
Google\Protobuf\Any|null

hasMetadata

clearMetadata

setMetadata

Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time.

Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.

Parameter
NameDescription
var Google\Protobuf\Any
Returns
TypeDescription
$this

getDone

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.

Returns
TypeDescription
bool

setDone

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.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getError

The error result of the operation in case of failure or cancellation.

Returns
TypeDescription
Google\Rpc\Status|null

hasError

setError

The error result of the operation in case of failure or cancellation.

Parameter
NameDescription
var Google\Rpc\Status
Returns
TypeDescription
$this

getResponse

The 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 standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.

Returns
TypeDescription
Google\Protobuf\Any|null

hasResponse

setResponse

The 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 standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.

Parameter
NameDescription
var Google\Protobuf\Any
Returns
TypeDescription
$this

getResult

Returns
TypeDescription
string