Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Imports an API from the FlexDeploy Artifact Repository into Oracle API Platform.

...

Property Name

Property Code

Required

Description

Oracle API Platform Account

FDOAP_CLOUD_ACCOUNT_CODE

Yes

The Oracle API Platform cloud account to use for this operation. 

Project Properties

Property Name

Property Code

Required

Description

Oracle API Name

FDOAP_API_NAME

Yes

Name of the API being managed

Oracle API Version

FDOAP_API_VERSION

Yes

Version of the API being managed

API Entitlements

FDOAP_API_ENTITLEMENTS

No

CSV list of Plan names to entitle the API with during import. If the plan doesn't exist a warning will be logged during execution. This should only be used when multiple API Platform instances are being used.

...

Input Name

Input Code

Required

Description

Smart Import

FDOAP_INP_SMART_IMPORT

No

Import will only take place if changes are detected in the implementation or publication of the API.  This prevents unnecessary API iteration increases.

API Grants

FDOAP_INP_API_GRANTS

No

Multiselect list of grants to grant to the group(s) specified in the Grantee Groups input

Grantee Groups

FDOAP_INP_GROUPS

No

Groups or Users are required if API Grants are specified.  Oracle Paas group to receive API Grants.  If multiple, then separate with a comma.  Group1, Group2

Grantee Users

FDOAP_INP_USERS

No

Groups or Users are required if API Grants are specified. Oracle users to receive API Grants.

Update References

FDOAP_INP_UPDATE_REFERENCES

No

Will query target environment for reference ids and replace them before importing.

  • Always - Always attempt to replace references found in the .references file. If no .references file exists in the artifact repository, then an exception will be thrown

  • WhenFound - References will only be imported when the .references file is found. This is the default behavior

  • Never - Never replace references even if the file is found.

See ExportAPI Special Considerations for more information on replacing references.

Apiary Token

FDOAP_INP_APIARY_TOKEN

No

Refresh token for Apiary. If you have apiary documentation linked in any APIs then this should be set. See Generating an Apiary Token below.

If the import process detects Apiary Documentation and no Token is set your API import will still succeed but the documentation may not be linked properly, and you will see a warning in the logs.

...