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 \ LongRunningMethods
__construct
Constructor.
Parameters | |
---|---|
Name | Description |
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 |
↳ 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 |
↳ 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 |
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 | |
---|---|
Type | Description |
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 | |
---|---|
Name | Description |
var |
string
|
Returns | |
---|---|
Type | Description |
$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 | |
---|---|
Type | Description |
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 | |
---|---|
Name | Description |
var |
Google\Protobuf\Any
|
Returns | |
---|---|
Type | Description |
$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 | |
---|---|
Type | Description |
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 | |
---|---|
Name | Description |
var |
bool
|
Returns | |
---|---|
Type | Description |
$this |
getError
The error result of the operation in case of failure or cancellation.
Returns | |
---|---|
Type | Description |
Google\Rpc\Status|null |
hasError
setError
The error result of the operation in case of failure or cancellation.
Parameter | |
---|---|
Name | Description |
var |
Google\Rpc\Status
|
Returns | |
---|---|
Type | Description |
$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 | |
---|---|
Type | Description |
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 | |
---|---|
Name | Description |
var |
Google\Protobuf\Any
|
Returns | |
---|---|
Type | Description |
$this |
getResult
Returns | |
---|---|
Type | Description |
string |