REST Resource: projects.locations.unitOperations

Risorsa: UnitOperation

UnitOperation incapsula l'intento di modificare/interagire con il componente del servizio rappresentato dall'unità specifica. È possibile creare (richiedere) e pianificare più UnitOperation in futuro, ma ne verrà eseguita solo una alla volta (questa limitazione potrebbe cambiare in futuro per le operazioni non mutanti).

UnitOperations consente a diversi attori che interagiscono con la stessa unità di concentrarsi solo sulla modifica che hanno richiesto.

Si tratta di un oggetto di base che contiene i campi comuni in tutte le operazioni unitarie. Prossimamente: 22

Rappresentazione JSON 
{
  "name": string,
  "unit": string,
  "parentUnitOperation": string,
  "rollout": string,
  "cancel": boolean,
  "state": enum (UnitOperationState),
  "conditions": [
    {
      object (UnitOperationCondition)
    }
  ],
  "schedule": {
    object (Schedule)
  },
  "engineState": string,
  "errorCategory": enum (UnitOperationErrorCategory),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,

  // Union field unit_operation_type can be only one of the following:
  "provision": {
    object (Provision)
  },
  "upgrade": {
    object (Upgrade)
  },
  "deprovision": {
    object (Deprovision)
  }
  // End of list of possible types for union field unit_operation_type.
}
Campi
name

string

Identificatore. Il nome della risorsa (URI completo della risorsa) che segue lo schema di denominazione standard:

"projects/{project}/locations/{location}/unitOperations/{unitOperation}"
unit

string

Obbligatorio. Immutabile. L'unità su cui agirà una determinata operazione unità.
parentUnitOperation

string

Facoltativo. Riferimento alla risorsa padre: UnitOperation. Se un'operazione deve creare altre operazioni nell'ambito del suo flusso di lavoro, ogni operazione secondaria deve avere questo campo impostato sull'operazione principale. Questi dati possono essere utilizzati per il tracciamento. (Facoltativo)
rollout

string

Facoltativo. Specifica quale implementazione ha creato questa operazione unità. Non può essere modificato e viene utilizzato solo per scopi di filtraggio. Se un'operazione unità e un'unità dipendente vengono create nell'ambito di un'altra operazione unità, utilizzeranno lo stesso rolloutId.
cancel

boolean

Facoltativo. Se è true, tenta di annullare l'operazione. L'annullamento potrebbe non riuscire se l'operazione è già in esecuzione. (Facoltativo)
state

enum (UnitOperationState)

Facoltativo. Solo output. UnitOperationState descrive lo stato attuale dell'operazione dell'unità.
conditions[]

object (UnitOperationCondition)

Facoltativo. Solo output. Un insieme di condizioni che indicano le varie condizioni che questa risorsa può avere.
schedule

object (Schedule)

Facoltativo. Quando pianificare questa operazione.
engineState

string

Facoltativo. Solo output. Lo stato del motore per le operazioni del motore di deployment in corso. Questo campo è opaco per l'utilizzo esterno.
errorCategory

enum (UnitOperationErrorCategory)

Facoltativo. Solo output. UnitOperationErrorCategory descrive la categoria di errore.
labels

map (key: string, value: string)

Facoltativo. Le etichette sulla risorsa, che possono essere utilizzate per la categorizzazione, simili alle etichette delle risorse Kubernetes.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Facoltativo. Le annotazioni sono una mappa chiave-valore non strutturata archiviata con una risorsa che può essere impostata da strumenti esterni per archiviare e recuperare metadati arbitrari. Non sono interrogabili e devono essere conservati durante la modifica degli oggetti.

Scopri di più: https://kubernetes.io/docs/user-guide/annotations

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Solo output. Identificatore unico della risorsa. L'UID è unico nello spazio e nel tempo per questa risorsa nell'ambito del servizio. Viene tipicamente generato dal server durante la creazione di una risorsa e non deve essere modificato. L'UID viene utilizzato per identificare in modo unico le risorse quando i nomi risorsa vengono riutilizzati. Deve essere un UUID4.
etag

string

Solo output. Valore opaco che identifica in modo unico una versione o generazione di una risorsa. Può essere usato per confermare che client e server concordano nell'ordine di una risorsa in fase di scrittura.
createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento della risorsa. Qualsiasi modifica apportata alla risorsa dagli utenti deve aggiornare questo valore. Le modifiche a una risorsa apportate dal servizio devono aggiornare questo valore.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

Solo output. Il timestamp in cui la risorsa è stata contrassegnata per l'eliminazione (l'eliminazione è un'operazione asincrona).

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Campo unione unit_operation_type.

unit_operation_type può essere solo uno dei seguenti tipi:
provision

object (Provision)
upgrade

object (Upgrade)
deprovision

object (Deprovision)

Provisioning

Provision è l'operazione unità che esegue il provisioning delle risorse sottostanti rappresentate da un'unità. Può essere eseguito solo se l'unità non è attualmente sottoposta a provisioning.

