REST Resource: projects.locations.saas

Recurso: Saas

SaaS es una representación de un servicio de SaaS administrado por el Productor.

Representación JSON
{
  "name": string,
  "locations": [
    {
      object (Location)
    }
  ],
  "applicationTemplate": {
    object (CompositeRef)
  },
  "blueprintRepo": string,
  "state": enum (State),
  "conditions": [
    {
      object (SaasCondition)
    }
  ],
  "error": {
    object (Status)
  },
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
Campos
name

string

Es el identificador. Nombre del recurso (URI completo del recurso) según el esquema de nombres estándar:

"projects/{project}/locations/{location}/saas/{saas}"

locations[]

object (Location)

Es opcional. Es la lista de ubicaciones en las que está disponible el servicio. El lanzamiento hace referencia a la lista para generar un plan de lanzamiento.

applicationTemplate

object (CompositeRef)

Es una referencia a ApplicationTemplate compuesto. Cuando se especifiquen, los componentes de la plantilla se importarán a sus recursos equivalentes de UnitKind, Release y Blueprint. Las referencias borradas no borrarán los recursos importados. Solo se debe especificar en las regiones de origen y no se debe especificar en las regiones de réplica.

blueprintRepo

string

Solo salida. Nombre del repositorio en Artifact Registry para los esquemas generados por el sistema, p. ej., Son los planos de los ApplicationTemplates importados.

state

enum (State)

Solo salida. Es el estado del SaaS. Siempre está en estado ACTIVE si applicationTemplate está vacío.

conditions[]

object (SaasCondition)

Solo salida. Es un conjunto de condiciones que indican las diversas condiciones que puede tener este recurso.

error

object (Status)

Solo salida. Si el estado es FAILED, se muestran el código y el mensaje de error correspondientes. El valor predeterminado es code=OK para todos los demás estados.

labels

map (key: string, value: string)

Es opcional. Son las etiquetas del recurso, que se pueden usar para la categorización, de forma similar a las etiquetas de recursos de Kubernetes.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

map (key: string, value: string)

Es opcional. Las anotaciones son un mapa clave-valor no estructurado que se almacena con un recurso que herramientas externas pueden establecer para almacenar y recuperar metadatos arbitrarios. No se pueden consultar y deben conservarse cuando se modifican objetos.

Más información: https://kubernetes.io/docs/user-guide/annotations

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

uid

string

Solo salida. Identificador único del recurso. El UID es único en el tiempo y espacio para este recurso dentro del alcance de este servicio. Normalmente, el servidor lo genera durante la creación correcta de un recurso y no se debe cambiar. El UID se usa para identificar los recursos de manera única en caso de la reutilización de nombres de recursos y debe ser un UUID4.

etag

string

Solo salida. Valor opaco que identifica de manera única a una versión o generación de un recurso. Se puede usar para confirmar que el cliente y el servidor están de acuerdo en el orden del recurso que se escribe.

createTime

string (Timestamp format)

Solo salida. Marca de tiempo cuando se creó el recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo salida. Marca de tiempo cuando se actualizó el recurso por última vez. Este valor debe actualizarse en caso de que los usuarios hagan cualquier cambio al recurso. Este valor debería actualizarse si el servicio hace cambios al recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Ubicación

Es la información de ubicación en la que está disponible el servicio.

Representación JSON
{
  "name": string
}
Campos
name

string

Es opcional. Es el nombre de la ubicación.

Estado

Es el estado del SaaS.

Enums
STATE_TYPE_UNSPECIFIED El tipo de estado no está especificado.
ACTIVE

Obsoleto: Usa STATE_ACTIVE.

RUNNING

Obsoleto: Usa STATE_RUNNING.

FAILED

Obsoleto: Usa STATE_FAILED.

STATE_ACTIVE La SaaS está lista
STATE_RUNNING En el proceso de importar, sincronizar o replicar ApplicationTemplates
STATE_FAILED Falla durante el proceso de importación, sincronización o replicación del procesamiento de ApplicationTemplate

SaasCondition

SaasCondition describe el estado de un SaaS.

Representación JSON
{
  "status": enum (Status),
  "type": enum (Type),
  "lastTransitionTime": string,
  "message": string,
  "reason": string
}
Campos
status

enum (Status)

Obligatorio. Es el estado de la condición.

type

enum (Type)

Obligatorio. Es el tipo de condición.

lastTransitionTime

string (Timestamp format)

Obligatorio. Es la última vez que la condición pasó de un estado a otro.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

message

string

Obligatorio. Es un mensaje legible que indica detalles sobre la última transición.

reason

string

Obligatorio. Es el motivo breve de la última transición de la condición.

Estado

Es una enumeración de los estados de la condición.

Enums
STATUS_UNSPECIFIED El estado de la condición no está especificado.
STATUS_UNKNOWN Se desconoce la condición.
STATUS_TRUE La condición es verdadera.
STATUS_FALSE La condición es falsa.

Tipo

Es una enumeración de los tipos de condiciones.

Enums
TYPE_UNSPECIFIED No se especificó el tipo de condición.
TYPE_READY El tipo de condición está listo.
TYPE_SYNCHRONIZED El tipo de condición se sincronizó.

Métodos

create

Crea un nuevo SaaS.

delete

Borra un solo SaaS.

get

Recupera un solo SaaS.

list

Recupera una colección de SaaS.

patch

Actualiza un solo SaaS.