Method: namespaces.services.create

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://{endpoint}/apis/serving.knative.dev/v1/{parent}/services

Where {endpoint} is one of the supported service endpoints.

Path parameters

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 form namespaces/{namespace}.

Authorization requires the following IAM permission on the specified resource parent:

  • run.services.create

Query parameters

Parameters
dryRun

string

Indicates that the server should validate the request and populate default values without persisting the request. Supported values: all

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.