Sign in

v1

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

Create an API resource in the API hub. Once an API resource is created, versions can be added to it.

post/v1/{+parent}/apis

Path parameters

parentstring required

Required. The parent resource for the API resource. Format: projects/{project}/locations/{location}

Query parameters

apiIdstring

Optional. The ID to use for the API resource, which will become the final component of the API's resource name. This field is optional. * If provided, the same will be used. The service will throw an error if the specified id is already used by another API resource in the API hub. * If not provided, a system generated id will be used. This value should be 4-500 characters, and valid characters are /a-z[0-9]-_/.

Request body

fingerprintstring

Optional. Fingerprint of the API resource. This must be unique for each API resource. It can neither be unset nor be updated to an existing fingerprint of another API resource.

selectedVersionstring

Optional. The selected version for an API resource. This can be used when special handling is needed on client side for particular version of the API. Format is projects/{project}/locations/{location}/apis/{api}/versions/{version}

displayNamestring

Required. The display name of the API resource.

namestring

Identifier. The name of the API resource in the API Hub. Format: projects/{project}/locations/{location}/apis/{api}

attributesobject

Optional. The list of user defined attributes associated with the API resource. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

descriptionstring

Optional. The description of the API resource.

createTimestring google-datetime

Output only. The time at which the API resource was created.

updateTimestring google-datetime

Output only. The time at which the API resource was last updated.

versionsstring[]

Output only. The list of versions present in an API resource. Note: An API resource can be associated with more than 1 version. Format is projects/{project}/locations/{location}/apis/{api}/versions/{version}

Response

Successful response