Custom Metadata
Custom Metadata
(Optional) Additional metadata can be added to the instance information that is registered in the Discovery Service in the customMetadata
section. This information is propagated from the Discovery Service to the onboarded services (clients). In general, additional metadata do not change the behavior of the client. Some specific metadata can configure the functionality of the API Mediation Layer. Such metadata are generally prefixed with the apiml.
qualifier. We recommend you define your own qualifier, and group all metadata you wish to publish under this qualifier. If you use the Spring enabler, ensure that you include the prefix apiml.service
before the parameter name.
customMetadata.apiml.enableUrlEncodedCharacters
When this parameter is set to
true
, the Gateway allows encoded characters to be part of URL requests redirected through the Gateway. The default setting offalse
is the recommended setting. Change this setting totrue
only if you expect certain encoded characters in your application's requests.Important! When the expected encoded character is an encoded slash or backslash (
%2F
,%5C
), make sure the Gateway is also configured to allow encoded slashes. For more information, see Installing the Zowe runtime on z/OS.Note: If you use the Spring enabler, use the following parameter name:
apiml.service.customMetadata.apiml.enableUrlEncodedCharacters
customMetadata.apiml.connectTimeout
The value in milliseconds that specifies a period, in which API ML should establish a single, non-managed connection with this service. If omitted, the default value specified in the API ML Gateway service configuration is used.
Note: If you use the Spring enabler, use the following parameter name:
apiml.service.customMetadata.apiml.connectTimeout
customMetadata.apiml.readTimeout
The value in milliseconds that specifies the time of inactivity between two packets in response from this service to API ML. If omitted, the default value specified in the API MLGateway service configuration is used.
Note: If you use the Spring enabler, use the following parameter name:
apiml.service.customMetadata.apiml.readTimeout
customMetadata.apiml.connectionManagerTimeout
HttpClient employs a special entity to manage access to HTTP connections called by the HTTP connection manager. The purpose of an HTTP connection manager is to serve as a factory for new HTTP connections, to manage the life cycle of persistent connections, and to synchronize access to persistent connections. Internally, it works with managed connections which serve as proxies for real connections.
connectionManagerTimeout
specifies a period, in which managed connections with API ML should be established. The value is in milliseconds. If omitted, the default value specified in the API ML Gateway service configuration is used.Note: If you use the Spring enabler, use the following parameter name:
apiml.service.customMetadata.apiml.connectionManagerTimeout
customMetadata.apiml.okToRetryOnAllOperations
Specifies whether all operations can be retried for this service. The default value is
false
. Thefalse
value allows retries for onlyGET
requests if a response code of503
is returned. Setting this value totrue
enables retry requests for all methods, which return a503
response code. Enabling retry can impact server resources resulting from buffering of the request body.Note: If you use the Spring enabler, use the following parameter name:
apiml.service.customMetadata.apiml.okToRetryOnAllOperations
customMetadata.apiml.corsEnabled
When this parameter is set to
true
, CORS is enabled on the service level for all the service routes. For more information, see this article about Cross-Origin Resource Sharing (CORS).Note: If you use the Spring enabler, use the following parameter name:
apiml.service.customMetadata.apiml.corsEnabled
customMetadata.apiml.lb.type This parameter is part of the load balancing configuration for the Deterministic Routing capability, where the client can now specify which instance of a service the user should be routed to. This parameter can be set to the following values:
headerRequest
Use this value to check the request header to verify if this header contains the service ID and if a match is present on the specified target server
authentication
Use this value if the user is authenticated. The instance information is cached and used afterwards to forward the client request to the specified target server
customMetadata.apiml.lb.cacheRecordExpirationTimeInHours
When the property
customMetadata.apiml.lb.type
is set toauthentication
, the user can also define the expiration time for the selected instance information that is cached. This property aims to prevent any discrepancy which might possibly occur if the required target server is not available anymore. The default value is 8 hours.