---
title: "POST /v1/{+parent}/saas"
method: POST
path: "/v1/{+parent}/saas"
tags: ["projects"]
---

# POST /v1/{+parent}/saas

`POST /v1/{+parent}/saas`

Create a new saas.

## Path parameters

- `parent` string, required

## Query parameters

- `requestId` string
- `saasId` string
- `validateOnly` boolean

## Request body

- Saas — Saas is a representation of a SaaS service managed by the Producer.
  - `state` 'STATE_TYPE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_RUNNING' | 'STATE_FAILED' — Output only. State of the Saas. It is always in STATE_ACTIVE state if the application_template is empty.
  - `etag` string — Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written.
  - `createTime` string, google-datetime — Output only. The timestamp when the resource was created.
  - `locations` Location[] — Optional. List of locations that the service is available in. Rollout refers to the list to generate a rollout plan.
    - `name` string — Optional. Name of location.
  - `conditions` SaasCondition[] — Output only. A set of conditions which indicate the various conditions this resource can have.
    - `reason` string — Required. Brief reason for the condition's last transition.
    - `status` 'STATUS_UNSPECIFIED' | 'STATUS_UNKNOWN' | 'STATUS_TRUE' | 'STATUS_FALSE' — Required. Status of the condition.
    - `type` 'TYPE_UNSPECIFIED' | 'TYPE_READY' | 'TYPE_SYNCHRONIZED' — Required. Type of the condition.
    - `lastTransitionTime` string, google-datetime — Required. Last time the condition transited from one status to another.
    - `message` string — Required. Human readable message indicating details about the last transition.
  - `error` Status — The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
    - `message` string — A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
    - `code` integer — The status code, which should be an enum value of google.rpc.Code.
    - `details` object[] — A list of messages that carry the error details. There is a common set of message types for APIs to use.
  - `labels` object — Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.
  - `annotations` object — Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations
  - `name` string — Identifier. The resource name (full URI of the resource) following the standard naming scheme: "projects/{project}/locations/{location}/saas/{saas}"
  - `uid` string — Output only. The unique identifier of the resource. UID is unique in the time and space for this resource within the scope of the service. It is typically generated by the server on successful creation of a resource and must not be changed. UID is used to uniquely identify resources with resource name reuses. This should be a UUID4.
  - `updateTime` string, google-datetime — Output only. The timestamp when the resource was last updated. Any change to the resource made by users must refresh this value. Changes to a resource made by the service should refresh this value.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/saasservicemgmt.md) · [All operations](https://skmtc.net/google/apis/saasservicemgmt/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/saasservicemgmt/versions/f94de4124ae2/schema)