v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13141948.7 KB
projects

Creates a service, and returns the new service.

post/v1/{+parent}/services

Path parameters

parentstring required

Required. The resource name of the namespace this service will belong to.

Query parameters

serviceIdstring

Required. The Resource ID must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

Request body

namestring

Immutable. The resource name for the service in the format projects/*/locations/*/namespaces/*/services/*.

annotationsobject

Optional. Annotations for the service. This data can be consumed by service clients. Restrictions: * The entire annotations dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Annotations that go beyond this limit are rejected * Valid annotation keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Annotations that fails to meet these requirements are rejected Note: This field is equivalent to the metadata field in the v1beta1 API. They have the same syntax and read/write to the same location in Service Directory.

uidstring

Output only. The globally unique identifier of the service in the UUID4 format.

Response

Successful response