['min_range' => 1]] ); $requestKey = $actor['request_idempotency_key'] ?? null; $hostId = filter_var( $input['target_host_id'] ?? null, FILTER_VALIDATE_INT, ['options' => ['min_range' => 1]] ); $resourcePoolId = filter_var( $input['target_resource_pool_id'] ?? null, FILTER_VALIDATE_INT, ['options' => ['min_range' => 1]] ); $planSha256 = $input['target_plan_sha256'] ?? null; if ($requesterId === false) { throw new CloudError('恢复请求用户身份无效', 403); } if (!is_string($requestKey) || preg_match('/^[A-Za-z0-9_.-]{16,128}$/D', $requestKey) !== 1) { throw new CloudError('恢复请求必须提供有效的幂等标识', 400); } if ($hostId === false) { throw new CloudError('请选择目标宿主机'); } if ($resourcePoolId === false) { throw new CloudError('请选择目标资源池'); } if (!is_string($planSha256) || preg_match('/^[a-f0-9]{64}$/D', $planSha256) !== 1) { throw new CloudError('请选择精确的恢复目标计划', 409); } if (($input['confirm_new_instance'] ?? false) !== true) { throw new CloudError('请确认恢复会创建免计费的独立新实例'); } $targetName = CloudInput::name($input['name'] ?? null); $plan = self::plan( $backup, (int) $requesterId, $requestKey, (int) $hostId, (int) $resourcePoolId, $planSha256, $targetName ); $reserved = CloudPortableRestoreAttemptCoordinator::reserve( $actor, $backup, $plan, $planSha256, $targetName, $requestKey )->toArray(); $attemptKey = $reserved['attempt_key'] ?? null; if (!is_string($attemptKey) || preg_match('/^[a-f0-9]{32}$/D', $attemptKey) !== 1) { throw new CloudError('恢复预留回执无效,必须人工核查', 503); } $attempt = CloudBackupRestoreAttempt::where( 'attempt_key', $attemptKey )->first(); if (!$attempt instanceof CloudBackupRestoreAttempt || (int) $attempt->backup_restore_id !== (int) ($reserved['restore_id'] ?? 0)) { throw new CloudError('恢复预留账本不完整,必须人工核查', 503); } if ($attempt->job_id === null || (string) $attempt->state === 'queued') { CloudPortableRestoreJobDispatcher::queue( $actor, $attemptKey ); } return self::result( (int) $backup->id, (int) $requesterId, $attemptKey ); } private static function plan(CloudInstanceBackup $backup, int $requesterId, string $requestKey, int $hostId, int $resourcePoolId, string $planSha256, string $targetName): CloudPortableRestoreTargetPlan { $existing = CloudBackupRestore::where( 'requested_by_user_id', $requesterId )->where('request_idempotency_key', $requestKey)->first(); if ($existing instanceof CloudBackupRestore) { try { $plan = CloudPortableRestoreTargetPlan::fromStored( (string) $existing->selected_plan_json, (string) $existing->selected_plan_sha256 ); } catch (\InvalidArgumentException) { throw new CloudError('恢复请求保存的目标计划损坏', 409); } $target = $plan->toArray()['target']; if ((int) $existing->backup_id !== (int) $backup->id || !hash_equals($plan->sha256(), $planSha256) || (int) $target['host_id'] !== $hostId || (int) $target['resource_pool_id'] !== $resourcePoolId || !hash_equals((string) $existing->new_name, $targetName)) { throw new CloudError('恢复请求幂等身份冲突', 409); } return $plan; } $matches = []; foreach (CloudPortableRestoreTargetService::candidates($backup) as $candidate) { $target = $candidate->toArray()['target']; if ((int) $target['host_id'] === $hostId && (int) $target['resource_pool_id'] === $resourcePoolId && hash_equals($candidate->sha256(), $planSha256)) { $matches[] = $candidate; } } if (count($matches) !== 1) { throw new CloudError('恢复目标计划已过期,请刷新后重新选择', 409); } return $matches[0]; } /** @return array{restore:CloudBackupRestore,job:CloudJob} */ private static function result(int $backupId, int $requesterId, string $attemptKey): array { return (new CloudJob())->getConnection()->transaction( static function () use ( $backupId, $requesterId, $attemptKey ): array { $attempt = CloudBackupRestoreAttempt::where( 'attempt_key', $attemptKey )->first(); $restore = $attempt instanceof CloudBackupRestoreAttempt ? CloudBackupRestore::find( (int) $attempt->backup_restore_id ) : null; $backup = $restore instanceof CloudBackupRestore ? CloudInstanceBackup::find((int) $restore->backup_id) : null; $job = $attempt instanceof CloudBackupRestoreAttempt && $attempt->job_id !== null ? CloudJob::find((int) $attempt->job_id) : null; self::assertRows( $backup, $restore, $attempt, $job, $backupId, $requesterId ); self::assertEnvelope($backup, $restore, $attempt, $job); return ['restore' => $restore, 'job' => $job]; }, 1 ); } private static function assertRows(?CloudInstanceBackup $backup, ?CloudBackupRestore $restore, ?CloudBackupRestoreAttempt $attempt, ?CloudJob $job, int $backupId, int $requesterId): void { $targetInstanceId = $restore?->target_instance_id === null ? null : (int) $restore->target_instance_id; $jobInstanceId = $job?->instance_id === null ? null : (int) $job->instance_id; if (!$backup instanceof CloudInstanceBackup || !$restore instanceof CloudBackupRestore || !$attempt instanceof CloudBackupRestoreAttempt || !$job instanceof CloudJob || (int) $backup->id !== $backupId || (int) $restore->backup_id !== $backupId || (int) $restore->requested_by_user_id !== $requesterId || (int) $attempt->backup_restore_id !== (int) $restore->id || (int) $attempt->job_id !== (int) $job->id || (int) $job->backup_id !== $backupId || (int) $job->backup_restore_id !== (int) $restore->id || (int) $job->user_id !== (int) $backup->user_id || (int) $job->host_id !== (int) $attempt->target_host_id || $targetInstanceId !== $jobInstanceId || (string) $job->kind !== 'backup_restore' || (string) $job->execution_mode !== 'agent' || !hash_equals( (string) $job->operation_id, (string) $attempt->operation_id ) || !hash_equals( (string) $job->request_idempotency_key, (string) $attempt->attempt_key ) || ((int) $attempt->generation === 1 && (int) $restore->job_id !== (int) $job->id)) { throw new CloudError('恢复任务账本不完整,必须人工核查', 503); } } private static function assertEnvelope(CloudInstanceBackup $backup, CloudBackupRestore $restore, CloudBackupRestoreAttempt $attempt, CloudJob $job): void { try { $payload = CloudSecrets::decrypt( (string) $job->sealed_payload, 'job-payload' ); } catch (\Throwable) { throw new CloudError('恢复任务冻结信封无法读取', 409); } if (!is_array($payload) || array_is_list($payload)) { throw new CloudError('恢复任务冻结信封结构无效', 409); } $state = (string) $attempt->state; if ($state === 'queued') { CloudPortableRestoreJobEnvelope::fromJobForDispatch( $job, $payload ); return; } if (in_array($state, [ 'awaiting_receipt', 'effect_unknown', 'finalization_pending', ], true)) { CloudPortableRestoreJobEnvelope::fromJobForRecovery( $job, $payload ); return; } self::assertTerminalEnvelope( $backup, $restore, $attempt, $job, $payload ); } private static function assertTerminalEnvelope( CloudInstanceBackup $backup, CloudBackupRestore $restore, CloudBackupRestoreAttempt $attempt, CloudJob $job, array $payload): void { $body = $payload['body'] ?? null; $state = (string) $attempt->state; $terminalShape = $state === 'succeeded' ? (string) $attempt->effect_resolution === 'applied' && (string) $job->phase === 'terminal' && (string) $job->outcome === 'succeeded' && (string) $job->effect_resolution === 'applied' && $attempt->terminal_at !== null && $job->terminal_at !== null && $restore->target_instance_id !== null : ($state === 'failed' && (string) $attempt->effect_resolution === 'not_applied' && (string) $job->phase === 'terminal' && (string) $job->outcome === 'failed' && (string) $job->effect_resolution === 'not_applied' && $attempt->terminal_at !== null && $job->terminal_at !== null && $restore->target_instance_id === null); if (!$terminalShape || !is_array($body) || array_is_list($body) || self::containsCapability($payload) || (int) ($payload['owner_id'] ?? 0) !== (int) $backup->user_id || (int) ($payload['reservation_id'] ?? 0) !== (int) $attempt->reservation_id || (int) ($payload['generation'] ?? 0) !== (int) $attempt->generation || !hash_equals( (string) ($payload['backup_key'] ?? ''), (string) $backup->backup_key ) || !hash_equals( (string) ($payload['restore_key'] ?? ''), (string) $restore->restore_key ) || !hash_equals( (string) ($payload['attempt_key'] ?? ''), (string) $attempt->attempt_key ) || !hash_equals( (string) ($payload['target_plan_sha256'] ?? ''), (string) $attempt->target_plan_sha256 ) || !hash_equals( (string) ($payload['target_identity_sha256'] ?? ''), (string) $attempt->target_identity_sha256 ) || !hash_equals( (string) ($payload['target_claim_set_sha256'] ?? ''), (string) $attempt->target_claim_set_sha256 ) || !hash_equals( (string) ($payload['target_public_network_sha256'] ?? ''), (string) $attempt->target_public_network_sha256 ) || !hash_equals( (string) ($body['operation_id'] ?? ''), (string) $attempt->operation_id ) || !hash_equals( strtolower((string) ($body['uuid'] ?? '')), strtolower((string) $attempt->target_uuid) ) || !hash_equals( (string) ($body['name'] ?? ''), (string) $attempt->target_name ) || !hash_equals( (string) ($body['backup_key'] ?? ''), (string) $backup->backup_key )) { throw new CloudError('恢复任务终态账本不一致', 409); } } private static function containsCapability(array $value): bool { $forbidden = [ 'source_url' => true, 'object_key' => true, 'sealed_storage_runtime' => true, 'access_key_id' => true, 'secret_access_key' => true, 'credentials' => true, ]; foreach ($value as $key => $item) { if (is_string($key) && isset($forbidden[$key])) { return true; } if (is_array($item) && self::containsCapability($item)) { return true; } } return false; } }