Function buildServers

index.js:81–176

(endpointPrefix, serviceName, awsRegionConfig)

// Build a OpenAPI v3-compatible 'servers' object for this endpoint, for all regions.
// For now this will be attached as x-servers, for v2 compatibility (see swaggerplusplus)
function buildServers(endpointPrefix, serviceName, awsRegionConfig) {
    // This uses the same logic for config lookup as aws-sdk/lib/region_config.js

    // Build a map of URL -> regions covered by that URL
    const regionsByEndpoint = awsRegions.list().reduce((regionsByEndpoint, region) => {
        // From the AWS SDK. Defines a list of keys for the config of this service, from
        // most to least specific. We'll use the most specific that exists.
        const regionPrefix = generateRegionPrefix(region.code);
        const endpointKeys = [
            [region.code, endpointPrefix],
            [regionPrefix, endpointPrefix],
            [region.code, '*'],
            [regionPrefix, '*'],
            ['*', endpointPrefix],
            ['*', '*']
        ].map((item) => item[0] && item[1] ? item.join('/') : null);

        const endpointConfigKey = _.find(endpointKeys, (k) => awsRegionConfig.rules[k]);

        // Config is either a config, or a key for a config in the 'patterns' object
        const endpointConfig = typeof awsRegionConfig.rules[endpointConfigKey] === 'string'
            ? awsRegionConfig.patterns[awsRegionConfig.rules[endpointConfigKey]]
            : awsRegionConfig.rules[endpointConfigKey];

        let endpoints = [];

        // If no protocol is specified, both HTTP & HTTPS are allowed
        if (endpointConfig.endpoint.match(/^https?:\/\//)) {
            endpoints.push(endpointConfig.endpoint);
        } else {
            endpoints.push('http://' + endpointConfig.endpoint);
            endpoints.push('https://' + endpointConfig.endpoint);
        }

        // If we have both region & general endpoints, add the general endpoint(s) too
        if (endpointConfig.generalEndpoint) {
            if (endpointConfig.generalEndpoint.match(/^https?:\/\//)) {
                endpoints.push(endpointConfig.generalEndpoint);
            } else {
                endpoints.push('http://' + endpointConfig.generalEndpoint);
                endpoints.push('https://' + endpointConfig.generalEndpoint);
            }
        }

        endpoints.forEach((endpoint) => {
            if (!regionsByEndpoint[endpoint]) {
                regionsByEndpoint[endpoint] = [region];
            } else {
                regionsByEndpoint[endpoint].push(region);
            }
        });

        return regionsByEndpoint;
    }, {});

    // Turn the endpoint URLs + regions list into nice url + description + vars objects
    return Object.keys(regionsByEndpoint).map((endpoint) => {
        const validRegions = regionsByEndpoint[endpoint];