Method: namespaces.services.delete

Delete a service. This will cause the Service to stop serving traffic and will delete the child entities like Routes, Configurations and Revisions.

HTTP request

DELETE https://{endpoint}/apis/serving.knative.dev/v1/{name}

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

Path parameters

Parameters
name

string

The name of the service to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number. It takes the form namespaces/{namespace_id}/services/{service_id}.

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

  • run.services.delete

Query parameters

Parameters
propagationPolicy

string

Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.

kind

string

Cloud Run currently ignores this parameter.

apiVersion

string

Cloud Run currently ignores this parameter.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Status.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.