Rappresentazione JSON 
{
  "release": string,
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ]
}
Campi
release

string

Facoltativo. Riferimento all'oggetto Release da utilizzare per l'unità. (facoltativo).
inputVariables[]

object (UnitVariable)

Facoltativo. Set di variabili di input. Massimo 100. (facoltativo)

Esegui l'upgrade

L'upgrade è l'operazione unità che esegue l'upgrade di un'unità di cui è stato eseguito il provisioning, che può includere anche le risorse sottostanti rappresentate da un'unità. Può essere eseguito solo se l'unità è attualmente sottoposta a provisioning.

Rappresentazione JSON 
{
  "release": string,
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ]
}
Campi
release

string

Facoltativo. Riferimento all'oggetto Release da utilizzare per l'unità. (facoltativo).
inputVariables[]

object (UnitVariable)

Facoltativo. Set di variabili di input. Massimo 100. (facoltativo)

Esegui deprovisioning

Questo tipo non contiene campi.

Il deprovisioning è l'operazione unità che esegue il deprovisioning delle risorse sottostanti rappresentate da un'unità. Può essere eseguito solo se l'unità è attualmente sottoposta a provisioning.

UnitOperationState

UnitOperationState descrive lo stato attuale dell'operazione dell'unità.

Enum
UNIT_OPERATION_STATE_UNKNOWN
UNIT_OPERATION_STATE_PENDING L'operazione sull'unità è accettata, ma non è pronta per l'esecuzione.
UNIT_OPERATION_STATE_SCHEDULED L'operazione unità è accettata e pianificata.
UNIT_OPERATION_STATE_RUNNING L'operazione unità è in esecuzione.
UNIT_OPERATION_STATE_SUCCEEDED L'operazione sull'unità è stata completata correttamente.
UNIT_OPERATION_STATE_FAILED L'operazione sull'unità non è riuscita.
UNIT_OPERATION_STATE_CANCELLED L'operazione sull'unità è stata annullata.

UnitOperationCondition

UnitOperationCondition descrive lo stato di un'operazione unità. UnitOperationCondition sono singoli componenti che contribuiscono a uno stato generale.

Rappresentazione JSON 
{
  "status": enum (Status),
  "type": enum (Type),
  "lastTransitionTime": string,
  "message": string,
  "reason": string
}
Campi
status

enum (Status)

Obbligatorio. Stato della condizione.
type

enum (Type)

Obbligatorio. Il tipo di condizione.
lastTransitionTime

string (Timestamp format)

Obbligatorio. L'ultima volta che la condizione è passata da uno stato all'altro.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
message

string

Obbligatorio. Messaggio leggibile che indica i dettagli dell'ultima transizione.
reason

string

Obbligatorio. Breve motivo dell'ultima transizione della condizione.

Stato

Enumerazione degli stati delle condizioni.

Enum
STATUS_UNSPECIFIED Lo stato della condizione non è specificato.
STATUS_UNKNOWN Condizione sconosciuta.
STATUS_TRUE La condizione è vera.
STATUS_FALSE La condizione è false.

Tipo

Enumerazione dei tipi di condizioni.

Enum
TYPE_UNSPECIFIED Il tipo di condizione non è specificato.
TYPE_SCHEDULED Il tipo di condizione è programmato.
TYPE_RUNNING Il tipo di condizione è in esecuzione.
TYPE_SUCCEEDED Il tipo di condizione è riuscito.
TYPE_CANCELLED Il tipo di condizione è stato annullato.
TYPE_APP_CREATED Indica se è stata creata l'app AppHub.
TYPE_APP_COMPONENTS_REGISTERED Indica se i servizi e i workload sono stati registrati in App Hub.

Pianifica

Una specifica dell'ora per pianificare la manutenzione.

Rappresentazione JSON 
{
  "startTime": string
}
Campi
startTime

string (Timestamp format)

Facoltativo. Inizio dell'operazione. Se non viene impostato, verrà impostato all'inizio della finestra successiva. (facoltativo)

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

UnitOperationErrorCategory

UnitOperationErrorCategory descrive la categoria di errore dell'operazione unitaria.

Enum
UNIT_OPERATION_ERROR_CATEGORY_UNSPECIFIED La categoria di errore dell'operazione delle unità non è specificata
NOT_APPLICABLE La categoria di errore dell'operazione unitaria non è applicabile o non è un errore
FATAL La categoria di errore dell'operazione unità è irreversibile
RETRIABLE La categoria di errore dell'operazione dell'unità è riprovabile
IGNORABLE La categoria di errore dell'operazione dell'unità è ignorabile
STANDARD La categoria di errore dell'operazione unità è standard e viene conteggiata nel budget di errore di implementazione

Metodi

create

 Crea una nuova operazione unitaria.

delete

 Elimina una singola operazione unitaria.

get

 Recupera una singola operazione unità.

list

 Recupera una raccolta di operazioni unitarie.

patch

 Aggiorna una singola operazione unitaria.