- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
Create an API resource in the API hub. Once an API resource is created, versions can be added to it.
HTTP request
POST https://apihub.googleapis.com/v1/{parent=projects/*/locations/*}/apis
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent
|
Required. The parent resource for the API resource. Format: |
Query parameters
apiId
string
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][A-Z][0-9]-_/.
Request body
The request body contains an instance of Api
.
Response body
If successful, the response body contains a newly created instance of Api
.
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
IAM Permissions
Requires the following IAM
permission on the parent
resource:
-
apihub.apis.create
For more information, see the IAM documentation .
