Creates a new Service. Service creation will trigger a new deployment. Use services.get, and check service.status to determine if the Service is ready.
HTTP request
POST https://run.googleapis.com/apis/serving.knative.dev/v1/{parent}/services
Path parameters
parent
string
Required. The resource's parent. In Cloud Run, it may be one of the following:
-
{project_id_or_number} -
namespaces/{project_id_or_number} -
namespaces/{project_id_or_number}/services -
projects/{project_id_or_number}/locations/{region} -
projects/{project_id_or_number}/regions/{region}It takes the formnamespaces/{namespace}.
Authorization requires the following IAM
permission on the specified resource parent
:
-
run.services.create
Query parameters
| Parameters | |
|---|---|
dryRun
|
Indicates that the server should validate the request and populate default values without persisting the request. Supported values: |
Request body
The request body contains an instance of Service
.
Response body
If successful, the response body contains a newly created instance of Service
.
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .

