Uma operação rastreia o status de todas as solicitações que modificam os dados e retorna para cada solicitação que altera quaisquer recursos.
Para ver uma lista dos métodos desse recurso, consulte o final desta página.
Representações de recursos
Um recurso de operação usado para gerenciar solicitações de API assíncronas.
{ "kind": "deploymentmanager#operation", "id":unsigned long , "creationTimestamp":string , "name":string , "zone":string , "clientOperationId":string , "operationType":string , "targetLink":string , "targetId":unsigned long , "status":string , "statusMessage":string , "user":string , "progress":integer , "insertTime":string , "startTime":string , "endTime":string , "error": { "errors": [ { "code":string , "location":string , "message":string } ] }, "warnings": [ { "code":string , "message":string , "data": [ { "key":string , "value":string } ] } ], "httpErrorStatusCode":integer , "httpErrorMessage":string , "selfLink":string , "region":string , "description":string }
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
clientOperationId |
string |
[Somente saída] O valor de "requestId", se você o forneceu na solicitação. Caso contrário, não está presente. | |
creationTimestamp |
string |
[Descontinuado] Este campo foi descontinuado. | |
description |
string |
[Somente saída] Uma descrição textual da operação, configurada quando a operação foi criada. | |
endTime |
string |
[Somente saída] Hora em que a operação foi concluída. Esse valor está no formato de texto RFC3339. | |
error |
object |
[Somente saída] Se forem gerados erros durante o processamento da operação, este campo será preenchido. | |
error.errors[] |
list |
[Somente saída] A matriz de erros encontrados durante o processamento dessa operação. | |
error.errors[].code |
string |
[Somente saída] O código do tipo desse erro. | |
error.errors[].location |
string |
[Somente saída] Indica o campo na solicitação que causou o erro. Esta propriedade é opcional. | |
error.errors[].message |
string |
[Somente saída] Uma mensagem de erro opcional, legível. | |
httpErrorMessage |
string |
[Somente saída] Se a operação falhar, esse campo vai conter a mensagem de erro HTTP que foi retornada, como NOT FOUND . |
|
httpErrorStatusCode |
integer |
[Somente saída] Se a operação falhar, este campo conterá o código de status de erro HTTP retornado. Por exemplo, um 404 significa que o recurso não foi encontrado. |
|
id |
unsigned long |
[Somente saída] Código único do recurso. Definido pelo servidor. | |
insertTime |
string |
[Somente saída] Hora em que a operação foi solicitada. Esse valor está no formato de texto RFC3339. | |
kind |
string |
[Somente saída] Tipo do recurso. Sempre compute#operation para recursos de operação. |
|
name |
string |
[Somente saída] Nome do recurso. | |
operationType |
string |
[Somente saída] O tipo de operação, como insert , update ou delete e assim por diante. |
|
progress |
integer |
[Somente saída] Um indicador de progresso opcional que varia de 0 a 100. Não há nenhuma exigência de que seja linear nem tenha compatibilidade com qualquer granularidade de operações. Não use este indicador para adivinhar quando a operação será concluída. O número precisa aumentar uniformemente à medida que a operação progride. | |
region |
string |
[Somente saída] URL da região onde reside a operação. Somente disponível na execução de operações regionais. É necessário especificar esse campo como parte do URL da solicitação HTTP. Ele não pode ser definido como um campo no corpo da solicitação. | |
selfLink |
string |
[Somente saída] URL definido pelo servidor para o recurso. | |
startTime |
string |
[Somente saída] Hora em que a operação foi iniciada pelo servidor. Esse valor está no formato de texto RFC3339. | |
status |
string |
[Somente saída] Status da operação, que pode ser um dos seguintes: PENDING , RUNNING ou DONE . |
|
statusMessage |
string |
[Somente saída] Uma descrição textual opcional do status atual da operação. | |
targetId |
unsigned long |
[Somente saída] Código único de destino, que identifica uma concretização específica do recurso de destino. | |
targetLink |
string |
[Somente saída] URL do recurso modificado pela operação. Em operações relacionadas à criação de um instantâneo, isso aponta para o disco permanente do qual o instantâneo foi criado. | |
user |
string |
[Somente saída] Usuário que solicitou a operação, por exemplo: user@example.com . |
|
warnings[] |
list |
[Somente saída] Se forem geradas mensagens de aviso durante o processamento da operação, este campo será preenchido. | |
warnings[].code |
string |
[Somente saída] Um código de aviso, se aplicável. Por exemplo, o código NO_RESULTS_ON_PAGE é retornado no Compute Engine quando não há resultados na resposta. |
|
warnings[].data[] |
list |
[Somente saída] Metadados sobre esse aviso no formato key: value . Exemplo: "data": [ { "key": "scope", "value": "zones/us-east1-d" } |
|
warnings[].data[].key |
string |
[Somente saída] Uma chave que fornece mais detalhes sobre o aviso retornado. Por exemplo, para avisos em que não há resultados em uma solicitação de lista para uma zona específica, essa chave pode ser scope e o valor da chave pode ser o nome da zona. Outros exemplos podem ser uma chave indicando um recurso com uso suspenso e uma substituição sugerida, ou um aviso sobre configurações de rede inválidas. Por exemplo, se uma instância tenta executar o encaminhamento de IP, mas não é ativada pelo encaminhamento. |
|
warnings[].data[].value |
string |
[Somente saída] Um valor de dados do aviso correspondente à chave. | |
warnings[].message |
string |
[Somente saída] Uma descrição legível do código de advertência. | |
zone |
string |
[Somente saída] URL da zona onde reside a operação. Só disponível durante a execução de operações por zona. É necessário especificar esse campo como parte do URL da solicitação HTTP. Ele não pode ser definido como um campo no corpo da solicitação. |