Creates an API proxy. The API proxy created will not be accessible at runtime until it is deployed to an environment.
Create a new API proxy by setting the name query parameter to the name of the API proxy.
Import an API proxy configuration bundle stored in zip format on your local machine to your organization by doing the following:
- Set the
namequery parameter to the name of the API proxy. - Set the
actionquery parameter toimport. - Set the
Content-Typeheader tomultipart/form-data. - Pass as a file the name of API proxy configuration bundle stored in zip format on your local machine.
Note: To validate the API proxy configuration bundle only without importing it, set the action query parameter to validate.
When importing an API proxy configuration bundle, if the API proxy does not exist, it will be created. If the API proxy exists, then a new revision is created. Invalid API proxy configurations are rejected, and a list of validation errors is returned to the client.
HTTP request
POST https://apigee.googleapis.com/v1/{parent=organizations/*}/apis
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent |
Required. Name of the organization in the following format: |
Query parameters
| Parameters | |
|---|---|
apiProxyId |
Name of the API proxy. Restrict the characters used to: A-Za-z0-9._- |
action |
Action to perform when importing an API proxy configuration bundle. Set this parameter to one of the following values:
|
validate |
Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API. |
Request body
The request body contains an instance of HttpBody.
Response body
If successful, the response body contains a newly created instance of ApiProxyRevision.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform