Function validatePutVersionId

lib/api/apiUtils/object/coldStorage.js:131–164

* Check if "put version id" is allowed * * @param {ObjectMD} objMD - object metadata * @param {string} versionId - object's version id * @param {object} log - werelogs logger * @return {ArsenalError|undefined} - undefined if "put version id" is allowed

(objMD, versionId, log)

 * @return {ArsenalError|undefined} - undefined if "put version id" is allowed
 */
function validatePutVersionId(objMD, versionId, log) {
    if (!objMD) {
        const err = versionId ? errors.NoSuchVersion : errors.NoSuchKey;
        log.error('error no object metadata found', { method: 'validatePutVersionId', versionId });
        return err;
    }

    if (objMD.isDeleteMarker) {
        log.error('version is a delete marker', { method: 'validatePutVersionId', versionId });
        return errors.MethodNotAllowed;
    }

    const isLocationCold = locationConstraints[objMD.dataStoreName]?.isCold;
    if (!isLocationCold) {
        log.error('The object data is not stored in a cold storage location.',
            {
                isLocationCold,
                dataStoreName: objMD.dataStoreName,
                method: 'validatePutVersionId',
            });
        return errors.InvalidObjectState;
    }

    // make sure object archive restoration is in progress
    // NOTE: we do not use putObjectVersion to update the restoration period.
    if (!objMD.archive || !objMD.archive.restoreRequestedAt || !objMD.archive.restoreRequestedDays
        || objMD.archive.restoreCompletedAt || objMD.archive.restoreWillExpireAt) {
        log.error('object archive restoration is not in progress',
            { method: 'validatePutVersionId', versionId });
        return errors.InvalidObjectState;
    }

    return undefined;
}

/**
 * Check if the object is already restored, and update the expiration date accordingly: