This operation builds api specification file(s) from a SCM repository and validates the file contents by uploading to OCI API. The apiBuild operation can only be used with a FlexDeploy package-based deployment project of type Oracle Api Gateway.

Artifact is a single zip file containing api specification files (JSON or YAML).

Target Properties

Property Name

Property Code

Required

Description

Oracle API Gateway Account

FDOAG_CLOUD_ACCOUNT_CODE

No*

OCI account with all the required properties like Tenancy Id, User OCID, and Private Key, etc.

Oracle API Gateway Account will be required on either the plugin input or Target. If a value is set on both then, the plugin input will take precedence.

See Special Considerations below for instructions on how to create an OCI account for Oracle API Gateway.

Compartment Name

FDOAG_COMPARTMENT_NAME

No*

The OCI compartment used to validate the api specification. Useful if you build from a different compartment per environment.

Compartment Name is required if Compartment Name on a file level attribute contains property replacement syntax - Property Replacement Support

Project Properties

Property Name

Property Code

Required

Description

Root Compartment Id

FDOAG_ROOT_COMPARTMENT_ID

Yes

Root or parent compartment Id used to find sub-compartments. i.e. ocid1.tenancy.oc1..<OCID>

This can be sub-compartment as well, but root is suggested.

Inputs

Property Name	Property Code	Required	Description
Oracle API Gateway Account	FDOAG_INP_CLOUD_ACCOUNT_CODE	No	OCI account with all the required properties like Tenancy Id, User OCID, and Private Key, etc.

Artifacts

This operation produces artifacts that will be stored in the artifacts repository.

Endpoint Selection

This operation will select all available endpoints associated to the Target.

Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.

Special Considerations

N/A